Files
jobboard/docs/plan-hosts-wave-2.md

56 lines
5.8 KiB
Markdown

# Plan: the readers left after the hosts of 2026-09-29
Planned 2026-09-29. None of the packages below is built. Each builds against the reader contract in `plugins/readers/__init__.py`. What is open without a plan is in `open.md`. This file and `docs/plan-hosts/` are deleted when the packages land or are dropped.
The board filter this plan had as WP11 landed as the agents' reach (`decisions.md`, Ingestion), which also brought Infineon and Microsoft under Eightfold's page cap.
## Where it stands
In the seed (`seed/companies.json`, 362 companies, 286 with a board), 76 companies have no board, each with the careers page opened on 2026-09-29 and, but for nine, a reason; 35 carry `unread`: a program can read them and nothing does yet. The live Watchlist has moved on: 89 companies have no board (14 more were added by hand), Infineon and Microsoft are attached as Eightfold boards, and Novonesis, Darktrace and Criteo as Workday boards.
| Route | Companies | Roles seen |
|---|---|---|
| Sitemap and structured data | Arm, Mambu, Odoo, Aiven, SOPHiA GENETICS, AUTO1, Apple, ASML | about 2,000 |
| Own JSON API | Ørsted, Amazon, Vinted, Dynatrace, RELEX, Siteimprove, Bending Spoons | about 570 |
| Own HTML list | Zalando, Netcompany, Bolt, CHECK24, Google with DeepMind, Lucca, Shopify, Framer, Bird, Ableton | about 950 |
| A host that is read, with a gap | Tryg, DNB, Allegro (SuccessFactors), Quantum Systems (Recruitee on a custom domain), Siemens (Avature), Metacore, Wallbox (empty boards) | |
| Teamtailor, career host not found | Templafy, Queue-it, Telenor, Polestar, IQM, TeamViewer, Tractive, Starship, Factorial | |
The survey's record of each company is in `docs/plan-hosts/survey-own.json` (class, host, identifier, listing URL, roles seen, the request that showed it), with a paragraph per host in `own-1.md` to `own-4.md`. Arm and Mambu are not in it; their notes are under WP10. The raw responses were not kept, so a builder fetches its own fixtures, and `survey-own.json` is the whole record.
## Decisions to take first
**A listing that knows no title.** A sitemap lists URLs, and the listing rewrites the title on every pull, so a sitemap reader would show a title made from the URL. The contract already has `Reads(title="provisional")` (`plugins/readers/_contract.py`), but nothing honours it: `upsert_role` overwrites the title on every pull. And `detail` cannot fill a title yet, since `_runner.DETAIL_FIELDS` has no `title` and the contract says the listing rewrites it. WP9 adds both rules: `title` in `DETAIL_FIELDS`, so the runner takes it from `detail`, and `upsert_role` keeping a stored title over a provisional one.
**One module per company.** An own API or an own HTML list is read by a module named after the company, with a fixed slug. `RANK` puts them after the hosts, and they have no `PATTERNS`, since discovery finds nothing a slug could be made from.
## Work packages
Each owns its modules in `plugins/readers/`, `tests/test_ats_<name>.py` and `tests/fixtures/ats/<name>*`, and nothing else. The live request limits apply, robots.txt is read first, no key is taken from a script, and each package ends with a report of the targets to attach.
| WP | Model | Builds | Needs |
|---|---|---|---|
| 9 Provisional title | Opus | `title` in `DETAIL_FIELDS`, `upsert_role` keeping a stored title over a provisional one, and their tests; owns `plugins/readers/_runner.py`, `app/storage/store.py`, `plugins/ats.py`, `tests/test_storage.py` | |
| 10 Sitemap reader | Sonnet | `sitemap`: role URLs from a sitemap, the role from the page's JSON-LD or microdata | WP9 |
| 12 Own APIs | Sonnet | Ørsted, Amazon, Vinted, Dynatrace, RELEX, Siteimprove, Bending Spoons | |
| 13 Own lists, Nordic and German | Sonnet | Zalando, Netcompany, CHECK24, Bolt | |
| 14 Own lists, the rest | Sonnet | Google with DeepMind, Lucca, Shopify; Framer, Bird and Ableton only if an afternoon is left | |
| 15 Gaps in hosts that are read | Sonnet | Recruitee on a custom domain; the SuccessFactors pages of Tryg, DNB and Allegro; Avature for Siemens | |
WP12 to WP15 own new modules only and can start at once and in parallel. WP10 waits for WP9.
### WP10 notes: Mambu and Arm
Both were read live on 2026-09-29 without a browser or a block.
- **Mambu, classic iCIMS.** `https://careers-mambu.icims.com/sitemap.xml` has one `<loc>` per role (`/jobs/{id}/{slug}/job`) with `lastmod`, plus `/jobs/intro`; robots.txt allows it and lists the sitemap. The detail `.../jobs/{id}/x/job?in_iframe=1` carries a JSON-LD `JobPosting` with `datePosted`, `description`, `jobLocation[].address.addressCountry`, `validThrough` and `employmentType`. Tenants use other subdomain prefixes, so the target stores the whole host. 8 roles.
- **Arm, TalentBrew (Radancy).** The `*-arm.icims.com` hosts only redirect to `careers.arm.com`. `https://careers.arm.com/sitemap.xml` lists all 399 `/job/...` URLs in one request, without titles. The detail's JSON-LD has `datePosted` (unpadded, "2026-6-25"), `description`, `identifier` and `jobLocation[].address`. The paged list at `/search-jobs/results` is HTML inside JSON and only answers the full parameter set; its `data-total-results` counts content pages, `data-total-job-results` counts roles.
## Planner, after the merges
- Attach each board with `app companies set-board`, which reads it first and clears the reason.
- Bring `seed/companies.json` in line with the live database: the board of every company that has one (24 more than the seed's 286, among them Microsoft, Infineon, Novonesis, Darktrace, Criteo and NVIDIA), the reason of every company that has none (five differ; `app companies seed` never replaces a board, so this is done by hand).
- Declare `Fields(posted="trusted")` on a reader whose date is a posting date, with the evidence in the docstring.
- Restart the server by its PID after a backup in `../jobboard-backups/`.
- Find the career host of the nine Teamtailor companies by opening each careers page.