@joshuafolkken/kit 1.3041.0 → 1.3092.0

package/dist/commands/chunk-C54QXJD6.js

@@ -1,4208 +0,0 @@
-import {
-  gate_plan
-} from "./chunk-HQGNXR6I.js";
-import {
-  issue_body_keys
-} from "./chunk-KXK2A2HB.js";
-import {
-  GATE_COMMAND,
-  LINT_RULE_WORKERS,
-  OPTIONAL_ENV_FILE_FLAGS
-} from "./chunk-TBIX5FRN.js";
-import {
-  ports
-} from "./chunk-IGD6QJPH.js";
-import {
-  core_weights
-} from "./chunk-ENFPR7J2.js";
-
-// scripts/josh/josh-commands-backlog.ts
-var EXCLUDE = "--exclude <N>";
-var JUST_MERGED = "skip the issue just merged";
-var EXCLUDE_1630 = "--exclude 1630";
-var BUDGET = '--answer candidates --started "$started" --active "$active"';
-var BACKLOG_COMMANDS = {
-  // Started from a terminal: the `backlogrun` keyword's launcher, and the board.
-  backlogrun: {
-    script: "scripts/backlog/backlogrun-cli.ts",
-    description: "Start a backlogrun in the background and show its board; with one already running, only show the board, or replace it when it is idle and the invocation differs; --stop stops it; --restart replaces its processes and keeps its record",
-    category: "AI tools",
-    reference: [
-      "[<n>...] [--only] [--max <n>] [--idle <minutes>] [--agent claude|codex] | --stop | --restart",
-      "developer",
-      ["files", "network", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "start with the configured provider, then show the board" },
-        { arguments: "3437 --only", note: "the arguments go to backlogrun as typed" },
-        { arguments: "--agent codex", note: "start in Codex" },
-        { arguments: "--stop", note: "stop the run in this repository" },
-        { arguments: "--restart", note: "replace the run's processes, keeping its record" }
-      ]
-    }
-  },
-  "backlog:next": {
-    script: "scripts/backlog/backlog-next-main.ts",
-    description: "Order the whole opted-in backlog: auto-ok issues and the descendants of auto-ok epics, transitively through nested epics",
-    category: "AI tools",
-    reference: ["[--exclude <n>[,<n>...]]", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "" }, { arguments: EXCLUDE_1630, note: JUST_MERGED }],
-      flags: [
-        {
-          names: [EXCLUDE],
-          description: "drop issues from every bucket; comma-separated, repeatable."
-        }
-      ]
-    }
-  },
-  "backlog:offer": {
-    script: "scripts/backlog/backlog-offer-main.ts",
-    description: "Collapse a backlogrun loop-head event into one call: read backlog:next, ask backlog:budget, return the verdict and any issues to start",
-    category: "AI tools",
-    reference: ["[options]", "automation", ["files", "git", "network", "processes"]],
-    usage: {
-      examples: [{ arguments: '--started "$started" --active "$active" --running 2 --retries 1' }]
-    }
-  },
-  "backlog:drive": {
-    script: "scripts/backlog/backlog-drive-cli.ts",
-    description: "Drive backlogrun through offer, launch and merge; restore this run\u2019s lanes and report when complete",
-    category: "AI tools",
-    reference: ["[--owner <pid>] [options]", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "[--max <n>] [--idle <minutes>] [--only]" }]
-    }
-  },
-  "backlog:triage": {
-    script: "scripts/backlog/backlog-triage-cli.ts",
-    description: "Run a parent triage pass, decide solo/lane from three conditions, or apply one issue's verdict",
-    category: "AI tools",
-    reference: [
-      "--pass [--exclude <n>] | --decide --defect yes|no|unknown --verification yes|no|unknown --every-run yes|no|unknown | --apply <n> [--lane | --solo --defect yes --verification yes --every-run yes] [--blocked-by <m> | --unblock <m>] --reason <text> [--clear] | --apply <n> --adopt <k> --reason <text> [--done <text>]",
-      "automation",
-      ["files", "network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "--pass" },
-        { arguments: "--decide --defect yes --verification yes --every-run no" },
-        { arguments: '--apply 912 --lane --reason "<why>"' },
-        {
-          arguments: '--apply 913 --solo --defect yes --verification yes --every-run yes --reason "<why>" --clear'
-        },
-        {
-          arguments: '--apply 914 --blocked-by 912 --reason "<why>"'
-        },
-        {
-          arguments: '--apply 914 --unblock 912 --reason "<why>"'
-        },
-        {
-          arguments: '--apply 915 --adopt 1 --reason "<why>"'
-        }
-      ],
-      flags: [
-        {
-          names: ["--pass [--exclude <N>]"],
-          description: "settles mechanical lane candidates and prints one next command; exclude decisions kept parked. Each park's recommendation and tier go to stderr, with its `--adopt` command unless no pick or a tier C pick. Failed or incomplete reads exit 1."
-        },
-        {
-          names: ["--decide --defect <answer> --verification <answer> --every-run <answer>"],
-          description: "yes/no/unknown evidence: three yes \u2192 run:solo; any no \u2192 run:lane; otherwise judge. Read-only."
-        },
-        {
-          names: ["--apply <N> --lane|--solo --reason <text>"],
-          description: "comments the reason, then applies the run label (`auto-ok:judge --apply`)."
-        },
-        {
-          names: ["--clear"],
-          description: "clears the park (`run:park <N> --clear`) only when the issue answers its decision question."
-        },
-        {
-          names: ["--blocked-by <M>"],
-          description: "records the native `blocked-by` relation on `#M` before the comment and the run label, declared in the epic tracking `#N` as `run:pause` does; it stands in for the run label or goes with it."
-        },
-        {
-          names: ["--unblock <M>"],
-          description: "removes it instead, with the tracking epic's `#M -> #N` declaration (`epic --remove`'s path); `--blocked-by` restores it. A failed write is named, exit 1."
-        },
-        {
-          names: ["--adopt <k>"],
-          description: "takes option `<k>` of the child's latest park in one call: records the decision in its one tracking epic (`epic --decide`'s path), clears the park, then `run:add <N> --retry`. A park with no recommendation, an unlisted or tier C option, no single tracking epic, or no backlogrun running here is refused before any write."
-        },
-        {
-          names: ["--done <text>"],
-          description: "what the parent did for an option whose `\u5FC5\u8981\u306A\u6A29\u9650` starts with `\u89AA` (e.g. `\u89AA\u30BB\u30C3\u30B7\u30E7\u30F3`): the parent carries the option out first, then adopts it with `--done <what was done>`, recorded with the decision. Without it such an option is refused before any write, so the child stays parked; on any other option it is refused."
-        }
-      ]
-    }
-  },
-  "backlog:plan": {
-    script: "scripts/backlog/backlog-plan-cli.ts",
-    description: "Print the whole backlog as a plan: ready now, waiting on what, waiting on a person, out of scope",
-    category: "AI tools",
-    reference: [
-      "[issue...] [--only] [--waves] [--exclude <n>[,<n>...]]",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: EXCLUDE_1630, note: "after #1630 merged" },
-        { arguments: "--waves", note: "the run order, wave by wave" }
-      ],
-      flags: [
-        { names: [EXCLUDE], description: "same exclusion as `backlog:next`." },
-        {
-          names: ["--waves"],
-          description: "print the order the run takes, wave by wave, assuming each wave merges before the next. Read-only."
-        }
-      ]
-    }
-  },
-  "backlog:budget": {
-    script: "scripts/backlog/backlog-budget-main.ts",
-    description: "Say whether a backlogrun may start more work, keep watching, or finish",
-    category: "AI tools",
-    reference: ["[options]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: BUDGET },
-        { arguments: '--answer exhausted --started "$started" --active "$active" --idle 60' },
-        { arguments: `${BUDGET} --merged 3 --running 2 --max 5` }
-      ],
-      flags: [
-        {
-          names: ["--answer <candidates|exhausted|blocked|parked|unreadable|untriaged>"],
-          description: "`backlog:next`'s answer, mapped."
-        },
-        {
-          names: ["--started", "--active"],
-          description: "when the invocation began / when it last had work (required unless the watch is off)."
-        },
-        {
-          names: ["--idle <minutes>"],
-          description: "once nothing can proceed, keep polling this long, counted from `--active` (default 480, 8 hours; `--idle 0` turns the watch off)."
-        },
-        {
-          names: ["--max <count>"],
-          description: "issues one invocation may take (default unlimited); `--merged` and `--running` count against it."
-        },
-        {
-          names: ["--json"],
-          description: 'collapse verdict and reason into `{"budget": "<verdict>", "reason": "\u2026"}`.'
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-document.ts
-var DOCUMENT_COMMANDS = {
-  "doc:section": {
-    script: "scripts/document/document-section-main.ts",
-    description: 'Print one section of a markdown document, for a `file.md` \u2192 "Heading" reference',
-    category: "AI tools",
-    reference: ["<file> <heading>", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: '<file.md> "<heading>"' },
-        { arguments: 'backlogrun.md "The hand-off"' }
-      ]
-    }
-  },
-  "code:symbol": {
-    script: "scripts/code/code-symbol-cli.ts",
-    description: "Print one TypeScript declaration by name, numbered, or list where a name is declared",
-    category: "AI tools",
-    reference: ["<file> <name> | <name>", "automation", ["none"]],
-    // Parses the repository's sources and prints, so a consultation session can run it.
-    is_read_only: true,
-    usage: {
-      examples: [
-        { arguments: "<file> <name>", note: "the declaration, its comment block included" },
-        { arguments: "<name>", note: "every file:line that declares it" },
-        { arguments: "scripts/code/code-symbol.ts declarations" }
-      ]
-    }
-  },
-  "read:set": {
-    script: "scripts/document/read-set-cli.ts",
-    description: "Print what an entry point reads before it starts, and what that read costs",
-    category: "AI tools",
-    reference: ["[<entry>] [--json | --bytes]", "automation", ["none"]],
-    // Reads the repository's documents and prints, so a consultation session can run it.
-    is_read_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "every entry point" },
-        { arguments: "backlogrun", note: "one of them" },
-        { arguments: "backlogrun --json" },
-        { arguments: "fullrun --bytes", note: "its total read bytes alone, as the last line" }
-      ]
-    }
-  },
-  "doc:read": {
-    script: "scripts/document/document-read-cli.ts",
-    description: "Read a whole document safely: print it, or point at the Read tool when over the Bash cap",
-    category: "AI tools",
-    reference: ["<file>", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "CLAUDE.md", note: "under the cap: prints the document" },
-        { arguments: "backlogrun.md", note: "over the cap: prints a directive, no content" }
-      ]
-    }
-  },
-  "read:files": {
-    script: "scripts/document/read-files-cli.ts",
-    description: "Read several files in one call so edit targets fold into one turn",
-    category: "AI tools",
-    reference: ["<path> [<path> ...]", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "a.ts b.ts c.ts",
-          note: "under the cap: prints each file under its own header"
-        },
-        {
-          arguments: "a.ts big.ts",
-          note: "over the cap: prints a directive to Read them in one turn, no content"
-        }
-      ]
-    }
-  },
-  "edit:files": {
-    script: "scripts/document/edit-files-cli.ts",
-    description: "Apply several content-addressed edits from a plan in one call",
-    category: "AI tools",
-    reference: ["<plan-path | ->", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "plan.txt",
-          note: "applies every block in the plan, one line per edit reporting the outcome"
-        },
-        { arguments: "- <<'EDITS'", note: "plan from stdin, then EDITS" }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-epic.ts
-var REPO = "--repo <owner/repo>";
-var EXCLUDE2 = "--exclude <N>";
-var JUST_MERGED2 = "skip the issue just merged";
-var EPIC_COMMANDS = {
-  epic: {
-    script: "scripts/epic/epic-main.ts",
-    // `--notify` sends the `planning` Telegram (epic-notify.ts), which reads `.env`.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Create an epic issue from its child issue numbers",
-    category: "AI tools",
-    reference: ["<title> <issue...> [--ordered]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: '"Epic: split the parser work" 101 102 103' },
-        { arguments: '"Epic: staged rollout" 101 102 --ordered' },
-        { arguments: '"Epic: ..." 101 102 --rationale-file .josh/tmp/rationale.md' },
-        { arguments: "--promote 858 101 102 103", note: "turn an existing issue into an epic" },
-        { arguments: "--add 893 894", note: "track #894, declaring no order for it" },
-        { arguments: "--add 893 894 --before 891", note: "#894 must finish before #891" },
-        { arguments: "--add 893 894 --after 890", note: "#894 starts once #890 is done" },
-        {
-          arguments: "--add 893 894 --decision-file .josh/tmp/why.md",
-          note: "\u2026and record why, in one call"
-        },
-        {
-          arguments: "--reconcile 2184",
-          note: "rewrite the body to match the recorded blocked-by, and record any order the body declared"
-        },
-        { arguments: "--decide 893 894 --decision-file .josh/tmp/why.md" },
-        { arguments: "--untrack 893 894", note: "remove a child row and its connected orders" }
-      ],
-      flags: [
-        {
-          names: ["--ordered"],
-          description: "argument order is the dependency order; writes the arrow chain, records the matching `blocked-by` relations, and adds a `### Declared order` entry under `## Decisions`."
-        },
-        {
-          names: ["--rationale-file <path|->"],
-          description: "split rationale prose, written under `.josh/tmp/` (`-` reads stdin)."
-        },
-        {
-          names: ["--origin <owner/repo#N>"],
-          description: "backlink when the split originated in another repository."
-        },
-        {
-          names: ["--notify"],
-          description: "on create or `--promote`: send the split path's `planning` Telegram (the epic URL, child URLs and `Next: pnpm josh backlogrun <E> --only`), as `issue:plan --planned` sends; a failed send only warns."
-        },
-        {
-          names: ["--title <title>"],
-          description: "with `--promote`: rename the issue first."
-        },
-        {
-          names: ["--before <M>"],
-          description: "with `--add`: insert before `#M`, re-pointing what `#M` was waiting on so the chain is never broken."
-        },
-        {
-          names: ["--after <M>"],
-          description: "with `--add`: start after `#M`; branches when `#M` already has a successor, extends when it is a tail."
-        },
-        {
-          names: ["--order-before <M>", "--order-after <M>"],
-          description: "with `--add`: move the task-list row only; write no `blocked-by` relation."
-        },
-        {
-          names: ["--decision-file <path|->"],
-          description: "with `--add`: record why the child was placed, written under `.josh/tmp/` (`-` reads stdin)."
-        },
-        {
-          names: ["--remove <E> <M> <N> [<N2> \u2026]"],
-          description: "delete a declared order from the body and the relations; each consecutive pair is one link."
-        },
-        {
-          names: ["--untrack <E> <N...>"],
-          description: "remove child rows and connected orders without reconnecting survivors; relation failures preserve the body for retry; absent rows are safe to repeat."
-        }
-      ]
-    }
-  },
-  "epic:next": {
-    script: "scripts/epic/epic-next-main.ts",
-    description: "List an epic's runnable children, bundled per repository",
-    category: "AI tools",
-    reference: ["<epic>... [--repo <owner/repo>] [--lanes]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "858" },
-        {
-          arguments: "858 --repo joshuafolkken/kit",
-          note: "just the next child for one repository"
-        },
-        {
-          arguments: "858 --repo joshuafolkken/kit --lanes",
-          note: "one child per free lane there"
-        }
-      ],
-      flags: [
-        {
-          names: [REPO],
-          description: "answer for one repository; stdout carries one token (an issue number, or `wait`/`stop`/`complete`), everything else on stderr."
-        },
-        {
-          names: ["--lanes"],
-          description: "print one issue number per free lane (requires `--repo`); `JOSH_LANE_LIMIT` sets the ceiling, default 4. Prints `triage` instead while any candidate carries neither `run:solo` nor `run:lane` (the triage gate in `josh backlog:next`)."
-        }
-      ]
-    }
-  },
-  "epic:bundle": {
-    script: "scripts/epic/epic-bundle-main.ts",
-    description: "Say whether a newly filed issue belongs with ones already in the backlog",
-    category: "AI tools",
-    reference: ["<issue> [--apply]", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "874" }, { arguments: "874 --apply", note: "write it" }]
-    }
-  },
-  "epic:audit": {
-    script: "scripts/epic/epic-audit-main.ts",
-    description: "Audit an epic's children against each other for contradictions",
-    category: "AI tools",
-    reference: ["<epic>", "automation", ["network"]],
-    usage: { examples: [{ arguments: "858" }] }
-  },
-  "epic:check": {
-    script: "scripts/epic/epic-check.ts",
-    description: "Check an epic issue against the tracking requirements",
-    category: "AI tools",
-    reference: ["<epic>", "automation", ["network"]],
-    usage: { examples: [{ arguments: "700" }] }
-  },
-  "auto-ok:next": {
-    script: "scripts/auto-ok/auto-ok-main.ts",
-    description: "Print the next opted-in issue an unattended run may pick up outside an epic",
-    category: "AI tools",
-    reference: ["[--exclude <n>[,<n>...]] [--label <name>]", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "" }, { arguments: "--exclude 906", note: JUST_MERGED2 }],
-      flags: [
-        {
-          names: [EXCLUDE2],
-          description: "drop issues from the answer; comma-separated, repeatable."
-        }
-      ]
-    }
-  },
-  "auto-ok:judge": {
-    script: "scripts/auto-ok/auto-ok-judge-cli.ts",
-    description: "List the open issues backlogrun owes an auto-ok judgement, or record one (--apply / --decline)",
-    category: "AI tools",
-    reference: [
-      "[--apply <n> (--lane | --solo --defect yes --verification yes --every-run yes) | --decline <n> --reason <text>]",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "the issues that still owe a judgement" },
-        { arguments: "--apply 912 --lane", note: "opt it in, with its run label" },
-        { arguments: '--decline 913 --reason "<why>"', note: "record why it stays out" }
-      ],
-      flags: [
-        {
-          names: ["--apply <N> --lane|--solo"],
-          description: "checks the exclusions again against the labels as they stand, records the judgement on the issue, then applies the run label and then `auto-ok`."
-        },
-        { names: ["--decline <N> --reason <text>"], description: "applies nothing." }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-issue-write.ts
-var REPO2 = "--repo <owner/repo>";
-var BODY_FILE = "--body-file <path>";
-var TITLE = "--title <title>";
-var EVIDENCE_FILE = "--evidence-file <path>";
-var BLOCKS_FINDER = "--blocks-finder";
-var DISTINCT = "--distinct <N,\u2026>";
-var EVIDENCE_REFERENCE = `<issue> ${EVIDENCE_FILE}`;
-var ISSUE_WRITE_COMMANDS = {
-  "issue:tick": {
-    script: "scripts/issue/issue-tick-cli.ts",
-    description: "Tick selected acceptance checkboxes by their plan identifiers",
-    category: "AI tools",
-    reference: ["<issue> <ac-id>...", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "6233 ac-a1f32a2f ac-8647b0dd" }]
-    }
-  },
-  "issue:consolidate": {
-    script: "scripts/issue/issue-consolidate-cli.ts",
-    description: "Fold duplicates into a target: untrack, close as not planned; a failed write lists the writes done",
-    category: "AI tools",
-    reference: [
-      "<target> <duplicate>... [--title <title>] [--body-file <path>] [--demote]",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [{ arguments: "6559 6567 6568 --body-file .josh/tmp/body.md --demote" }],
-      flags: [
-        { names: [TITLE], description: "replace the target's title." },
-        {
-          names: [BODY_FILE],
-          description: "replace the target's body, from a file or stdin (`-`). Target author needs write access."
-        },
-        {
-          names: ["--demote"],
-          description: "remove the `epic` label and the `## Split into children` sections from the body."
-        }
-      ]
-    }
-  },
-  "issue:release-class": {
-    script: "scripts/issue/issue-release-class-cli.ts",
-    description: "Write the issue body's one release classification line, replacing any earlier one",
-    category: "AI tools",
-    reference: ["<issue> <enhancement|other-change>", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "6636 other-change" }]
-    }
-  },
-  "issue:comment": {
-    script: "scripts/issue/issue-comment-main.ts",
-    description: "Post one comment to an issue from a file, so no shell expands the body",
-    category: "AI tools",
-    reference: ["<issue> --body <text> | --body-file <path>", "automation", ["network"]],
-    usage: {
-      examples: [
-        {
-          arguments: "2304 --body-file .josh/tmp/park.md",
-          note: "the body from a file \u2014 no shell evaluates it"
-        },
-        {
-          arguments: '2304 --body "a short note"',
-          note: "inline, for a body with no backticks or $"
-        }
-      ],
-      flags: [
-        {
-          names: ["--body <text>"],
-          description: "the comment body, inline. Trimmed, with `\\n` expanded to a newline."
-        },
-        {
-          names: [BODY_FILE],
-          description: "read the body from a file, or from stdin with `-`. The safe form the rule steers every caller toward."
-        }
-      ]
-    }
-  },
-  "issue:body": {
-    script: "scripts/issue/issue-body-cli.ts",
-    description: "Replace an issue's body with a file that passes issue:lint",
-    category: "AI tools",
-    reference: ["<issue> --body-file <path>", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "6982 --body-file .josh/tmp/issue-6982-body.md" }],
-      flags: [
-        {
-          names: [BODY_FILE],
-          description: "the new body, from a file or stdin (`-`). A body `issue:lint` refuses is not written."
-        }
-      ]
-    }
-  },
-  "issue:plan": {
-    script: "scripts/issue/issue-plan-cli.ts",
-    description: "Record a plan: normalize the title, fill a blank body or comment, apply run:planned",
-    category: "AI tools",
-    // `--planned` sends the `planning` Telegram (issue-plan-notify.ts), which reads `.env`.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [
-      "<issue> --body-file <path> [--title <title>] [--planned] [--no-notify] [--repo <owner/name>]",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: '4134 --body-file .josh/tmp/plan.md --title "Add issue:plan" --planned',
-          note: "kickoff's three writes"
-        }
-      ],
-      flags: [
-        {
-          names: [BODY_FILE],
-          description: "the plan, from a file or stdin (`-`): a blank body takes it, else a comment."
-        },
-        { names: [TITLE], description: "replace the issue title first." },
-        {
-          names: ["--planned"],
-          description: "apply `run:planned` once the plan is posted, so the next entry skips planning; send the `planning` Telegram (change items, `Next:`)."
-        },
-        {
-          names: ["--no-notify"],
-          description: "with `--planned`, skip the `planning` Telegram."
-        },
-        {
-          names: ["--repo <owner/name>"],
-          description: "write to that repository's issue."
-        }
-      ]
-    }
-  },
-  "issue:premise-unmet": {
-    script: "scripts/issue/issue-premise-unmet-cli.ts",
-    description: "Exit an issue whose declared close condition holds: post the verdict, close it as not planned, release the hold",
-    category: "AI tools",
-    // Releasing the hold runs `run:hold`, which reaches the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [EVIDENCE_REFERENCE, "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "7249 --evidence-file .josh/tmp/premise-unmet.md",
-          note: "comment, not-planned close, release \u2014 in that order"
-        }
-      ],
-      flags: [
-        {
-          names: [EVIDENCE_FILE],
-          description: "the verdict comment: the measured values and why the close condition holds; an empty file is refused"
-        }
-      ]
-    }
-  },
-  "issue:already-done": {
-    script: "scripts/issue/issue-already-done-cli.ts",
-    description: "Exit an issue whose work is already merged: post the evidence, apply already-done, close it when a cited PR is merged or a cited commit is on main, release the hold",
-    category: "AI tools",
-    // Releasing the hold runs `run:hold`, which reaches the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [EVIDENCE_REFERENCE, "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "4130 --evidence-file .josh/tmp/already-done.md",
-          note: "comment, label, close on a merged PR or a commit on main, release \u2014 in that order"
-        }
-      ],
-      flags: [
-        {
-          names: [EVIDENCE_FILE],
-          description: "the evidence comment: the merging PR or commit and, per acceptance criterion, its `file:line`. An empty file is refused before anything is written."
-        }
-      ]
-    }
-  },
-  "issue:measured": {
-    script: "scripts/issue/issue-measured-cli.ts",
-    description: "Complete a measurement-only issue: post the result, label it measured, close it, release the hold",
-    category: "AI tools",
-    // Releasing the hold runs `run:hold`, which reaches the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [`${EVIDENCE_REFERENCE} [--unmet]`, "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "4452 --evidence-file .josh/tmp/measured.md",
-          note: "comment, label, close, release \u2014 in that order"
-        },
-        {
-          arguments: "4452 --unmet --evidence-file .josh/tmp/measured.md",
-          note: "the measurement fell short of the expected effect: measured:unmet as well"
-        }
-      ],
-      flags: [
-        {
-          names: [EVIDENCE_FILE],
-          description: "the result comment: per acceptance criterion, the measurement and the run it came from. An empty file is refused before anything is written."
-        },
-        {
-          names: ["--unmet"],
-          description: "the measurement fell short of the expected effect it checked; adds the measured:unmet label `josh effect:audit` reads"
-        }
-      ]
-    }
-  },
-  "issue:file": {
-    script: "scripts/issue/issue-file-main.ts",
-    description: "File an Issue: filing cap, fold, one pass naming each refusal (lint, Origin, auto-ok, start condition, WIP cap, scout), labels, epic:bundle",
-    category: "AI tools",
-    reference: [
-      "<title> --body-file <path> | --batch <dir|file> [--route <route>] [--label <name>] [--defect yes|no|unknown] [--verification yes|no|unknown] [--every-run yes|no|unknown] [--repo <owner/repo>] [--distinct <N,\u2026>] [--found-during <N>] [--over-cap] [--no-auto-ok] [--release] [--blocks-finder] [--check]",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: '"<title>" --body-file .josh/tmp/body.md' },
-        {
-          arguments: '"<title>" --body-file .josh/tmp/body.md --route tier-a --repo joshuafolkken/kit'
-        },
-        { arguments: '"<title>" --body-file .josh/tmp/body.md --distinct 2801,2795' },
-        { arguments: "--batch .josh/tmp/deferred --route tier-a" },
-        { arguments: "--batch .josh/tmp/deferred.md --route tier-a" }
-      ],
-      flags: [
-        { names: [BODY_FILE], description: "the body. Required unless `--batch`." },
-        {
-          names: ["--batch <dir|file>"],
-          description: "file each `*.md` in `<dir>` by name, or each `%%%`-separated part of `<file>`, other flags applied to each; every scout report prints once before the first filing. Title: front matter `title:`, else the first line; front matter `distinct: <N,\u2026>` is its `--distinct`. A refused filing stays unfiled, the rest are filed, the summary names each; any refusal exits 1."
-        },
-        {
-          names: ["--route <tier-a|split|interrupt|review-cap>"],
-          description: "the `route:` label naming the filing route. Omit it for a filing with no route."
-        },
-        {
-          names: ["--label <name>"],
-          description: "an extra label (e.g. `epic`). Repeatable. With `josh.worker`, `worker:<name>` names a printed profile."
-        },
-        {
-          names: ["--defect / --verification / --every-run <yes|no|unknown>"],
-          description: "`--label run:solo` requires all three `yes`: a verification defect affecting unrelated PRs every run. Missing, invalid, `no` or `unknown` answers file nothing; success comments the three answers on the issue."
-        },
-        {
-          names: [REPO2],
-          description: "the target repository. Defaults to this repository."
-        },
-        {
-          names: [DISTINCT],
-          description: "duplicate candidates you read and judged distinct."
-        },
-        {
-          names: ["--found-during <N>"],
-          description: "the Issue whose work the filing came from, when it is not the lane or branch Issue. The filing cap counts per origin (step 2); step 7 never holds it as a candidate here. #N gets a deferral comment."
-        },
-        {
-          names: ["--over-cap"],
-          description: "the run is blocked by this filing, or a user typed `new` (`kickoff` / `fullrun` / `halfrun` / `prrun new`, whose filing commands carry it); the WIP cap lets it through."
-        },
-        {
-          names: ["--no-auto-ok"],
-          description: "needs human judgement or a verified user prohibition; no `auto-ok`."
-        },
-        {
-          names: ["--release"],
-          description: "a consumer can use the change only once it is published. The filed issue becomes a blocker of the target's release issue (step 10)."
-        },
-        {
-          names: [BLOCKS_FINDER],
-          description: "with `--route interrupt`, the finder cannot go on until this issue is done. The finder is recorded as blocked by the filed issue (step 9); under an epic, `epic --reconcile <E>` after `epic --add` declares it."
-        },
-        {
-          names: ["--check"],
-          description: "run steps 1\u20137, create nothing; exit 1 on a refusal. `--batch` refuses it."
-        }
-      ]
-    }
-  },
-  "issue:spill": {
-    script: "scripts/issue/issue-spill-main.ts",
-    description: "Move an issue's unchecked acceptance criteria into a follow-up filed by `issue:file --route split`, placed after it in its epic (or a new one), leaving one link line",
-    category: "AI tools",
-    reference: [
-      `<issue> --estimate "<F> \u30D5\u30A1\u30A4\u30EB / <L> \u884C" [--reason "<\u7406\u7531>"] [${DISTINCT}]`,
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [{ arguments: '5999 --estimate "3 \u30D5\u30A1\u30A4\u30EB / 80 \u884C"' }],
-      flags: [
-        {
-          names: ['--estimate "<F> \u30D5\u30A1\u30A4\u30EB / <L> \u884C"'],
-          description: "the follow-up's size estimate, never apportioned from the issue's. Required."
-        },
-        {
-          names: ['--reason "<\u7406\u7531>"'],
-          description: `the follow-up's \`${issue_body_keys.prefix("no_split_reason")}\` line, the only excuse from the size bar; the issue's own is not carried over.`
-        },
-        {
-          names: [DISTINCT],
-          description: "duplicate candidates `issue:file` held the follow-up on, declared separate; the issue itself always is. Repeatable."
-        }
-      ]
-    }
-  },
-  "upstream:interrupt": {
-    script: "scripts/issue/upstream-interrupt-main.ts",
-    description: "Stop for a defect in another package in one call: stash, file the upstream issue, backlink it on the finder, send the confirmation",
-    category: "AI tools",
-    reference: [
-      `<finder> <title> ${REPO2} ${BODY_FILE} [--blocks-finder]`,
-      "automation",
-      ["git", "network", "notifications"]
-    ],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        {
-          arguments: '2304 "<root-cause title>" --repo joshuafolkken/kit --body-file .josh/tmp/body.md'
-        }
-      ],
-      flags: [
-        { names: [REPO2], description: "the upstream repository. Required." },
-        { names: [BODY_FILE], description: "the upstream issue body. Required." },
-        {
-          names: [BLOCKS_FINDER],
-          description: "passed to `issue:file`: the finder is recorded as blocked by the filing."
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-issue.ts
-var REPO3 = "--repo <owner/repo>";
-var CONCURRENT = "several numbers, read concurrently";
-var REPO_FLAG = {
-  names: [REPO3],
-  description: "read an issue in another repository; applies to every number."
-};
-var BODY_FILE2 = "--body-file <path>";
-var JSON_FLAG = { names: ["--json"], description: "print the verdict and reason as JSON." };
-var ISSUES_WITH_REPO = "<issue...> [--repo <owner/repo>]";
-var ISSUE_COMMANDS = {
-  "issue:ack": {
-    script: "scripts/issue/issue-ack-cli.ts",
-    description: "Record that the run read a person's update to its issue, printing the update it acknowledges",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["network"]],
-    usage: { examples: [{ arguments: "3773" }] }
-  },
-  "issue:priority": {
-    script: "scripts/issue/issue-priority-cli.ts",
-    description: "Raise an issue to the priority its body declares or reaches, or set the one a person instructs",
-    category: "AI tools",
-    reference: ["<issue> [--critical|--high|--normal --reason <text>]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "4960" },
-        {
-          arguments: '6707 --critical --reason "asked in this turn"',
-          note: "on a person's instruction only"
-        },
-        {
-          arguments: '6683 --normal --reason "asked in this turn"',
-          note: "lowers it the same way"
-        }
-      ]
-    }
-  },
-  "issue:read": {
-    script: "scripts/issue/issue-read-main.ts",
-    description: "Print each issue's title, body and every comment on it, in one call",
-    category: "AI tools",
-    reference: [ISSUES_WITH_REPO, "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "1715" },
-        { arguments: "1715 1567 1605", note: CONCURRENT },
-        { arguments: "42 --repo joshuafolkken/app-kit", note: "an issue in another repo" }
-      ],
-      flags: [REPO_FLAG]
-    }
-  },
-  "issue:state": {
-    script: "scripts/issue/issue-state-main.ts",
-    description: "Print each issue's state and labels, in the spelling the documents compare against",
-    category: "AI tools",
-    reference: [ISSUES_WITH_REPO, "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "42", note: "single-number shape" },
-        { arguments: "42 43 44", note: "each block headed by `issue:`" },
-        { arguments: "42 43 --repo joshuafolkken/app-kit", note: "a child in another repo" }
-      ],
-      flags: [REPO_FLAG]
-    }
-  },
-  "issue:scout": {
-    script: "scripts/issue/issue-scout-main.ts",
-    description: "Before filing: say whether an issue like this exists and which epic it belongs to",
-    category: "AI tools",
-    reference: ["<title> [--body <summary> | --body-file <path>]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: '"Stop the gate re-running after every edit"' },
-        { arguments: '"<title>" --body "parent: #1246"' },
-        { arguments: '"<title>" --body-file .josh/tmp/draft.md' }
-      ],
-      flags: [
-        {
-          names: ['--body "<text>"'],
-          description: "supply references (`#N`) in a `parent: #N` line or an acceptance-criteria section so the epic half has a number to work from; without one there (a background mention does not count) it prints `Epic: not asked`."
-        },
-        {
-          names: [BODY_FILE2],
-          description: 'pass the whole draft, including its purpose, requirements and acceptance criteria. A file that cannot be read ends the command rather than being treated as "no candidates".'
-        }
-      ]
-    }
-  },
-  "defect:origin": {
-    script: "scripts/issue/defect-origin-main.ts",
-    description: "List the merged pull requests that last changed what a defect issue names, as candidates for its origin line",
-    category: "AI tools",
-    reference: ["<N>", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: "4241", note: "newest first, merged before the issue was filed" }]
-    }
-  },
-  "defect:report": {
-    script: "scripts/issue/defect-report-main.ts",
-    description: "Count defects by the origin pull request their issue declares, by change kind and by area",
-    category: "AI tools",
-    reference: ["", "automation", ["network"]],
-    usage: { examples: [{ arguments: "", note: "every issue labelled bug, open or closed" }] }
-  },
-  "effect:audit": {
-    script: "scripts/issue/effect-audit-cli.ts",
-    is_read_only: true,
-    write_flags: ["--draft"],
-    description: "List closed run-time-shortening issues with their expected effect, follow-up measurement and result",
-    category: "AI tools",
-    reference: ["[--days <N>] [--draft <issue>]", "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "issues closed in the last 30 days, one line each" },
-        { arguments: "--days 7", note: "a shorter window" },
-        {
-          arguments: "--draft 4896",
-          note: "write the retirement candidate of a shortfall and print its issue:file line"
-        }
-      ],
-      flags: [
-        { names: ["--days <N>"], description: "the window, in days back from now (default 30)" },
-        {
-          names: ["--draft <issue>"],
-          description: "an issue whose measurement carries measured:unmet: write its retirement-candidate body to a temporary file"
-        }
-      ]
-    }
-  },
-  "issue:fold": {
-    script: "scripts/issue/issue-fold-main.ts",
-    description: "Before a second filing: say whether findings from this session fold into one issue",
-    category: "AI tools",
-    reference: ["<title>... [--not-separable] [--json]", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: '"First finding" "Second finding"',
-          note: "fold | separate | no-fold-needed | undetermined"
-        },
-        { arguments: '"a" "b" --not-separable', note: "the pair is really one deliverable \u2192 fold" },
-        { arguments: '"a" "b" --json', note: "the verdict and reason, machine-readable" }
-      ],
-      flags: [
-        {
-          names: ["--not-separable"],
-          description: "declare the judgement half: the findings are one deliverable, so they fold whatever their size."
-        },
-        JSON_FLAG
-      ]
-    }
-  },
-  "issue:fold-existing": {
-    script: "scripts/issue/issue-fold-existing-cli.ts",
-    description: "Assess whether a complete draft can join an unstarted issue",
-    category: "AI tools",
-    reference: [
-      "<assessment.json> [--json | --apply <N> [--blocked <M> | --found-during <M>]] | --fingerprint <N>",
-      "automation",
-      ["network"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: "--fingerprint 5848",
-          note: "read the comment fingerprint before assessment."
-        },
-        { arguments: "assessment.json --json" },
-        {
-          arguments: "assessment.json --apply 5848",
-          note: "apply and verify the assessed fold and priority floor."
-        },
-        {
-          arguments: "assessment.json --apply 5848 --blocked 5849",
-          note: "record a confirmed duplicate dependency and reconcile its epic."
-        },
-        {
-          arguments: "assessment.json --apply 5848 --found-during 5849",
-          note: "record a split fold as lane 5849's split child."
-        }
-      ]
-    }
-  },
-  "issue:cite": {
-    script: "scripts/issue/issue-cite-main.ts",
-    description: "Print the paste-ready number-link citation line for each issue, in one call",
-    category: "AI tools",
-    reference: [ISSUES_WITH_REPO, "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "2220" },
-        { arguments: "2220 1758 1252", note: CONCURRENT },
-        {
-          arguments: "45 --repo joshuafolkken/app-kit",
-          note: "bare numbers in another repository"
-        },
-        { arguments: "joshuafolkken/app-kit#45 2220", note: "per-token owner/repo#N notation" }
-      ],
-      flags: [
-        {
-          names: [REPO3],
-          description: "the repository for every bare number; a token written `owner/repo#N` overrides it for itself."
-        }
-      ]
-    }
-  },
-  ...ISSUE_WRITE_COMMANDS,
-  "plan:consumers": {
-    script: "scripts/issue/plan-consumers-main.ts",
-    description: "List every existing reference to each identifier a plan adds or changes, by kind, and draft the plan's existing-consumers section",
-    category: "AI tools",
-    reference: ["<identifier...>", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "lane:pause" },
-        { arguments: "lane:pause run:paused", note: "one block per identifier, one draft" }
-      ]
-    }
-  },
-  "issue:release": {
-    script: "scripts/issue/issue-release-main.ts",
-    description: "Link an Issue to the repository's open release Issue as its blocker (or, with --wait, as waiting on it), filing one when none is open",
-    category: "AI tools",
-    reference: ["<issue> [--wait]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "3360" },
-        { arguments: "3716 --wait", note: "blocked by the release issue instead" }
-      ],
-      flags: [
-        {
-          names: ["--wait"],
-          description: "the issue is blocked by the release issue instead, so `backlog:next` offers it again once the release ships (`.claude/skills/workflow-commands/prerequisite.md`)."
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-review.ts
-var LEVEL_ONLY = "--level-only";
-var CHECK = "--check";
-var MACHINE_READABLE = "the verdict and the reason, machine-readable";
-var JSON_FLAG2 = "--json";
-var RECORD = "--record";
-var FULL_CHANGE = "--full-change";
-var REVIEW_COMMANDS = {
-  "review:brief": {
-    script: "scripts/review/review-brief-main.ts",
-    description: "Print the whole /code-review invocation: level, what the gate already proved, target (--level-only for the level alone)",
-    category: "AI tools",
-    reference: [
-      "[--round <1|2> | --full-change] | --interaction | --level-only [--staged] [--json]",
-      "automation",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "round 1" },
-        { arguments: "--round 2", note: "verification pass, scoped to the fix delta" },
-        { arguments: FULL_CHANGE, note: "final round 2 over the whole change" },
-        { arguments: "--interaction", note: "the interaction review of a run-tooling change" },
-        { arguments: LEVEL_ONLY, note: "the level alone (pre-commit review)" },
-        { arguments: "--level-only --json", note: "level and reason, machine-readable" }
-      ],
-      flags: [
-        {
-          names: [FULL_CHANGE],
-          description: "final round 2 over the whole change (no `--round` or `--interaction`)."
-        },
-        {
-          names: ["--round 2"],
-          description: "target is round 1's fixes and nothing else (widened back to the whole change when the record's change base no longer matches)."
-        },
-        {
-          names: [LEVEL_ONLY],
-          description: "print the level alone (level to stdout, reason to stderr); bypasses the scoped-green refusal."
-        },
-        {
-          names: ["--staged", "--json"],
-          description: "the staged diff; machine-readable level and reason."
-        }
-      ]
-    }
-  },
-  "review:attest": {
-    script: "scripts/review/review-attest-cli.ts",
-    description: "Record, or verify, which checkout a /code-review actually read",
-    category: "AI tools",
-    reference: ["<nonce> | --check", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "<nonce>", note: "run by the review, from the checkout it read" },
-        { arguments: CHECK, note: "run by the run, before it acts on the review" }
-      ],
-      flags: [
-        { names: ["<nonce>"], description: "attest the checkout the review read." },
-        {
-          names: [CHECK],
-          description: "verify before acting; `josh followup` asks again before merging."
-        }
-      ]
-    }
-  },
-  "review:submit": {
-    script: "scripts/review/review-submit-cli.ts",
-    description: "Write a reviewer's findings, read from stdin, where the ship or review:record --from-slot reads them; --review lints the review in the same call",
-    category: "AI tools",
-    reference: [
-      "[--interaction] [--review <absolute-path> [--round <1|2>]] < findings | \u2026 --none",
-      "automation",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "< findings.txt", note: "the /code-review slot" },
-        { arguments: "--interaction < findings.txt", note: "the interaction review slot" },
-        { arguments: "--none", note: "a review with no findings" },
-        {
-          arguments: '--review "$PWD/review.md" < findings.txt',
-          note: "lint the review and submit the findings in one call"
-        }
-      ],
-      flags: [
-        {
-          names: ["--none"],
-          description: "a review with no findings; empty stdin without it is refused."
-        },
-        {
-          names: ["--review <absolute-path>"],
-          description: "the reviewer's markdown review, by absolute path (josh runs from the package root, so a relative path is refused), linted against the rubric's output format in the same call; a violation and a grammar refusal are reported together, and nothing is written while either stands."
-        },
-        {
-          names: ["--round <1|2>"],
-          description: "the rubric shape `--review` is linted against; round 1 by default."
-        }
-      ]
-    }
-  },
-  "review:pair": {
-    script: "scripts/review/review-pair-cli.ts",
-    description: "Record a paired comparison under JOSH_REVIEWER_PAIRED=1: the Opus and Sonnet round-1 findings with severity and each agent cost; never gates",
-    category: "AI tools",
-    reference: ["--issue <N> --opus-agent <id> --sonnet-agent <id>", "automation", ["files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "--issue 6902 --opus-agent a1b2 --sonnet-agent c3d4",
-          note: "after both round-1 reviewers return, before review:record"
-        }
-      ],
-      flags: [
-        {
-          names: ["--opus-agent <id>", "--sonnet-agent <id>"],
-          description: "each reviewer's agentId, whose transcript prices its cost."
-        }
-      ]
-    }
-  },
-  // The self-check's "Prose matches the code" as a search: each word the diff removed that prose still names.
-  "prose:stale": {
-    script: "scripts/review/prose-stale-cli.ts",
-    description: "List each removed declared or exported name, josh command, UPPER_CASE constant or .md heading that docs, prompts or comments still name",
-    category: "AI tools",
-    reference: ["", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "\u2192 `file:line kind word` per reference, or `ok` (exit 1 / 0; 2 on a failure)"
-        }
-      ]
-    }
-  },
-  "review:selfcheck": {
-    script: "scripts/review/selfcheck-cli.ts",
-    description: "Answer the pre-commit self-check questions 2, 4 and 10 \u2014 stale prose, untouched readers, new command examples run \u2014 in one command",
-    category: "AI tools",
-    reference: ["[--interaction-answered]", "automation", ["files", "processes"]],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "\u2192 `file:line` per finding, then one `selfcheck: pass|fail` line (exit 0 / 1; 2 on a failure)"
-        },
-        {
-          arguments: "--interaction-answered",
-          note: "\u2192 a passing, due run also records the issue's interaction round"
-        }
-      ]
-    }
-  },
-  "diff:summary": {
-    script: "scripts/review/diff-summary-cli.ts",
-    description: "Print the diff from the change base as one table \u2014 lines, hunks, ranges and declarations per file \u2014 and save it whole",
-    category: "AI tools",
-    reference: ["[<base>]", "automation", ["files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "\u2192 one row per file, then `full output: <path>` (the diff, in the git directory)"
-        },
-        { arguments: "HEAD", note: "\u2192 the same, against a named base" }
-      ]
-    }
-  },
-  "review:round2": {
-    script: "scripts/review/review-round2-cli.ts",
-    description: "Say whether the second /code-review round is due, or may be skipped entirely",
-    category: "AI tools",
-    reference: ["[--record <N>] [--json]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "\u2192 required | skip, for the branch\u2019s issue" },
-        { arguments: `${RECORD} 123`, note: "\u2192 required | skip, a skip commented on that issue" },
-        { arguments: JSON_FLAG2, note: MACHINE_READABLE }
-      ],
-      flags: [
-        {
-          names: [RECORD],
-          description: "the issue whose ledger dispositions decide round 1\u2019s closure \u2014 skip only when every High/Medium is `fixed` or `false-positive` \u2014 and where a skip is commented under `## Round 2 skipped`, once."
-        },
-        { names: [JSON_FLAG2], description: "machine-readable verdict and reason." }
-      ]
-    }
-  },
-  delegate: {
-    script: "scripts/delegation/delegation-cli.ts",
-    description: "Say whether a run step may go to a cheaper execution tier",
-    category: "AI tools",
-    reference: ["<step> | --list", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "gate-fix", note: "\u2192 delegate" },
-        { arguments: "review", note: "\u2192 keep" },
-        { arguments: "--list", note: "the enumeration, and what was rejected and why" }
-      ]
-    }
-  },
-  fanout: {
-    script: "scripts/delegation/fanout-cli.ts",
-    description: "Say whether proposed implementation units are file-disjoint, so they may run in parallel",
-    category: "AI tools",
-    reference: ["<unit-files> <unit-files> [<unit-files> \u2026]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "scripts/a.ts,scripts/a.test.ts scripts/b.ts", note: "\u2192 parallel" },
-        {
-          arguments: "scripts/a.ts,shared.ts scripts/b.ts,shared.ts",
-          note: "\u2192 serial (units share shared.ts)"
-        },
-        { arguments: "scripts/a.ts", note: "\u2192 serial (fewer than two units)" }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-pause.ts
-var PAUSE_COMMANDS = {
-  "run:pause": {
-    script: "scripts/run/pause/run-pause-cli.ts",
-    description: "Set a run aside while its prerequisite lands first",
-    category: "AI tools",
-    // `run:release` underneath can send the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: ["<issue> --for <prerequisite>", "automation", ["git", "network", "files"]],
-    usage: {
-      examples: [{ arguments: "1091 --for 1102", note: "pause 1091 until 1102 lands" }],
-      flags: [
-        {
-          names: ["--for <prerequisite>"],
-          description: "the issue that has to land first; `<issue>` is recorded blocked by it."
-        }
-      ]
-    }
-  },
-  "run:split": {
-    script: "scripts/run/split/run-split-cli.ts",
-    description: "Set a run aside and place its split or prerequisite into an epic in one call",
-    category: "AI tools",
-    // `run:release` underneath can send the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [
-      "<issue> (--children <N1,N2,...> [--ordered] | --prerequisite <P>) [--title <title>]",
-      "automation",
-      ["git", "network", "files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: '1091 --children 1102,1103 --title "Split 1091"', note: "independent split" },
-        { arguments: "1091 --children 1102 --ordered", note: "1102 after 1091" },
-        { arguments: '1091 --prerequisite 1104 --title "1104 then 1091"', note: "1104 first" }
-      ],
-      flags: [
-        {
-          names: ["--children <N1,N2,...>"],
-          description: "the filed split issues, comma-separated."
-        },
-        { names: ["--ordered"], description: "`<issue>` first, then the children in that order." },
-        {
-          names: ["--prerequisite <P>"],
-          description: "the filed issue that has to land first; `<issue>` is paused on it."
-        },
-        {
-          names: ["--title <title>"],
-          description: "the new epic\u2019s title; required when no epic tracks `<issue>` yet."
-        }
-      ]
-    }
-  },
-  "run:stale": {
-    script: "scripts/run/stale/run-stale-main.ts",
-    description: "Remove a stale `in-progress` label no checkout still holds",
-    category: "AI tools",
-    reference: ["", "automation", ["git", "network", "files"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "tree:status": {
-    script: "scripts/run/tree-status-cli.ts",
-    description: "Bundle the working tree\u2019s read-only pre-check: branch, status, stash list, run hold",
-    category: "AI tools",
-    // Reads the branch, status, stash list and hold only; a consultation scope runs it.
-    is_read_only: true,
-    reference: ["", "automation", ["git", "files"]],
-    usage: { examples: [{ arguments: "" }] }
-  }
-};
-
-// scripts/josh/josh-commands-prime.ts
-var PRIME_COMMANDS = {
-  "run:tidy": {
-    script: "scripts/run/tidy/run-tidy-main.ts",
-    description: "Close merged lanes and drop stashes whose issues are all merged",
-    category: "AI tools",
-    reference: ["", "automation", ["git", "network", "files"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "run:prime": {
-    script: "scripts/run/prime/run-prime-cli.ts",
-    description: "Prepare the primary checkout once before a backlogrun\u2019s first lane: main:sync, latest:if-required, the update stashed, lane:prune, run:tidy",
-    category: "AI tools",
-    // `latest:if-required` underneath runs `josh latest`, which reads `.env`.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: ["", "automation", ["git", "network", "files", "processes"]],
-    usage: {
-      examples: [{ arguments: "", note: "prints `latest <scope>` and `stash <message>|clean`" }]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-progress.ts
-var PROGRESS_COMMANDS = {
-  "run:progress": {
-    script: "scripts/run/progress/run-progress-main.ts",
-    description: "Report an unattended run\u2019s progress once it has gone quiet for an interval",
-    category: "AI tools",
-    reference: [
-      "[--once | --wait] [--interval <minutes>] [--hours <hours>] [--repo <owner/repo>] [--output <path>] | --mark | --path",
-      "automation",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "--output <path>" },
-        { arguments: "--once", note: "five labelled lines now, whatever the clock says" },
-        { arguments: "--interval 20 --repo joshuafolkken/app-kit --hours 4" }
-      ],
-      flags: [
-        {
-          names: ["--mark"],
-          description: "record that a real report happened without printing a line (keeps the last line for `run:wake --list`)."
-        },
-        {
-          names: ["--path"],
-          description: 'print the ambient heartbeat log\'s path and exit. Every heartbeat line is mirrored there, so `tail -F "$(pnpm josh run:progress --path)"` follows the run across a `backlogrun` session cut. Reads no run state, so it answers in a lane child too.'
-        },
-        {
-          names: ["--interval <min>"],
-          description: "silence interval (default 20; also `JOSH_PROGRESS_INTERVAL_MINUTES`, then `josh.progress_interval_minutes`)."
-        },
-        {
-          names: ["--wait"],
-          description: 'start once in the background: as it starts it prints `progress-watcher.md` \u2192 "Progress while the run is quiet" once per session (a repeat names it in one line \u2014 `run:entry` has printed it first outside a lane child); each report then goes to the event stream and ambient log, never stdout; exits only on an arrival, `josh followup` ending the run, or `--hours`.'
-        },
-        {
-          names: ["--hours <n>"],
-          description: "how long the watcher lives (default 8 with `--wait`, 1 otherwise)."
-        },
-        { names: ["--repo <owner/name>"], description: "scopes the read." }
-      ]
-    }
-  },
-  "run:board": {
-    script: "scripts/run/board/run-board-main.ts",
-    // `--every` pushes its frame as a Telegram, so the credentials come from `.env` as for `run:carry`.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Draw a live board of the running backlogrun, redrawn every second",
-    category: "AI tools",
-    reference: ["[--once | --chat | --every <minutes>]", "automation", ["files", "network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "redraw until interrupted" },
-        { arguments: "--once", note: "one frame, then exit" },
-        { arguments: "--chat", note: "one frame for a chat, recorded as a progress report" },
-        {
-          arguments: "--every 5",
-          note: "the --chat frame as a \u{1F4CA} Progress Telegram every 5 minutes, until the run ends"
-        }
-      ],
-      flags: [
-        {
-          names: ["--chat"],
-          description: "answers a `backlogrun`, `fullrun` or `halfrun` progress question: the frame `--once` draws, with only `\u{1F9E0}` on the machine line and no escapes; it records the report as `run:progress --mark` does."
-        },
-        {
-          names: ["--every <minutes>"],
-          description: "sends the `--chat` frame as a `\u{1F4CA} Progress` Telegram now and every `<minutes>` until the run ends \u2014 only when a person asks for it."
-        }
-      ]
-    }
-  },
-  "run:pickup": {
-    script: "scripts/run/run-pickup-cli.ts",
-    description: "Pick the lanes up after a manual cut: launch what the epics offer, then each liveness and the watcher line",
-    category: "AI tools",
-    reference: ["[<epic>...]", "automation", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "one line per lane, then the watcher line" },
-        {
-          arguments: "5800",
-          note: "first one line per child the epic offers: launched, refused or its verdict"
-        }
-      ]
-    }
-  },
-  "run:handoff-lanes": {
-    script: "scripts/run/handoff-lanes/run-handoff-lanes-cli.ts",
-    description: "Chain a backlogrun hand-off: cost --cut, the lane reading, run:carry --cut, run:board --chat and run:report --handoff, answering under, cut, blocked or capped",
-    category: "AI tools",
-    reference: ["", "automation", ["processes", "files", "network"]],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "after each child\u2019s merge; prints the verdict line, then its next action"
-        }
-      ]
-    }
-  },
-  "run:handoff": {
-    script: "scripts/run/handoff/run-handoff-cli.ts",
-    description: "Hand a workflow keyword typed in a consultation session to a child on the role profile model",
-    category: "AI tools",
-    reference: ["<keyword> [N|new ...] --brief-file <path>", "automation", ["processes", "files"]],
-    usage: {
-      examples: [
-        {
-          arguments: "kickoff new --brief-file .josh/tmp/brief.md",
-          note: "waits; prints its final message and URLs"
-        },
-        {
-          arguments: "fullrun <N> --brief-file .josh/tmp/brief.md",
-          note: "detached; a bare N is #N; check it with run:progress --once"
-        },
-        {
-          arguments: "backlogrun <E> --only",
-          note: "josh backlogrun with this session\u2019s --agent"
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-run.ts
-var OWNER = "--owner <pid>";
-var OUTPUT = "--output <path>";
-var REPO_FLAG2 = { names: ["--repo <owner/name>"], description: "a child in another repository." };
-var ISSUE = { arguments: "<N>" };
-var RUN_HOLD_SCRIPT = "scripts/run/hold/run-hold-main.ts";
-var RUN_COMMANDS = {
-  "run:hold": {
-    script: RUN_HOLD_SCRIPT,
-    description: "Claim this working tree for a run, or say which run already holds it",
-    category: "AI tools",
-    // A `--halfrun-stop` / `--human-review-stop` / `--prrun-stop` sends the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [
-      "[<issue> [--fullrun | --halfrun-stop | --human-review-stop | --prrun-stop]] | --adopt <issue>",
-      "automation",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "1091", note: "claim for issue 1091" },
-        { arguments: "1091 --fullrun", note: "claim as `fullrun #1091` (what `run:entry` runs)" },
-        { arguments: "--adopt 1091", note: "hand a `new` run's hold to the issue it filed" }
-      ],
-      flags: [
-        { names: ["--fullrun"], description: "marks the record as `fullrun #N`'s." },
-        {
-          names: ["--adopt <issue>"],
-          description: "re-keys the unnumbered `new` run's record to the filed issue and applies `in-progress`; answers `none` (exit 1) when the tree holds no record."
-        },
-        {
-          names: ["--halfrun-stop"],
-          description: "marks a `halfrun` stop for `run:entry` to adopt, and sends its `confirmation` Telegram; answers `e2e-owed` (exit 1) until `test:e2e` answered green on this tree."
-        },
-        {
-          names: ["--human-review-stop"],
-          description: "marks a `halfrun` stop and a `human-review` lane, retaining its tree and hold. Sends `confirmation`; its worker's exit frees the execution place. Answers `e2e-owed` (exit 1) until `test:e2e` is green on this tree."
-        },
-        {
-          names: ["--prrun-stop"],
-          description: "marks a `prrun` stop with the commit its pull request is on, and sends its `confirmation` Telegram."
-        }
-      ]
-    }
-  },
-  "run:release": {
-    script: RUN_HOLD_SCRIPT,
-    description: "Release this working tree's run record",
-    category: "AI tools",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: ["[issue|--force]", "automation", ["files"]],
-    default_script_arguments: ["--release"],
-    usage: {
-      examples: [
-        { arguments: "1091", note: "release this run's own record" },
-        { arguments: "--force", note: "clear a record left by a run that has ended" }
-      ],
-      flags: [
-        {
-          names: ["--force"],
-          description: "removes a record this run did not write, clearing another run's stale claim."
-        }
-      ]
-    }
-  },
-  ...PAUSE_COMMANDS,
-  ...PRIME_COMMANDS,
-  "run:carry": {
-    script: "scripts/run/carry/run-carry-cli.ts",
-    // `--stopped` sends the stop confirmation, so the Telegram credentials come from `.env` as for
-    // `run:wake` below.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Carry one invocation\u2019s budget across its own session cuts",
-    category: "AI tools",
-    reference: ["<operation> [arguments...]", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: '--begin "backlogrun --max 5"' },
-        { arguments: "--json", note: "read the record back in a resumed session" },
-        { arguments: "--cut", note: "hand the record off before a cut" },
-        {
-          arguments: '--retrospective --summary "0 filed; dropped #2240 already merged"',
-          note: "close the end-of-run retrospective"
-        },
-        { arguments: '--resume "backlogrun --max 5"', note: "adopt a record no cut handed off" },
-        {
-          arguments: '--end --stopped "epic #2126: everything is blocked behind parked #2118"',
-          note: "end + push"
-        }
-      ],
-      flags: [
-        {
-          names: [OWNER],
-          description: "the long-lived process spending the budget; omitted, the `CLAUDE_PID` of the calling Claude session (none elsewhere, e.g. Codex). Read by counts and `--begin` / `--resume`. A live PID stays `busy` if probes fail."
-        },
-        { names: ["--done <issue>"], description: "shrinks a named-issue run's `remaining` list." },
-        {
-          names: ["--merged <issue>"],
-          description: "names the merged issue and counts it once against `merged_issues`, so a merge `run:merge` already recorded is not counted twice."
-        },
-        { names: ["--filed", "--cut"], description: "increments, never totals." },
-        {
-          names: ["--retrospective"],
-          description: "marks the end-of-run retrospective run, once per invocation, and requires `--summary <text>` \u2014 the same close writes that result as one `retrospective` event on the run's event stream (best-effort), so a run that filed zero improvements reads apart from one whose retrospective never ran. Either flag without the other is refused."
-        },
-        {
-          names: ["--stopped <reason>"],
-          description: "rides on `--end`: the run stopped rather than finished, so one \u23F8\uFE0F confirmation is pushed with the reason."
-        },
-        {
-          names: ["--end"],
-          description: "over a live record flushes pending ledger lines once (a failed flush goes to stderr and the record is still cleared); first collects each lane the run launched whose issue merged, exactly as `run:merge` would; keeps the run it removes as the last ended run \u2014 its invocation, start and end, one record overwritten by the next `--end` \u2014 so `run:board` can still draw a finished run."
-        }
-      ]
-    }
-  },
-  "run:add": {
-    script: "scripts/run/add/run-add-cli.ts",
-    description: "Add issues to a live backlogrun, ahead of the queue unless --no-priority; epics become roots",
-    category: "AI tools",
-    reference: ["<issue...> [--no-priority] [--retry]", "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        { arguments: "101 102", note: "ahead of the rest of the queue (`#N` works too)" },
-        { arguments: "101 --no-priority", note: "at the end of the queue" },
-        { arguments: "101 --retry", note: "retry a mechanically stopped issue in this run" }
-      ]
-    }
-  },
-  "run:wake": {
-    script: "scripts/run/wake/run-wake-main.ts",
-    // `.env` rather than the ambient environment:
-    // the failure warning needs the Telegram credentials, the same
-    // reasons `notify` and `followup` carry these flags.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Wake the next session of a cut backlogrun from outside the conversation",
-    category: "AI tools",
-    reference: ["[options]", "automation", ["processes", "notifications"]],
-    usage: {
-      examples: [
-        { arguments: "--start", note: "launch the detached supervisor" },
-        { arguments: "--list", note: "supervisor state, cut/wake counts, latest progress line" },
-        { arguments: "--stop", note: "stop the supervisor alone" },
-        { arguments: "--loop --interval 30", note: "run the loop body in the foreground" }
-      ]
-    }
-  },
-  "run:cut": {
-    script: "scripts/run/cut/run-cut-cli.ts",
-    description: "Cut a lane child before the gate and resume a fresh process",
-    category: "AI tools",
-    reference: ["[--resume] <issue> [--impl] [--handoff <path>]", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "1839", note: "take the cut and hand it to a fresh process" },
-        {
-          arguments: "--impl 1839 --handoff .josh/tmp/handoff-1839.json",
-          note: "cut mid-implementation, carrying the instruction"
-        },
-        { arguments: "--resume 1839", note: "a fresh process's entry check" },
-        { arguments: "--end", note: "clear the record" }
-      ]
-    }
-  },
-  "run:park": {
-    script: "scripts/run/park/run-park-cli.ts",
-    description: "Park a lane child for a decision or an escalation, or clear the park",
-    category: "AI tools",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    reference: [
-      "<issue> --body-file <path> | <issue> --clear | <issue> --escalate <reason>",
-      "automation",
-      ["files", "network"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: "1839 --body-file .josh/tmp/park-1839.md",
-          note: "options, tiers and a recommendation; then needs-decision, the record, run:release"
-        },
-        { arguments: "1839 --clear", note: "remove needs-decision and the record" },
-        {
-          arguments: '1839 --escalate "needs a stronger model"',
-          note: "josh.worker.escalate only: run:stalled with the reason, resumed one profile up"
-        }
-      ]
-    }
-  },
-  "run:liveness": {
-    script: "scripts/run/run-liveness-cli.ts",
-    description: "Say whether a delegated unit is still working, or stopped without reporting",
-    category: "AI tools",
-    reference: ["<issue> --output <path> [options]", "automation", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "1169 --output <path>" },
-        { arguments: "1169 --output <path> --window 45 --gap 2 --repo joshuafolkken/app-kit" }
-      ],
-      flags: [
-        {
-          names: [OUTPUT],
-          description: "absolute, under the home or temp directory; a symlink is followed and size compared as well as mtime."
-        },
-        {
-          names: ["--process alive | none"],
-          description: "overrides the process trace, which the command otherwise reads itself: the child's own command line (`fullrun #<N>`) or its detached ship supervisor."
-        },
-        {
-          names: ["--window <min>"],
-          description: "silent window the file must be frozen for (default 30)."
-        },
-        { names: ["--gap <sec>"], description: "spacing between samples (default 5)." },
-        REPO_FLAG2
-      ]
-    }
-  },
-  "run:ending": {
-    script: "scripts/run/run-ending-cli.ts",
-    description: "Classify how a dispatched lane child ended (merged, cut, abandoned, unreadable)",
-    category: "AI tools",
-    reference: ["<issue> --output <path> [--repo <owner/repo>]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "2118 --output <path>" },
-        { arguments: "2118 --output <path> --repo joshuafolkken/app-kit" }
-      ],
-      flags: [
-        {
-          names: [OUTPUT],
-          description: "the child's transcript, absolute and under the home or temp directory (validated the same way `run:liveness --output` is)."
-        },
-        REPO_FLAG2
-      ]
-    }
-  },
-  ...PROGRESS_COMMANDS,
-  "run:prep": {
-    script: "scripts/run/run-prep-main.ts",
-    description: "Bundle a run\u2019s pre-edit reads: body, comments, state, dependency scope",
-    category: "AI tools",
-    reference: ["<issue> [--summary]", "automation", ["network"]],
-    usage: { examples: [ISSUE, { arguments: "<N> --summary", note: "the work summary skeleton" }] }
-  },
-  // The entry sequence a lane opened on, folded into one call: claim the tree,
-  // read the budget, gather the issue reads and decide the pre-implementation step. `run:hold`,
-  // `cost --cut`, `run:prep` and `run:step` were four round trips re-billing a lane's full context each.
-  "run:entry": {
-    script: "scripts/run/entry/run-entry-cli.ts",
-    // A `busy` hold or an `over` budget sends the stop confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Open a run in one call: claim the tree, read the budget, bundle the reads, decide the pre-implementation step",
-    category: "AI tools",
-    reference: ["<issue> [--to <command>] [--adopt]", "automation", ["git", "network", "files"]],
-    usage: {
-      examples: [
-        { arguments: "<N>", note: "a `fullrun`" },
-        { arguments: "<N> --to halfrun", note: "a run that goes as far as `halfrun`" },
-        { arguments: "<N> --adopt", note: "a `new` run's entry once <N> is filed" }
-      ]
-    }
-  },
-  "run:status": {
-    script: "scripts/run/run-status-cli.ts",
-    description: "Bundle a run\u2019s read-only status: issue state, cost verdict, carry counters",
-    category: "AI tools",
-    reference: ["<issue> [--repo <owner/repo>]", "automation", ["network"]],
-    usage: {
-      examples: [ISSUE, { arguments: "<N> --repo <owner/repo>", note: "a cross-repo child" }]
-    }
-  },
-  "run:next": {
-    script: "scripts/run/run-next-cli.ts",
-    description: "Print the next step a fullrun takes, computed from the run\u2019s state",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["network"]],
-    usage: { examples: [ISSUE] }
-  },
-  "run:step": {
-    script: "scripts/run/run-step-cli.ts",
-    description: "Print the run\u2019s next single action, computed from the event stream, carry record and issue state",
-    category: "AI tools",
-    reference: ["[<issue>]", "automation", ["network", "files"]],
-    usage: {
-      examples: [
-        { arguments: "<N>", note: "the run's next action for issue <N>" },
-        { arguments: "", note: "the `backlogrun` parent's next action" }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-ship.ts
-var OUTPUT2 = "--output <path>";
-var OWNER2 = "--owner <pid>";
-var ISSUE_WITH_OPTIONS = "<issue> [options]";
-var SHIP_COMMANDS = {
-  "run:merge": {
-    script: "scripts/run/merge/run-merge-main.ts",
-    description: "Collapse a backlogrun merge event into one call: confirm the child, do the post-merge steps, offer the next child",
-    category: "AI tools",
-    reference: [ISSUE_WITH_OPTIONS, "automation", ["git", "network"]],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        {
-          arguments: "<N> --epic <E> --repo <owner/repo> --output <path>",
-          note: "prints the next child number, or a verdict"
-        },
-        { arguments: "<N>", note: "backlog offer (no epic)" }
-      ],
-      flags: [
-        {
-          names: ["--epic <E>", "--repo <owner/repo>"],
-          description: "offer the epic's next children; omit both for the opted-in backlog."
-        },
-        {
-          names: [OWNER2],
-          description: "the parent's process, so the carry count respects the ownership guard; omitted, the calling session."
-        },
-        {
-          names: [OUTPUT2],
-          description: "the transcript the outage and usage-limit splits read; absent, they are off."
-        },
-        {
-          names: ["--driver"],
-          description: "the caller is `backlog:drive`, which has no context to cut and asks `backlog:offer` itself, so the merge is never handed back `over` and answers `deferred` in place of the next offer."
-        },
-        {
-          names: ["--stash"],
-          description: "before classifying, stash the lane's uncommitted work and comment the `stash:pop` line on the Issue \u2014 the stopped-unit recovery."
-        }
-      ]
-    }
-  },
-  "run:review": {
-    script: "scripts/run/review/run-review-cli.ts",
-    description: "Start test:pinned in the background, run the gate and, once it is green, write the /code-review brief to a file, printing its path (--join to join them; it stops on an unpinned change)",
-    category: "AI tools",
-    reference: [
-      '[--code-only] [--unpinned-ok "<reason>"] | --join [--fixing] | --pinned | --push',
-      "automation",
-      ["processes", "files", "git", "network"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "detach test:pinned, wait for a green gate, write the brief (the interaction brief after it where due) to a file and print its path, then launch a reviewer per brief"
-        },
-        {
-          arguments: "--code-only",
-          note: "josh ship's own open: code's brief alone, since the ship opens the interaction brief itself"
-        },
-        {
-          arguments: '--unpinned-ok "only logs"',
-          note: "check beside the pair as ever; the join prints the list and the reason and carries on past unpinned places"
-        },
-        {
-          arguments: "--join",
-          note: "after the review returns: join the gate and test:pinned; exit 3 on an unpinned change"
-        },
-        {
-          arguments: "--join --fixing",
-          note: "the join when round 1 has fixes to make: no grace on test:pinned, left running; prints the unpinned places the cache already holds"
-        },
-        {
-          arguments: "--pinned",
-          note: "read test:pinned alone (the ship's pre-detach reads it anyway); a lane child returns at once"
-        },
-        {
-          arguments: "--push",
-          note: "launched by a lane open: push and open the PR at a green gate"
-        }
-      ]
-    }
-  },
-  // The main line's chain up to the review, folded into one call: `main:merge`, `review:selfcheck`,
-  // `check:related` and `run:review` were four round trips re-billing the run's full context each.
-  "run:chain": {
-    script: "scripts/run/review/run-chain-cli.ts",
-    description: "Open the review, or --join to join, attest and record it; --ship starts ship --detach --review after a clean record. Stops at the first refusal with its next action",
-    category: "AI tools",
-    reference: [
-      '<issue> [--from <stage>] [--unpinned-ok "<reason>"] | <issue> --join [--fixing] [--from <stage>] [--ship "<title> #<N>"]',
-      "automation",
-      ["processes", "files", "git", "network"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: "<N>",
-          note: "after `run:cut <N>` alone: merge main (not in a lane child), answer the self-check, run the scoped pair, open the review"
-        },
-        {
-          arguments: "<N> --from check:related",
-          note: "resume at the stage a stop named, once the run settled it"
-        },
-        {
-          arguments: '<N> --unpinned-ok "only logs"',
-          note: "forwarded to run:review as given"
-        },
-        {
-          arguments: "<N> --join",
-          note: "join the gate, attest and record; every finding holds for disposition"
-        },
-        {
-          arguments: "<N> --join --fixing",
-          note: "the same, when round 1 has fixes to make"
-        },
-        {
-          arguments: '<N> --join --ship "<title> #<N>"',
-          note: "ship a clean round; title must match the issue. Record interaction review first."
-        }
-      ]
-    }
-  },
-  // The post-merge sequence a run closed on, folded into one call: commit the
-  // observation ledger, read the completion citations and decide the release scope. `observations:flush`,
-  // `issue:cite` and `release:scope` were three round trips re-billing the run's full context each.
-  "run:tail": {
-    script: "scripts/run/run-tail-cli.ts",
-    description: "Close a run in one call: return to the default branch, commit the observation ledger, read the citations, decide the release scope",
-    category: "AI tools",
-    reference: ["[<issue> ...]", "automation", ["git", "network"]],
-    usage: {
-      examples: [
-        { arguments: "<N>", note: "the closed issue" },
-        { arguments: "<N> <follow-up-N>", note: "and a follow-up filed this run" }
-      ]
-    }
-  },
-  // The commit-to-report region a run ships a change on, folded into one call:
-  // the gate, the commit/push/PR (`git -y`), the CI-wait merge (`followup`) and the report bookkeeping
-  // (`run:tail`) were four round trips re-billing the run's full context each. It stops at the first
-  // failed step and names it, so the run reads only the step to fix.
-  ship: {
-    script: "scripts/run/ship/run-ship-cli.ts",
-    // `.env` rather than the ambient environment: parking a lane child past the relaunch cap
-    // sends a Telegram warning, which needs the credentials.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Ship a change in one call: gate, commit/push/PR, the CI-wait merge and the report bookkeeping, stopping at the first failed step",
-    category: "AI tools",
-    reference: [
-      '"<title> #<N>" [<follow-up-N> ...] [--cite <N>] [--review [--unpinned-ok "<reason>"]] [--detach] [--body-file <path>] [--notify-message <text> | --notify-message-file <path>] | --log <N>',
-      "automation",
-      ["git", "network"]
-    ],
-    // `--log <N>` stands alone and prints a detached ship's log (`run-ship-args.ts`).
-    read_only_flags: ["--log"],
-    usage: {
-      examples: [
-        { arguments: '"<title> #<N>" --body-file .josh/tmp/evidence.md' },
-        { arguments: '"<title> #<N>" --review', note: "both review rounds inside the ship" },
-        {
-          arguments: '--detach "<title> #<N>"',
-          note: "hand the ship to a supervisor; on `launched` and `cost --cut` `under`, wait one `ship:wait` chunk"
-        },
-        { arguments: "--log <N>", note: "a detached ship's log" }
-      ],
-      flags: [
-        {
-          names: ["--body-file <path>"],
-          description: "the PR body carrying the live-execution evidence `followup` gates on, written under `.josh/tmp/`; forwarded to `git -y` alone."
-        },
-        { names: ["--notify-message <text>"], description: "forwarded to `followup` alone." },
-        {
-          names: ["--review"],
-          description: "runs round 1 beside the gate; after sync and round 1, an owed round 2 runs beside the gate and joins before the PR opens. A High or unfixed Medium stops the ship. A pre-detach `test:pinned` stop probes remaining hunks in the background for the next pre-detach."
-        },
-        {
-          names: ["--unpinned-ok <reason>"],
-          description: "forwarded to round 1's `run:review`, past `unpinned` places no test can pin."
-        },
-        {
-          names: ["--detach"],
-          description: "hands the ship to a supervisor (implied in a lane child); a stop emits `ship-stop` (`--log <N>`). The preflight, type check, unused exports, cspell, guard tests and (`--review`, under `--unpinned-ok`, given or recorded, only if round 1 is reused) `test:pinned` precede hand-off, the checks even after a preflight refusal, so one stop reports every failure."
-        }
-      ]
-    }
-  },
-  "ship:wait": {
-    script: "scripts/run/ship/run-ship-wait-main.ts",
-    description: "Wait on a detached ship through its gate and review round 1, so a stop there returns to this session (returned | passed | ended | pending)",
-    category: "AI tools",
-    reference: ["<N>", "automation", ["files", "processes"]],
-    usage: {
-      examples: [
-        {
-          arguments: "<N>",
-          note: "re-issue it on `pending` while `cost --cut` is `under`; `returned` prints the stop to fix"
-        }
-      ]
-    }
-  },
-  "ship:evidence": {
-    script: "scripts/run/ship/run-ship-evidence-cli.ts",
-    description: "Run a command and append its invocation and output tail to the ship body draft\u2019s live-evidence section (exits with the command\u2019s code)",
-    category: "AI tools",
-    reference: ["<N> [--fresh] -- <command...>", "automation", ["files", "processes"]],
-    usage: {
-      examples: [
-        {
-          arguments: "<N> -- pnpm josh <command>",
-          note: "the run picks which command is the evidence; the format is written for it"
-        },
-        {
-          arguments: "<N> --fresh -- pnpm josh <command>",
-          note: "runs it even when this tree already holds a recorded run of it"
-        }
-      ]
-    }
-  },
-  "run:event": {
-    script: "scripts/run/event/run-event-cli.ts",
-    description: "Append to, read or watch the run\u2019s append-only event stream (--append <kind> <text> | --from|--follow <n> | --watch [<n>] | --last)",
-    category: "AI tools",
-    reference: [
-      "--append <kind> <text> | --from|--follow <n> | --watch [<n>] | --last",
-      "automation",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "--append <kind> <text>", note: "append one event; prints its position" },
-        { arguments: "--from <position>", note: "every event after <position>, in order (JSON)" },
-        {
-          arguments: "--follow <position>",
-          note: "new events, waiting for one; position on stderr"
-        },
-        { arguments: "--watch [<position>]", note: "every new event, rendered, until interrupted" },
-        { arguments: "--last", note: "the newest event alone" }
-      ]
-    }
-  },
-  "run:report": {
-    script: "scripts/run/run-report-cli.ts",
-    // `.env` rather than the ambient environment: `--handoff` sends the hand-off confirmation.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Generate the session-facing report for this invocation from the run\u2019s event stream (merges, parks, cuts) with the release tail \u2014 the same text josh notify sends",
-    category: "AI tools",
-    // `--end` stops the `run:wake` supervisor process.
-    reference: [
-      '[--handoff | --end [--stopped "<reason>"]]',
-      "automation",
-      ["files", "network", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "print the report; the same text josh notify sends" },
-        {
-          arguments: "--handoff",
-          note: "print the backlogrun hand-off report and send it as the confirmation"
-        },
-        {
-          arguments: "--end",
-          note: "end the run: the report, run:carry --end, run:wake --stop \u2014 stops at a failed stage"
-        },
-        {
-          arguments: '--end --stopped "<reason>"',
-          note: "end a run that stopped: run:carry --end --stopped sends the confirmation"
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-ai.ts
-var DIR = "--dir <path>";
-var PATH_DIR = "--path <dir>";
-var BARE = { arguments: "" };
-var LANE_SIGNAL_EXAMPLES = [
-  { arguments: "4198" },
-  { arguments: "--all", note: "every open lane" }
-];
-var LANE_SCRIPT = "scripts/lane/lane-cli.ts";
-var LANE_ARGUMENTS = { script: LANE_SCRIPT, tsx_arguments: OPTIONAL_ENV_FILE_FLAGS };
-var ISSUE_WITH_OPTIONS2 = "<issue> [options]";
-var ISSUE_OR_ALL = "<issue> | --all";
-var MEASURE_ARGUMENTS = {
-  script: "scripts/lane/lane-measure-cli.ts",
-  tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
-};
-var PAUSE_ARGUMENTS = {
-  script: "scripts/lane/lane-pause-cli.ts",
-  tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-  category: "AI tools",
-  reference: [ISSUE_OR_ALL, "developer", ["processes"]]
-};
-var AI_COMMANDS = {
-  ...ISSUE_COMMANDS,
-  "pkg:scout": {
-    script: "scripts/package/package-scout-cli.ts",
-    description: "Rank package candidates by measured metrics so the Package-First tier decision is read, not judged",
-    category: "AI tools",
-    reference: ["<keywords> [--size <n>] [--issue <n>]", "automation", ["network"]],
-    usage: {
-      examples: [{ arguments: '"date formatting" --size 5' }],
-      flags: [
-        {
-          names: ["--size <n>"],
-          description: "how many candidates to fetch and rank (default 10)."
-        },
-        {
-          names: ["--issue <n>"],
-          description: "the Issue a close pair reads for reuse (default: the held run)."
-        }
-      ]
-    }
-  },
-  "stash:push": {
-    script: "scripts/git/stash/stash-push-main.ts",
-    description: "Stash the working tree, untracked files included, leaving the observation ledger",
-    category: "AI tools",
-    reference: ["<message>", "automation", ["git"]],
-    usage: {
-      examples: [{ arguments: '"backlogrun: josh latest before lanes"' }],
-      flags: [
-        {
-          names: [DIR],
-          description: "stashes that work tree (`git -C <path>`); without it the current checkout."
-        }
-      ]
-    }
-  },
-  "stash:pop": {
-    script: "scripts/git/stash/stash-pop-main.ts",
-    description: "Pop the stash matching this message, not whichever a shared stack has on top",
-    category: "AI tools",
-    reference: ["<message>", "automation", ["git"]],
-    usage: {
-      examples: [
-        { arguments: '"backlogrun: parked #2028"' },
-        {
-          arguments: '"backlogrun: josh latest before lanes" --dir "$dir"',
-          note: "into a lane's work tree"
-        }
-      ],
-      flags: [
-        {
-          names: [DIR],
-          description: "applies the pop in that work tree (`git -C <path>`); without it the pop lands in the current checkout. The stack is shared, so it reads the same either way."
-        }
-      ]
-    }
-  },
-  ...EPIC_COMMANDS,
-  ...BACKLOG_COMMANDS,
-  cost: {
-    script: "scripts/cost-runtime/cost-main.ts",
-    description: "Say whether the next turn of a run crosses the context-cut threshold (--cut) or a given tokens-per-request figure (--over)",
-    category: "AI tools",
-    reference: ["(--cut | --over <tokens-per-request>) [--path <dir>]", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "--cut",
-          note: "compare billed input per request with the context-cut threshold priced at the session model"
-        },
-        { arguments: "--over <tokens>", note: "compare with an explicit limit" },
-        { arguments: `--cut ${PATH_DIR}`, note: "Anthropic project or current OpenAI worktree" }
-      ],
-      flags: [
-        {
-          names: [PATH_DIR],
-          description: "selects another Anthropic project; OpenAI accepts only linked checkouts of the current project."
-        }
-      ]
-    }
-  },
-  "cost:audit": {
-    script: "tools/cost-audit/cost-audit-main.ts",
-    description: "Report AI cost over a period by session kind, tool category and guard, with cost per merge and regressions against the period before",
-    category: "AI tools",
-    reference: [
-      "[--period <days> | --since <YYYY-MM-DD> --until <YYYY-MM-DD>] [--density]",
-      "maintainer",
-      ["none"]
-    ],
-    // Kit-only: it reads kit's own transcript store, like `josh retrospective`, which carries its
-    // summary line.
-    is_kit_only: true,
-    // Reads transcripts and a `gh api` search (GET) only, so a consultation session can run it.
-    is_read_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "the last 7 days against the 7 before" },
-        { arguments: "--period 30", note: "the last 30 days against the 30 before" },
-        {
-          arguments: "--since 2026-10-27 --until 2026-11-10",
-          note: "those 15 UTC days against the 15 before"
-        },
-        {
-          arguments: "--density",
-          note: "the lane-child calls per request alone, as the last line"
-        }
-      ],
-      flags: [
-        {
-          names: ["--period <days>"],
-          description: "the length of each period, a positive whole number of days (default 7)."
-        },
-        {
-          names: ["--since <YYYY-MM-DD>", "--until <YYYY-MM-DD>"],
-          description: "a fixed period instead, from the first UTC date through the second, both included; given together and never beside `--period`."
-        },
-        {
-          names: ["--density"],
-          description: "print only the period's lane-child density (calls per request, two decimals), so a measurement Issue declares it; no lane-child request prints nothing and exits 1."
-        }
-      ]
-    }
-  },
-  ...DOCUMENT_COMMANDS,
-  time: {
-    script: "tools/time/time-cli.ts",
-    description: "Report where a run's wall clock went: model wait, tool execution, human wait",
-    category: "AI tools",
-    reference: ["[options]", "maintainer", ["none"]],
-    // Kit-only: it measures kit's own development runs and its report modules live under the
-    // undistributed `tools/time/`, so it means nothing in a consumer project and is dropped from a
-    // consumer's help. The runtime analysis hooks and guards rely on stays
-    // distributed under `scripts/time-runtime/`.
-    is_kit_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "the last run tree, wall clock and cost by role" },
-        { arguments: "--run", note: "the same run-tree scope, named explicitly" },
-        { arguments: "--json", note: "the same figures, machine-readable" },
-        { arguments: PATH_DIR, note: "read another project's transcripts from this checkout" },
-        {
-          arguments: "--split-at 2026-10-16T21:33:19Z",
-          note: "the same tree compared by role before and after a merge"
-        }
-      ],
-      flags: [
-        {
-          names: ["--run"],
-          description: '(default) the whole run tree, wall clock led beside dollars. It is the only scope; any flag not listed here is a usage error (exit 1). History: `docs/maintainers/josh-commands-run-rationale.md` \u2192 "`josh cost` and `josh time` lost their report scopes".'
-        },
-        {
-          names: [PATH_DIR],
-          description: "aim the read at another project (absolute path); keeps the `cwd` behavior when absent."
-        },
-        { names: ["--json"], description: "the run tree, machine-readable." },
-        {
-          names: ["--split-at <ISO time>"],
-          description: "add a before \u2192 after block by role (time share, cost share, req/session), each session on the side of its first request; an unparseable time is a usage error (exit 1)."
-        }
-      ]
-    }
-  },
-  // The tool-calls-per-round-trip density the batching guard is measured on, aggregated across the
-  // recent lane sessions. Kit-only for the same reason `time` is: it reads
-  // kit's own lane transcripts and means nothing in a consumer project.
-  "time:density": {
-    script: "tools/time/time-density-cli.ts",
-    description: "Report tool calls per round trip across the recent lane sessions",
-    category: "AI tools",
-    reference: ["[--lanes <n>] [--path <dir>]", "maintainer", ["none"]],
-    is_kit_only: true,
-    usage: {
-      examples: [{ arguments: "" }, { arguments: "--lanes 5", note: "the five most recent lanes" }],
-      flags: [
-        {
-          names: ["--lanes <n>"],
-          description: "average over a different count of recent qualifying lanes (default 10)."
-        },
-        {
-          names: [PATH_DIR],
-          description: "read another project's lane transcripts, as `josh time` does. Run from a lane, it reads its main checkout's lanes."
-        }
-      ]
-    }
-  },
-  retrospective: {
-    script: "tools/retrospective/retrospective-cli.ts",
-    description: "Aggregate a finished run's cost, review findings, observation ledger and events into one digest",
-    category: "AI tools",
-    reference: ["", "maintainer", ["none"]],
-    core_weight: core_weights.CORE_WEIGHTS.retrospective,
-    memory_mb: core_weights.MEMORY_MB.retrospective,
-    // Kit-only: it reads kit's own development run — the transcript store, the review ledger and the
-    // run event stream — so it means nothing in a consumer project and is dropped from a consumer's
-    // help, through the same declaration `josh time` uses for the same reason.
-    is_kit_only: true,
-    usage: {
-      examples: [{ arguments: "", note: "the digest for the run this checkout carries" }]
-    }
-  },
-  ...REVIEW_COMMANDS,
-  ...RUN_COMMANDS,
-  "repo:party": {
-    script: "scripts/discovery/repo-party-cli.ts",
-    description: "Say whether a repository is first-party or third-party by owner equality (computed, not judged)",
-    category: "AI tools",
-    reference: ["[<owner/repo>]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "joshuafolkken/kit", note: "\u2192 first-party (in the kit session)" },
-        { arguments: "sveltejs/kit", note: "\u2192 third-party" },
-        { arguments: "", note: "no argument: the session's own repository" }
-      ]
-    }
-  },
-  "pin:verify": {
-    script: "scripts/discovery/pin-verify-cli.ts",
-    description: "Check that a tag resolves to the commit a SHA pin names, printing a line a bypass reason cites",
-    category: "AI tools",
-    reference: ["<owner/repo> <tag> <sha>", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "actions/checkout v4.2.2 11bd71901bbe5b1630ceea73d27597364c9af683",
-          note: "\u2192 match / mismatch / unreadable"
-        }
-      ]
-    }
-  },
-  ...SHIP_COMMANDS,
-  "lane:open": {
-    ...LANE_ARGUMENTS,
-    description: "Open a lane: a linked work tree with its own branch and its own port seed",
-    category: "AI tools",
-    reference: [ISSUE_WITH_OPTIONS2, "automation", ["files", "git"]],
-    default_script_arguments: ["open"],
-    usage: { examples: [{ arguments: "1490", note: "prints the lane directory on stdout" }] }
-  },
-  "lane:close": {
-    ...LANE_ARGUMENTS,
-    description: "Close a lane, leaving no work tree, branch or directory behind",
-    category: "AI tools",
-    reference: ["<issue>", "automation", ["files", "git"]],
-    default_script_arguments: ["close"],
-    usage: {
-      examples: [{ arguments: "1490" }, { arguments: "--all" }],
-      flags: [{ names: ["--all"], description: "closes every lane." }]
-    }
-  },
-  "lane:list": {
-    ...LANE_ARGUMENTS,
-    description: "List the open lanes: which issue, which ports, and where each one is",
-    category: "AI tools",
-    reference: ["", "automation", ["none"]],
-    default_script_arguments: ["list"],
-    usage: { examples: [BARE] }
-  },
-  "lane:prune": {
-    ...LANE_ARGUMENTS,
-    description: "Close every lane an interruption left without its work tree and every spent lane, then sweep unregistered leftovers under the lanes root",
-    category: "AI tools",
-    reference: ["", "automation", ["files", "git"]],
-    default_script_arguments: ["prune"],
-    usage: { examples: [BARE] }
-  },
-  "lane:output": {
-    ...LANE_ARGUMENTS,
-    description: "Record, or read back, where the unit running a lane\u2019s child writes",
-    category: "AI tools",
-    reference: ["<issue> [path]", "automation", ["files"]],
-    default_script_arguments: ["output"],
-    usage: {
-      examples: [
-        { arguments: "1713 /abs/path/to/agent-7.jsonl", note: "record it; prints the path back" },
-        { arguments: "1713", note: "read it; prints the path, or `none`" }
-      ]
-    }
-  },
-  "lane:dispatch": {
-    ...LANE_ARGUMENTS,
-    description: "Start a lane\u2019s child as a detached process that outlives this session",
-    category: "AI tools",
-    reference: ["<issue> <prompt>", "automation", ["processes"]],
-    default_script_arguments: ["dispatch"],
-    usage: {
-      examples: [
-        {
-          arguments: "1749",
-          note: "prints the child's pid; a refusal is an empty capture and exit 1"
-        }
-      ],
-      flags: [
-        {
-          names: ["JOSH_{SCHEDULER,WORKER,REVIEWER}_MODEL"],
-          description: "Claude Code role overrides; Anthropic defaults are respectively `claude-opus-5-5`, `claude-opus-5-5`, and `claude-opus-5-5`. Codex keeps its provider-specific model."
-        },
-        {
-          names: ["JOSH_{SCHEDULER,WORKER,REVIEWER}_EFFORT"],
-          description: "role effort overrides for either provider; defaults are `medium`, `medium`, and `medium`."
-        },
-        {
-          names: ["JOSH_REVIEWER_VERIFICATION_{MODEL,EFFORT}"],
-          description: "review round 2 and later (the verification pass); defaults are `claude-sonnet-5-5` / `high` on Anthropic and `high` on OpenAI, falling back to `JOSH_REVIEWER_*`."
-        }
-      ]
-    }
-  },
-  "lane:await": {
-    ...LANE_ARGUMENTS,
-    description: "Block until any of the named in-flight lane children completes; prints which one finished",
-    category: "AI tools",
-    reference: ["<issue> [<issue>...] [--owner <pid>]", "automation", ["files", "processes"]],
-    default_script_arguments: ["await"],
-    usage: {
-      examples: [
-        {
-          arguments: "1749 1750",
-          note: "reclaim a resumed conversation\u2019s carry record, then block until either lane completes"
-        }
-      ]
-    }
-  },
-  "lane:launch": {
-    script: "scripts/lane/lane-launch-main.ts",
-    description: "Collapse a backlogrun lane-start event into one call: open the lane, pop and re-install on the first, dispatch the child",
-    category: "AI tools",
-    reference: ["<issue> [--stash <message>]", "automation", ["files", "git", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "1749", note: "every lane after the first" },
-        {
-          arguments: '1749 --stash "backlogrun: josh latest before lanes"',
-          note: "the first lane only"
-        }
-      ]
-    }
-  },
-  // `.env` is read for `JOSH_LANE_ROOT`, as every lane command reads it, so the lane is found.
-  "lane:restart": {
-    script: "scripts/lane/lane-restart-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Stop a running lane child, stash its uncommitted work and re-dispatch its issue in a fresh session \u2014 not counted as an outage or a failure",
-    category: "AI tools",
-    reference: ["<issue>", "developer", ["files", "git", "processes", "network"]],
-    usage: {
-      examples: [{ arguments: "3769", note: "prints the fresh child's pid" }]
-    }
-  },
-  // `.env` is read for `JOSH_LANE_ROOT`, as every lane command reads it, so the lane is found.
-  "lane:withdraw": {
-    script: "scripts/lane/lane-withdraw-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Stop a running lane child, stash its uncommitted work and close the lane, leaving its issue open for the next run \u2014 booked withdrawn, not as an outage or a failure",
-    category: "AI tools",
-    reference: ["<issue> --reason <text>", "developer", ["files", "git", "processes", "network"]],
-    usage: {
-      examples: [{ arguments: '3769 --reason "folded into a broader issue"' }]
-    }
-  },
-  "lane:resolve": {
-    script: "scripts/lane/lane-resolve-cli.ts",
-    description: "Merge the default branch into a lane's branch and print one verdict \u2014 resolved, conflict <paths>, or step-back 2 (overlapping hunks, merge aborted) / 3 (a resolution already recorded on the issue); --record posts that resolution comment once the lane is pushed",
-    category: "AI tools",
-    reference: ["<issue> [--record [<path>...]]", "developer", ["git", "network", "files"]],
-    usage: {
-      examples: [
-        { arguments: "3769", note: "prints `conflict docs/a.md` on a hand-resolvable conflict" },
-        {
-          arguments: "3769 --record docs/a.md",
-          note: "posts the `## Lane conflict resolved` comment once the lane is pushed"
-        }
-      ]
-    }
-  },
-  // `.env` is read for the Telegram settings the yield's hold release reaches (`run-hold-cli.ts`).
-  "lane:plan": {
-    script: "scripts/lane/lane-plan-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Record a lane child's planned files; yield its lane, naming file and holder, when an earlier-planned running lane declares or plans one; `--size-approval` bounds lines/files",
-    category: "AI tools",
-    reference: [
-      "<issue> <path>... [--probe] [--single] [--estimate <json-file>] [--size-approval <json-file>] [--imports <path>...]",
-      "automation",
-      ["files", "network"]
-    ],
-    usage: {
-      examples: [{ arguments: "4864 scripts/lane/lane-plan.ts scripts/backlog/backlog-next.ts" }]
-    }
-  },
-  // `.env` is read for `JOSH_LANE_ROOT`, as every lane command reads it, so `--all` finds the lanes.
-  "lane:pause": {
-    ...PAUSE_ARGUMENTS,
-    description: "Suspend a running lane child\u2019s process tree (SIGSTOP) in place, leaving its work tree, branch and issue untouched, and record the pause in the lane\u2019s state and the run\u2019s event stream",
-    default_script_arguments: ["pause"],
-    usage: { examples: LANE_SIGNAL_EXAMPLES }
-  },
-  "lane:resume": {
-    ...PAUSE_ARGUMENTS,
-    description: "Let a paused lane child carry on from where it stopped (SIGCONT)",
-    default_script_arguments: ["resume"],
-    usage: { examples: LANE_SIGNAL_EXAMPLES }
-  },
-  // `.env` is read for `JOSH_LANE_ROOT`, as every lane command reads it, so `--all` finds the lanes.
-  "lane:adopt": {
-    script: "scripts/lane/lane-adopt-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Give an open lane that lost its state record a record again, read from its process, work tree, unpushed commits, pull request and issue \u2014 its work untouched",
-    category: "AI tools",
-    reference: [ISSUE_OR_ALL, "developer", ["files", "git", "processes", "network"]],
-    usage: {
-      examples: [
-        { arguments: "4744" },
-        { arguments: "--all", note: "every open lane with no record" }
-      ]
-    }
-  },
-  // A live run's lane limit: `.env` is read so the bare form reports the
-  // `JOSH_LANE_LIMIT` a person set there when no override stands.
-  "lane:limit": {
-    script: "scripts/lane/lane-limit-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Change a live backlogrun\u2019s lane limit without stopping it, or print the limit, lanes in use and free lanes",
-    category: "AI tools",
-    reference: ["[<limit>] [--reset]", "developer", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "8", note: "raise or lower the live run's limit to 8" },
-        { arguments: "", note: "print the limit, the lanes in use and the free lanes" },
-        { arguments: "--reset", note: "clear the override; the run\u2019s start limit applies again" }
-      ]
-    }
-  },
-  // The lane-limit measurement: `.env` is read so `lane:stats` labels the row
-  // with the `JOSH_LANE_LIMIT` a person set there.
-  "lane:sample": {
-    ...MEASURE_ARGUMENTS,
-    description: "Record the machine load (load average, swap, free memory, working lanes) to the lane ledger \u2014 a backlogrun samples itself, this is for a reading outside one",
-    category: "AI tools",
-    reference: ["[--every <seconds>]", "maintainer", ["files"]],
-    default_script_arguments: ["sample"],
-    usage: { examples: [{ arguments: "", note: "one machine-load reading" }] }
-  },
-  "lane:stats": {
-    ...MEASURE_ARGUMENTS,
-    description: "Print period lane throughput, stage, stop (by failed CI check, longest first), check and machine-load statistics; --sinks shows stage totals, --over lane chains, --why cause groups above a net-minute threshold, and --pairs scoped pair runs",
-    category: "AI tools",
-    reference: [
-      "(--period <days> | --since <instant>) [--limit <lane-limit> | --sinks [<minutes>] | --over <minutes> | --why <minutes> | --pairs]",
-      "maintainer",
-      ["none"]
-    ],
-    default_script_arguments: ["stats"],
-    usage: {
-      examples: [
-        { arguments: "--period 7", note: "a 7-day period's stage medians and maxima" },
-        { arguments: "--period 1 --sinks", note: "stage totals of the lanes over 30 net min" },
-        { arguments: "--period 1 --over 40", note: "ledger chains of lanes over 40 net min" },
-        { arguments: "--period 1 --why 40", note: "cause groups of lanes over 40 net min" },
-        { arguments: "--period 7 --pairs", note: "a 7-day period's scoped pair runs" },
-        { arguments: "--since 2026-11-10T01:00Z --why 40", note: "cause groups since an instant" }
-      ]
-    }
-  },
-  // One lane measurement as one number on the last line, for an Issue's measurement declaration
-  // (joshuafolkken/kit#4630).
-  "lane:value": {
-    ...MEASURE_ARGUMENTS,
-    description: "Print one lane measurement since an instant as a single number: cell (a lane:stats table cell, --table --row --where --column --item --zero), lint-unmoved (median s of a lint:related that found nothing moved), metrics-stops (pre-detach metrics stops per lane), lint-core-wait (lint:related core-budget wait, min per lane), edit (median s of one Edit)",
-    category: "AI tools",
-    reference: ["<metric> --since <instant>", "maintainer", ["none"]],
-    default_script_arguments: ["value"],
-    usage: {
-      examples: [
-        {
-          arguments: "edit --since 2026-10-23T03:29Z",
-          note: "the median Edit time since an instant"
-        },
-        {
-          arguments: 'cell --table "test:related scope" --row related --column "median (s)" --since 2026-10-23T03:29Z',
-          note: "one lane:stats table cell since an instant"
-        }
-      ]
-    }
-  },
-  "lane:net": {
-    ...MEASURE_ARGUMENTS,
-    description: "Print a lane's net minutes: its issue's first dispatch to its merge, less the waits its parks, outages, usage-limit stops and yields stood, the host's sleeps and the ship's followup",
-    category: "AI tools",
-    reference: ["<issue>", "maintainer", ["none"]],
-    default_script_arguments: ["net"],
-    usage: {
-      examples: [
-        {
-          arguments: "4695",
-          note: "the net minutes a causing-lane line declares"
-        }
-      ]
-    }
-  },
-  "lane:breakdown": {
-    script: "scripts/lane/lane-breakdown-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Print a merged lane's net time by stage, longest first, the implementation split by its tool calls",
-    category: "AI tools",
-    reference: ["<issue> [--timeline]", "maintainer", ["none"]],
-    usage: {
-      flags: [
-        {
-          names: ["--timeline"],
-          description: "prints the lane in time order instead, one line a stage, wait or event, the stage lines adding up to the net time."
-        }
-      ],
-      examples: [
-        {
-          arguments: "4970",
-          note: "the breakdown the overrun investigation comments on the lane"
-        },
-        { arguments: "4970 --timeline", note: "when each stage ran and where the lane waited" }
-      ]
-    }
-  },
-  "lane:why": {
-    script: "scripts/lane/lane-why-cli.ts",
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    description: "Print a merged lane's stages over budget, one row each, beside the records that say why",
-    category: "AI tools",
-    reference: ["<issue>", "maintainer", ["processes", "network"]],
-    usage: {
-      examples: [
-        {
-          arguments: "6050",
-          note: "the cause table an overrun investigation joins by hand"
-        }
-      ]
-    }
-  },
-  "run:watcher:guard": {
-    script: "scripts/run/run-watcher-guard-cli.ts",
-    description: "Guard: exits non-zero when lane children are in-flight but the watcher has not pinged recently",
-    category: "AI tools",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [BARE] }
-  },
-  "split:recover": {
-    script: "scripts/split/split-child-recover-cli.ts",
-    description: "Recover split-child evidence after verifying an existing child URL, split route and parent",
-    category: "AI tools",
-    reference: ["<origin> <child-issue-url>", "automation", ["network", "files"]],
-    usage: { examples: [{ arguments: "6212 https://github.com/joshuafolkken/kit/issues/6326" }] }
-  },
-  "split:assess": {
-    script: "scripts/split/split-assess-cli.ts",
-    description: "Measure the branch change size (tests excluded) and answer the split assessment size question: split | single",
-    category: "AI tools",
-    reference: ["[--json]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "\u2192 single" },
-        { arguments: "--json", note: "the verdict and the reason, machine-readable" }
-      ]
-    }
-  },
-  "oracle:list": {
-    script: "scripts/rules/oracle-list-cli.ts",
-    description: "Print the decision oracles \u2014 commands that answer a rule question mechanically",
-    category: "AI tools",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  eval: {
-    script: "tools/eval/eval-run.ts",
-    description: "Run the agent rule-compliance scenarios (real Claude sessions)",
-    category: "AI tools",
-    reference: ["[scenario...]", "maintainer", ["processes", "network"]],
-    // Kit-only: it replays kit's own distributed rules against real Claude sessions, so it means
-    // nothing in a consumer project and is dropped from a consumer's help.
-    is_kit_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "every scenario" },
-        { arguments: "consult-not-execute", note: "one scenario by name" }
-      ],
-      flags: [
-        { names: ["JOSH_EVAL_MODEL"], description: "the model to run against (default `sonnet`)." },
-        {
-          names: ["JOSH_EVAL_CONCURRENCY"],
-          description: "how many sessions run at once (default `5`); a non-positive-integer value is refused."
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-clone.ts
-var CLONE_COMMANDS = {
-  "clone:scan": {
-    script: "scripts/clone/clone-scan-cli.ts",
-    description: "Count code duplication across files and first-party repositories, printing each clone as file:line pairs",
-    category: "AI tools",
-    reference: ["", "automation", ["files"]],
-    usage: { examples: [{ arguments: "" }] }
-  }
-};
-
-// scripts/josh/josh-commands-agent-hooks.ts
-var PRE_TOOL_USE = "run by the PreToolUse hook, the pending tool call as JSON on stdin";
-var AGENT_HOOK_COMMANDS = {
-  "usage:tee": {
-    script: "scripts/usage/usage-tee-cli.ts",
-    description: "Record account-wide Claude statusLine rate limits without printing output",
-    category: "Development",
-    reference: ["", "automation", ["files"]],
-    usage: {
-      examples: [{ arguments: "", note: "Claude statusLine JSON on stdin; stdout stays empty" }]
-    }
-  },
-  "format:edited": {
-    script: "scripts/hooks/format-edited-cli.ts",
-    description: "Claude Code hook: format the file just edited (reads the tool call on stdin)",
-    category: "Development",
-    reference: ["", "automation", ["files", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "run by the PostToolUse hook, the tool call as JSON on stdin" }
-      ]
-    }
-  },
-  "pretool:guard": {
-    script: "scripts/hooks/pretool-guard-cli.ts",
-    description: "Claude Code hook: the batch, investigation and rule guards in one process (reads the tool call on stdin)",
-    category: "Development",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [{ arguments: "", note: PRE_TOOL_USE }] }
-    // **No `tsx_arguments`, deliberately.** The guards read `.env` for their other values, as other
-    // commands do through `OPTIONAL_ENV_FILE_FLAGS`; the guard switches themselves come from the
-    // launch environment alone (`josh-environment-file.ts`). Each guard it composes loads `.env`
-    // through the shared loader on its real hook path instead, so the unit tests never see a
-    // developer's `.env`.
-  },
-  // The hook ledger read per rule (joshuafolkken/kit#6664): which rules refuse, and how often wrongly.
-  // `--apply` / `--restore` write the demoted-rules file (joshuafolkken/kit#6591).
-  "hook:ledger": {
-    script: "scripts/hooks/hook-ledger-cli.ts",
-    is_read_only: true,
-    write_flags: ["--apply", "--restore"],
-    description: "Print Claude Code hook refusals per hook and rule over a period: refusals, the same call passing later, and route:interrupt issues naming the rule; list, demote or restore rules that mostly refuse allowed work",
-    category: "Development",
-    reference: [
-      "--period <days> [--demote [--apply]] | --restore <rule>",
-      "maintainer",
-      ["network", "files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "--period 7", note: "a 7-day period's refusals per rule" },
-        { arguments: "--period 7 --demote", note: "rules to demote from blocking to notice" },
-        {
-          arguments: "--period 7 --demote --apply",
-          note: "record them in .josh/hook-demoted.json"
-        },
-        { arguments: "--restore batching", note: "make a demoted rule block again" }
-      ]
-    }
-  },
-  "stop:guard": {
-    script: "scripts/hooks/stop-guard.ts",
-    description: "Claude Code Stop hook: send the hold notify and release the hold itself; block on the rules that need the model (reads the Stop payload on stdin)",
-    category: "Development",
-    reference: ["", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "run by the Stop hook, the stop payload as JSON on stdin" }
-      ]
-    }
-    // **No `tsx_arguments`, deliberately**, the same as `pretool:guard` above: this runs at every
-    // turn end, so it must stay eligible for in-process dispatch rather than pay a second tsx start.
-    // It loads `.env` through the shared `hook-decision.ts` loader.
-  },
-  "session:lang": {
-    script: "scripts/josh/session-language-main.ts",
-    description: "Claude Code hook: print a non-default JOSH_SESSION_LANG for the session context, the run:board reply rule while a backlogrun is live, and the run:handoff line for a workflow keyword on a consultation model (otherwise nothing)",
-    category: "Development",
-    reference: ["", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: "", note: "run by the UserPromptSubmit hook; `ja` prints nothing" }]
-    }
-    // **No `tsx_arguments`, deliberately**, the same as `pretool:guard` above: this runs on every
-    // `UserPromptSubmit`, so it must stay eligible for in-process dispatch rather than pay a second
-    // tsx start each turn. It loads `.env` itself through the shared loader.
-  },
-  "codex:hook-adapter": {
-    script: "scripts/hooks/codex-hook-adapter.ts",
-    description: "Codex hook: run the pretool or posttool guard on a Codex payload (reads the tool call on stdin)",
-    category: "Development",
-    reference: ["<pretool|posttool>", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "pretool", note: "a Codex PreToolUse payload on stdin" },
-        { arguments: "posttool", note: "a Codex PostToolUse payload on stdin" }
-      ]
-    }
-    // The live-source fallback `scripts/hooks/run-hook.sh` derives from the `codex-hook-adapter`
-    // bundle name. **No `tsx_arguments`**, the same as `pretool:guard`
-    // above: it runs before every guarded Codex call.
-  }
-};
-
-// scripts/josh/josh-commands-test-check.ts
-var TEST_CHECK_COMMANDS = {
-  "test:declared": {
-    script: "scripts/test/test-declared.ts",
-    description: "Report whether the working-tree change needs a test (required/exempt/satisfied); --match checks Step 0 declarations on stdin",
-    category: "Development",
-    reference: ["[--match]", "developer", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--match", note: "check Step 0 declarations on stdin" },
-        { arguments: "--help", note: "print usage, including the --match stdin form" }
-      ]
-    }
-  },
-  "test:red": {
-    script: "scripts/test/test-red-main.ts",
-    description: "Run the changed unit tests against the pre-fix tree (merge-base worktree) and report red/green/no-test/stopped/test-only",
-    category: "Development",
-    reference: ["", "developer", ["git", "processes"]],
-    usage: { examples: [{ arguments: "", note: "red, green, no-test, stopped or test-only" }] }
-  },
-  "test:reach": {
-    script: "scripts/test/test-reach-cli.ts",
-    description: "Print how many test files each file's imports reach \u2014 the count test:related sizes its claim by \u2014 one '<count> <file>' line per file",
-    category: "Development",
-    reference: ["<files...>", "automation", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "scripts/lane/lane-ledger.ts",
-          note: "a reach count to measure before and after a change"
-        }
-      ]
-    }
-  },
-  "test:pinned": {
-    script: "scripts/test/test-pinned-main.ts",
-    description: "Revert each changed hunk outside tests and fixtures only they reach, and replace each added file's top-level function bodies with a throw, in a HEAD worktree, run the related tests, and list what no test went red on",
-    category: "Development",
-    reference: [
-      "[--max <n>] [--record <token>] [--origin <run-review|pre-detach|manual>] [--first-unpinned]",
-      "developer",
-      ["git", "processes"]
-    ],
-    ...gate_plan.DIRECT_UNIT_CLAIM,
-    usage: {
-      examples: [
-        { arguments: "", note: "unpinned <file>:<line> lines; unchecked counted per reason" },
-        { arguments: "--max 5", note: "check at most 5 hunks; the rest count as unchecked" },
-        {
-          arguments: "--record <token>",
-          note: "also leave the answer, under the launch token, for run:review --join"
-        },
-        {
-          arguments: "--origin pre-detach",
-          note: "name what started the run on its lane ledger row (default manual)"
-        },
-        {
-          arguments: "--first-unpinned",
-          note: "start no probe once one hunk is unpinned; the rest count as unchecked"
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-development.ts
-var NARROWED = { arguments: "scripts/thing.ts", note: "narrow by the given files instead" };
-var FORWARDED_TO_VITEST = "flags are forwarded to vitest";
-var UNSEEDED = {};
-var FILE_ARGUMENTS = "[files...]";
-var REQUIRED_FILE_ARGUMENTS = "<files...>";
-var FILTER_ARGUMENTS = "[filters...]";
-var PATH_ARGUMENTS = "<path...>";
-var DEV_COMMANDS = {
-  "pr:classification": {
-    script: "scripts/ci/pr-classification-main.ts",
-    description: "Require one release classification on a pull request",
-    category: "Development",
-    reference: ["", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: "", note: "run by CI on a pull request; fails without one label" }]
-    }
-  },
-  [GATE_COMMAND]: {
-    script: "scripts/gate/verification-gate.ts",
-    description: "Run lint, type check, spell check and unit tests concurrently",
-    category: "Development",
-    reference: [
-      "[--verbose|--force|--no-unit|--whole-tree|--static-group=<group>]",
-      "developer",
-      ["files", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--verbose", note: "every check's output, passing ones included" },
-        { arguments: "--force", note: "re-run even on a tree already recorded green" },
-        { arguments: "--no-unit", note: "the static checks only (CI only)" },
-        {
-          arguments: "--whole-tree",
-          note: "add the whole-tree checks (the ship's gate on the final tree)"
-        }
-      ]
-    }
-  },
-  lint: {
-    script: "scripts/lint/lint-parallel-main.ts",
-    description: "Check code with prettier and eslint (skips a tool a basic project lacks)",
-    category: "Development",
-    reference: ["[--changed] [--shard=<n>]", "developer", ["processes"]],
-    core_weight: core_weights.CORE_WEIGHTS.lint,
-    memory_mb: core_weights.MEMORY_MB.lint,
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--changed", note: "the branch's changed files \u2014 the gate's form" },
-        { arguments: "--shard=1", note: "one of two fixed halves of the tree (1 or 2) \u2014 a CI leg" }
-      ]
-    }
-  },
-  "lint:related": {
-    script: "scripts/lint/lint-related.ts",
-    description: "Check only the changed files with prettier and eslint, and in kit the source guard tests (whole tree on fallback)",
-    category: "Development",
-    reference: [FILE_ARGUMENTS, "developer", ["processes"]],
-    core_weight: core_weights.CORE_WEIGHTS.lint,
-    memory_mb: core_weights.MEMORY_MB.lint,
-    usage: { examples: [{ arguments: "" }, NARROWED] }
-  },
-  lines: {
-    script: "scripts/lines/lines-command.ts",
-    description: "Print a file's code lines against the max-lines limit and the headroom left",
-    category: "Development",
-    reference: [REQUIRED_FILE_ARGUMENTS, "developer", ["none"]],
-    core_weight: core_weights.CORE_WEIGHTS.eslint_scan,
-    memory_mb: core_weights.MEMORY_MB.eslint_scan,
-    usage: {
-      examples: [{ arguments: "scripts/hooks/format-edited-file.ts scripts/josh/josh-logic.ts" }]
-    }
-  },
-  metrics: {
-    script: "tools/metrics/metrics-command.ts",
-    description: "Print repository-wide quality totals and durations, and fail when a total grew past the merge-base or a duration past its baseline",
-    category: "Development",
-    reference: [
-      '[--no-startup | --totals-only [--rerecord] | --accept --reason "<why>"]',
-      "developer",
-      ["files"]
-    ],
-    core_weight: core_weights.CORE_WEIGHTS.eslint_scan,
-    memory_mb: core_weights.MEMORY_MB.metrics,
-    is_kit_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "print the totals and check them against the merge-base's" },
-        { arguments: '--accept --reason "<why>"', note: "record this branch's growth and why" }
-      ]
-    }
-  },
-  "refactor:scan": {
-    script: "scripts/refactor/refactor-scan-cli.ts",
-    description: "List refactoring candidates in the changed scope by category and answer clear/candidates",
-    category: "Development",
-    reference: ["", "automation", ["processes"]],
-    core_weight: core_weights.CORE_WEIGHTS.eslint_scan,
-    memory_mb: core_weights.MEMORY_MB.eslint_scan,
-    usage: { examples: [{ arguments: "" }] }
-  },
-  bytes: {
-    script: "scripts/lines/bytes-command.ts",
-    description: "Print an agent-read document's byte size against its ceiling and the headroom left",
-    category: "Development",
-    reference: [REQUIRED_FILE_ARGUMENTS, "developer", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "docs/josh-commands.md", note: "one document" },
-        { arguments: "", note: "scan: every budgeted document near its ceiling" }
-      ]
-    }
-  },
-  "rule:value": {
-    script: "scripts/rules/rule-value-cli.ts",
-    description: "Print each delivered rule's unaided compliance \u2014 runs reached, kept rate, refusals",
-    category: "AI tools",
-    reference: [
-      "[--fresh | --refresh | --period <days> | --weekly <rule-id>... | --prose]",
-      "developer",
-      ["files"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "a reading cached under 15 minutes ago, else measure" },
-        { arguments: "--fresh", note: "measure now, whatever the cache holds" },
-        {
-          arguments: "--refresh",
-          note: "write the reading to the loop-head cache instead of stdout"
-        },
-        {
-          arguments: "--period 7",
-          note: "measure only the transcripts written in the last 7 days, cache untouched"
-        },
-        {
-          arguments: "--weekly <rule-id>...",
-          note: "reached / refused / rephrased of the named rules, one line per week"
-        },
-        { arguments: "--prose", note: "class each prose rule: enforced, measured or prose only" }
-      ]
-    }
-  },
-  "rule:list": {
-    script: "scripts/rules/rule-list.ts",
-    description: "Print the trigger-delivered rules \u2014 each one's source, firing call and silent turn \u2014 from the guard rows",
-    category: "AI tools",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [{ arguments: "", note: "print every trigger-delivered rule" }] }
-  },
-  format: {
-    script: "scripts/lint/format.ts",
-    description: "Format code with prettier and eslint (skips a tool a basic project lacks)",
-    category: "Development",
-    reference: ["", "developer", ["files", "processes"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  rename: {
-    script: "scripts/lint/rename-cli.ts",
-    description: "Rename an identifier, and the import specifier it moved with, across files through the TypeScript parse tree",
-    category: "Development",
-    reference: [
-      "<old-identifier> <new-identifier> [--import <old-specifier> <new-specifier>] <file...>",
-      "automation",
-      ["files", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "old_name new_name scripts/a.ts scripts/b.ts" },
-        {
-          arguments: "lane_ledger lane_ledger_write --import '#scripts/lane/lane-ledger' '#scripts/lane/lane-ledger-write' scripts/gate/core-wait-record.ts",
-          note: "the identifier and its module together"
-        }
-      ]
-    }
-  },
-  ...AGENT_HOOK_COMMANDS,
-  "cspell:dot": {
-    script: "scripts/lint/cspell-cached.ts",
-    description: "Run spell check including dotfiles",
-    category: "Development",
-    reference: ["", "developer", ["processes"]],
-    core_weight: core_weights.CORE_WEIGHTS.spell_check,
-    memory_mb: core_weights.MEMORY_MB.spell_check,
-    usage: { examples: [{ arguments: "", note: "includes dotfiles" }] }
-  },
-  "check:related": {
-    script: "scripts/gate/check-related.ts",
-    description: "Run related lint, type and dotfile spelling checks in parallel, and the unit tests once lint passes",
-    category: "Development",
-    reference: ["", "developer", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--full", note: "whole outputs" },
-        { arguments: "--touched", note: "mid-run: test:related --touched, no green record" }
-      ]
-    }
-  },
-  behavior: {
-    script: "scripts/behavior/behavior-cli.ts",
-    description: "Check the current run's recorded transcript against the behavior assertions (no model call)",
-    category: "Development",
-    reference: ["", "developer", ["files"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "exports:unused": {
-    script: "scripts/exports/unused-members-cli.ts",
-    description: "Report exported namespace members nothing reads (kit only; a consumer project skips it)",
-    category: "Development",
-    reference: ["", "developer", ["none"]],
-    // One TypeScript program, as the type check builds (joshuafolkken/kit#7030).
-    core_weight: core_weights.CORE_WEIGHTS.type_check,
-    // Reads source files and prints only, so a consultation session can run it.
-    is_read_only: true,
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "test:unit": {
-    script: "scripts/test/test-unit-guard-main.ts",
-    description: "Run unit tests with Vitest (without Vitest: a basic project runs its own test script, others skip; fails when Vitest has no tests)",
-    category: "Development",
-    reference: [FILTER_ARGUMENTS, "developer", ["processes"]],
-    ...gate_plan.DIRECT_UNIT_CLAIM,
-    usage: {
-      examples: [{ arguments: "" }, { arguments: "--shard=1/3", note: FORWARDED_TO_VITEST }]
-    }
-  },
-  "test:related": {
-    script: "scripts/test/test-related-main.ts",
-    description: "Run only the unit tests related to the changed files (full suite on fallback)",
-    category: "Development",
-    reference: [FILE_ARGUMENTS, "developer", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        NARROWED,
-        { arguments: "--touched", note: "diff tests, same-named tests and direct test importers" },
-        { arguments: "--silent", note: FORWARDED_TO_VITEST }
-      ]
-    }
-  },
-  ...TEST_CHECK_COMMANDS,
-  disposition: {
-    script: "scripts/review/disposition-cli.ts",
-    description: "Say whether a review finding reaches a runtime path (runtime) or is inert (non-runtime)",
-    category: "AI tools",
-    reference: [`${PATH_ARGUMENTS} | --batch <findings-file>`, "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "<path...>", note: "\u2192 runtime | non-runtime" },
-        { arguments: "--batch <findings-file>", note: "\u2192 branch table + drop notes" }
-      ]
-    }
-  },
-  "e2e:retry-check": {
-    script: "scripts/test/e2e-retry-check.ts",
-    description: "Report whether the preview server crashed during a failed E2E attempt (CI)",
-    category: "Development",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "test:e2e": {
-    script: "scripts/test/test-e2e-guard.ts",
-    description: "Run E2E tests with Playwright (skips when absent or no e2e files)",
-    category: "Development",
-    reference: [FILTER_ARGUMENTS, "developer", ["processes"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  test: {
-    shell: ["sh", "-c", "pnpm josh test:unit && pnpm josh test:e2e"],
-    description: "Run unit and E2E tests",
-    category: "Development",
-    reference: ["", "developer", ["processes"]],
-    argument_targets: ["test:unit", "test:e2e"],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  check: {
-    script: "scripts/gate/type-check-command.ts",
-    description: "Type-check with tsc (skips a basic project with no TypeScript to check)",
-    category: "Development",
-    reference: ["[arguments...]", "developer", ["processes"]],
-    core_weight: core_weights.CORE_WEIGHTS.type_check,
-    memory_mb: core_weights.MEMORY_MB.type_check,
-    usage: { examples: [{ arguments: "" }] }
-  },
-  port: {
-    script: "scripts/ports/port-command.ts",
-    description: "Print the PORT_SEED-resolved dev or preview port",
-    category: "Development",
-    reference: ["<dev|preview>", "developer", ["none"]],
-    usage: {
-      examples: [
-        {
-          arguments: "dev",
-          note: `${String(ports.resolve_development_port(UNSEEDED))} with no seed set`
-        },
-        {
-          arguments: "preview",
-          note: `${String(ports.resolve_preview_port(UNSEEDED))} with no seed set`
-        }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-hooks.ts
-var HOOKS_COMMANDS = {
-  "prevent-main-commit": {
-    script: "scripts/hooks/prevent-main-commit.ts",
-    description: "Git hook: block commits to main",
-    category: "Git hooks",
-    reference: ["", "automation", ["none"]],
-    usage: { examples: [{ arguments: "", note: "run by the pre-commit hook" }] }
-  },
-  "check-commit-message": {
-    script: "scripts/hooks/check-commit-message-main.ts",
-    description: "Git hook: validate commit message",
-    category: "Git hooks",
-    reference: ["[<message-file>]", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: ".git/COMMIT_EDITMSG", note: "run by the commit-msg hook" }]
-    }
-  },
-  "secretlint-scan": {
-    script: "scripts/security/secretlint-scan.ts",
-    description: "Git hook: scan staged files for secrets",
-    category: "Git hooks",
-    reference: ["[paths...]", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: "src/app.ts .env.example", note: "the staged paths" }]
-    }
-  },
-  "pre-commit-lint": {
-    script: "scripts/hooks/pre-commit-lint.ts",
-    description: "Git hook: run cspell, prettier or eslint over staged files from a content cache",
-    category: "Git hooks",
-    reference: ["<cspell|prettier|eslint> [paths...]", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "cspell src/app.ts" },
-        { arguments: "prettier src/app.ts" },
-        { arguments: "eslint src/app.ts" }
-      ]
-    }
-  },
-  "pre-push-unit": {
-    script: "scripts/hooks/pre-push-unit.ts",
-    description: "Git hook: run unit tests, reusing a green gate recorded on the pushed tree",
-    category: "Git hooks",
-    reference: ["", "automation", ["processes"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "reserved-run": {
-    script: "scripts/hooks/reserved-run.ts",
-    description: "Git hook: run a command while holding a place in the machine-wide core budget",
-    category: "Git hooks",
-    reference: ["<weight> [--memory <MB>] -- <command...>", "automation", ["processes"]],
-    usage: {
-      examples: [
-        { arguments: "2 -- pnpm install", note: "hold 2 cores while installing" },
-        { arguments: "1 --memory 3000 -- <command>", note: "hold 3,000 MB beside the core" }
-      ]
-    }
-  },
-  "pre-commit-type-check": {
-    script: "scripts/gate/pre-commit-type-check.ts",
-    description: "Git hook: type-check, reusing a green gate recorded on the committed tree",
-    category: "Git hooks",
-    reference: ["", "automation", ["processes"]],
-    usage: { examples: [{ arguments: "" }] }
-  }
-};
-
-// scripts/josh/josh-commands-lint.ts
-var LINT_COMMANDS = {
-  "lint:rule": {
-    script: "scripts/lint/lint-rule.ts",
-    description: "Run one eslint rule over the whole repository, or with --paths a subset, on a cache of its own and write the rule's violations to a file",
-    category: "Development",
-    reference: [
-      "<rule> [--config <path>] [--output <path>] [--paths <path>...]",
-      "developer",
-      ["files", "processes"]
-    ],
-    core_weight: LINT_RULE_WORKERS * core_weights.CORE_WEIGHTS.eslint_scan,
-    memory_mb: LINT_RULE_WORKERS * core_weights.MEMORY_MB.eslint_scan,
-    usage: {
-      examples: [
-        { arguments: "kit/no-measurement-comment" },
-        {
-          arguments: "kit/no-measurement-comment --config eslint.tmp.config.js",
-          note: "a temporary config"
-        },
-        { arguments: "kit/no-measurement-comment --output .josh/tmp/violations.txt" },
-        {
-          arguments: "kit/no-measurement-comment --paths scripts/lint/*.ts",
-          note: "only these paths, on a subset cache and report"
-        }
-      ]
-    }
-  },
-  "issue:lint": {
-    script: "scripts/issue/issue-lint-main.ts",
-    description: "Check an issue body file for the template's required headings",
-    category: "AI tools",
-    reference: ["<path>", "automation", ["files"]],
-    usage: { examples: [{ arguments: ".josh/tmp/issue-body.md" }] }
-  },
-  "report:lint": {
-    script: "scripts/report/report-lint-cli.ts",
-    description: "Check a two-layer work summary, or with --child-summary a lane child's summary, on stdin against its mechanical format rules",
-    category: "AI tools",
-    reference: ["[--child-summary] (reads stdin)", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: "< summary.md" }, { arguments: "--child-summary < summary.md" }]
-    }
-  },
-  "report:template": {
-    script: "scripts/report/report-template-cli.ts",
-    description: "Print the work summary, completion report or lane child's summary skeleton in the session language: summary | done | child",
-    category: "AI tools",
-    reference: ["summary|done|child [<path>...]", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "summary scripts/report/report-lint.ts" },
-        { arguments: "done" },
-        { arguments: "child" }
-      ]
-    }
-  },
-  cases: {
-    script: "scripts/cases/cases-cli.ts",
-    description: "Read changed paths and print the boundaries crossed and their mandatory abnormal cases: network | process | fs | time | state | env | none",
-    category: "AI tools",
-    reference: ["<path...>", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "scripts/a.ts scripts/b.ts", note: "the boundaries these paths cross" }
-      ]
-    }
-  },
-  "plan:scaffold": {
-    script: "scripts/plan/plan-scaffold-cli.ts",
-    description: "Print a work summary's inputs in one call: the run:prep skeleton, planned files near the line limit, the test:declared verdict, the owed cases and the plan:consumers draft",
-    category: "AI tools",
-    reference: ["<issue> [<path>...] [--estimate <json-file>]", "automation", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "123", note: "planned files from the issue body" },
-        { arguments: "123 scripts/a.ts scripts/b.ts", note: "the files this plan touches" }
-      ]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-maintenance.ts
-var CHECK2 = "--check";
-var JSON_FLAG3 = "--json";
-var MAINTENANCE_COMMANDS = {
-  doctor: {
-    script: "scripts/doctor/doctor.ts",
-    description: "Diagnose PATH shadowing of the global josh and show the discovered repository map (--fix reclaims a stale shim)",
-    category: "Maintenance",
-    reference: ["[--fix]", "developer", ["files"]],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        { arguments: "", note: "diagnose only" },
-        { arguments: "--fix", note: "reclaim the global josh by removing a stale kit shim" },
-        { arguments: "--ports", note: "also print the per-repository port-seed table" }
-      ],
-      flags: [
-        {
-          names: ["--fix"],
-          description: "remove a shadowing binary **only if it is a kit shim** (its body references `@joshuafolkken/kit` or the removed `install-bin` script); any other binary is left and reported for manual review. Also the one-shot recovery for an old project that re-created the global shim."
-        },
-        { names: ["--ports"], description: "additionally print the port-seed table (see below)." }
-      ]
-    }
-  },
-  "ruleset:check": {
-    script: "scripts/repo/ruleset-check-cli.ts",
-    description: "Check that the default branch requires every status check kit's workflows report (--apply adds the missing ones)",
-    category: "Maintenance",
-    reference: ["[--apply]", "maintainer", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "report only" },
-        { arguments: "--apply", note: "add the missing checks to the existing rule" }
-      ],
-      flags: [
-        {
-          names: ["--apply"],
-          description: "append the missing checks to the ruleset's required-checks rule (or to the branch protection's contexts). It never creates a ruleset: with none, create one under Settings \u2192 Rules \u2192 Rulesets, then rerun. Writing a repository setting needs admin access, so only this flag writes \u2014 `josh sync` and `josh doctor` never do."
-        }
-      ]
-    }
-  },
-  overrides: {
-    script: "scripts/overrides/overrides-check.ts",
-    description: "Check pnpm overrides for drift",
-    category: "Maintenance",
-    reference: ["[--save] [--diff <base>[...<head>]]", "developer", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "verify overrides unchanged" },
-        { arguments: "--save", note: "snapshot current merged overrides" },
-        { arguments: "--diff HEAD", note: "after an update not yet committed" },
-        { arguments: "--diff main...<branch>", note: "after `josh adopt` committed its branch" }
-      ],
-      flags: [
-        {
-          names: ["--save"],
-          description: "write the current merged overrides to `.overrides-snapshot.json` (gitignored); later runs compare against it and exit non-zero on any add, removal, or change."
-        },
-        {
-          names: ["--diff <base>[...<head>]"],
-          description: "compare against git instead of the snapshot \u2014 `<base>` against the working tree, `<base>...<head>` the head against its merge-base with `<base>` \u2014 printing the `devEngines` verdict and `\u2714 overrides unchanged since <range>`, or exiting non-zero on any add, removal, or change. Refused beside `--save`."
-        }
-      ]
-    }
-  },
-  audit: {
-    script: "scripts/security/security-audit-main.ts",
-    description: "Run security audit",
-    category: "Maintenance",
-    reference: ["", "developer", ["processes"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  "lockfile:policy": {
-    script: "tools/security/lockfile-policy.ts",
-    description: "Verify the lockfile against pnpm's supply-chain policy (minimumReleaseAge) when it or the policy moved from the merge-base",
-    category: "Maintenance",
-    reference: ["", "automation", ["network"]],
-    is_kit_only: true,
-    usage: {
-      examples: [{ arguments: "", note: "verify when the lockfile or its policy moved" }]
-    }
-  },
-  "ci:timing": {
-    script: "scripts/ci/ci-timing-cli.ts",
-    description: "Print the job and step durations and conclusions of a run id's GitHub Actions run, or of every run on a pull request's or a branch's latest commit",
-    category: "Maintenance",
-    reference: ["<pr|branch|run-id> [--json]", "developer", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "5544", note: "a pull request, or a branch name" },
-        { arguments: "18912345678 --json", note: "a run id, machine-readable" }
-      ]
-    }
-  },
-  // The reader of `gh-usage-log.ts`'s file (joshuafolkken/kit#6753).
-  "gh:usage": {
-    script: "scripts/gh/gh-usage-cli.ts",
-    description: "Tally the josh processes' logged GitHub API usage per command \u2014 runs, calls, 304 answers and core used \u2014 most calls first, under the period the lines cover",
-    category: "Maintenance",
-    reference: ["[--since <instant>]", "developer", ["none"]],
-    is_read_only: true,
-    usage: {
-      examples: [
-        { arguments: "", note: "every line the log holds" },
-        { arguments: "--since 2026-11-08T00:00Z", note: "the lines at or after an instant" }
-      ]
-    }
-  },
-  "command:derive": {
-    script: "tools/document/command-derive.ts",
-    description: "Write every artifact the command map derives \u2014 usage spans and catalog \u2014 and print page bytes against their ceilings",
-    category: "Maintenance",
-    reference: ["", "maintainer", ["files"]],
-    // Kit-only: the pages it writes are kit's own documentation, and the script lives under the
-    // undistributed `tools/`.
-    is_kit_only: true,
-    // The command-map snapshot runs through one single-file vitest run.
-    core_weight: 1,
-    usage: {
-      examples: [{ arguments: "", note: "after adding, renaming or describing a command" }]
-    }
-  },
-  "audit:provision": {
-    script: "scripts/security/security-audit-provision-main.ts",
-    description: "Install the pinned osv-scanner when the audit cannot find one (no-op if present)",
-    category: "Maintenance",
-    reference: ["", "automation", ["files", "network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "no-op if a scanner is already present" },
-        { arguments: "--force", note: "ignore backoff, allow a longer download" }
-      ],
-      flags: [
-        {
-          names: ["--force"],
-          description: "ignore the 6-hour failure backoff and allow a longer download window; the command to run after fixing a network problem."
-        }
-      ]
-    }
-  },
-  "reconcile-templates": {
-    script: "scripts/sync/reconcile-templates.ts",
-    description: "Record template source hashes (--check to verify drift)",
-    category: "Maintenance",
-    reference: ["", "maintainer", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "regenerate copy templates + record tripwire hashes" },
-        { arguments: CHECK2, note: "verify templates are in sync; non-zero on drift" }
-      ],
-      flags: [
-        {
-          names: [CHECK2],
-          description: "verify only; exits non-zero on drift. A pre-commit hook runs this when a tracked source or copy template is staged."
-        }
-      ]
-    }
-  },
-  latest: {
-    shell: [
-      "sh",
-      "-c",
-      "export NODE_AUTH_TOKEN=$(gh auth token) && pnpm josh latest:guard && pnpm josh latest:update && pnpm josh ranges && pnpm josh audit && pnpm josh latest:corepack && pnpm josh latest:scope --record"
-    ],
-    description: "Update dependencies, run security audit, then update pnpm",
-    category: "Maintenance",
-    reference: ["", "developer", ["files", "network", "processes"]],
-    argument_targets: ["latest:corepack", "latest:update", "audit"],
-    usage: { examples: [{ arguments: "", note: "full update (update + audit + pnpm)" }] }
-  },
-  "latest:scope": {
-    script: "scripts/version/latest-scope-main.ts",
-    description: "Say whether this run has to update dependencies, from when josh latest last finished (--record notes a run)",
-    category: "Maintenance",
-    reference: ["[--record] [--json]", "automation", ["files"]],
-    // `JOSH_LATEST_MAX_AGE_HOURS` is documented as a project setting, so it has to be readable
-    // where the project keeps its settings — a variable that only works when exported from the
-    // shell is one a user follows the documentation for and gets the default from, silently.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        { arguments: "", note: "required or skip, the reason on stderr" },
-        { arguments: "--record", note: "note a finished josh latest run" },
-        { arguments: JSON_FLAG3, note: "the verdict and the reason as JSON" }
-      ],
-      flags: [
-        {
-          names: ["--record"],
-          description: "write the completion record `josh latest` ends with."
-        },
-        { names: [JSON_FLAG3], description: "emit the verdict and its reason as JSON." }
-      ]
-    }
-  },
-  "latest:if-required": {
-    script: "scripts/version/latest-if-required-cli.ts",
-    description: "Run josh latest only when latest:scope answers required, stashing around it",
-    category: "Maintenance",
-    reference: ["", "automation", ["files", "network", "processes"]],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: { examples: [{ arguments: "", note: "stash, update, pop on required" }] }
-  },
-  "latest:guard": {
-    script: "scripts/version/latest-lane-guard-main.ts",
-    description: "Refuse josh latest inside a lane (the update stamp is keyed to the project root)",
-    category: "Maintenance",
-    reference: ["", "automation", ["files"]],
-    usage: { examples: [{ arguments: "", note: "refuses inside a lane" }] }
-  },
-  "latest:corepack": {
-    script: "scripts/version/latest-corepack.ts",
-    description: "Update pnpm on the current major while preserving the integrity pin",
-    category: "Maintenance",
-    reference: ["", "developer", ["files", "network"]],
-    usage: { examples: [{ arguments: "", note: "update pnpm only" }] }
-  },
-  "latest:update": {
-    script: "scripts/version/latest-update.ts",
-    description: "Update all dependencies to latest",
-    category: "Maintenance",
-    reference: ["", "developer", ["files", "network"]],
-    // `JOSH_PLAYWRIGHT_BROWSERS` widens the browsers a Playwright bump installs, and a project
-    // keeps that setting in its `.env`.
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: { examples: [{ arguments: "", note: "update dependencies only" }] }
-  }
-};
-
-// scripts/josh/josh-commands-project.ts
-var STAGED = "--staged";
-var JSON_FLAG4 = "--json";
-var BRANCH_DIFF = "the branch diff";
-var STAGED_DIFF = "the staged diff instead";
-var PR_NUMBER = "42";
-var DRY_RUN = "--dry-run";
-var SKIP_PUBLISH_WAIT = "--skip-publish-wait";
-var PROFILE_ARGUMENTS = "[--profile basic|full]";
-var PROJECT_COMMANDS = {
-  profile: {
-    script: "scripts/init/project-profile-cli.ts",
-    description: "Show the project profile and the reason for it",
-    category: "Project",
-    reference: [PROFILE_ARGUMENTS, "developer", ["files"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  start: {
-    script: "scripts/init/start.ts",
-    description: "Set a project up for the GitHub Issue workflow, from git init to the setup PR",
-    category: "Project",
-    reference: [
-      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public] [--dry-run] [--init-command <command>] [--push-preflight-command <command>]`,
-      "developer",
-      ["files", "git", "network", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "", note: "asks for the profile and the repository" },
-        {
-          arguments: "--yes --github --profile basic",
-          note: "unattended, including the GitHub repository"
-        }
-      ],
-      flags: [
-        { names: ["--profile basic|full"], description: "the profile, without asking." },
-        { names: ["--yes"], description: "take the defaults \u2014 not consent to write to GitHub." },
-        { names: ["--github"], description: "create the GitHub repository and push `main`." },
-        { names: ["--public"], description: "create the repository public instead of private." },
-        {
-          names: ['--init-command "<command>"'],
-          description: "run this setup command in place of `josh init`."
-        },
-        {
-          names: ['--push-preflight-command "<command>"'],
-          description: "a check run before the first step when the plan pushes; a failure stops the run before it writes anything."
-        },
-        { names: ["--dry-run"], description: "print the plan and change nothing." }
-      ]
-    }
-  },
-  "dogfood:commit": {
-    script: "tools/dogfood/dogfood-commit-cli.ts",
-    description: "Make the first commit of a dogfood run's own kit-test-* project",
-    category: "Project",
-    reference: ["<dir>", "automation", ["files", "git"]],
-    is_kit_only: true,
-    usage: { examples: [{ arguments: "~/Development/kit-test-html-start" }] }
-  },
-  "fresh:run": {
-    script: "scripts/fresh-machine/fresh-machine-cli.ts",
-    description: "Run an install scenario in a Docker container of a machine with nothing installed, and keep the log",
-    category: "Project",
-    reference: [
-      "<pattern> | --spec <file.json> [--package-version <version>] [--log-dir <dir>] [--rebuild] | --list",
-      "maintainer",
-      ["files", "network", "processes"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "--list", note: "kit's seven patterns" },
-        { arguments: "kit-test-html-init", note: "one pattern, the packed checkout" },
-        {
-          arguments: "kit-test-html-start",
-          note: "a GitHub pattern, the latest published version"
-        },
-        { arguments: "--spec fresh/html-init.json", note: "a scenario another toolkit wrote" }
-      ],
-      flags: [
-        { names: ["--list"], description: "print the pattern names and run nothing." },
-        {
-          names: ["--spec <file.json>"],
-          description: "run the scenario in this file instead of a named pattern; the path is relative to the project root."
-        },
-        {
-          names: ["--package-version <version>"],
-          description: "the published version a `package_source: published` scenario installs. Default: the registry's latest version of the package the command is run from."
-        },
-        {
-          names: ["--log-dir <dir>"],
-          description: "where the log is written. Default: `.josh/tmp/fresh-machine`."
-        },
-        { names: ["--rebuild"], description: "build the machine image without the layer cache." }
-      ]
-    }
-  },
-  "auth:setup": {
-    script: "scripts/auth/auth-setup-cli.ts",
-    description: "Save the long-lived Claude Code token `claude setup-token` prints in the macOS keychain, for josh fresh:run",
-    category: "Project",
-    reference: ["[--check]", "maintainer", ["network", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "sign in and save the token" },
-        { arguments: "--check", note: "ok: \u2026 saved on <date>, or missing: \u2026 and exit 1" }
-      ]
-    }
-  },
-  init: {
-    script: "scripts/init/init-main.ts",
-    description: "Initialize config in a new project",
-    category: "Project",
-    reference: [
-      `${PROFILE_ARGUMENTS} [--no-install] [--dry-run]`,
-      "developer",
-      ["files", "network", "processes"]
-    ],
-    usage: {
-      examples: [
-        {
-          arguments: "",
-          note: "create/merge config files, install and format (--no-install skips both, --dry-run only prints the plan)"
-        }
-      ]
-    }
-  },
-  sync: {
-    script: "scripts/sync/sync-main.ts",
-    description: "Sync config files",
-    category: "Project",
-    reference: ["[--force]", "developer", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "overwrite managed files" },
-        { arguments: "--force", note: "also replace a file you added to, dropping your additions" }
-      ]
-    }
-  },
-  uninstall: {
-    script: "scripts/uninstall/uninstall.ts",
-    description: "Remove what kit added to a project and list what is left to review by hand",
-    category: "Project",
-    reference: [`${PROFILE_ARGUMENTS} [--yes]`, "developer", ["files", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "show the plan, then ask" },
-        { arguments: "--yes", note: "remove without asking" }
-      ]
-    }
-  },
-  "sync:scope": {
-    script: "scripts/sync/managed-config-scope-cli.ts",
-    description: "Say whether this change touches a file josh sync distributes",
-    category: "Project",
-    reference: ["[--staged] [--json]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "", note: BRANCH_DIFF },
-        { arguments: STAGED, note: STAGED_DIFF },
-        { arguments: JSON_FLAG4, note: '{"scope":"managed","reason":"..."}' }
-      ],
-      flags: [
-        { names: [STAGED], description: "inspect the staged diff instead of the branch diff." },
-        { names: [JSON_FLAG4], description: 'emit `{"scope","reason"}` as JSON.' }
-      ]
-    }
-  },
-  "sonar:hotspots": {
-    script: "scripts/sonar/sonar-hotspots-cli.ts",
-    description: "Fetch SonarCloud hotspots on a pull request and print each one's Step B disposition",
-    category: "Project",
-    reference: ["<PR>", "automation", ["network"]],
-    usage: { examples: [{ arguments: PR_NUMBER }] }
-  },
-  "sonar:new-code": {
-    script: "scripts/sonar/sonar-new-code-cli.ts",
-    description: "Fail when a pull request adds any new SonarCloud issue or duplicated block",
-    category: "Project",
-    reference: ["<PR>", "automation", ["network"]],
-    usage: { examples: [{ arguments: PR_NUMBER }] }
-  },
-  "ui:routes": {
-    script: "scripts/ui/ui-routes-cli.ts",
-    description: "List the screenshot-target routes the current change touches",
-    category: "Project",
-    reference: ["[--staged]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "", note: BRANCH_DIFF },
-        { arguments: STAGED, note: STAGED_DIFF }
-      ]
-    }
-  },
-  "ui:shot": {
-    script: "scripts/ui/ui-shot-cli.ts",
-    description: "Capture routes with this project's own screenshot command",
-    category: "Project",
-    reference: ["<route> [route...]", "automation", ["processes"]],
-    usage: { examples: [{ arguments: "/ /blog" }] }
-  },
-  propagate: {
-    script: "scripts/propagate/propagate.ts",
-    description: "Carry the published release into every consumer repository next to this one",
-    category: "Project",
-    reference: [
-      "[--dry-run] [--skip-publish-wait] [--target <repo>]",
-      "maintainer",
-      ["files", "network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: DRY_RUN, note: "report targets and steps, write nothing" },
-        { arguments: SKIP_PUBLISH_WAIT, note: "release already known to be published" },
-        { arguments: "--target app-kit", note: "carry the release into one consumer only" }
-      ],
-      flags: [
-        {
-          names: [DRY_RUN],
-          description: "report targets and steps without writing; skips the publish wait, opens no issues."
-        },
-        {
-          names: [SKIP_PUBLISH_WAIT],
-          description: "skip the registry poll for an already-published release."
-        },
-        {
-          names: ["--target <repo>"],
-          description: "process only that consumer (`app-kit` or `joshuafolkken/app-kit`); the rest are reported `skipped` and left untouched. An unknown, ambiguous or non-dependent name fails before the publish wait, writing nothing."
-        }
-      ]
-    }
-  },
-  adopt: {
-    script: "scripts/adopt/adopt.ts",
-    description: "Upgrade the @joshuafolkken toolkits and other dependencies here, open the PR",
-    category: "Project",
-    reference: ["[--dry-run]", "developer", ["files", "git", "network", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--dry-run", note: "report the steps without touching anything" }
-      ],
-      flags: [{ names: ["--dry-run"], description: "report the plan without writing." }]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-versioning.ts
-var VERSIONING_COMMANDS = {
-  bump: {
-    script: "scripts/version/bump-version-main.ts",
-    description: "Bump package version",
-    category: "Versioning",
-    reference: ["[major|minor|patch]", "maintainer", ["files"]],
-    usage: { examples: [{ arguments: "major" }, { arguments: "minor" }, { arguments: "patch" }] }
-  },
-  version: {
-    script: "scripts/version/version-check.ts",
-    description: "Show kit versions; --upgrade updates the global and project install",
-    category: "Versioning",
-    reference: ["[--upgrade]", "developer", ["files", "network", "processes"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        {
-          arguments: "--upgrade",
-          note: "upgrade global + project to latest, then re-run fix-gh-packages"
-        }
-      ],
-      flags: [
-        {
-          names: ["--upgrade"],
-          description: "upgrade both the global install (`pnpm add -g`) and the project devDependency (`pnpm add -D` + `fix-gh-packages`); already-current or not-installed targets are skipped."
-        }
-      ]
-    }
-  },
-  // A `script` entry, not a shell one: script paths resolve against the kit package root, so this
-  // keeps working from a consumer repo where the file lives under node_modules. The registry
-  // probes need NODE_AUTH_TOKEN for any `@joshuafolkken/*` dependency; `josh latest` exports it
-  // before chaining here, exactly as it already does for `latest:update`.
-  ranges: {
-    script: "scripts/version/publishable-range-check.ts",
-    description: "Check that every published dependency range still resolves for a consumer and no peer range falls below an installed toolkit",
-    category: "Versioning",
-    reference: ["", "developer", ["network"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  // The one place that decides a version. A `script` entry for the same
-  // reason `ranges` is one: script paths resolve against the kit package root, so it keeps working
-  // from a consumer repository where the file lives under node_modules.
-  release: {
-    script: "scripts/release/release-cli.ts",
-    description: "Release the merges main has taken since the version last changed",
-    category: "Versioning",
-    reference: ["[--dry-run]", "maintainer", ["git", "network", "release"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--dry-run", note: "count and report, write nothing" }
-      ],
-      flags: [
-        {
-          names: ["--dry-run"],
-          description: "count and report only; writes nothing, fetches nothing, and creates no work tree."
-        },
-        {
-          names: ["--help", "-h"],
-          description: "print the usage line and exit 0 without fetching or releasing. Any other argument is refused with the usage line and a non-zero exit, before anything is fetched."
-        }
-      ]
-    }
-  },
-  // The read-only half of the one above. `release --dry-run` cannot
-  // answer this question: it refuses off the default branch and on a dirty tree, which is every
-  // position a run asks it from. A `script` entry for the same reason `release` is one.
-  "release:scope": {
-    script: "scripts/release/release-scope-main.ts",
-    description: "Say whether a release is owed, from the unreleased merges on main",
-    category: "Versioning",
-    reference: ["[--json]", "automation", ["none"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "\u2192 required | skip | unknown" },
-        { arguments: "--json", note: '{"scope":"\u2026","reason":"\u2026"} on one line' }
-      ]
-    }
-  },
-  // Run by the release workflows, kit's and the one sync distributes, after a tag has published.
-  // Settings come from the environment, so the workflow decides them.
-  "release:github": {
-    script: "scripts/release/github-release-cli.ts",
-    description: "Create the GitHub Release for a published tag, with generated notes",
-    category: "Versioning",
-    reference: ["", "automation", ["network", "release"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "run by CI with GH_TOKEN, RELEASE_TAG and GITHUB_REPOSITORY set" }
-      ]
-    }
-  },
-  // Run by publish.yml, kit's and the one sync distributes: josh runs it through kit's own tsx, which
-  // a kit that publishes may not have as a dependency of its own (#7303).
-  "release:tag": {
-    script: "scripts/release/publish-tag-cli.ts",
-    description: "Print the npm dist-tag a version publishes under, given the current latest",
-    category: "Versioning",
-    reference: ["<version> <latest>", "automation", ["none"]],
-    usage: {
-      examples: [{ arguments: "1.2.0 1.1.0", note: "\u2192 latest" }]
-    }
-  }
-};
-
-// scripts/josh/josh-commands-workflow.ts
-var PR_TITLE = '"PR title #N"';
-var BODY_FILE_NOTE = "written under `.josh/tmp/` (`-` reads stdin); use this whenever the body carries a backtick or `$`. Passing both forms is refused.";
-var ISSUE_URL = '--issue-url "https://..."';
-var REVIEW_ISSUE = "--issue 2325";
-var CHECK3 = "--check";
-var YES = "-y";
-var SKIP_COMMIT = "--skip-commit";
-var SKIP_PUSH = "--skip-push";
-var GIT_WORKFLOW_SCRIPT = "scripts/git/git-workflow.ts";
-var GIT_MESSAGE_ARGUMENTS = "[-y] <message>";
-var PERIOD_ARGUMENTS = "[--period <days>]";
-var WORKFLOW_COMMANDS = {
-  git: {
-    script: GIT_WORKFLOW_SCRIPT,
-    description: "Git workflow helper",
-    category: "Workflow",
-    reference: [GIT_MESSAGE_ARGUMENTS, "developer", ["git", "network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "interactive" },
-        { arguments: YES, note: "unattended (no TTY required)" },
-        { arguments: '-y "title"', note: "set commit message prefix" },
-        { arguments: '-y "<title> #<N>"', note: "follow-up commit on the same branch" },
-        {
-          arguments: "-y --skip-commit --skip-push",
-          note: "open the PR without committing/pushing"
-        }
-      ],
-      flags: [
-        {
-          names: [YES, "--yes"],
-          description: "run non-interactively; works without a TTY (agent or CI shell)."
-        },
-        {
-          names: [SKIP_COMMIT, SKIP_PUSH],
-          description: "recover/open a PR without a new commit or push."
-        },
-        {
-          names: ["--body-file <path>"],
-          description: "extra PR body text after `closes #N`, from a file (`-` = stdin); use it when the text holds a backtick or `$`."
-        }
-      ]
-    }
-  },
-  pr: {
-    script: GIT_WORKFLOW_SCRIPT,
-    description: "Create PR only (skip commit and push)",
-    category: "Workflow",
-    // Not `GIT_MESSAGE_ARGUMENTS`: `-y` is already in the default arguments below, so advertising
-    // it would document a flag that cannot change what this command does.
-    reference: ["<message>", "developer", ["network"]],
-    default_script_arguments: [YES, SKIP_COMMIT, SKIP_PUSH],
-    usage: { examples: [{ arguments: "", note: "open the PR for the current <N>-<slug> branch" }] }
-  },
-  // **The optional form, on both**. The mandatory `--env-file=.env` is resolved by node before the
-  // script's first line: on a machine with no `.env` it dies as `.env: not found` with exit code 9,
-  // even where `TELEGRAM_BOT_TOKEN` and `TELEGRAM_CHAT_ID` exist as real environment variables — a
-  // cloud session, and `followup` with them the merge step of every `fullrun` there.
-  //
-  // Nothing is lost by relaxing it: both scripts already load `.env` through `josh_environment_file`
-  // themselves, so the file is read either way and node's precedence — an existing environment
-  // variable wins over the file — is node's own in both spellings.
-  //
-  // **A missing credential still fails loudly**: `telegram_notify.send` throws on missing credentials
-  // and on a failed send, so `josh notify` exits non-zero instead of warning and answering 0.
-  followup: {
-    script: "scripts/followup/git-followup-workflow.ts",
-    description: "Follow-up git workflow",
-    category: "Workflow",
-    reference: [
-      "<title> [--notify-message <text>]",
-      "automation",
-      ["git", "network", "notifications"]
-    ],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        { arguments: PR_TITLE, note: "merges (default)" },
-        { arguments: String.raw`${PR_TITLE} --notify-message "Implemented X:\n- change 1"` },
-        { arguments: `${PR_TITLE} --notify-message-file .josh/tmp/completion.md` },
-        { arguments: `${PR_TITLE} --ai-review-ignore-reason "false positive"` },
-        { arguments: `${PR_TITLE} --no-merge`, note: "do the work, leave the PR open" }
-      ],
-      flags: [
-        {
-          names: ["--no-merge"],
-          description: "do the follow-up work but do not merge; leaves the PR open (the only flag that stops the merge). `--merge` is a deprecated no-op. A PR already merged by hand skips the CI wait, the AI-review scan and the merge and runs only the post-merge tail; a completion report already on the Issue is not posted again."
-        },
-        {
-          names: ["--notify-message"],
-          description: "inline completion body; `\\n` expands to newlines."
-        },
-        {
-          names: ["--notify-message-file"],
-          description: `read the completion body from a file ${BODY_FILE_NOTE}`
-        },
-        {
-          names: ["--ai-review-ignore-reason"],
-          description: "reason to dismiss an AI-review finding."
-        }
-      ]
-    }
-  },
-  "checks:failed": {
-    script: "scripts/gh/git-gh-checks-failed-main.ts",
-    description: "List the failing CI checks of a pull request or commit, required or not (check runs and commit statuses)",
-    category: "Workflow",
-    reference: ["[<PR|sha>]", "developer", ["network"]],
-    usage: {
-      examples: [
-        { arguments: "", note: "the current branch's pull request" },
-        { arguments: "7147", note: "a pull request by number" },
-        { arguments: "c0ffee1", note: "a commit by sha" }
-      ]
-    },
-    is_read_only: true
-  },
-  notify: {
-    script: "scripts/notify/telegram-test-main.ts",
-    description: "Send Telegram notification",
-    category: "Workflow",
-    reference: [
-      "[--task-type <type>] [--body <text> | --body-file <path>] [--issue-url <url>] [--pr-url <url>] [--issue-title <text>] [--repo-name <name>] [--recommended <text>] [--alternative <text>]...",
-      "automation",
-      ["notifications"]
-    ],
-    tsx_arguments: OPTIONAL_ENV_FILE_FLAGS,
-    usage: {
-      examples: [
-        {
-          arguments: String.raw`--task-type planning ${ISSUE_URL} --body="- bullet 1\n- bullet 2"`
-        },
-        {
-          arguments: `--task-type confirmation ${ISSUE_URL} --body-file .josh/tmp/r.md --recommended "Go" --alternative "Wait"`
-        }
-      ],
-      flags: [
-        {
-          names: ["--task-type"],
-          description: "one of `planning` \u{1F4CB}, `completion` \u2705, `failure` \u274C, `warning` \u26A0\uFE0F, `kickoff_retry` \u{1F504}, `confirmation` \u23F8\uFE0F. Do not send `completion` or `warning` by hand \u2014 `josh followup` sends them."
-        },
-        {
-          names: ["--body", "--body=$'\u2026'"],
-          description: "inline body; use `--body=$'\u2026'` when it starts with `-`."
-        },
-        { names: ["--body-file"], description: `read the body from a file ${BODY_FILE_NOTE}` },
-        {
-          names: ["--repo-name", "--issue-url", "--pr-url"],
-          description: "header repository, resolved in that order, then the working directory. The issue title is read from `--issue-url`."
-        },
-        {
-          names: ["--recommended", "--alternative"],
-          description: "the choices appended under `JOSH_SESSION_LANG` headings; `--recommended` is required for `confirmation`, `--alternative` is repeatable."
-        }
-      ]
-    }
-  },
-  // Counting, appending and deciding a second sighting together keeps ledger judgments consistent.
-  "observation:record": {
-    script: "scripts/observations/observation-record-cli.ts",
-    description: "Record an observation sighting and answer whether it is now filed",
-    category: "Workflow",
-    reference: ["<key> <depth> <where> <what> [--checkout <path>]", "automation", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "flaky-e2e d1 'tests/e2e/login.test.ts' 'times out on CI only'" },
-        {
-          arguments: "flaky-e2e d1 'src/app.ts' 'fails there too' --checkout ~/Development/app",
-          note: "another repository's ledger"
-        }
-      ],
-      flags: [
-        {
-          names: ["--checkout <path>"],
-          description: "count and append in that repository's `.josh/observations/` instead."
-        }
-      ]
-    }
-  },
-  // The depth test's table read off a path, so the `<depth>` above is derived rather than judged.
-  "observation:depth": {
-    script: "scripts/observations/observation-depth-cli.ts",
-    description: "Print the depth test's depth for a subject path",
-    category: "Workflow",
-    reference: ["<path>", "automation", ["none"]],
-    usage: { examples: [{ arguments: "scripts/lane/lane-plan.ts" }] }
-  },
-  // The observation ledger's commit path for the lines no run's own commit carried:
-  // a lane's lines sit in the primary checkout, which
-  // its commit cannot see, and the recurrence count the promotion rule reads is a count of main.
-  "observations:flush": {
-    script: "scripts/observations/observations-flush-cli.ts",
-    description: "Commit the observation ledger as a pull request of its own, and merge it",
-    category: "Workflow",
-    reference: ["", "automation", ["git", "network"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  // The one write path for a `/code-review` round's findings, plus the
-  // `--check` gate `followup` runs before it merges. It appends a `- rf:`
-  // line per finding — or one zero-finding line for a clean round — to the observation ledger, so
-  // `observations:flush` commits them and the recurrence count survives the run.
-  "review:record": {
-    script: "scripts/review/review-record-main.ts",
-    description: "Record a review round\u2019s findings, or check a round was recorded",
-    category: "Workflow",
-    reference: [
-      "--issue <N> [--comment | --interaction] [<category>:<severity>:<file>[ \u2014 <reason>] ...] | --from-slot --issue <N> [--comment | --interaction] [<n>=<disposition> ...] | --check [--interaction] --issue <N>",
-      "automation",
-      ["files", "network"]
-    ],
-    usage: {
-      examples: [
-        { arguments: `${REVIEW_ISSUE} bug-risks:medium:src/foo.ts:42 tests:low:a.test.ts` },
-        { arguments: REVIEW_ISSUE, note: "a zero-finding round \u2014 records one `none` line" },
-        {
-          arguments: `${REVIEW_ISSUE} --comment`,
-          note: "a round that passed after the PR opened \u2014 an Issue comment, no append"
-        },
-        { arguments: `${CHECK3} ${REVIEW_ISSUE}`, note: "the merge gate: was it recorded?" },
-        {
-          arguments: `${REVIEW_ISSUE} --interaction`,
-          note: "the interaction review\u2019s pass \u2014 a `- ri:` line"
-        },
-        {
-          arguments: `--from-slot ${REVIEW_ISSUE} 2=filed:#7`,
-          note: "the findings the reviewer wrote with review:submit \u2014 each `fixed` unless its line is given another"
-        }
-      ]
-    }
-  },
-  // The reader over the durable review stop log: each finding that stopped a ship, with its file:line
-  // and first sentence, so a period's stops are classified without reading ship logs.
-  "review:stops": {
-    script: "scripts/review/review-stops-cli.ts",
-    description: "List the review findings that stopped a josh ship over a period, by kind, file:line and first sentence",
-    category: "Workflow",
-    reference: [PERIOD_ARGUMENTS, "developer", ["none"]],
-    usage: { examples: [{ arguments: "--period 30", note: "the last 30 days (default 7)" }] }
-  },
-  // The reader over what `review:record` wrote: each recurring category’s
-  // count, and the number of zero-finding rounds that distinguishes a quiet category from an unwatched one.
-  "review:findings": {
-    script: "scripts/review/review-findings-cli.ts",
-    description: "Count review findings by category from the observation ledger",
-    category: "Workflow",
-    reference: [PERIOD_ARGUMENTS, "developer", ["files"]],
-    usage: {
-      examples: [
-        { arguments: "" },
-        { arguments: "--period 7", note: "the last 7 days, by category and severity" }
-      ]
-    }
-  },
-  // After a behavior-change Issue merges, re-run its declared baseline and print before/after; a value
-  // that did not move appends a refuted-premise line to the observation ledger.
-  "measure:rerun": {
-    script: "scripts/issue/measure-rerun-cli.ts",
-    description: "Re-run a merged issue\u2019s baseline command and print the before/after pair",
-    category: "Workflow",
-    reference: ["<issue-number>", "automation", ["network", "processes", "files"]],
-    usage: { examples: [{ arguments: "2212" }] }
-  },
-  // A script rather than an `sh -c` chain, because it has a precondition to enforce: run inside a
-  // linked work tree it would hijack the default branch from every other one.
-  "main:sync": {
-    script: "scripts/git/main-sync-main.ts",
-    description: "Checkout default branch, pull latest, and prune merged remote-gone branches (refuses inside a lane)",
-    category: "Workflow",
-    reference: ["", "developer", ["git", "network"]],
-    usage: { examples: [{ arguments: "" }] }
-  },
-  // A script rather than an `sh -c` chain, because the strategy has to be named rather than left to
-  // the caller's git configuration: a bare `git pull` aborts with `Need to specify how to reconcile
-  // divergent branches` on exactly the diverged branch the command exists for.
-  //
-  // **It declares no core weight, by measurement** (joshuafolkken/kit#3944): its own work is git, and
-  // the catalog it may regenerate took 0.6s of CPU. The heavy processes seen beside it are commit
-  // hooks — its regenerated catalog's commit runs them — which reserve themselves, and a weight here
-  // would set the held mark they inherit, folding the parallel hook tools into this one place.
-  "main:merge": {
-    script: "scripts/git/main-merge-main.ts",
-    description: "Merge origin default branch into the current branch",
-    category: "Workflow",
-    reference: ["", "developer", ["git", "network"]],
-    usage: { examples: [{ arguments: "" }] }
-  }
-};
-
-// scripts/josh/josh-command-map.ts
-var CATEGORY_ORDER = [
-  "Development",
-  "Project",
-  "Workflow",
-  "Versioning",
-  "Maintenance",
-  "Git hooks",
-  "AI tools"
-];
-var COMMAND_MAP = {
-  completion: {
-    script: "scripts/josh/josh-completion.ts",
-    description: "Print command names and aliases, or a shell completion script",
-    category: "Development",
-    reference: ["--names | <zsh|bash|fish>", "automation", ["none"]],
-    is_read_only: true,
-    usage: {
-      examples: [
-        { arguments: "--names" },
-        { arguments: "zsh" },
-        { arguments: "bash" },
-        { arguments: "fish" }
-      ]
-    }
-  },
-  ...DEV_COMMANDS,
-  ...PROJECT_COMMANDS,
-  ...WORKFLOW_COMMANDS,
-  ...VERSIONING_COMMANDS,
-  ...MAINTENANCE_COMMANDS,
-  ...HOOKS_COMMANDS,
-  ...AI_COMMANDS,
-  ...LINT_COMMANDS,
-  ...CLONE_COMMANDS
-};
-
-export {
-  CATEGORY_ORDER,
-  COMMAND_MAP
-};