@wrenautomation/birdwatch 0.29.0 → 0.30.0

package/README.md

@@ -7,23 +7,22 @@ run read. `skills/birdwatch/SKILL.md` (in this repo) is how an agent drives it.
 
 Reading the web and files (the fetch ladder, HTML and PDF to text, video) is
 [`@wrenautomation/read`](https://github.com/wrenautomation/engine/tree/main/packages/read)'s. Every model call goes through
-[`@wrenautomation/models`](https://github.com/wrenautomation/engine/tree/main/packages/models). Until 0.29.0 this was three packages: raven (the planner,
-now `./plan`), falcon's `./document` and weaver (the engine, sources, ledger and CLI).
+[`@wrenautomation/models`](https://github.com/wrenautomation/engine/tree/main/packages/models). Until 0.29.0 this was three packages: raven (a model planner, gone at 0.30.0: the
+agent plans), falcon (`./document`) and weaver (the engine, sources, ledger and CLI).
 
 | Import | Does |
 |---|---|
-| `@wrenautomation/birdwatch/engine` | `Source` (a name, `search` and/or `open`, a cost), `registry` and the plan's allow-list; the agent's calls (`planRound`, `search`, `open`, `extract`, `check`, `add`, `accept`, `brief`), one step each; the judge's passes (`judgeHits`, `judgeDocuments`, `judgeFindings`, `judgeStats`); `run(deps, options)`: plan, fetch, triage, read, extract, check (a sample of findings against their documents), review, round after round until the planner's edge says stop; `fold` rebuilds a run's state from its records, so a run resumes from the step it stopped on; `Transient`, the failure worth another try; the planner's `Ask`, `PlanFile` and record shapes re-exported |
+| `@wrenautomation/birdwatch/engine` | `Source` (a name, `search` and/or `open`, a cost), `registry` and the plan's allow-list; the agent's calls (`planRound`, `search`, `open`, `extract`, `check`, `add`, `accept`, `brief`), one step each; the judge's passes (`judgeHits`, `judgeDocuments`, `judgeFindings`, `judgeStats`); `fold` rebuilds a run's state from its records, so a step run again skips what is done; `Transient`, the failure worth another try; the ask and plan file shapes (`Ask`, `PlanFile`, `Query`, `QueryTree`, `Edge`, `Snapshot`) and a stock plan file per ask kind (`web`, `video`, `channel`, `person`, `site`: sources, budget, `age`, `rules`, the query tree's guide) |
 | `@wrenautomation/birdwatch/sources` | `searxng`, `exa` (search), `youtube` (search and read, yt-dlp), `fetcher` (open, the polite fetcher), `ladder` (open, autobrowse's fetch ladder up to a browser), `reddit` and `facebook` (open a thread or a group post through autobrowse's site routes), `google` (Google's own page through the desk's browser: each result a hit, the AI Overview one hit with its text as the snippet, each page it cites a hit), `arxiv` (search and read: the API inside `BIRDWATCH_ARXIV_CATEGORIES`, each hit led by its OpenAlex citation count and comment; the paper read whole from its HTML, else its PDF; one call per 3 s), `paste` (a person's URLs), `ledger` (hits earlier runs saw). A query with a `site` skips a searcher that cannot keep to it (`Source.keeps`: `youtube` keeps to YouTube only). A follow (`Source.follows`, `follow`) lists a page's author's posts (`youtube`: a channel's uploads, from a video or the channel, and a TikTok profile; `reddit`: a user's top posts and comments) or pages like it (`exa`: findSimilar) |
 | `@wrenautomation/birdwatch/ledger` | the records (`query`, `hit`, `document`, `finding`, `verdict`, `call`, `spend`, `snapshot`, `edge`, `done`, `steer`, `gap`, `check`, `pattern`, `found`, `judge`, `person`), `FilesLedger` (a folder: `runs/<run>/<writer>.jsonl`, `plans/<kind>.json`), `MemoryLedger`, yield rows per source, person, channel and kind |
-| `@wrenautomation/birdwatch/plan` | the planner: `plan` (an ask, proposals and yield rows in; typed queries out, each with `why`, `from`, `by`), `triage` (read or skip per hit), `review` (the edge after a round: `stop`, `again`, `back`), the shapes (`Ask`, `Plan`, `PlanFile`, `Query`, `Edge`, `Snapshot`), a stock plan file per ask kind (`web`, `video`, `channel`, `person`, `site`: prompts, sources, budget, `age`, the query tree's guide), the renderers. Pure functions and prompts; the model is injected. The runner uses all of it; an agent makes the three decisions itself and uses the shapes |
 | `@wrenautomation/birdwatch/document` | the document side: `Document`, `Finding`, `Proof`, `Verdict` (zod), readers by media (`html`, `pdf`, `text`), `claimExtractor` (findings that quote the document, through the gate, and a verdict on the document: its quality and the ask's gap; no cap on findings or their length, and an answer the model's output cap cut is continued from its last kept quote), the `Model` seam it takes and the `Cut` a model throws when its cap cut an answer |
 
-Every record carries `from` (ai, human or tool) and `by` (a model id, a source, a person). A
-person's pasted URL, a person's keep or drop, are the same records as the model's. The plan
-file in `plans/<kind>.json` beside the ledger (prompts, sources, budget) is where a run learns:
-`birdwatch learn <kind>` writes its next version from what a run taught (sources, budget, age, a
-prompt), on the person's agreement; a kind with no tuned file runs the stock one
-(`birdwatch plans <kind>` prints it).
+Every record carries `from` (ai, human or tool) and `by` (an agent or model id, a source, a
+person). A person's keep or drop is the same record as the agent's. The plan file in
+`plans/<kind>.json` beside the ledger (sources, budget, age, rules, the tree guide) is where a run
+learns: `birdwatch learn <kind>` writes its next version from what a run taught, on the person's
+agreement; a kind with no tuned file runs the stock one (`birdwatch plans <kind>` prints it).
+`brief.guide` shows the kind's age sentence and rules to the agent.
 
 ## CLI
 
@@ -41,12 +40,9 @@ COHERE_API_KEY=... npx birdwatch watch talk.mp4                           # spee
 npx birdwatch plans web > ledger/plans/web.json                           # a stock plan file, to tune
 ```
 
-The engine has two drivers over the same steps. An agent (Claude Code, or any agent with a
-shell) drives it one command at a time: it plans, triages, reviews and stops in its own head and
-the engine does the fixed work (search, open, extract behind the quote gate, check) and keeps the
-records. `run` is the runner: the planner's prompts make those decisions and the loop runs alone. Both
-write the same ledger, so `run --resume` takes over a run an agent started and `brief` reads a
-run the runner made. Every command prints JSON.
+An agent (Claude Code, or any agent with a shell) drives the engine one command at a time: it
+plans, triages, reviews and stops in its own head, and the engine does the fixed work (search,
+open, extract behind the quote gate, check) and keeps the records. Every command prints JSON.
 
 ```sh
 export BIRDWATCH_AGENT=claude-code                     # the agent's id on every record it writes
@@ -115,21 +111,14 @@ hit with the facets that found it, most first; `brief.tree` shows every try with
 
 The agent reads for itself: `show <run> <document>` prints a document's stored text, `add
 finding` writes what it read behind the same quote gate, `add check` its own check. `extract` and
-`check` put a model behind the same gate instead, for bulk or for the runner; both paths write
-the same records.
+`check` put a model behind the same gate instead, for bulk; both paths write the same records.
 
-The runner alone:
+The person, through the agent or by hand:
 
 ```sh
-BIRDWATCH_CONTACT=you@example.com npx birdwatch run "how do staffing firms win repeat clients" --known "referrals convert"
-npx birdwatch run "..." --kind video --propose "cold email teardown" --by will   # your queries, merged with the model's
-npx birdwatch run "..." --url https://a.example/report https://b.example/post    # pages you want read, first
-npx birdwatch run --resume 01M5YS... --url https://a.example/report             # from the step it stopped on; same --url, same --model
-npx birdwatch run "..." --pause                                                   # stop after each round's review
-npx birdwatch add steer 01M5YS... "numbers only; skip vendor pages" --human       # what you say, first in every prompt after
-npx birdwatch run --resume 01M5YS... --pause                                      # the next round, steered
-npx birdwatch add gap 01M5YS... "no UK numbers yet" --human                       # what the run lacks: its review and next plan read it
-npx birdwatch add edge 01M5YS... back --to fetch --why "searxng was down" --human # rerun one step of the round; then --resume
+npx birdwatch add steer 01M5YS... "numbers only; skip vendor pages" --human       # what you say: the brief shows it first
+npx birdwatch add gap 01M5YS... "no UK numbers yet" --human                       # what the run lacks: the next plan reads it
+npx birdwatch add edge 01M5YS... back --to fetch --why "searxng was down" --human # the step to run again
 npx birdwatch trace 01M5YS... --type finding spend                                # the run's records, JSON lines
 npx birdwatch add call 01M5YS... 01M5YT... drop --why "a forecast, not a result" --human   # a call in your name
 npx birdwatch yield --source exa                                                  # hits, reads, proposed, kept
@@ -141,8 +130,7 @@ The model is `anthropic` by default (Claude Haiku direct, `ANTHROPIC_API_KEY`; `
 anthropic:sonnet|opus|id` for another), `--model gateway[:alias]` for Wren's LLM gateway
 (`WREN_LLM_GATEWAY_URL`, `WREN_LLM_GATEWAY_TOKEN`), or any command that reads a prompt on stdin
 and prints the answer (`claude -p --output-format json` is Claude Code headless). The model does
-the bulk (extract, check); `--decider <spec>` (`BIRDWATCH_DECIDER`) takes the steps that decide what
-comes next (plan, triage, review): `anthropic:sonnet` when the model is Haiku, else the model. Sources come
+the bulk (extract, check) only; the agent decides. Sources come
 from the environment: `SEARXNG_URL` (and `SEARXNG_TOKEN`, a bearer, for an instance behind a
 proxy), `EXA_API_KEY` (or `_1..n`), `GEMINI_API_KEY` for videos without captions,
 `BIRDWATCH_CONTACT` for the fetcher and `arxiv` (no contact, no page opens; `OPENALEX_API_KEY`, free, gives `arxiv` its own citation budget, and `SEMANTIC_SCHOLAR_API_KEY`, free, its own rate for `--as refs`; `--sources arxiv` names it, since no stock plan file does), and for the ladder either
@@ -191,24 +179,21 @@ that still cannot go on writes no `done`, and `run` waits and resumes it, five t
 before it exits 2. Searches, reads and extracts fan out (four reads or extracts at a time);
 each document's records land as its batch settles, and a step run again skips what its records
 show done. An extract that fails for good (the model's answer would not parse, a 400) stops the
-step with its findings so far on record and `run` exits 2: `--resume` asks only for the
+step with its findings so far on record and exits 2: `extract` again asks only for the
 documents without a verdict. A model answer the output cap cut is not a failure: the whole
 findings before the cut go through the gate and the model is asked again for the rest of the
 document, with those findings known (`./document`'s `Cut`; the `spend` carries both calls' tokens).
 
-`--pause` stops the run after a review that says `again`, with no exit code: between rounds
-you (or a Claude Code session) read `brief`, keep or drop findings (`add call`), and steer the
-run with free text (`add steer`). Every `steer` record is rendered first in every prompt of the
-rounds after it, under "The person says:". `--resume` goes on. A review that says `again` into
-a round past `budget.rounds` parks the run the same way (`parked` says so, no exit code): the
-budget is a guard rail, not a stop rule. `--resume` goes one more round; `plan --run` opens it
-by hand.
+Between rounds the person reads `brief` (or the agent tells them), keeps or drops findings (`add
+call`), and steers the run with free text (`add steer`). Every `steer` record shows first in the
+brief and in the extract's prompt of the rounds after it. `budget.rounds` is a guard
+rail, not a stop rule: past it, the edge's why says why one more round is worth it.
 
 The steps talk in English records. A query every searcher answered with no new hit, and a kept
 hit no source could open (a 403, a block the ladder could not pass), each write a `gap`; so does
 `add gap`. The round's review reads the gaps and a person's keep or drop with its why; the next
 round's plan reads them, and the review's why on `again`, under "The last round left open".
-`add edge back --to <step>` writes a person's edge: the fold takes it like the planner's. A `pattern`
+`add edge back --to <step>` writes a person's edge: the fold takes it like the agent's. A `pattern`
 (`add pattern`) is what several kept findings say together, in the agent's words; its count of
 distinct sites is computed from the findings' proofs, never claimed, and `brief.patterns` lists
 them for the report. A run can be a child (`--parent <run> --why`): its snapshot names the parent, its plan reads
@@ -258,16 +243,14 @@ gates on it yet.
 From 0.25.0 the judge reads a page whole: the body to its references (an appendix stays), in
 parts of 64,000 characters, 4 at most, each answer the most yes of any part. Jev's input is
 cheap (about $0.04 per million tokens), so a paper costs about a tenth of a cent. A run's
-criteria (`--criterion name="question"`, on `run` and `plan`) are the person's own yes-or-no
-tests of a good source: the judge asks each one on every hit and every page. Every prompt shows
-them with the person's steer, and the runner's triage sees the judge's odds on each hit (serves
-and each test) as a hint. Their mean sorts `hits.uncalled` and `documents.toExtract`; `brief.judge.criteria` gives each one's AUC against
+criteria (`--criterion name="question"`, on `plan`) are the person's own yes-or-no tests of a
+good source: the judge asks each one on every hit and every page, and the brief shows its odds
+on each hit (serves and each test) as a hint. Their mean sorts `hits.uncalled` and `documents.toExtract`; `brief.judge.criteria` gives each one's AUC against
 "a finding on it was kept", on hits and on pages. A sort and a hint, never a gate.
 
 From 0.27.0 the extractor reads the body too (the reference list holds no finding). Each review
 sees every earlier round's new hits and kept findings, and decides when to stop. A paper's
-`follow --as refs` and `--as citers` list what it cites and what cites it. `--decider` runs plan,
-triage and review on Sonnet while Haiku does the bulk. A check (25 papers, Sonnet as reference):
+`follow --as refs` and `--as citers` list what it cites and what cites it. A check (25 papers, Sonnet as reference):
 on the whole page, Jev's criteria odds rank Sonnet's yes over its no with AUC 0.94 to 1.00; on the
 abstract, 0.77 to 1.00.
 
@@ -308,21 +291,21 @@ The engine, with your own model and sources:
 
 ```ts
 import { claimExtractor } from "@wrenautomation/birdwatch/document";
-import { registry, run } from "@wrenautomation/birdwatch/engine";
+import { extract, open, planRound, registry, search } from "@wrenautomation/birdwatch/engine";
 import { FilesLedger, ulids } from "@wrenautomation/birdwatch/ledger";
 import { exa, fetcherSource } from "@wrenautomation/birdwatch/sources";
 
 const ledger = new FilesLedger("./ledger", "will");
 const sources = registry(exa({ keys }), fetcherSource({ fetcher }));
-const result = await run(
-  { sources, ledger, model, extractor: claimExtractor, clock: () => new Date(), ids: ulids(), runner: "will" },
-  { ask: { text: "how do staffing firms win repeat clients", kind: "web", known: [] }, planFile },
-);
-result.state.findings; // each with its proof: a quote on a page the run read
+const deps = { sources, ledger, model, extractor: claimExtractor, clock: () => new Date(), ids: ulids(), writer: "will" };
+const agent = { from: "ai" as const, by: "my-agent" };
+const { run } = await planRound(deps, { ask: { text: "how do staffing firms win repeat clients", kind: "web" }, planFile, model: model.id });
+await search(deps, run, [{ terms: "staffing repeat client rate", why: "the ask's words" }], agent);
+await open(deps, run, { urls: ["https://a.example/report"], why: "a survey" }, agent);
+await extract(deps, run); // findings, each with its proof: a quote on a page the run read
 ```
 
-`RunOptions.steps` bounds one call (64 by default): a loop that advances a run a little per pass
-passes a few and calls again with `resume`. A host with its own ledger, sources or model mounts
+A host with its own ledger, sources or model mounts
 the same commands: `addEngineCommands(program, { ledger, sources, model, extractor })` from
 `@wrenautomation/birdwatch` (wren's `research` command is these over Postgres).
 

package/dist/app/cli.js

@@ -6,7 +6,7 @@
  * text and links, `watch <video>` what a video file shows and says. `plans [kind]` prints a stock
  * plan file to tune. Keys come from the environment: COHERE_API_KEY (or COHERE_API_KEY_1..n),
  * GEMINI_API_KEY. The engine's commands are in `engine-cli.ts`: the agent's (`plan`, `search`,
- * `open`, `extract`, `check`, `add`, `brief`), the runner's (`run`), the plan file's (`learn`) and
+ * `open`, `extract`, `check`, `add`, `brief`), the plan file's (`learn`) and
  * the ledger's (`trace`, `yield`, `sources`). A person's word goes through `add ... --human`.
  */
 import { readFile } from "node:fs/promises";
@@ -14,7 +14,7 @@ import { PoliteFetcher, userAgent } from "@wrenautomation/read/fetch";
 import { htmlText, pdfText, readPage } from "@wrenautomation/read/text";
 import { cohereEye, cohereSpeech, flatPlaylist, frameCounts, geminiVideo, readVideo, readYoutube, renderWatched, watchFile, } from "@wrenautomation/read/video";
 import { Command } from "commander";
-import { AskKind, defaultPlanFile, PLAN_KINDS } from "../plan/index.js";
+import { AskKind, defaultPlanFile, PLAN_KINDS } from "../engine/plan.js";
 import { addEngineCommands, keys } from "./engine-cli.js";
 const program = new Command()
     .name("birdwatch")

package/dist/app/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/app/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/app/cli.ts"],"names":[],"mappings":"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"}

package/dist/app/engine-cli.d.ts

@@ -1,15 +1,11 @@
-import { type Model } from "@wrenautomation/models";
+import type { Model } from "@wrenautomation/models";
 import { type Judge } from "@wrenautomation/models/judge";
 import type { Command } from "commander";
 import type { Extractor } from "../document/index.js";
 import { costOf, type Sources } from "../engine/index.js";
+import { type AskKind, Criterion } from "../engine/plan.js";
 import { FilesLedger, type Ledger, type Problem } from "../ledger/index.js";
-import { type AskKind, Criterion } from "../plan/index.js";
-/** Resumes `run` makes on its own after a transient failure. */
-export declare const RESUMES = 5;
 export { costOf };
-/** The pause before a resume: to `retryAfter` (five minutes at most), else 15 s per resume so far. */
-export declare function resumeWaitMs(n: number, retryAfter: string | undefined, now?: number): number;
 /** `NAME`, then `NAME_1`, `NAME_2`, ... in order: a fleet of keys for one vendor. */
 export declare function keys(printed: NodeJS.ProcessEnv, name: string): string[];
 /** `name=question` lines as criteria; a name the judge already asks, or a repeat, fails. */
@@ -31,8 +27,6 @@ export interface EngineCliDeps {
     /** The judge for a `--judge` spec; the default is models' `judgeFromSpec`. */
     judge?(spec: string, printed: NodeJS.ProcessEnv): Judge | null;
     extractor?: Extractor;
-    /** The pause before a resume; a test passes a stub. */
-    sleep?(ms: number): Promise<void>;
 }
 /** The sources this machine can run, from the environment. */
 export declare function sourcesHere(printed: NodeJS.ProcessEnv, ledger: FilesLedger, ytDlp: string, warn?: (line: string) => void): Sources;

package/dist/app/engine-cli.js

@@ -1,45 +1,31 @@
 /**
- * The engine from a shell: `run` an ask, `trace` a run, `keep` or `drop` a finding by hand, `steer`
- * a run, say a `gap`, send it `back` to a step,
- * `yield` per source, `sources` on this machine. Every command prints JSON, so Claude Code
- * can drive it. The ledger is a folder (`--ledger`, BIRDWATCH_LEDGER, default `./ledger`); a
+ * The engine from a shell, one step per command for the agent that drives it: `plan`, `search`,
+ * `open`, `extract`, `check`, `add`, `brief`, `trace` a run, `yield` per source, `sources` on this
+ * machine. Every command prints JSON. The ledger is a folder (`--ledger`, BIRDWATCH_LEDGER, default `./ledger`); a
  * writer names this terminal's file in it (`--writer`, BIRDWATCH_WRITER, default the user name).
  * The model is a `@wrenautomation/models` spec: `anthropic` by default (Claude Haiku direct,
  * ANTHROPIC_API_KEY), `gateway[:alias]`, `gemini`, `claude-code`, `command:<cmd>` and the rest
  * of its grammar. A host with its own ledger, sources or
  * model passes them in `EngineCliDeps`; wren's `research` command is these commands over
- * Postgres. A run that stops on a transient failure (a 429, a 5xx, a dropped connection) is
- * resumed by `run` itself after a pause, up to RESUMES times.
+ * Postgres. A step that stops on a transient failure (a 429, a 5xx, a dropped connection) exits
+ * with its note; the agent runs it again, and it skips what its records show done.
  */
 import { mkdir, readFile } from "node:fs/promises";
 import { userInfo } from "node:os";
 import { serve } from "@hono/node-server";
-import { isTransient } from "@wrenautomation/models";
 import { judgeFromSpec } from "@wrenautomation/models/judge";
 import { modelFromSpec } from "@wrenautomation/models/spec";
 import { PoliteFetcher, userAgent } from "@wrenautomation/read/fetch";
 import { geminiVideo } from "@wrenautomation/read/video";
 import { claimExtractor } from "../document/index.js";
-import { accept, add, brief, check, costOf, extract, fold, follow, joined, open, planRound, RESERVED, recall, registry, run, search, searchTree, tunePlan, } from "../engine/index.js";
+import { accept, add, brief, check, costOf, extract, fold, follow, joined, open, planRound, RESERVED, recall, registry, search, searchTree, tunePlan, } from "../engine/index.js";
+import { Criterion, defaultPlanFile, PLAN_KINDS, QueryTree, TreeGuide, treeOf, } from "../engine/plan.js";
+import { Step as PlanStep } from "../engine/types.js";
 import { FilesLedger, FollowAs, SOURCE_CLASSES, SourceClass, ulids, } from "../ledger/index.js";
-import { Criterion, defaultPlanFile, PLAN_KINDS, Step as PlanStep, QueryTree, TreeGuide, treeOf, } from "../plan/index.js";
-import { accountsFrom, arxivSource, exa, facebookSource, fetcherSource, googleSource, httpLadderClient, ingressLadderClient, ladderSource, ledgerSource, paste, redditSource, searxng, ytdlpSource, } from "../sources/index.js";
+import { accountsFrom, arxivSource, exa, facebookSource, fetcherSource, googleSource, httpLadderClient, ingressLadderClient, ladderSource, ledgerSource, redditSource, searxng, ytdlpSource, } from "../sources/index.js";
 import { SERVE_ORIGINS, SERVE_PORT, serveApp, watchRuns } from "./serve.js";
 const DEFAULT_MODEL = "anthropic";
-/** Resumes `run` makes on its own after a transient failure. */
-export const RESUMES = 5;
-/** The longest pause before a resume, whatever `retry-after` said. */
-const MAX_RESUME_WAIT_MS = 300_000;
 export { costOf };
-/** The pause before a resume: to `retryAfter` (five minutes at most), else 15 s per resume so far. */
-export function resumeWaitMs(n, retryAfter, now = Date.now()) {
-    if (retryAfter) {
-        const until = Date.parse(retryAfter) - now;
-        if (!Number.isNaN(until))
-            return Math.max(0, Math.min(until, MAX_RESUME_WAIT_MS));
-    }
-    return 15_000 * n;
-}
 /** `NAME`, then `NAME_1`, `NAME_2`, ... in order: a fleet of keys for one vendor. */
 export function keys(printed, name) {
     const out = [];
@@ -110,7 +96,7 @@ export function sourcesHere(printed, ledger, ytDlp, warn = (l) => console.error(
                 url: printed.RESTATE_INGRESS_URL,
                 token: printed.RESTATE_AUTH_TOKEN ?? null,
                 ...(printed.AUTOBROWSE_SERVICE ? { service: printed.AUTOBROWSE_SERVICE } : {}),
-                caller: `birdwatch:${printed.BIRDWATCH_AGENT ?? "runner"}`,
+                caller: `birdwatch:${printed.BIRDWATCH_AGENT ?? "cli"}`,
             })
             : null;
     if (sites) {
@@ -140,7 +126,6 @@ export function allowList(sources, wanted, byHand, warn = (l) => console.error(l
         : [...sources.values()].filter((s) => s.open && !out.includes(s.name)).map((s) => s.name);
     return { sources: out, opens };
 }
-const progress = (e) => console.error(`${e.run} ${e.round}.${e.step} ${e.ok ? "ok" : "gave up"} ${e.ms}ms${e.note ? `: ${e.note}` : ""}`);
 /** A kind the engine plans for; anything else is the caller's mistake, said in words. */
 export const kindOf = (kind) => {
     const k = PLAN_KINDS.find((p) => p === kind);
@@ -148,7 +133,7 @@ export const kindOf = (kind) => {
         throw new Error(`no kind "${kind}": the kinds are ${PLAN_KINDS.join(", ")}`);
     return k;
 };
-/** Prints what a command did as JSON; a step that gave up exits 2, like `run`. */
+/** Prints what a command did as JSON; a step that gave up exits 2. */
 function printDid(did) {
     console.error(`${did.run} ${did.round}.${did.step} ${did.ok ? "ok" : "gave up"}${did.note ? `: ${did.note}` : ""}`);
     console.log(JSON.stringify(did, null, 2));
@@ -164,14 +149,12 @@ async function stdinText() {
 }
 export function addEngineCommands(program, deps = {}) {
     const ledgerOf = deps.ledger ?? filesLedger;
-    const sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
     const common = (c) => c
         .option("--ledger <dir>", "the ledger folder", process.env.BIRDWATCH_LEDGER ?? "./ledger")
         .option("--writer <name>", "this terminal's file in the ledger", process.env.BIRDWATCH_WRITER ?? userInfo().username);
     const machine = (c) => c
         .option("--model <spec>", "a models spec: anthropic[:haiku|sonnet|opus], gateway[:alias], gemini[:id], claude-code, command:<cmd>, ...", process.env.BIRDWATCH_MODEL ?? DEFAULT_MODEL)
         .option("--no-model", "no model: nothing extracted or checked")
-        .option("--decider <spec>", "the model for the steps that decide what comes next (plan, triage, review); default: anthropic:sonnet when --model is Haiku, else --model", process.env.BIRDWATCH_DECIDER)
         .option("--judge <spec>", "cheap typed answers on every hit, page and finding (a hint and a router): jev[:model], fake, off", process.env.BIRDWATCH_JUDGE ?? (process.env.TYPESAFE_API_KEY ? "jev" : "off"))
         .option("--no-judge", "no judge")
         .option("--yt-dlp <cmd>", "the yt-dlp command", process.env.BIRDWATCH_YTDLP ?? "yt-dlp");
@@ -185,12 +168,8 @@ export function addEngineCommands(program, deps = {}) {
             ? deps.sources(o, ledger)
             : sourcesHere(process.env, ledger, o.ytDlp);
         const model = o.model === false ? null : (deps.model ?? modelFromSpec)(o.model, process.env);
-        // Haiku restates, Sonnet decides: a few cents a run.
-        const deciderSpec = o.decider ??
-            (o.model === "anthropic" || o.model === "anthropic:haiku" ? "anthropic:sonnet" : null);
-        const decider = model && deciderSpec ? (deps.model ?? modelFromSpec)(deciderSpec, process.env) : null;
         const judge = o.judge === false ? null : (deps.judge ?? judgeFromSpec)(o.judge, process.env);
-        return { ledger, sources, model, judge, ...(decider ? { decider } : {}) };
+        return { ledger, sources, model, judge };
     };
     /**
      * The ledger's tuned plan file for the kind (the stock one when none), its sources the run's
@@ -203,16 +182,16 @@ export function addEngineCommands(program, deps = {}) {
         if (tuned.version < stock.version)
             console.error(`plan file ${kind} is version ${tuned.version}; birdwatch ships ${stock.version}: delete it to take the new one`);
         const wanted = byHand ?? [...first, ...tuned.sources];
-        // The planner narrows to the plan file's sources, so the run's allow-list goes in as the plan file's.
+        // A run narrows to the plan file's sources, so the run's allow-list goes in as the plan file's.
         const { sources: list, opens } = allowList(sources, wanted, !!byHand);
         return { planFile: { ...tuned, sources: list }, opens };
     };
-    const depsOf = (s, runner) => ({
+    const depsOf = (s, writer) => ({
         ...s,
         extractor: deps.extractor ?? claimExtractor,
         clock: () => new Date(),
         ids: ulids(),
-        runner,
+        writer,
     });
     /** The agent's id: `--by` or BIRDWATCH_AGENT. Every record it writes names it. */
     const agentOf = (o) => {
@@ -224,123 +203,6 @@ export function addEngineCommands(program, deps = {}) {
     const whoOf = (o) => o.human
         ? { from: "human", by: o.human === true ? o.writer : o.human }
         : { from: "ai", by: agentOf(o) };
-    machine(common(program.command("run [ask]")))
-        .description("run an ask through plan, fetch, triage, read, extract, check and review; prints the run as JSON")
-        .option("--kind <kind>", `one of ${PLAN_KINDS.join(", ")}`, "web")
-        .option("--known <line...>", "what is known already, one line each, with its URL or ledger id; a line without one is a premise")
-        .option("--premise <line...>", "what the ask takes as given (a buyer, an offer, a price): the tree tests each")
-        .option("--criterion <name=question...>", 'a yes-or-no test of a good source (code="Is code released?"): the judge asks it on every hit and every page read whole, a hint only')
-        .option("--steer <line...>", "what you say to the model, first in every prompt")
-        .option("--site <host>", "the site the ask is about")
-        .option("--sources <name...>", "the allow-list for this run (default: the plan file's, as far as this machine has them)")
-        .option("--propose <terms...>", "queries from you, merged with the model's in round 1")
-        .option("--url <url...>", "pages you want read: a paste source, first in the allow-list")
-        .option("--by <who>", "who proposes or pastes", process.env.BIRDWATCH_WRITER ?? userInfo().username)
-        .option("--resume <run>", "continue an earlier run from the step it stopped on")
-        .option("--run <id>", "the new run's id")
-        .option("--pause", "stop after each round's review: `birdwatch steer`, then --resume")
-        .option("--parent <run>", "a new run's parent: this run is a child of it (one niche of a wide run)")
-        .option("--why <why>", "with --parent: why this child")
-        .action(async (ask, o) => {
-        if (!ask && !o.resume)
-            throw new Error("run needs an ask, or --resume <run>");
-        const kind = kindOf(o.kind);
-        const s = setup(o);
-        const { ledger, sources } = s;
-        if (o.url?.length)
-            sources.set("paste", paste(o.url.map((url) => ({ url })), o.by));
-        const { planFile, opens } = await planFileOf(ledger, sources, kind, o.sources, o.url?.length ? ["paste"] : []);
-        const byHand = [
-            ...(o.propose ?? []).map((terms) => ({ kind, terms, why: "proposed by hand" })),
-            // The paste answers the first query it sees: this one, when nothing else is proposed.
-            ...(o.url?.length && !o.propose?.length && ask
-                ? [{ kind, terms: ask, why: "the pasted pages" }]
-                : []),
-        ];
-        const proposals = byHand.length
-            ? [{ from: "human", by: o.by, queries: byHand }]
-            : [];
-        const id = o.resume ?? o.run ?? ulids()();
-        const engineDeps = depsOf(s, o.writer);
-        const options = {
-            ...(ask
-                ? {
-                    ask: {
-                        text: ask,
-                        kind,
-                        known: o.known ?? [],
-                        premises: o.premise ?? [],
-                        criteria: criteriaOf(o.criterion),
-                        steer: o.steer ?? [],
-                        ...(o.site ? { site: o.site } : {}),
-                    },
-                }
-                : {}),
-            planFile,
-            opens,
-            proposals,
-            onStep: progress,
-            ...(o.pause ? { pause: true } : {}),
-            ...(o.parent ? { parent: { run: o.parent, why: o.why ?? "" } } : {}),
-        };
-        let result = null;
-        for (let n = 0; result === null; n++) {
-            try {
-                result = await run(engineDeps, {
-                    ...options,
-                    ...(n === 0 && !o.resume ? { run: id } : { resume: id }),
-                });
-            }
-            catch (err) {
-                if (!isTransient(err))
-                    throw err;
-                if (n >= RESUMES) {
-                    console.error(`${id}: ${err.message}; stopped after ${RESUMES} resumes`);
-                    break;
-                }
-                const ms = resumeWaitMs(n + 1, err.retryAfter);
-                console.error(`${id}: ${err.message}; resume ${n + 1} of ${RESUMES} in ${Math.round(ms / 1000)}s`);
-                await sleep(ms);
-            }
-        }
-        const state = result?.state ?? fold(id, await ledger.trace(id));
-        if (result?.paused)
-            console.error(`${id}: paused after round ${state.edges.length}; birdwatch add steer ${id} "<their words>" --human, then birdwatch run --resume ${id} --pause`);
-        if (result?.parked)
-            console.error(`${id}: ${result.parked}; birdwatch run --resume ${id} goes one more round, birdwatch plan --run ${id} opens it by hand`);
-        const cost = costOf(state.spends);
-        // The last review's word: what the ask still lacks, or that it is answered.
-        const last = state.edges.at(-1);
-        if (last)
-            console.error(`${id}: ${last.next}: ${last.why}`);
-        console.error(`${id}: ${cost.line}`);
-        console.log(JSON.stringify({
-            run: id,
-            rounds: state.round,
-            cost: cost.total,
-            finished: result?.finished ?? false,
-            ...(result?.paused ? { paused: true } : {}),
-            ...(result?.parked ? { parked: result.parked } : {}),
-            note: result ? result.note : "stopped on a transient failure: --resume to go on",
-            ...(last ? { edge: { next: last.next, why: last.why } } : {}),
-            hits: state.hits.length,
-            documents: state.documents.length,
-            findings: state.findings.filter((f) => state.called.get(f.id) !== "drop"),
-            spends: state.spends.map(({ source, op, about, ok, cost, ms, usd, tokens }) => ({
-                source,
-                op,
-                about,
-                ok,
-                cost,
-                ms,
-                ...(usd !== undefined ? { usd } : {}),
-                ...(tokens ? { tokens } : {}),
-            })),
-            problems: ledger.problems ?? [],
-        }, null, 2));
-        if (!result?.finished && !result?.paused && !result?.parked)
-            process.exitCode = 2;
-    });
     agent(machine(common(program.command("plan [ask]"))))
         .description("open a round: a new run from an ask, or the next round of --run after an edge that said again. Prints the run id")
         .option("--run <id>", "the run whose next round to open")
@@ -605,12 +467,10 @@ export function addEngineCommands(program, deps = {}) {
         .option("--sources <name...>", "the allow-list, in order of preference")
         .option("--queries <n>", "queries per round", Number)
         .option("--reads <n>", "reads per round", Number)
-        .option("--rounds <n>", "rounds before the runner parks", Number)
+        .option("--rounds <n>", "rounds a run should take: a guard rail", Number)
         .option("--checks <n>", "findings checked per round", Number)
         .option("--age <sentence>", "how much a source's age counts")
-        .option("--propose <file>", "the propose prompt, from a file")
-        .option("--triage <file>", "the triage prompt, from a file")
-        .option("--review <file>", "the review prompt, from a file")
+        .option("--rule <line...>", "the rules the agent heeds for this kind, one line each: replaces them all")
         .option("--thin <n>", "new hits under which a tree's try is thin, so the next try runs", Number)
         .option("--tree <file>", "the query tree's guide, as JSON {facets: [{name, why}], thin}")
         .action(async (kind, o) => {
@@ -634,9 +494,7 @@ export function addEngineCommands(program, deps = {}) {
             ...(o.sources ? { sources: o.sources } : {}),
             budget,
             ...(o.age !== undefined ? { age: o.age } : {}),
-            ...(o.propose ? { propose: await text(o.propose) } : {}),
-            ...(o.triage ? { triage: await text(o.triage) } : {}),
-            ...(o.review ? { review: await text(o.review) } : {}),
+            ...(o.rule ? { rules: o.rule } : {}),
             ...(o.tree
                 ? { tree: TreeGuide.parse(JSON.parse(await text(o.tree))) }
                 : o.thin !== undefined