@pmelab/gtd 64.2.0 → 64.3.0

package/dist/gtd.core.mjs

@@ -583,7 +583,7 @@ Refuses when the workflow declares no summary template, or when the process has
 
 Prints a sorted JSON array ([] when clean) and a summary on stderr; --verbose adds one stray: line per path. Runs in any git repository, no process needed. Exits 10 when strays were found, 1 on an unknown revision, 2 on a bad range.`},{token:`history list`,kind:`historyList`,arity:`none`,group:`Inspect`,summary:`List finished processes`,details:"List the finished processes this clone keeps, newest first: entry, branch, tip, date and subject. --json prints an array of { ref, entry, branch, tip, date, subject }. Writes nothing; with none kept it suggests `gtd history fetch`."},{token:`history show`,kind:`historyShow`,arity:{name:`ref`},group:`Inspect`,summary:`Replay one finished process`,details:`Replay one finished process under today's config and print its steps, judge verdicts and approvals. <ref> is a full ref, an entry hash or a unique prefix of one, or a branch name. Refuses when a config file changed since; a different gtd version only warns. --json prints the trail as one document. Writes nothing.`},{token:`history metrics`,kind:`historyMetrics`,arity:{name:`ref`,many:!0},group:`Inspect`,summary:`Report cost and rework of finished processes`,details:"Report how finished processes went: builds that landed first time or were rebuilt, cost by model and phase, review findings per lens, and red checks that passed when re-run — per process and in total. <ref> is read as by `gtd history show`, but a branch name means every process kept from it; no <ref> means all of them. Never replays, so a changed config is no reason to refuse. --json prints { processes, total }. Writes nothing."},{token:`history judges`,kind:`historyJudges`,arity:{name:`ref`,many:!0},group:`Inspect`,summary:`Calibrate the judges of finished processes`,details:"Calibrate the judges of finished processes from their recorded verdicts: per judge and confidence bucket, how many verdicts later events overturned. <ref> is read as by `gtd history metrics`. Never replays and asks no model. --json prints { processes, total, whatIf }. Writes nothing."},{token:`history fetch`,kind:`historyFetch`,arity:{name:`remote`,optional:!0},group:`Inspect`,summary:`Print a script that fetches finished processes`,details:`Print a script that fetches every finished process kept on <remote> (default: origin) and reports how many arrived. gtd runs no git itself:
 
-  s=$(gtd history fetch --json=script) && sh -c "$s"`},{token:`ui`,kind:`ui`,arity:`none`,group:`Inspect`,summary:`Serve the web and phone client`,details:"Serve gtd's web and phone client for this worktree. By default it publishes through `tailscale serve`, reachable from anywhere on the tailnet, on the first of ports 8443, 10000 and 443 that works; when none does it serves HTTPS locally instead of refusing."},{token:`guide`,kind:`guide`,arity:`none`,group:`Driver plumbing`,summary:`Print a briefing for writing a driver`,details:`Print a self-contained briefing that teaches an agent or a person to build a gtd driver in any shell or runtime, and where to get a workflow — gtd ships none. Writes nothing.`},{token:`bundle`,kind:`bundle`,arity:`none`,group:`Driver plumbing`,summary:`Print the pin of the current workflow`,details:"Print a pin to stdout: gtd's engine and the current workflow — gtd.config.ts, every module it imports and every npm package they use — as one gzipped ES module, after a plain-text header line `gtdpin <format> gtd <version>`. Git diffs it as binary. Refuses a workflow gtd would refuse, and a package that loads a native addon (.node), naming it. Writes nothing."},{token:`judge`,kind:`judge`,arity:`none`,group:`Driver plumbing`,summary:`Print the pending judgment`,details:"Print the current step's pending judgment: the prepared state, its questions and their criteria — the judge field `gtd next --json` carries. Writes nothing; refuses when the step declares no judge."},{token:`judge answer`,kind:`judgeAnswer`,arity:`none`,group:`Driver plumbing`,summary:`Land a verdict read from stdin`,details:"Read a verdict from stdin — one { id, answer, p } entry per pending question — and land it the way `gtd land` does: plain output names the commit, --json=script prints the script. Refuses when the step declares no judge; a verdict that is not JSON, or names a question that was not asked, is a usage error (exit 2)."},{token:`judge run`,kind:`judgeRun`,arity:`none`,group:`Driver plumbing`,summary:`Answer a judgment with a model`,details:"Answer a judgment: read the `gtd judge --json` document from stdin and print the verdict [{ id, answer, p }] `gtd judge answer` reads. Needs no repository.\n\nThe fixed answerer reads --answers and leaves out the questions it does not cover; jev asks TypeSafe ($TYPESAFE_API_KEY); llm asks the `claude` CLI on PATH. jev and llm exit 1, printing nothing, when they cannot answer every question. A stdin that is not a judgment document is a usage error (exit 2)."},{token:`check`,kind:`check`,arity:{names:[`mode`,`file`]},group:`Driver plumbing`,summary:`Check a steering file's format`,details:`Run the steering format <mode> (qa, review or findings, or the declared format --spec describes) over <file> and print each finding on a line of its own; exits 1 when there are any, or when <file> does not exist. An unknown <mode> is a usage error (exit 2). Reads no workflow and runs from any directory — emitted validation scripts call it.`},{token:`uncheck`,kind:`uncheck`,arity:{name:`file`},group:`Driver plumbing`,summary:`Untick a review file's boxes`,details:`Reset every ticked review box (- [x]) in <file> to - [ ], writing the file only when it changes; a missing file writes nothing. Reads no workflow and runs from any directory — the landing script at a review gate calls it, so no tick is ever committed.`},{token:`lsp`,kind:`lsp`,arity:`none`,group:`Driver plumbing`,summary:`Start the steering-file language server`,details:`Start the language server for .gtd/ steering files on stdio.`}],BZ=e=>zZ.find(t=>t.token===e),VZ=[.../* @__PURE__ */ new Set([...zZ.map(e=>e.token.split(` `)[0]),`help`,`version`])],HZ=e=>{let{token:t,arity:n}=e;return n===`none`?t:`names`in n?`${t} <${n.names[0]}> <${n.names[1]}>`:`bare`in n?`${t} [${n.name}] [${n.variadic}...]`:`variadic`in n?`${t} <${n.name}> [${n.variadic}...]`:`optional`in n?`${t} [${n.name}]`:`many`in n?`${t} [${n.name}...]`:`${t} <${n.name}>`},UZ=/* @__PURE__ */ new Set([`--var`,`--threshold`]),WZ=e=>e.valueHint===``?e.name:e.arity===`optional`?`${e.name}[=${e.valueHint}]`:UZ.has(e.name)?`${e.name} ${e.valueHint}`:`${e.name}=${e.valueHint}`,GZ=[[`-v, --verbose`,`Narrate on stderr what gtd resolved`],[`--live`,`Run this gtd, not the process's pin; it may misread the process`],[`-h, --help`,`Print help; gtd <command> --help for one command`],[`-V, --version`,`Print the version`],[`--`,`End the options: every word after it is an argument`]],KZ=[[`help [command]`,`Print help for gtd or one command`,`Print gtd's overview, or with <command> that command's own help.`],[`version`,`Print the version`,`Print gtd's version, and the version of a pinned process's gtd.`]],qZ=e=>e.map(e=>`${e}\n`).join(``),JZ=[`Core loop`,`Start and stop`,`Inspect`,`Driver plumbing`],YZ=()=>{let e=JZ.map(e=>{let t=zZ.filter(t=>t.group===e).flatMap(e=>OZ(HZ(e),e.summary,28)),n=e===`Driver plumbing`?KZ.flatMap(([e,t])=>OZ(e,t,28)):[];return`${e}:\n${qZ([...t,...n])}`});return`Usage: gtd <command> [options]
+  s=$(gtd history fetch --json=script) && sh -c "$s"`},{token:`ui`,kind:`ui`,arity:`none`,group:`Inspect`,summary:`Serve the web and phone client`,details:"Serve gtd's web and phone client for this worktree. By default it publishes through `tailscale serve`, reachable from anywhere on the tailnet, on the first of ports 8443, 10000 and 443 that works; when none does it serves HTTPS locally instead of refusing. Done saves the steering file and keeps serving; the server exits when the worktree moves on to another step, or on a signal."},{token:`guide`,kind:`guide`,arity:`none`,group:`Driver plumbing`,summary:`Print a briefing for writing a driver`,details:`Print a self-contained briefing that teaches an agent or a person to build a gtd driver in any shell or runtime, and where to get a workflow — gtd ships none. Writes nothing.`},{token:`bundle`,kind:`bundle`,arity:`none`,group:`Driver plumbing`,summary:`Print the pin of the current workflow`,details:"Print a pin to stdout: gtd's engine and the current workflow — gtd.config.ts, every module it imports and every npm package they use — as one gzipped ES module, after a plain-text header line `gtdpin <format> gtd <version>`. Git diffs it as binary. Refuses a workflow gtd would refuse, and a package that loads a native addon (.node), naming it. Writes nothing."},{token:`judge`,kind:`judge`,arity:`none`,group:`Driver plumbing`,summary:`Print the pending judgment`,details:"Print the current step's pending judgment: the prepared state, its questions and their criteria — the judge field `gtd next --json` carries. Writes nothing; refuses when the step declares no judge."},{token:`judge answer`,kind:`judgeAnswer`,arity:`none`,group:`Driver plumbing`,summary:`Land a verdict read from stdin`,details:"Read a verdict from stdin — one { id, answer, p } entry per pending question — and land it the way `gtd land` does: plain output names the commit, --json=script prints the script. Refuses when the step declares no judge; a verdict that is not JSON, or names a question that was not asked, is a usage error (exit 2)."},{token:`judge run`,kind:`judgeRun`,arity:`none`,group:`Driver plumbing`,summary:`Answer a judgment with a model`,details:"Answer a judgment: read the `gtd judge --json` document from stdin and print the verdict [{ id, answer, p }] `gtd judge answer` reads. Needs no repository.\n\nThe fixed answerer reads --answers and leaves out the questions it does not cover; jev asks TypeSafe ($TYPESAFE_API_KEY); llm asks the `claude` CLI on PATH. jev and llm exit 1, printing nothing, when they cannot answer every question. A stdin that is not a judgment document is a usage error (exit 2)."},{token:`check`,kind:`check`,arity:{names:[`mode`,`file`]},group:`Driver plumbing`,summary:`Check a steering file's format`,details:`Run the steering format <mode> (qa, review or findings, or the declared format --spec describes) over <file> and print each finding on a line of its own; exits 1 when there are any, or when <file> does not exist. An unknown <mode> is a usage error (exit 2). Reads no workflow and runs from any directory — emitted validation scripts call it.`},{token:`uncheck`,kind:`uncheck`,arity:{name:`file`},group:`Driver plumbing`,summary:`Untick a review file's boxes`,details:`Reset every ticked review box (- [x]) in <file> to - [ ], writing the file only when it changes; a missing file writes nothing. Reads no workflow and runs from any directory — the landing script at a review gate calls it, so no tick is ever committed.`},{token:`lsp`,kind:`lsp`,arity:`none`,group:`Driver plumbing`,summary:`Start the steering-file language server`,details:`Start the language server for .gtd/ steering files on stdio.`}],BZ=e=>zZ.find(t=>t.token===e),VZ=[.../* @__PURE__ */ new Set([...zZ.map(e=>e.token.split(` `)[0]),`help`,`version`])],HZ=e=>{let{token:t,arity:n}=e;return n===`none`?t:`names`in n?`${t} <${n.names[0]}> <${n.names[1]}>`:`bare`in n?`${t} [${n.name}] [${n.variadic}...]`:`variadic`in n?`${t} <${n.name}> [${n.variadic}...]`:`optional`in n?`${t} [${n.name}]`:`many`in n?`${t} [${n.name}...]`:`${t} <${n.name}>`},UZ=/* @__PURE__ */ new Set([`--var`,`--threshold`]),WZ=e=>e.valueHint===``?e.name:e.arity===`optional`?`${e.name}[=${e.valueHint}]`:UZ.has(e.name)?`${e.name} ${e.valueHint}`:`${e.name}=${e.valueHint}`,GZ=[[`-v, --verbose`,`Narrate on stderr what gtd resolved`],[`--live`,`Run this gtd, not the process's pin; it may misread the process`],[`-h, --help`,`Print help; gtd <command> --help for one command`],[`-V, --version`,`Print the version`],[`--`,`End the options: every word after it is an argument`]],KZ=[[`help [command]`,`Print help for gtd or one command`,`Print gtd's overview, or with <command> that command's own help.`],[`version`,`Print the version`,`Print gtd's version, and the version of a pinned process's gtd.`]],qZ=e=>e.map(e=>`${e}\n`).join(``),JZ=[`Core loop`,`Start and stop`,`Inspect`,`Driver plumbing`],YZ=()=>{let e=JZ.map(e=>{let t=zZ.filter(t=>t.group===e).flatMap(e=>OZ(HZ(e),e.summary,28)),n=e===`Driver plumbing`?KZ.flatMap(([e,t])=>OZ(e,t,28)):[];return`${e}:\n${qZ([...t,...n])}`});return`Usage: gtd <command> [options]
 
 `+qZ(DZ(`gtd reads a repository's git state and prints what should happen next in its workflow. It never acts on it: a driver, or you, runs what it prints.`))+`
 `+e.join(`

package/dist/testkit/gherkin.mjs

@@ -1,4 +1,4 @@
-import { n as runsItsScript, r as testRepo } from "../chunks/testkit-BwCH8ky6.mjs";
+import { n as runsItsScript, r as testRepo } from "../chunks/testkit-BUX-47TD.mjs";
 import { pathToFileURL } from "node:url";
 import { resolve } from "node:path";
 import { After, AfterAll, Given, QuickPickleWorld, Then, When, setWorldConstructor } from "quickpickle";

package/dist/testkit.mjs

@@ -1,3 +1,3 @@
 import { H as installContext } from "./chunks/flows-dnIE_qbe.mjs";
-import { a as verdictWhen, i as verdict, n as runsItsScript, o as whenPrompted, r as testRepo, t as inTurn } from "./chunks/testkit-BwCH8ky6.mjs";
+import { a as verdictWhen, i as verdict, n as runsItsScript, o as whenPrompted, r as testRepo, t as inTurn } from "./chunks/testkit-BUX-47TD.mjs";
 export { inTurn, installContext, runsItsScript, testRepo, verdict, verdictWhen, whenPrompted };

package/dist/web/main.js

@@ -35949,8 +35949,8 @@ const openable = (step) => step?.status === "ok" && step.file !== void 0;
 * `"qa"` means `Plan`; `"findings"` means `Findings`; anything else (absent, or an unregistered mode name)
 * falls through to `FreeForm`, which reads the file as plain markdown and
 * offers only a note per block, plus a textfield when it's empty. Neither
-* screen offers a way back to a list — `done` is the only
-* thing that ends the turn, and it exits the process.
+* screen offers a way back to a list — `done` hands the turn back (the
+* server keeps running until the outer loop moves on).
 *
 * Never returns `null`: a blank white screen was package 03's own regression
 * (a phone over a tailnet with nothing on-screen to explain why) — every

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pmelab/gtd",
-  "version": "64.2.0",
+  "version": "64.3.0",
   "private": false,
   "description": "Git-aware CLI that emits the next prompt for an autonomous coding agent based on the current repository state",
   "bin": {

package/src/cli/Cli.ts

@@ -557,7 +557,7 @@ Prints a sorted JSON array ([] when clean) and a summary on stderr; --verbose ad
     arity: "none",
     group: "Inspect",
     summary: "Serve the web and phone client",
-    details: `Serve gtd's web and phone client for this worktree. By default it publishes through \`tailscale serve\`, reachable from anywhere on the tailnet, on the first of ports 8443, 10000 and 443 that works; when none does it serves HTTPS locally instead of refusing.`,
+    details: `Serve gtd's web and phone client for this worktree. By default it publishes through \`tailscale serve\`, reachable from anywhere on the tailnet, on the first of ports 8443, 10000 and 443 that works; when none does it serves HTTPS locally instead of refusing. Done saves the steering file and keeps serving; the server exits when the worktree moves on to another step, or on a signal.`,
   },
   {
     token: "guide",