swarm-orchestrator 13.1.5 → 13.1.7

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## 13.1.7
+
+Found by driving the session through a real terminal rather than a pipe.
+
+### Fixed
+
+- **Enter did not submit at the prompt.** A terminal hands over what it buffered in one read, so
+  the newline arrived inside a longer chunk with no key flag set, and the whole chunk including
+  the control character was typed into the task being composed. A pasted task arrives the same
+  way, so everything before the newline is now typed and the newline still means run it.
+- **The screen still showed a plain `DONE` for a run that changed nothing.** The gate strip
+  cannot tell passes over work from passes over an empty diff, and a model answering in prose
+  stops for the honest reason `completed` having done nothing. It now reads `DONE, but no files
+  changed`. The plain path already said this above its gate table.
+
+## 13.1.6
+
+A session, and the evidence a person reads.
+
+### Added
+
+- **`swarm` with no task opens a session.** One process, one ledger, tasks typed one after
+  another, each continuing the conversation the last one left. The screen keeps what each
+  finished turn came to, so it does not forget between them. `swarm "task"` is unchanged.
+- **Each turn is measured on its own.** A turn ends by recording where it left the tree, so the
+  next turn's gates see that turn's changes and not the ones before it. Without it the second
+  turn is charged with the first's diff and the file-set check calls the first turn's files
+  out-of-set.
+- **The review page says what happened.** The header carries the tasks, the model, whether the
+  loop completed, how long it took and what it cost, above the identifiers it used to open with.
+- **The gate table is in the bundle.** It was printed to a terminal and never written into the
+  page, where the gates had been indistinguishable cards among the model calls.
+- **The change itself is recorded and shown.** Nothing recorded a patch, so the question the
+  page exists to answer, what did this do to my code, meant leaving the evidence and running git.
+
+### Fixed
+
+- **A run that changed nothing reported `DONE`.** The gates run after the loop and each gate
+  event rewrote the status, so the last gate to pass over an empty diff became the last word on
+  a run that built nothing. The stop reason is now its own field, and a cycle that measured no
+  changed files says so before the table.
+- **A second turn measured its own edits as deletions.** `git diff <base>` from the person's
+  index calls a file that is in the base and untracked here deleted. Changes are now measured
+  through a scratch index, which makes the comparison tree to tree and counts a file the agent
+  just wrote as added.
+- **`q` did not leave the view.** It set a flag that three things read after the fact; nothing
+  unmounted the screen, which kept painting. It now comes down and the run reports the way it
+  does off a terminal.
+- **A refused bundle named nothing.** The failing check was read off stderr and the verifier
+  reports through stdout, so every real refusal said "no detail given" at the one moment the
+  panel exists for.
+- Six record types rendered as their own bare name on the page, including the one holding what
+  the run cost.
+
 ## 13.1.5
 
 Three fixes, all found by running the tool rather than by reading it.

package/README.md

@@ -31,11 +31,11 @@ a workspace it had never seen, recorded in a real terminal:
 
     npm install -g swarm-orchestrator
 
-That is **13.1.5**, and it leaves `swarm` on your path.
+That is **13.1.7**, and it leaves `swarm` on your path.
 
 Installing from a tag works too, but only into a project rather than globally:
 
-    npm install github:moonrunnerkc/swarm-orchestrator#v13.1.5
+    npm install github:moonrunnerkc/swarm-orchestrator#v13.1.7
 
 `dist/` is not committed, so a git ref builds itself on install and needs this package's
 devDependencies to do it. npm does not install those when a git ref is installed with `-g`: it
@@ -55,6 +55,7 @@ option, so on anything older that measurement does not happen.
 
     swarm "make slugify collapse whitespace and strip punctuation"
 
+    swarm                            # a session: type tasks, one after another
     swarm gates                      # run the gates over a workspace, no model
     swarm select                     # probe this machine, recommend a local model
     swarm calibrate                  # measure candidate models on the golden set
@@ -83,6 +84,25 @@ what it has learned.
 Settings live in one optional `swarm.toml`: providers and endpoints, gate definitions, budgets,
 model pins, and the `[interface]`, `[theme]` and `[keys]` tables. Flags win over the file.
 
+## A session, or a single task
+
+Run `swarm` with no task and it opens a session: one process, one ledger, and tasks typed one
+after another, each continuing the conversation the last one left.
+
+```
+› create calculator.js exporting add and multiply, and calculator.test.js covering both
+  8 gate(s) passed, 8 step(s)
+
+› add a divide function that throws on division by zero, and cover both cases
+```
+
+Each turn is measured on its own. A turn ends by recording where it left the tree, so the next
+one's gates see that turn's changes and not the ones before it. Three turns of this, with the
+bundle verified from outside and the page it produced, are in
+[`session.md`](docs/evidence/2026-08-24/session.md).
+
+`swarm "task"` still runs one task and exits, exactly as before.
+
 ## Watching it work
 
 On a terminal, a run draws a single screen you can drive. Off one, it writes the same plain
@@ -108,8 +128,9 @@ j scroll  enter expand  tab pane  / filter  e evidence  ? help  q detach  ctrl+c
 ```
 
 `?` lists every key. `enter` expands a row to its whole payload and the ledger record it came
-from. `q` leaves the view and lets the run finish; `ctrl+c` cancels the run. There is no
-progress bar, because an agent run has no denominator.
+from. `q` leaves the view: the screen comes down and the run keeps going, reporting the plain
+lines it writes off a terminal. `ctrl+c` cancels the run. There is no progress bar, because an
+agent run has no denominator.
 
 When the run ends, the screen lists what it produced, says how many claims the harness
 verified and how many it refused, and offers to open the review page. It says the bundle

package/dist/agent-run.js

@@ -2,6 +2,7 @@ import { resolve } from "node:path";
 import { runAgentLoop } from "./core/loop.js";
 import { runGatesEngine } from "./gates/engine.js";
 import { createAmendFileSetTool, createDeclareFileSetTool } from "./gates/file-set-tool.js";
+import { diffAgainstBase } from "./gates/scratch-index.js";
 import { createToolChokepoint } from "./tools/chokepoint.js";
 import { createLedgerChokepointRecorder } from "./tools/chokepoint-record.js";
 import { createClaimTool } from "./tools/claim-tool.js";
@@ -85,7 +86,10 @@ export async function runAgentTask(options) {
         maxOutputTokens: 8192,
         retryPolicy: { attempts: 3, baseDelayMs: 500, maxJitterRatio: 0.5 },
     };
-    const loop = await runAgentLoop(options.task, loopDependencies);
+    const loop = await runAgentLoop(options.task, {
+        ...loopDependencies,
+        ...(options.history === undefined ? {} : { history: options.history }),
+    });
     await options.evidence.record({
         type: "session-stopped",
         actor: "harness",
@@ -116,12 +120,52 @@ export async function runAgentTask(options) {
             ? {}
             : { singleFileTestCommand: options.singleFileTestCommand }),
     });
+    // Said to the screen as well as written down, because a gate strip of passes over a tree
+    // nothing touched looks exactly like a gate strip of passes over work.
+    options.emit({
+        type: "changes",
+        changedFiles: gates.outcome.finalCycle.measures.changedFiles ?? 0,
+    });
+    // What the task did to the tree, as a patch, recorded once the gates have settled so it is
+    // the state that was judged. Nothing else in the ledger answers "what did it change to my
+    // code?": the file-set record names files, the diff budget counts lines, and the tool calls
+    // hold fragments, so a reviewer had to leave the evidence and run git themselves.
+    await recordWorkspaceDiff(options);
     return {
         loop,
         gates,
         green: loop.stopReason === "completed" && gates.outcome.settled === "green",
     };
 }
+/** A patch is only worth reading up to a point, past which it is a file to open, not a page to read. */
+const diffCharacterCap = 200_000;
+async function recordWorkspaceDiff(options) {
+    let patch;
+    try {
+        patch = await diffAgainstBase({
+            workspaceRoot: options.workspace,
+            baseRef: options.baseRef,
+        });
+    }
+    catch {
+        // A tree the diff cannot be taken from is a fact about the workspace, and one the gates
+        // have already reported on. It is not a reason to lose the run's evidence.
+        return;
+    }
+    const truncated = patch.length > diffCharacterCap;
+    await options.evidence.record({
+        type: "workspace-diff",
+        actor: "harness",
+        // The patch is the harness's reading of the tree, and the tree is what the model wrote.
+        provenance: ["model"],
+        payload: {
+            baseRef: options.baseRef,
+            truncated,
+            characters: patch.length,
+            patch: truncated ? `${patch.slice(0, diffCharacterCap)}\n... truncated` : patch,
+        },
+    });
+}
 /**
  * One attempt at fixing what a gate reported. A fresh loop rather than a continued one: the
  * gate output is the whole brief, and starting clean keeps an attempt from inheriting the

package/dist/agent-run.js.map

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

package/dist/cli-options.js

@@ -2,7 +2,9 @@ import { resolve } from "node:path";
 import { bundledShortlistKeyword } from "./select/shortlist-source.js";
 export const usage = [
     "swarm [--model <provider:id>] [--workspace <dir>] [--bundle <dir>] [--base <ref>]",
-    '  [--attempts <n>] [--max-steps <n>] [--local-endpoint <url>] "<task>"',
+    '  [--attempts <n>] [--max-steps <n>] [--local-endpoint <url>] ["<task>"]',
+    "",
+    "  swarm                                            a session: type tasks, one after another",
     "",
     "  swarm gates [--workspace <dir>] [--base <ref>]   run the gates, no model",
     "  swarm select [--shortlist <file|url|bundled>]    probe this machine, recommend a model",
@@ -145,13 +147,7 @@ export function parseCommandLine(argv, context) {
             bundleDirectory,
         };
     }
-    const task = words.join(" ").trim();
-    if (task.length === 0) {
-        throw new InvalidCommandLineError("nothing to do");
-    }
-    return {
-        command: "run",
-        task,
+    const shared = {
         modelSpec: flags.get("model") ?? null,
         workspace,
         maxSteps: parseFlagCount(flags.get("max-steps"), "--max-steps"),
@@ -161,6 +157,11 @@ export function parseCommandLine(argv, context) {
         localEndpoint: parseLocalEndpoint(flags.get("local-endpoint")),
         interfaceFlags: parseInterfaceFlags(flags),
     };
+    const task = words.join(" ").trim();
+    if (task.length === 0) {
+        return { command: "session", ...shared };
+    }
+    return { command: "run", task, ...shared };
 }
 /** Both halves of a pair named at once is a contradiction, so it is an error rather than an order. */
 function parseInterfaceFlags(flags) {

package/dist/cli-options.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-options.js","sourceRoot":"","sources":["../src/cli-options.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-options.js","sourceRoot":"","sources":["../src/cli-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAwIvE,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,mFAAmF;IACnF,0EAA0E;IAC1E,EAAE;IACF,6FAA6F;IAC7F,EAAE;IACF,4EAA4E;IAC5E,0FAA0F;IAC1F,qFAAqF;IACrF,uEAAuE;IACvE,mFAAmF;IACnF,4FAA4F;IAC5F,qFAAqF;IACrF,uEAAuE;IACvE,EAAE;IACF,aAAa;IACb,+DAA+D;IAC/D,6EAA6E;IAC7E,2EAA2E;IAC3E,8CAA8C;IAC9C,EAAE;IACF,iFAAiF;CAClF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CACH,GAAG,OAAO,8EAA8E;YACtF,qEAAqE;YACrE,kDAAkD;YAClD,kFAAkF;YAClF,wFAAwF;YACxF,iFAAiF;YACjF,oFAAoF;YACpF,sCAAsC,CACzC,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,MAAM;IACN,QAAQ;IACR,OAAO;IACP,UAAU;IACV,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,uFAAuF;AACvF,MAAM,cAAc,GAAG,CAAC,CAAC;AAMzB,MAAM,UAAU,gBAAgB,CAC9B,IAAuB,EACvB,OAA2B;IAE3B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC/B,0FAA0F;QAC1F,4DAA4D;QAC5D,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,uBAAuB,CAAC,GAAG,QAAQ,gBAAgB,CAAC,CAAC;QACjE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACvB,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IAED,yFAAyF;IACzF,sBAAsB;IACtB,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;QAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAAC,iCAAiC,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,eAAe,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC;SAC3D,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,eAAe,GACnB,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;IAClF,8EAA8E;IAC9E,mDAAmD;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,CAAC;IAEnF,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,uBAAuB,CAC/B,qFAAqF;gBACnF,0BAA0B,CAC7B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,SAAS,CAAC;YACvD,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc;YAC5C,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;YAC/D,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;YAC7D,eAAe;YACf,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI;YACrC,aAAa,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;SAC/D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,WAAW,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;QACD,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;YACvD,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC3C,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;YAC5D,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;IAC7F,CAAC;IAED,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,SAAS;YACT,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc;YAC5C,eAAe;SAChB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI;QACrC,SAAS;QACT,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;QAC/D,eAAe;QACf,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,cAAc;QAC5C,QAAQ,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;QAC7D,aAAa,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9D,cAAc,EAAE,mBAAmB,CAAC,KAAK,CAAC;KAC3C,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,sGAAsG;AACtG,SAAS,mBAAmB,CAAC,KAAkC;IAC7D,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,uBAAuB,CAAC,8CAA8C,CAAC,CAAC;IACpF,CAAC;IACD,IAAI,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,uBAAuB,CAC/B,8DAA8D,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QACvC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;QAC7E,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC;YACtC,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;gBAC7B,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI;KACX,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,IAAY,EACZ,KAAkC,EAClC,SAAiB;IAEjB,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,uBAAuB,CAC/B,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,uBAAuB,CAC/B,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,GAAuB;IAC3C,MAAM,OAAO,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,CAAC,IAAI,cAAc,CAAC;IACnE,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,IAAI,uBAAuB,CAC/B,8BAA8B,cAAc,wCAAwC;YAClF,kCAAkC,CACrC,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAuB,EAAE,OAA2B;IAC5E,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,GAAG,KAAK,uBAAuB,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/F,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AAChD,CAAC;AAED;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAuB,EAAE,IAAY;IAC3D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,uBAAuB,CAAC,GAAG,IAAI,0CAA0C,GAAG,GAAG,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAuB;IACjD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,MAAM,IAAI,uBAAuB,CAAC,iDAAiD,GAAG,GAAG,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli.js

@@ -22,6 +22,7 @@ import { createFileSetRegistry } from "./gates/file-set.js";
 import { citedRecords, outstandingJustifications } from "./gates/gate-runner.js";
 import { createNodeCommandRunner } from "./gates/node-command-runner.js";
 import { summarizeRatchet } from "./gates/ratchet-summary.js";
+import { recordTurnBaseline } from "./gates/turn-baseline.js";
 import { localEndpointRecord, resolveLocalEndpoint, } from "./providers/endpoint-resolution.js";
 import { discoverLocalEndpoints } from "./providers/local-discovery.js";
 import { parseModelSpec } from "./providers/model-spec.js";
@@ -173,6 +174,186 @@ async function chooseModel(task, home, random) {
         candidates: calibrated.candidates,
     };
 }
+/**
+ * A session: one process, one ledger, many tasks, each typed rather than passed.
+ *
+ * Everything expensive is built once, which is the point of a session over repeated runs: the
+ * settings, the provider registry, the sandbox and its tool definitions, the evidence chain and
+ * the screen all outlive a turn. What is rebuilt per turn is what carries state that a second
+ * task must not inherit, and each of those is a decision rather than an oversight:
+ *
+ *   - the abort controller, because a signal is one-shot and a reused aborted one would make
+ *     the next turn stop before it started;
+ *   - the file-set registry, because declaring a set twice is an error and the check walks the
+ *     whole chain when it decides what was edited before it was authorised;
+ *   - the base commit, because the previous turn's edits are still uncommitted, and measuring
+ *     against the start of the session would charge this turn with the last one's diff;
+ *   - the routed model, because routing reads the task, and a different task may deserve a
+ *     different arm.
+ *
+ * The conversation is what carries across, so a follow-up can say "now make it throw" and mean
+ * the file the previous turn wrote.
+ */
+async function session(options) {
+    if (!statSync(options.workspace).isDirectory()) {
+        throw new Error(`${options.workspace} is not a directory to work in`);
+    }
+    const settings = await settingsFor(options.workspace, {
+        model: options.modelSpec,
+        maxSteps: options.maxSteps,
+        attempts: options.attempts,
+        localEndpoint: options.localEndpoint,
+        interfaceFlags: options.interfaceFlags,
+    });
+    const clock = createSystemClock();
+    const random = createSystemRandom();
+    const evidence = await openEvidenceSession({
+        root: defaultSessionRoot(homedir()),
+        sessionId: createSessionId(clock, random),
+        clock,
+    });
+    const ui = startInterface({ task: "", workspace: options.workspace, settings, clock });
+    let baseRef = options.baseRef;
+    let history = [];
+    let turns = 0;
+    let lastGreen = true;
+    try {
+        for (;;) {
+            const task = await ui.readTask();
+            if (task === null) {
+                break;
+            }
+            turns += 1;
+            ui.beginTurn(task);
+            const outcome = await runOneTurn({
+                task,
+                history,
+                baseRef,
+                options,
+                settings,
+                evidence,
+                ui,
+                clock,
+                random,
+            });
+            history = outcome.messages;
+            lastGreen = outcome.green;
+            // Where this turn ended is where the next one starts being measured from. A repository
+            // with no commit yet has nothing to hang one off, and the base stays where it was.
+            const recorded = await recordTurnBaseline({
+                workspaceRoot: options.workspace,
+                label: `turn ${turns}`,
+                previousBase: baseRef,
+            });
+            if (recorded !== null) {
+                baseRef = recorded;
+            }
+        }
+    }
+    finally {
+        if (turns > 0) {
+            const written = await writeBundle(evidence, options.bundleDirectory, clock, ui.note);
+            announceBundle(written.directory, ui.note);
+        }
+        await ui.stop();
+        taskReader?.close();
+        taskReader = null;
+        taskLines = null;
+    }
+    if (turns === 0) {
+        process.stdout.write("nothing was asked for, so nothing ran.\n");
+        return 0;
+    }
+    return lastGreen ? 0 : 1;
+}
+/** One turn of a session, from a typed task to a settled set of gates. */
+async function runOneTurn(input) {
+    const { task, options, settings, evidence, ui, clock, random } = input;
+    const routed = settings.modelPinned
+        ? {
+            modelSpec: null,
+            assignment: "pinned",
+            decision: null,
+            candidates: [],
+        }
+        : await chooseModel(task, homedir(), random);
+    const modelSpec = routed.modelSpec ?? settings.modelSpec;
+    const spec = parseModelSpec(modelSpec);
+    const localBackend = await resolveLocalBackend(settings, [spec]);
+    if (localBackend !== null) {
+        await evidence.record(localEndpointRecord(localBackend));
+    }
+    if (routed.decision !== null) {
+        await evidence.record(routingDecisionRecord(routed.decision));
+    }
+    const usable = spec.provider === "local" && localBackend !== null
+        ? chooseUsableModel({
+            requested: modelSpec,
+            preflight: await preflightAll(evidence, localBackend.url, [modelSpec]),
+            keys: settings.providerKeys,
+            candidates: routed.candidates,
+        })
+        : { outcome: "as-requested", modelSpec, reason: "not a local model" };
+    if (usable.outcome === "substituted") {
+        ui.note(`model: ${usable.modelSpec} instead of ${usable.requested}, ${usable.reason}`);
+    }
+    const registry = createProviderRegistry(registrySettingsFrom(settings, localBackend));
+    const model = createRecordingModelClient(registry.create(parseModelSpec(usable.modelSpec)), evidence);
+    const fileSet = createFileSetRegistry(evidence);
+    const interruption = new AbortController();
+    const onInterrupt = () => {
+        interruption.abort();
+    };
+    process.on("SIGINT", onInterrupt);
+    void ui.cancelled().then(onInterrupt);
+    const startedAt = clock.now();
+    const gateOptions = gateOptionsFrom(settings);
+    const diffBudget = diffBudgetFrom(settings);
+    try {
+        const { loop, gates } = await runAgentTask({
+            task,
+            workspace: options.workspace,
+            baseRef: input.baseRef,
+            maxSteps: settings.maxSteps,
+            attempts: settings.attempts,
+            model,
+            evidence,
+            fileSet,
+            clock,
+            random,
+            emit: (event) => {
+                ui.emit(event);
+            },
+            confirm: ui.confirm,
+            abortSignal: interruption.signal,
+            homeDir: homedir(),
+            history: input.history,
+            ...(gateOptions === undefined ? {} : { gateOptions }),
+            ...(diffBudget === undefined ? {} : { diffBudget }),
+        });
+        reportGates(gates.outcome, evidence, ui.note);
+        await logReward({
+            evidence,
+            home: homedir(),
+            task,
+            modelSpec: usable.modelSpec,
+            assignment: routed.assignment,
+            ratchet: summarizeRatchet(gates.outcome),
+            changedFiles: gates.outcome.finalCycle.measures.changedFiles ?? null,
+            latencyMs: clock.now() - startedAt,
+            recordedAt: clock.now(),
+            cost: await priceTask(usable.modelSpec, evidence),
+            note: ui.note,
+        });
+        return {
+            messages: loop.messages,
+            green: loop.stopReason === "completed" && gates.outcome.settled === "green",
+        };
+    }
+    finally {
+        process.off("SIGINT", onInterrupt);
+    }
+}
 /**
  * Everything ambient the screen needs, gathered here so nothing below the composition root
  * reads a terminal, an environment variable, or the clock (invariant 8).
@@ -201,11 +382,35 @@ function startInterface(input) {
         }),
         bindings: resolveKeyBindings(ui.keys),
         ...(isTty ? { askOnTerminal } : {}),
+        readLine: readTaskLine,
         openEvidence: ui.openEvidence,
         spawnOpen: spawnOpener,
         platform: platform(),
     });
 }
+/**
+ * One readline for the whole session, opened when the first task is asked for.
+ *
+ * Kept open rather than opened per question, because a fresh interface per line loses whatever
+ * is already buffered from a pipe, and a piped session is a list of tasks somebody wrote down.
+ * Null at end of input is what ends the session.
+ */
+let taskReader = null;
+let taskLines = null;
+async function readTaskLine(prompt) {
+    if (taskReader === null) {
+        taskReader = createInterface({ input: process.stdin, output: process.stderr });
+        taskLines = taskReader[Symbol.asyncIterator]();
+    }
+    if (process.stdin.isTTY === true) {
+        process.stderr.write(prompt);
+    }
+    const next = await taskLines?.next();
+    if (next === undefined || next.done === true) {
+        return null;
+    }
+    return next.value;
+}
 /** Readline, on the plain path only. Ink owns stdin whenever the screen is up. */
 async function askOnTerminal(question) {
     const prompt = createInterface({ input: process.stdin, output: process.stderr });
@@ -403,6 +608,16 @@ function describeCycle(cycle) {
 }
 /** Written through `note`, so an interactive screen holds them until it comes down. */
 function reportGates(outcome, evidence, note) {
+    // Said before the gate table rather than after it, because a table of passes over a tree
+    // nothing touched is the most misleading thing this tool can print. A model that answered in
+    // prose, or emitted its tool calls as text the protocol never parsed, reaches here having
+    // done nothing, stops for the honest reason "completed", and every gate then passes over an
+    // empty diff. A task can legitimately change nothing, so this states the fact rather than
+    // calling it a failure.
+    if (outcome.finalCycle.measures.changedFiles === 0) {
+        note("\nno files were changed. The gates below measured an unchanged workspace, so they say " +
+            "nothing about work being done.");
+    }
     note(`\ngates:\n${describeCycle(outcome.finalCycle)}`);
     for (const attempt of outcome.attempts) {
         note(`attempt ${attempt.attempt}: ${attempt.decision.accepted ? "accepted" : "REJECTED"} - ` +
@@ -882,6 +1097,9 @@ async function main() {
     if (options.command === "parallel") {
         return parallel(options);
     }
+    if (options.command === "session") {
+        return session(options);
+    }
     return options.command === "gates" ? gates(options) : run(options);
 }
 main().then((code) => {