diff --git a/README.md b/README.md index baa11a4..446630b 100644 --- a/README.md +++ b/README.md @@ -37,12 +37,12 @@ Two tabs, and a cog for settings. | **Roles** | newsdesk's feed: a filter rail (Show read, Best first or Newest first, first seen, tags, more filters), the open roles with company, place, age, tags and a summary, votes (▲ like ● neither way ▼ pass) and a Save button. A title opens the reader beside the list; on a phone it takes the screen. `j`/`k` move, `Enter` opens, `/` searches | | **Applications** | the saved roles and their status, each change recorded as an event | -The cog opens `/settings`, one shell with three sub-tabs: +The cog opens `/settings`: a rail of pages on the left, the page beside it, sticky so Runs is one click away however long the company list gets. On a phone the rail is a strip under the header. | | | |---|---| -| **Search agents** | the list of agents the Roles tab ranks by, and the form for one: name, intent, weights, and require/prefer gates behind an Advanced disclosure. Saving rescores; deleting one takes its votes, liked companies and scores with it | -| **Sources** | one page, one section per plugin: job boards (queries on Jobindex or Adzuna: try, save, edit, remove), company boards (every company whose board is read, its open roles and its affinity for the picked agent, following a company, pruning boards by region) and runs (Pull now, what is running, the schedule, one stage at a time, and the message log) | +| **Search agents** | a card per agent, newest first: name, an On/Off switch, what it looks for, and its weights. Edit turns the card into the form in place (name, intent, weights, require/prefer gates behind an Advanced disclosure); New agent puts a blank card on top. Saving or switching on rescores; deleting one takes its votes, liked companies and scores with it | +| **Sources** | one page showing one section at a time, picked in the rail or by the URL fragment: job boards (queries on Jobindex or Adzuna: try, save, edit, remove), company boards (every company whose board is read, its open roles and its affinity for the picked agent, following a company, pruning boards by region) and runs (Pull now, what is running, the schedule, one stage at a time, and the message log) | | **Account** | the password, sessions and passkeys. Open on loopback, locked on anything else | Likes, hidden companies and votes belong to a search agent, not to the account: two agents rank the same roles differently, and one may hide a company the other favours. An agent also learns from votes: its `taste` weight scores a role by how close it is to the roles the agent liked minus the ones it passed. diff --git a/app/static/agents.js b/app/static/agents.js index 72add23..f095ffd 100644 --- a/app/static/agents.js +++ b/app/static/agents.js @@ -1,9 +1,14 @@ /* The Search agents page: what Best match on the Roles tab is measured * against, one agent at a time. * - * The list is `/api/agents`; the form edits the agent picked from it, New - * clears it, Delete removes it. Votes, liked companies and scores are the - * agent's, so a delete takes them with it, and the confirm says so. + * Every agent from `/api/agents` is a card, newest first: its name, its + * switch, what it looks for, its weights, and a link to the Roles tab in its + * order. What it looks for is the paragraph, since that is what fit is + * measured against; the weights only share out the terms. Edit turns a card + * into the form from the page's `