From 10eaccf897b1fb58faa5bdb10bffbfe30de85ced Mon Sep 17 00:00:00 2001 From: Wolf Date: Sat, 26 Sep 2026 21:04:00 +0200 Subject: [PATCH 1/2] Docs: open items after the search sources and the Sources tab Co-Authored-By: Claude Opus 5.5 --- README.md | 1 + docs/open.md | 19 +++++++++++++++++++ 2 files changed, 20 insertions(+) create mode 100644 docs/open.md diff --git a/README.md b/README.md index ba0841d..4214b8b 100644 --- a/README.md +++ b/README.md @@ -53,5 +53,6 @@ A role's read page, `/roles/{uid}`, shows the full posting: the same vote and Sa ## Docs - [`docs/decisions.md`](docs/decisions.md): what was decided for roledesk and why. +- [`docs/open.md`](docs/open.md): what is left to do, for whoever picks this up next. - [`desk/README.md`](desk/README.md), [`pipeline/README.md`](pipeline/README.md), [`auth/README.md`](auth/README.md), [`deploy/README.md`](deploy/README.md): the copied modules, where each comes from and how to refresh it. - [`docs/hosting.md`](docs/hosting.md), [`docs/release.md`](docs/release.md), [`docs/server.md`](docs/server.md), [`docs/password-protection.md`](docs/password-protection.md), [`docs/llm-backends.md`](docs/llm-backends.md): the boilerplate's deployment docs. diff --git a/docs/open.md b/docs/open.md new file mode 100644 index 0000000..ee88936 --- /dev/null +++ b/docs/open.md @@ -0,0 +1,19 @@ +# Open items + +What is left after the search sources and the Sources tab (commits `047f7cd`, `6b40702`). Delete an entry when it is done; delete this file when it is empty. + +## Before the first beta run + +- **The local database is not cleaned up yet.** `roledesk.db` is gitignored, so copy it into the new checkout if its history matters, or start fresh with `uv run app companies seed`. On the Sources tab, run the prune (`europe`, or `DK,SE,NO,FI,EU` for a short list). Only 35 boards have no European role, so `europe` alone still leaves about 150 mostly US employers. +- **The three new starter agents are not in the existing database.** "Copenhagen engineering", "Remote from Europe" and "Europe hybrid" in `config.yaml` import only into an empty agents table, and the old "Berlin backend" and "Remote EU stretch" are there. Add them on the Agents tab, or delete the old two before the first start of a fresh database. +- **The starter searches assume a backend/platform engineer.** Queries were taken from the old starter agents; confirm the user's actual field and adjust the searches and agent intents on the Sources and Agents tabs. + +## Known gaps + +- **Adzuna has not run live.** Built against its documented response; needs `ADZUNA_APP_ID` and `ADZUNA_APP_KEY` from developer.adzuna.com. Check the parser against a real response on first use. +- **No company discovery from search results.** A Jobindex item links to Jobindex's own page; its `/c?t=` redirect leads to the employer's site or ATS, but following it per role counts as a click in Jobindex's statistics. A cleaner route to "this search found a company, follow its board" is still open. +- **Jobnet and Jooble are left out.** Jobnet's search endpoint answers 401 outside its own site's session; Jooble needs a manual key application and answered a Cloudflare challenge. See `docs/decisions.md`. +- **About 10% of roles have no country.** Location lines such as "Remote", "Hybrid" or "North America" name none, so country gates drop them. `extract` or a longer `_PLACES` table in `app/models.py` would fill more. +- **`extract` is off.** Seniority, permit and languages stay empty, so gates on them match nothing. Turning it on is a Haiku call per batch of 20 roles. +- **Some Jobindex ads have no company.** A crawled ad with no logo and no ", Company" suffix in its title stores an empty company. +- **Sources tab race.** A Save that is still reloading the list can overwrite an on/off switch made during the reload in the page's copy (not in the database). Reloading the page shows the true state. From 278ca46615849b6ca94a350979e4b57941237f5c Mon Sep 17 00:00:00 2001 From: Wolf Date: Sat, 26 Sep 2026 21:04:13 +0200 Subject: [PATCH 2/2] Open items and two rules, before the checkout moves Co-Authored-By: Claude Fable 5.1 --- CLAUDE.md | 8 ++++++++ docs/open.md | 26 +++++++++----------------- 2 files changed, 17 insertions(+), 17 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index ef3232b..bb9fe11 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -32,3 +32,11 @@ The package is `app`, following the boilerplate: the deploy kit, `APP_CONFIG`, ` # Rule: `pipeline/`, `auth/` and `deploy/` are downstream copies of `../boilerplate`, `desk/` of `../news`. They are refreshed with `git archive`, and a fix lands upstream first, otherwise the next refresh reverts it. + +# Rule: + +Phone and UI patterns come from `../news` (`newsdesk/web/templates/index.html`, `newsdesk/web/static/app.css`) and `../health` (`webapp/`), which went through the phone fixes already; the boilerplate has none. Copy their fragments, do not write new ones. + +# Rule: + +A larger rework is planned first, as a doc in `docs/` committed on main with work packages that own disjoint files, then built by Opus and Sonnet agents in parallel worktrees and merged into main by the planner. The plan is folded into `decisions.md` and deleted when the work lands. diff --git a/docs/open.md b/docs/open.md index ee88936..7bbb0d3 100644 --- a/docs/open.md +++ b/docs/open.md @@ -1,19 +1,11 @@ -# Open items +# Open -What is left after the search sources and the Sources tab (commits `047f7cd`, `6b40702`). Delete an entry when it is done; delete this file when it is empty. +What is left after the phone rework of 2026-09-25, for whoever picks the repo up next, in the order it bites. -## Before the first beta run - -- **The local database is not cleaned up yet.** `roledesk.db` is gitignored, so copy it into the new checkout if its history matters, or start fresh with `uv run app companies seed`. On the Sources tab, run the prune (`europe`, or `DK,SE,NO,FI,EU` for a short list). Only 35 boards have no European role, so `europe` alone still leaves about 150 mostly US employers. -- **The three new starter agents are not in the existing database.** "Copenhagen engineering", "Remote from Europe" and "Europe hybrid" in `config.yaml` import only into an empty agents table, and the old "Berlin backend" and "Remote EU stretch" are there. Add them on the Agents tab, or delete the old two before the first start of a fresh database. -- **The starter searches assume a backend/platform engineer.** Queries were taken from the old starter agents; confirm the user's actual field and adjust the searches and agent intents on the Sources and Agents tabs. - -## Known gaps - -- **Adzuna has not run live.** Built against its documented response; needs `ADZUNA_APP_ID` and `ADZUNA_APP_KEY` from developer.adzuna.com. Check the parser against a real response on first use. -- **No company discovery from search results.** A Jobindex item links to Jobindex's own page; its `/c?t=` redirect leads to the employer's site or ATS, but following it per role counts as a click in Jobindex's statistics. A cleaner route to "this search found a company, follow its board" is still open. -- **Jobnet and Jooble are left out.** Jobnet's search endpoint answers 401 outside its own site's session; Jooble needs a manual key application and answered a Cloudflare challenge. See `docs/decisions.md`. -- **About 10% of roles have no country.** Location lines such as "Remote", "Hybrid" or "North America" name none, so country gates drop them. `extract` or a longer `_PLACES` table in `app/models.py` would fill more. -- **`extract` is off.** Seniority, permit and languages stay empty, so gates on them match nothing. Turning it on is a Haiku call per batch of 20 roles. -- **Some Jobindex ads have no company.** A crawled ad with no logo and no ", Company" suffix in its title stores an empty company. -- **Sources tab race.** A Save that is still reloading the list can overwrite an on/off switch made during the reload in the page's copy (not in the database). Reloading the page shows the true state. +- **The checkout moved.** `CLAUDE.md`, `README.md`, `desk/README.md` and the refresh commands assume `../boilerplate` and `../news` beside the checkout. Keep them beside it in the sandbox or change the paths. `.venv` holds absolute paths, so `uv sync --all-extras` again after the move. +- **The boilerplate moved on.** Since roledesk's last refresh (`77052a8`, the schedules fix) it has `4573f6d` (the kit: the layout patterns every app built for itself, as classes) and `1679e88` (deploy from a WSL checkout, the sandbox setup). Refresh `deploy/` and `pipeline/` with `git archive`, and see whether `app/static/app.css` should use the kit's classes instead of its own copies of the same rules. +- **Restart the server.** A server started before the rework runs the old code; on start the database migrates to schema v4 (vote, summary, article text on `roles`). +- **The live database has two agents**, "Berlin backend" and "Remote EU stretch", so Ranking edits the first and the Roles order menu lists both by name. Delete one with the CLI for a plain Best match. +- **Summarising is off** (`summarise.enabled: false`) and needs a model backend, as extract does. The Summarise button on a read page works either way once a backend is configured. +- **Ranking's gates are still a JSON box** under Advanced. A form (country list, remote require or prefer) is the next step there. +- **Votes do not train fit.** A vote only moves the rank at read time. Feeding votes into the intent vector is worth doing once there are a few hundred.