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

+9 -2
View File
@@ -68,7 +68,8 @@ class Filters(_Frozen):
"""What the host filters at the source, per dimension. `country` takes
ISO 3166 alpha-2 codes, `place` place names, `remote` a bool, `query`
words. The runner never hands a reader a value on a dimension it
declared `none`."""
declared `none`. A board host with `query="one"` also takes the agents'
fetch terms, one term a series (`Ask.terms`, see `_runner.ask_for`)."""
country: Filter = "none"
place: Filter = "none"
@@ -159,13 +160,19 @@ class Ask(_Frozen):
series of their own: a reader never gets both `remote=True` and a
country or a place. With `remote="ids"`, `remote_ids` holds the host's
ids of its remote values (`facets(...)["remote"]`, any key), and
`remote` stays True."""
`remote` stays True.
`terms` are the agents' fetch terms a board is narrowed by (see
`app/jobs/reach.py`). The runner makes one series per term, each with
that term as `query`, so a reader only ever reads `query`. A read with
terms is never the whole board: it sets no size and closes nothing."""
countries: tuple[str, ...] = ()
places: tuple[str, ...] = ()
remote: bool | None = None
remote_ids: tuple[str, ...] = ()
query: str = ""
terms: tuple[str, ...] = ()
params: dict[str, Any] = {}