Find fresh roles from a discovery source, ranked by fit, de-duped by role.

Args: angle: a search lens from SEARCH_ANGLES.md (e.g. "FDE", "Overemployed", "IoT") to bias ranking toward that lane. Empty = the default FDE lane. source: which live sweep to run. One of "newsource" (Getro VC networks + Anthropic-customer ATS boards, highest yield), "getro", "anthropic", or "board_harvest" (curated Ashby/Greenhouse seed miner). limit: max roles to return.

Returns a list of job dicts (title, company, url, source, location, remote, ats, role_key). Network calls are made by the underlying repo scripts.

Score one role 0-10 against FIT_RUBRIC.md and return the pursue verdict.

Pass the JD text when available; titles under- and over-sell, so scoring on the JD is sharper. Returns value (0-10), pursue (bool, >= threshold and no hard cap), reasons (one line per signal), and hard_cap (set when a required-skill gap, over-level title, non-US-only, or excluded domain/company disqualifies it).

Look up one search angle (lens) by name or trigger from SEARCH_ANGLES.md.

Empty name returns the default (FDE / converting-profile) lane. Returns the angle's name, trigger phrase, definition, and target titles, or null if no angle matches.

List every search angle defined in SEARCH_ANGLES.md (name, trigger, definition).

List the verified resume building blocks from _genlib.py (roles, bullets, projects).

Every fragment traces to CLAIMS_BANK.md. Build resumes only from these names (or text that traces to the claims bank); this is what keeps the output honest.

Build a tailored one-page resume from verified fragments and run the static gates.

Args: name: output file stem (becomes ".html" in the resumes dir). tagline: the header tagline (mid-level; no over-level words). summary: the summary paragraph. experience: list of [role_key, [bullet, ...]] where role_key is one of bnb / twinspires / upwork / humana / tesla / dojo / lifespring, and each bullet is a fragment NAME (e.g. "BNB_AI") or text tracing to CLAIMS_BANK. projects: list of project fragment names (e.g. "P_CASEK") or verified HTML. skills: list of [label, text] rows for the Skills block.

Returns the resume with lint_ok / verify_ok and any findings. The 1-page render gate runs separately via render_resume (it needs Chrome).

Render .html to PDF via _render.sh and report whether it is one page.

Returns the resume with one_page set and the pdf_path. Requires Google Chrome and qpdf. This is the first of the 4 gates.

Run the two static gates (lint + anti-fabrication verify) on a resume HTML.

Use this to check any resume on disk. Returns lint_ok, verify_ok, passed (their AND), and findings: every blocklist hit (C/C++, fabricated employer, model over-claim, ...) and style flag (banned words, em dashes, rule-of-three).

Build the fill-and-park submission plan for a role (no browser is driven here).

Returns a plan an agent executes with the Playwright MCP: the ATS, the action ("auto_submit" for Ashby/Greenhouse, "fill_and_park" for Lever/Workday/captcha walls, or "blocked" for a rail violation), the standard field values and honest screening answers, the single human_step left when parked, and ATS-specific gotcha notes. Identity PII and credentials are read from the environment, never stored. Report the real outcome afterward with record_application.

Append one row to the application ledger (applications.json), de-duped by role.

Status mirrors the existing vocabulary ("submitted", "submitted-verified", "deferred-captcha", "skipped-overlevel", ...). Date defaults to today. Returns whether it was recorded (false if this company+role is already logged) and the new total.

List roles in the discovery queue (top300_jobs.json) by queue status.

Status is the queue's own field ("todo" by default). Returns up to limit job dicts. Use this to apply from the existing queue before running new discovery (the queue-first gate).

List ledger rows, optionally filtered by status. Empty status = all rows.

Return a count of ledger rows by status (a one-glance system summary).