One migration for the columns the phone UI's votes, summaries and read page
need, so the packages that build those never both touch the schema. The
columns sit before created_at in SCHEMA: SQLite cannot drop a last column
whose preceding comment would then swallow the closing parenthesis, which
the v1 migration test does.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Two tabs and a cog, settings sub-tabs, news's feed row and reader, votes,
paging, on-demand posting text and a bounded summarise stage, Companies and
boards merged, forms on top, plain ledes. Work packages for a fan-out.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
What a pull reads can now be changed on a page instead of only the command
line: try a search and see its first ten results before saving it, edit or
remove one, follow a company's ATS board, switch any board or search on or
off, and preview and apply a prune by region. Each row shows its open roles
and the countries they are in.
The page and `app companies`/`app searches` call the same functions in
app/jobs/sources.py. Switching a target off closes its open roles, and the
pull's settle closes them again if a batch in flight reopened them. Roles
pulled before `country` existed are backfilled at startup.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The ats boards only read companies someone listed, and the seed list is
US-centred: 31 of 29,000 open roles were in Denmark. A `search` plugin runs
saved queries on boards that span companies, pulled in the same task as the
boards: Jobindex (Denmark, RSS, no key) and Adzuna (UK and most of the EU,
free key, built to its documented API). Jobnet and Jooble were checked and
left out.
`country` is now filled from the board's location line by a lookup, with EU
for Europe-wide roles, so country gates work without extract. `app companies
prune --in` unsubscribes boards with no open role in a region. The starter
agents and searches are Copenhagen and Europe.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
.gitignore adds .idea/, data/, deploy/release.env and deploy/backups/ next
to roledesk.db* and .scratch/; config.yaml stays committed as the default.
.gitattributes is the boilerplate's: deploy/ and every .sh check out with
LF, since a CRLF shell script fails on the server's first line.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
One entry replaces "own repo, depending on news" and "desk and pipeline
are never edited here": built on the boilerplate with desk copied from
news, all four downstream copies, fixes upstream first, package app. The
superseded 8 MB cap entry is gone and the 96 MB one is unwrapped. Long
entries are cut to the decision and one reason, and the stale names
(roles.yaml, the one alpha page, app.js) follow the restructure. New: pull
as a job on a 6h schedule, and the coupling rule's place in the layers.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
With fit as (cos + 1) / 2 the real run spanned about 0.55 to 0.79, so a
prefer gate at weight 0.2 moved a score more than the whole spread of fit.
fit is now the cosine min-max scaled across the roles an agent scores in
that run: the closest is 1, the farthest 0, a single role 1, and a role a
require gate rules out stays out of the range. The starter agents' prefer
weights drop to 0.05, enough to break a tie. A regression test pins the
case: two close cosines that the old mapping let a 0.05 gate reorder.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
app/main.py assembles it in the boilerplate's order, auth.connect first,
then the queue with the scheduler and the pages. TABS is Roles,
Applications, Agents, Companies, Jobs, Schedules, Messages and Account:
the alpha page's three views become templates on the boilerplate's
base.html, driven by static/roles.js (the old app.js) through api() and
toasts.js, over the unchanged JSON routes. Companies lists every board with
its open roles and the affinity control. A 422 is one sentence, so a toast
never reads [object Object].
Config takes the boilerplate's shape: APP_CONFIG or config.yaml, a missing
file is the defaults, an unknown key is an error. roles.yaml is gone;
config.yaml is the committed default and carries the starter agents.
pull is now a job that asks for the pull cascade, because a schedule
enqueues a job kind; its default schedule, every 6h, is declared beside it
in app/jobs/cascade.py. pull_batch's targets are keyword-only so the Jobs
tab offers no batch button. `app worker` is the boilerplate's; `app job`
still drains a queue of its own and fires no schedules.
test_coupling holds pipeline, auth and desk apart (desk may import
pipeline) and plugins to desk; test_architecture keeps app's layers, now
with main.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Drops news's own sources (Bluesky, Mastodon, X, podcast) and the tools only
they use (video, posts, walls), with the PodcastSource and segment_profile
exports. scrape, article, checks, browser and framing stay: base.py imports
scrape's Getter at module level and scrape imports the other four, so
dropping them would mean editing the plugin contract. desk/README.md records
the source of truth, the prune and how to refresh. All 371 tests pass.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Core is the boilerplate's plus what desk and the ats plugin import at module
level: httpx, feedparser and numpy. Extras: embeddings (sentence-transformers),
agent (anthropic, claude-agent-sdk) and passkeys (webauthn). Packages are app,
pipeline, auth and desk, each without its tests; pytest runs tests/,
pipeline/tests and auth/tests. ruff skips the boilerplate's copies, and mypy
reads the copied modules silently.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The boilerplate's rule: the deploy kit's Dockerfile, the APP_CONFIG,
APP_PASSWORD and APP_DATA variables and its commands all assume a package
called app, so a project renames its display title and nothing else. The
console script is `app`, and the launch entry runs `uv run app serve --port
8790`. The domain noun stays `role`.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The plugin contract, the model task and the tools roledesk imports, copied
rather than reached through an editable install of news, which also exposes
a package named pipeline. news stays the source of truth for desk.
Refreshed from news/desk at a275c38a1aa0fe80a7ec7dd5781ecccf683f71c6
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
roledesk is built on the boilerplate from here on: pipeline 2.0 (queue and
scheduler), auth (one password, sessions, passkeys), the deploy kit and its
docs, plus the coupling and packaging tests. Downstream copies, unedited.
Refreshed from boilerplate/d56949f7d0f6c0bfe5745478e09007bfad67ae87
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
roledesk job embed and job score reported the final job's tally, which
says a job finished but not how many roles it embedded or scored.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
embed stores one vector per open role; score rates every open role for
every enabled agent from require and prefer gates, fit against the
agent's intent, recency and company affinity, keeping gated rows with a
reason. Schema v3 adds vectors and the cached intent vector. The page
gets an agent order, the score on each row, and an Agents tab. Two
starter agents in roles.yaml are imported once.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
roledesk job extract reads open, unanswered roles 20 to a call and fills
place, country, remote, seniority, salary, currency, function, permit and
languages, only into columns the board left empty. Schema v2 adds
roles.permit, roles.languages and roles.extract_tries. Off by default.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/, GET /api/roles|companies|applications, POST /api/companies/{key}/affinity
and /api/applications[/{id}/status]. The Jinja2 template renders an empty
shell; static/app.js fills it and drives Save, affinity and status changes.
<desk-jobs> from pipeline.web mounts at the bottom so Pull can be started
from the page.
Store.roles gains q, function, remote, days and hide_muted, and company/
place move from a key match to a substring on the text a board wrote.
hide_muted filters in SQL before LIMIT: filtering after it shipped first and
broke immediately on real data, since Databricks' freshly pulled 884 roles
were the newest 200-plus rows in the table and muting it left nothing to
show.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
openings.go's 8 MB cap was written against arbitrary URLs; every URL here is
on a fixed allow-list of seven ATS hosts, and the real pull of 2026-09-23
refused Anduril, Anthropic, OpenAI, Databricks, Carvana, Axon and Airwallex
for it. A board that still exceeds 96 MB now retries once without
content=true (Greenhouse only), trading the description for the listing.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
The real run against the seeded 186 companies refused seven of the
largest boards outright, Anduril worst at 41 MB, because the cap and
requesting full descriptions pull against each other on exactly the
employers that post the most roles. Left as is for now; the fix is a
retry without content=true, tracked as an open decision.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
seed/companies.json: 179 companies from jobhunt-hq's seed.json (MIT),
reduced to key/name/board/careers_url, plus a hand-added DACH set.
`roledesk companies seed|add|check` import it, add one company from its
board with a live check first, and report dead boards.
roledesk/jobs/pull.py is now a pipeline task: ten boards per pull_batch job
on the http resource, upserting every role the ats plugin yields. Its final
job's settle closes every board this run answered in full and no longer
lists a role from, reading the plugin's own self.state stamps rather than
each batch job's return value, so one bad board in a batch does not cost the
other nine their closure. `roledesk job pull` runs it, and it registers
itself in pipeline.TASKS so <desk-jobs> can start it too.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Personio boards
The `ats` plugin: one Source per host's public JSON (Personio: XML), each
parsed to a common row and yielded as a `role` item. The field map, the
redirect allow-list, the 8 MB cap and the 10 s timeout are ported from
jobhunt-hq's openings.go (MIT); the nine-function classifier is ported from
its seedgen. Workable, SmartRecruiters, Recruitee and Personio are new,
written from one real board of each fetched while this was built. Fixtures
under tests/fixtures/ats/ keep every test off the network.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
roledesk/storage/schema.py creates the tables at v1 with WAL and the
versioned-migration machinery from newsdesk; store.py adds upsert_role
(unpacks raw into gate columns, first_seen on insert, last_seen every
time), roles(), mark_closed, companies and subscriptions CRUD, and
save_application writing an append-only application_events row on every
status entered. Key helpers company_key, title_key, place_key live in
models.py. docs/decisions.md records the key decisions.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Package layers models, config, storage, jobs, web, cli, held by
tests/test_architecture.py with desk and pipeline as external trees and
plugins/ limited to desk. roles.yaml is the default config, roledesk.db
its own file, port 8790. create_app mounts pipeline.web.connect over
Jobs(config.database); `roledesk job pull` drains a no-op pull and
`roledesk db init` creates the file.
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>