Fetch terms narrow what big boards read with the wide reach send (WP F2)

An agent has fetch_terms (migration 23, API, a chip field in the agent
editor). The terms of a pull are the union over the enabled agents, none
when one of them has none. They go only to wide reads: a company tagged All
roles, or a reach ask_for drops as too many countries for a one host; a
board's {"terms": false} switches them off. SmartRecruiters q,
SuccessFactors q, Workday searchText, Phenom keywords, Eightfold query and
Oracle keyword declare query="one"; the runner makes one series per term
times the country series, drops the places first over MAX_SERIES, then the
terms. A term read is narrowed: it writes no ats:size, closes nothing and
prunes no per-role state, and the 10% guard holds it to its own
fingerprint. The Companies reach line counts the terms.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
WolfandClaude Opus 5.5 committed 2026-09-30 11:59:27 +02:00
1 parent 3917b31209
commit 0fd45b333a
28 files changed
+839 -113

No files matched your search

+1
View File
@@ -62,6 +62,7 @@ Terms apply only to boards of 300 roles or more that are not tagged All roles. T
| R2 Raw rows o to z | Sonnet | The same for Oracle to Workday and the three providers | those modules and tests, their table sections | K merged |
| P Prep stage | Opus | `app/prep/` stage, host-word columns and the `unmapped` table (migration 22), `upsert_role` storing raw values, gazetteer and alias resolution moved into prep, the cascade, `app prep` CLI, the Sources page list of unmapped words | `app/prep/*` except the table sections, `app/storage/*`, `app/jobs/cascade.py`, `app/jobs/stages.py`, `app/cli.py`, `app/static/sources.js`, their tests | K merged; R1 and R2 merge with it |
| F2 Terms and towns | Opus | `fetch_terms` on agents (model, API, agent editor), terms and towns in the reach, runner series for `query` and `place`, reader filters per the survey | `app/jobs/reach.py`, `plugins/readers/_runner.py`, `_contract.py`, the filtering readers, `app/static/agents.js` | S, and R1/R2/P merged |
| F2 done 2026-09-30 | Opus | `agents.fetch_terms` (migration 23, API, a chip field in the agent editor); terms in the reach for wide reads only; one series per term on SmartRecruiters `q`, SuccessFactors `q`, Workday `searchText`, Phenom `keywords`, Eightfold `query`, Oracle `keyword`; places dropped first, then terms, over `MAX_SERIES`; a term read (`ats:narrowed`) sets no size and closes nothing; the reach line counts the terms. Towns stay fetched as their country | branch `wp-f2-terms` | |
The survey (`docs/plan-prep-survey.md`) narrowed F2: the narrow reach already leaves at most 149 roles on any big board, and keywords match the whole text, so terms go only to reads with the wide reach (All roles, or a one-country host over `MAX_SERIES`). `query` is built in this order: SmartRecruiters, SuccessFactors, then Workday, Phenom, Eightfold and Oracle. Category and level filters wait until something maps agent terms to host ids. Towns stay fetched as their country. A term-filtered read never sets `ats:size` and never closes roles as gone.