diff --git a/docs/architecture.md b/docs/architecture.md index 0622ca9..0b24114 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -6,7 +6,7 @@ This is the owner's document: how a role gets from a board to the Roles feed, fo Each agent decides about a role three times, and each decision acts as a filter: -- **Fetch gate**, a yes or no: the agent's hard rules. These are the required countries (Europe), the Where lines (countries, towns, remote) and the titles to leave out. Companies on the follow-everywhere list skip the location part. The gate applies at every stage: at the host when the host can filter, in the cheap pass, again after extract (now with the real location and remote area), and in the feed. A role that fails it is never read by a model and never shown. +- **Fetch gate**, a yes or no: the agent's hard rules. These are the required countries (Europe), the Where lines (countries, towns, remote) and the titles to leave out. A company set to **All roles** passes everything but the required countries: its roles skip the Where lines and the titles to leave out. The gate applies at every stage: at the host when the host can filter, in the cheap pass, again after extract (now with the real location and remote area), and in the feed. A role that fails it is never read by a model and never shown. - **Analysis score**: decides which roles that pass the fetch gate make the **cut**, the roles that get fetch text and the model pass. - **Final score**: orders the feed. @@ -54,7 +54,7 @@ Names: **fetch text** is the second HTTP read of a role's own page, with no mode **Decided: the cut is two lists, joined.** One list is by prompt fit. The other is by CV closeness: the roles closest to the CV that the first list leaves out. The two are not merged into one number, because they answer different questions (what I want, what I am), and a merged number would let the stronger side crowd the other out. Each list has a count and a minimum level on the form. For a broad agent the count stops the list; for a narrow agent the minimum does, so roles that do not fit are not read just to fill the count. Starting values: 500 by prompt fit and 150 by CV closeness, each at least 0.6. The minimums are levels of plain fit and plain CV closeness, not of today's blended score. Among agent 2's roles that pass the fetch gate, 2,086 reach fit 0.6, 1,580 reach CV closeness 0.6, and 2,437 reach either, so for agent 2 the counts decide. -**Decided: affinity is a bonus on the level, as today in spirit.** A role's level on both lists rises by the company's affinity. Today the affinity term is weighted 0.2 out of 1.25, which puts a liked company about 0.05 above a neutral one and a favourite about 0.1 above. The cut keeps those sizes. The four company settings are hidden (-1), neutral (0), liked (1) and favourite (2). A hidden company is not scored at all, so it never reaches the cut or the feed. There is no level that pushes a company down without hiding it, and none is planned. Affinity remains a nudge, not a pass: a favourite's role that matches nothing stays out of the cut. +**Decided: affinity is a bonus on the level, as today in spirit.** A role's level on both lists rises by the company's affinity. Today the affinity term is weighted 0.2 out of 1.25, which puts a liked company about 0.05 above a neutral one and a favourite about 0.1 above. The cut keeps those sizes. The four company settings are hidden (-1), neutral (0), liked (1) and favourite (2). A hidden company is not scored at all, so it never reaches the cut or the feed. There is no level that pushes a company down without hiding it, and none is planned. Affinity remains a nudge, not a pass: a favourite's role that matches nothing stays out of the cut. Favourite only raises the level. Today it also skips the Where lines; that moves to All roles (section 5). **Decided: a role you like or save always makes the cut.** This is part of the analysis score, not a separate manual path: a like or a save passes the cut whatever the role's levels, so the role gets fetch text, extract and judge. It goes through on the next pull or agent save, not the moment you click. @@ -100,12 +100,13 @@ Without the Where lines, about four in five model reads go to roles outside DK, - The feed shows every role that passes the fetch gate, loaded as you scroll, not only the cut. Newest first stays inside the fetch gate as well, so no order shows roles outside the agent's places. - There are two orders: "what I'm looking for" (final score) and "what fits me" (CV match). The final score includes newness and likes. It is not one blended number. - Front-end filters only narrow further. The Roles page says that the feed is already filtered by the agent's fetch gate, location included. +- **All roles**, one company switch in place of today's All countries and All roles. It is for small companies worth a speculative approach ("have you thought about hiring in Denmark?"). The company is fetched from every country inside the required countries (Europe) and without fetch terms, and its roles pass the fetch gate whatever the Where lines and the titles to leave out say. It changes nothing in any score: its roles enter the cut only by their levels, and favourite is what pushes them up. It applies to every agent, as the two switches do today. +- The company view says plainly what is filtered: for an All roles company, "every role in Europe, not filtered by country or title"; for any other company, that it shows the roles the agent's fetch gate passes. Looking up a company must not silently hide roles in other countries. - **Saved filters.** The current filter settings can be saved under a name, loaded with one click and deleted. There is no editing: to change one, save a new one and delete the old. **Open.** - What the final score is made of: whether fit stays at 0.6, whether it reads extracted facts such as seniority, and whether location counts at all or is left to filters and saved filters. -- Whether the follow-everywhere list replaces favourite (affinity 2), All countries and All roles, or is a fourth company setting beside them. ## 6 After the ranking