@joshuafolkken/kit 1.953.0 → 1.972.0

package/README.md

@@ -19,13 +19,15 @@ kit adds no linter or test runner for languages other than JavaScript and TypeSc
 In your project directory:
 
 ```bash
-pnpm add -D --allow-build=esbuild @joshuafolkken/kit
+pnpm add -D --allow-build=esbuild --allow-build=unrs-resolver @joshuafolkken/kit
 pnpm exec josh init
-pnpm install
-pnpm josh format
 pnpm josh gate
 ```
 
+`josh init` finishes by running `pnpm install` and `josh format` itself; pass `--no-install` to skip both, for example on CI or offline.
+
+`josh init` is the entry without GitHub. To start a new project on the GitHub Issue workflow (`kickoff`), run `pnpm exec josh start` instead of `josh init` — it also creates the Git repository, the GitHub repository and the labels ([init.md → `josh init` or `josh start`](./docs/init.md#josh-init-or-josh-start)).
+
 It needs [Node.js](https://nodejs.org/) 22.19.0 or later with [pnpm](https://pnpm.io/), even for a `static` project; [getting-started.md](./docs/getting-started.md) installs both. The global `josh` command ([cli.md](./docs/cli.md)) and the [gh CLI](https://cli.github.com/) for `josh version` and the GitHub Issue workflow are optional.
 
 ## Documentation

package/dist/CLAUDE.md

@@ -89,7 +89,7 @@ Read from a `.env` file at the project root by the AI scripts, `josh port` and `
 
 ### Dependency overrides (`pnpm-workspace.yaml` / `package.json`)
 
-- **Effective overrides live in `pnpm-workspace.yaml`.** pnpm 11 and 12 ignore `pnpm.overrides` in `package.json` (verified with pnpm 12.6.0). Check both files for existing declarations, but never count the ignored package field as an effective override. **An absent or empty `pnpm.overrides` is not evidence that the project has no overrides.**
+- **Effective overrides live in `pnpm-workspace.yaml`.** pnpm 11 and 12 ignore `pnpm.overrides` in `package.json`. Check both files for existing declarations, but never count the ignored package field as an effective override. **An absent or empty `pnpm.overrides` is not evidence that the project has no overrides.**
 - **NEVER** remove or modify entries in **either** location without explicit user approval.
 - **NEVER** modify the `devEngines` field in `package.json` without explicit user confirmation. It pins the development toolchain (e.g. pnpm version); silently changing it can break CI or other contributors' environments.
 - **The check is a command you run, not a conclusion you reach.** After `pnpm update`, `josh latest`, or any dependency-update command, **load the `dependency-update` skill** and follow its procedure before reporting anything about the pins.
@@ -144,7 +144,7 @@ Before every `git commit` (follow-up commits included), self-review against `nod
 
 ## Doc Sync Rules
 
-**`CLAUDE.md` is the single source for every agent rule.** `AGENTS.md` and `GEMINI.md` carry no rules — a rule addition, spec change or wording fix is written **once**, here (joshuafolkken/kit#963). The structural test [scripts/document/ai-document-pointers.test.ts](https://github.com/joshuafolkken/kit/blob/main/scripts/document/ai-document-pointers.test.ts) fails if a rule body reappears in either, or if a pointer loses the sentence that sends an agent here.
+**`CLAUDE.md` is the single source for every agent rule.** `AGENTS.md` and `GEMINI.md` carry no rules — a rule addition, spec change or wording fix is written **once**, here (joshuafolkken/kit#963).
 
 **docs/ must stay in sync with the package.** When `josh bump` changes the version, review `https://github.com/joshuafolkken/kit/tree/main/docs/` and update any section describing changed behavior (new/renamed commands, `josh init` / `josh sync` behavior, new config files) before committing.
 
@@ -166,7 +166,7 @@ Before every `git commit` (follow-up commits included), self-review against `nod
 
 `kickoff`, `fullrun`, `halfrun` and `backlogrun` are the Issue-driven shorthand commands. **Their procedures are not resident** — they live in the `workflow-commands` skill. **What stays here is decided by one question: must the rule fire on a turn where no skill was loaded?** Explicit invocation, the mid-workflow stop notification, the `overrides` / `devEngines` prohibitions, the UI-verification gate and the three `epic:*` rules below all do; everything a run reaches only after reading the skill is routed to, never restated (`SKILL.md` → "What stays resident, and what is read from here").
 
-**Read the skill before running any part of a command — including the first `gh` call.** Acting from the table below alone is not enough: the table says which command was typed, not how to run it.
+**Read the skill before running any part of a command — including the first `gh` call.**
 
 | Typed keyword            | What it does                                                                                                                                                          | Read first                                                       |
 | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |

package/dist/hooks/batch-guard.js

@@ -9,10 +9,10 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-V7RH56HU.js";
-import "./chunk-OM5VDM6F.js";
-import "./chunk-O3PEDF3M.js";
-import "./chunk-EYFJ74MJ.js";
+} from "./chunk-NXL3SBXY.js";
+import "./chunk-2K52BRWV.js";
+import "./chunk-KQG4776P.js";
+import "./chunk-ZPLXLJ7O.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 export {

package/dist/hooks/{chunk-OM5VDM6F.js → chunk-2K52BRWV.js}

@@ -1,13 +1,13 @@
 import {
   lane_child_marker
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 import {
   time_bundle_call,
   time_format,
   time_round_trips,
   time_spans,
   time_transcript_line
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 
 // scripts/lane/lane-guard-policy.ts
 var DEFAULT_MODE = "refuse";

package/dist/hooks/{chunk-Z5TVZ4AP.js → chunk-BNWIOJFU.js}

@@ -35,31 +35,31 @@ import {
   run_watcher_guard,
   shell_segments,
   tail_commands
-} from "./chunk-452OKRQX.js";
+} from "./chunk-WWTMHHZU.js";
 import {
   find_local_bin_upwards
 } from "./chunk-3V37IID6.js";
 import {
   batch_outcome
-} from "./chunk-V7RH56HU.js";
+} from "./chunk-NXL3SBXY.js";
 import {
   investigation_refusal
-} from "./chunk-NKVLBB65.js";
+} from "./chunk-BVMSPG3M.js";
 import {
   duplicate_read_outcome
-} from "./chunk-IBFC25IX.js";
+} from "./chunk-ZYYSBNR6.js";
 import {
   investigation_reads
-} from "./chunk-M4U4YNRE.js";
+} from "./chunk-F6OM6SIG.js";
 import {
   lane_guard_policy,
   time_batch_guard
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-2K52BRWV.js";
 import {
   hook_decision,
   lane_child_marker,
   run_issue_number
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 import {
   PLATFORM_TEMP_ROOT,
   cost_attribute,
@@ -71,7 +71,7 @@ import {
   stamp_file,
   time_density_hook,
   time_shell
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 
 // scripts/hooks/pretool-guard.ts
 import { text } from "node:stream/consumers";
@@ -1016,24 +1016,37 @@ function current_state() {
     directory: process.cwd(),
     source: process.env,
     carried: run_cut.carried_cut_sync,
+    held_issue: run_cut.held_issue_sync,
     // **Read through the short reuse window** (joshuafolkken/kit#2385). The row now fires per
     // threshold crossing rather than once per run, so this predicate is a candidate on every edit;
     // the window collapses one turn's burst of edits to a single whole-transcript price.
     verdict: () => implementation_cut_verdict.reused_verdict(() => cost_cli.session_verdict())
   };
 }
-function uncut_lane_child_issue(state) {
+function lane_child_issue(state) {
   if (!lane_child_marker.is_child_of(state.directory, state.source)) return void 0;
-  const issue = lane_paths.lane_issue_of(state.directory, { ...state.source });
+  return lane_paths.lane_issue_of(state.directory, { ...state.source });
+}
+function held_run_issue(state) {
+  if (lane_paths.lane_issue_of(state.directory, { ...state.source }) !== void 0) return void 0;
+  return state.held_issue();
+}
+function uncut_run_issue(state) {
+  const issue = lane_child_issue(state) ?? held_run_issue(state);
   if (issue === void 0) return void 0;
   return state.carried()?.issue === issue ? void 0 : issue;
 }
+function warrants_the_cut(state) {
+  const verdict = state.verdict();
+  if (lane_child_issue(state) === void 0) return verdict === cost_verdict.OVER_VERDICT;
+  return verdict !== cost_verdict.UNDER_VERDICT;
+}
 function is_over_threshold_edit(call, state = current_state()) {
-  if (!is_edit_tool(call.name) || uncut_lane_child_issue(state) === void 0) return false;
-  return state.verdict() !== cost_verdict.UNDER_VERDICT;
+  if (!is_edit_tool(call.name) || uncut_run_issue(state) === void 0) return false;
+  return warrants_the_cut(state);
 }
 var THRESHOLD_TEXT = `${cost_format.format_tokens(CONTEXT_CUT_THRESHOLD)}-token`;
-var IMPLEMENTATION_CUT_REASON = `\u26D4 implementation-phase cut: this checkout is a lane dispatched for this issue and its recent-context cost has crossed the shared ${THRESHOLD_TEXT} threshold mid-implementation, so the thinking accumulated so far is now re-read on every later request. Take the cut before this edit. First write a handoff file with the Write tool \u2014 the user\u2019s instruction verbatim, what you have completed, what remains, and what you deliberately did not touch \u2014 and pass it as \`--handoff <path>\`, so the fresh process resumes on the original instruction rather than the working tree alone (joshuafolkken/kit#2354); a resume that finds no instruction is refused \`incomplete\` rather than continuing blind. \`pnpm josh run:cut --impl <N> --handoff <path>\` ends this process and relaunches a fresh one that resumes back into implementation (\`resume-impl\`), dropping the accumulated context rather than carrying it \u2014 joshuafolkken/kit#1933 built the boundary and joshuafolkken/kit#2310 measured it firing 0 times because the verdict was only ever read at session entry, where the context has not yet grown. The verdict is \`pnpm josh cost --cut\`'s exactly \u2014 the same per-request billed-input statistic against the same threshold, never a second measurement. Issue \`pnpm josh run:cut --impl <N> --handoff <path>\` now and read the verdict: on \`cut\`, **end the turn immediately** \u2014 the fresh process owns the run and continues implementing, so it must not be waited for; on \`not-a-lane\`, \`unready\`, \`busy\`, \`failed\` or \`unknown\`, this process carries the run on and the edit is simply the next call. Never relaunch a second process after \`busy\`. This fired because the dispatch mark names this lane; a person working here carries no mark and sees no refusal, so there is no human-or-child judgement left to make. The procedure is \`.claude/skills/workflow-commands/pre-gate-cut.md\`. Reissue this edit once the cut has answered \u2014 an edit reissued right after this refusal passes, so \`busy\` / \`failed\` cannot wedge the run edit after edit; this fires again on the next threshold crossing rather than once per run.`;
+var IMPLEMENTATION_CUT_REASON = `\u26D4 implementation-phase cut: this checkout is a lane dispatched for this issue, or a run holds it for this issue (joshuafolkken/kit#2760), and its recent-context cost has crossed the shared ${THRESHOLD_TEXT} threshold mid-implementation, so the thinking accumulated so far is now re-read on every later request. Take the cut before this edit. First write a handoff file with the Write tool \u2014 the user\u2019s instruction verbatim, what you have completed, what remains, and what you deliberately did not touch \u2014 and pass it as \`--handoff <path>\`, so the fresh process resumes on the original instruction rather than the working tree alone (joshuafolkken/kit#2354); a resume that finds no instruction is refused \`incomplete\` rather than continuing blind. \`pnpm josh run:cut --impl <N> --handoff <path>\` ends this process and relaunches a fresh one that resumes back into implementation (\`resume-impl\`), dropping the accumulated context rather than carrying it \u2014 joshuafolkken/kit#1933 built the boundary and joshuafolkken/kit#2310 measured it firing 0 times because the verdict was only ever read at session entry, where the context has not yet grown. The verdict is \`pnpm josh cost --cut\`'s exactly \u2014 the same per-request billed-input statistic against the same threshold, never a second measurement. Issue \`pnpm josh run:cut --impl <N> --handoff <path>\` now and read the verdict: on \`cut\`, **end the turn immediately** \u2014 in a lane the fresh process owns the run and continues implementing, so it must not be waited for; outside a lane nothing is relaunched, so first send the \`confirmation\` Telegram naming the resume command \`fullrun #<N>\` and keep the hold; on \`not-a-lane\`, \`unready\`, \`busy\`, \`failed\` or \`unknown\`, this process carries the run on and the edit is simply the next call. Never relaunch a second process after \`busy\`. This fired because the dispatch mark names this lane or the run hold names this issue; a person working here carries no mark and holds no run, so sees no refusal, so there is no human-or-child judgement left to make. The procedure is \`.claude/skills/workflow-commands/pre-gate-cut.md\`. Reissue this edit once the cut has answered \u2014 an edit reissued right after this refusal passes, so \`busy\` / \`failed\` cannot wedge the run edit after edit; this fires again on the next threshold crossing rather than once per run.`;
 var REISSUE_WINDOW_MS = 9e4;
 function is_reissued_refusal(now_ms, delivered_at_ms) {
   return now_ms - delivered_at_ms < REISSUE_WINDOW_MS;
@@ -1057,7 +1070,7 @@ var implementation_cut = {
   is_over_threshold_edit,
   is_reissued_refusal,
   takes_the_impl_cut,
-  uncut_lane_child_issue
+  uncut_run_issue
 };
 
 // scripts/rules/issue-bug-label.ts
@@ -1951,12 +1964,12 @@ function uncut_lane_issue(state) {
   if (state.marked_issue !== issue) return void 0;
   return state.carried()?.issue === issue ? void 0 : issue;
 }
-function warrants_the_cut(verdict) {
+function warrants_the_cut2(verdict) {
   return verdict !== cost_verdict.UNDER_VERDICT;
 }
 function is_uncut_gate(command, state = current_state2()) {
   if (!runs_the_gate(command) || uncut_lane_issue(state) === void 0) return false;
-  return warrants_the_cut(state.context_verdict());
+  return warrants_the_cut2(state.context_verdict());
 }
 var PRE_GATE_CUT_REASON = "\u26D4 pre-gate cut: this checkout is a lane dispatched for this issue and the gate is the boundary to cut at, so take the cut before running it. `pnpm josh run:cut <N>` ends this process and relaunches a fresh one that resumes from the gate, dropping the thinking built up while implementing rather than carrying it on every later request \u2014 joshuafolkken/kit#1839 measured 176K of 204K output riding across that boundary, and joshuafolkken/kit#1864 measured the step itself firing 0 times in 6 lane children while it was carried as prose. Issue `pnpm josh run:cut <N>` now, and read the verdict: on `cut`, **end the turn immediately** \u2014 the fresh process owns the run from there and must not be waited for; on `not-a-lane`, `unready`, `busy`, `failed` or `unknown`, this process carries the run on and the gate is simply the next call. Never relaunch a second process after `busy`. This fired because the dispatch mark names this lane; a person working here carries no mark and sees no refusal, so there is no human-or-child judgement left to make. The procedure is `.claude/skills/workflow-commands/pre-gate-cut.md`. Reissue the gate once the cut has answered \u2014 this fires once per run, so it cannot repeat on the call in hand.";
 function reaches_the_pre_gate_boundary(call, _turn, run2) {

package/dist/hooks/{chunk-NKVLBB65.js → chunk-BVMSPG3M.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-M4U4YNRE.js";
+} from "./chunk-F6OM6SIG.js";
 import {
   lane_guard_policy
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-2K52BRWV.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-IA7WC4NS.js → chunk-CRGJTD6E.js}

@@ -5,7 +5,7 @@ import {
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 
 // scripts/hooks/format-edited-file.ts
 import { existsSync as existsSync2 } from "node:fs";

package/dist/hooks/{chunk-M4U4YNRE.js → chunk-F6OM6SIG.js}

@@ -1,16 +1,16 @@
 import {
   time_batch_guard
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-2K52BRWV.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 import {
   cost_blocks,
   cost_transcript,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 
 // scripts/delegation/investigation-reads.ts
 import path from "node:path";

package/dist/hooks/{chunk-O3PEDF3M.js → chunk-KQG4776P.js}

@@ -3,7 +3,7 @@ import {
   stamp_file,
   time_density_hook,
   time_hook_transcript
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 import {
   josh_environment_file
 } from "./chunk-WPALEIRX.js";

package/dist/hooks/{chunk-V7RH56HU.js → chunk-NXL3SBXY.js}

@@ -1,10 +1,10 @@
 import {
   lane_guard_policy,
   time_batch_guard
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-2K52BRWV.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-452OKRQX.js → chunk-WWTMHHZU.js}

@@ -1,7 +1,7 @@
 import {
   lane_child_marker,
   run_issue_number
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 import {
   PLATFORM_TEMP_ROOT,
   cost_blocks,
@@ -12,7 +12,7 @@ import {
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 import {
   ENV_FILE_NAME,
   LANE_SEAT_KEY,
@@ -546,7 +546,8 @@ async function is_linked_worktree() {
 var run_hold_schema = z.object({
   issue: z.string(),
   taken_at: z.string(),
-  pid: z.number()
+  pid: z.number(),
+  is_fullrun: z.boolean().optional()
 });
 function parse_hold(raw) {
   try {
@@ -570,16 +571,16 @@ function classify(raw, now) {
 function read_hold(target, now = /* @__PURE__ */ new Date()) {
   return classify(stamp_file.read_stamp_text(target), now);
 }
-function build_hold(issue, now) {
-  return { issue, taken_at: now.toISOString(), pid: process.pid };
+function build_hold(issue, now, is_fullrun) {
+  return { issue, taken_at: now.toISOString(), pid: process.pid, is_fullrun };
 }
 function write_hold(target, issue, now = /* @__PURE__ */ new Date()) {
   const hold = build_hold(issue, now);
   stamp_file.write_stamp(target, hold);
   return hold;
 }
-function create_hold(target, issue, now = /* @__PURE__ */ new Date()) {
-  return stamp_file.create_stamp(target, build_hold(issue, now));
+function create_hold(target, issue, now = /* @__PURE__ */ new Date(), is_fullrun) {
+  return stamp_file.create_stamp(target, build_hold(issue, now, is_fullrun));
 }
 async function is_tree_dirty() {
   try {
@@ -943,11 +944,13 @@ var IDLE_POLL_MINUTES = 5;
 var RUN_VERDICT = "run";
 var WATCH_VERDICT = "watch";
 var STOP_VERDICT = "stop";
-var ANSWERS = ["blocked", "candidates", "exhausted", "parked", "unreadable"];
+var TRIAGE_VERDICT = "triage";
+var ANSWERS = ["blocked", "candidates", "exhausted", "parked", "unreadable", "untriaged"];
 var WHOLE_RUN_REASON = `The whole-run bound of ${String(WHOLE_RUN_BUDGET_HOURS)} hours has passed. An unattended run that has not finished overnight needs a person, not more waiting.`;
 var PARKED_REASON = "Nothing opted in can proceed without a person. Report the parked issues and finish.";
 var UNREADABLE_REASON = "The backlog listing could not be read, so nothing was offered. Report what the command printed and finish \u2014 it is not an empty backlog.";
 var BLOCKED_REASON = "Everything opted in is blocked or already running, so waiting can still change the answer. Poll again at the polling interval.";
+var TRIAGE_REASON = "An opted-in candidate carries neither `run:solo` nor `run:lane`, so nothing starts until it is judged. Read each issue named above, record its order and one of the two labels with a comment, then ask again.";
 var NO_IDLE_WATCH_REASON = "The backlog is empty and the idle watch was turned off with `--idle 0`, so the run finishes here.";
 function to_minutes(duration_ms) {
   return String(Math.ceil(duration_ms / MS_PER_MINUTE));
@@ -1013,14 +1016,20 @@ function idle_decision(input) {
 function is_finish(input) {
   return stop_reason(input) === void 0 && max_decision(input) === void 0;
 }
+var FIXED_DECISIONS = {
+  blocked: { verdict: WATCH_VERDICT, reason: BLOCKED_REASON },
+  untriaged: { verdict: TRIAGE_VERDICT, reason: TRIAGE_REASON }
+};
+function answer_decision(input) {
+  if (input.answer === "candidates") return { verdict: RUN_VERDICT, reason: run_reason(input) };
+  return FIXED_DECISIONS[input.answer] ?? idle_decision(input);
+}
 function decide2(input) {
   const reason = stop_reason(input);
   if (reason !== void 0) return stopping(input, reason);
   const capped = max_decision(input);
   if (capped !== void 0) return capped;
-  if (input.answer === "candidates") return { verdict: RUN_VERDICT, reason: run_reason(input) };
-  if (input.answer === "blocked") return { verdict: WATCH_VERDICT, reason: BLOCKED_REASON };
-  return idle_decision(input);
+  return answer_decision(input);
 }
 var backlog_budget = {
   ANSWERS,
@@ -1034,6 +1043,8 @@ var backlog_budget = {
   PARKED_REASON,
   RUN_VERDICT,
   STOP_VERDICT,
+  TRIAGE_REASON,
+  TRIAGE_VERDICT,
   UNREADABLE_REASON,
   WATCH_VERDICT,
   WHOLE_RUN_BUDGET_HOURS,
@@ -1448,16 +1459,22 @@ function adopt_cut(target, cut) {
 function end_cut(target) {
   stamp_file.remove_stamp(target);
 }
-function tree_is_held(directory) {
-  if (directory === void 0) return false;
+function hold_of(directory) {
+  if (directory === void 0) return void 0;
   const read2 = run_hold.read_hold(run_hold.hold_path(directory));
-  return read2.kind === "held" || read2.kind === "stale";
+  return read2.kind === "held" || read2.kind === "stale" ? read2.hold : void 0;
+}
+function fullrun_issue(hold) {
+  return hold?.is_fullrun === true ? hold.issue : void 0;
+}
+function held_issue_sync() {
+  return fullrun_issue(hold_of(worktree_git_directory_sync()));
 }
 async function current_state() {
   const branch2 = await git_command.branch();
   const is_dirty = await run_hold.is_tree_dirty();
-  const directory = await worktree_directory2();
-  return { branch: branch2, is_dirty, is_held: tree_is_held(directory) };
+  const hold = hold_of(await worktree_directory2());
+  return { branch: branch2, is_dirty, is_held: hold !== void 0, held_issue: fullrun_issue(hold) };
 }
 function describe_cut(cut) {
   return `${cut.invocation} cut at ${cut.cut_at} on ${cut.branch} (${cut.phase})`;
@@ -1499,8 +1516,10 @@ var run_cut = {
   describe_cut,
   end_cut,
   fresh_cut,
+  fullrun_issue,
   handed_off_message,
   has_required_handoff,
+  held_issue_sync,
   incomplete_message,
   invocation_for,
   is_expired,
@@ -1602,12 +1621,19 @@ function is_candidate(call) {
 function is_background_long_run(call, is_lane_child = () => lane_child_marker.is_child_of(process.cwd())) {
   return is_candidate(call) && is_lane_child();
 }
-function pending_background_ids(tail) {
+function unfinished_ids(tail, launched_ids) {
   const lines = tail.split("\n").map((line) => time_transcript_line.parse_line(line));
   const finished = new Set(lines.map((line) => line?.finished_background ?? ""));
-  const launched = lines.flatMap((line) => line?.blocks.map((block) => block.background_id) ?? []);
+  const blocks = lines.flatMap((line) => line?.blocks ?? []);
+  const launched = blocks.flatMap((block) => launched_ids(block));
   return launched.filter((id) => id !== "" && !finished.has(id));
 }
+function pending_background_ids(tail) {
+  return unfinished_ids(tail, (block) => [block.background_id, block.agent_id]);
+}
+function pending_agent_ids(tail) {
+  return unfinished_ids(tail, (block) => [block.agent_id]);
+}
 var LANE_BACKGROUND_REASON = '\u26D4 lane background: this session is a dispatched lane child (`JOSH_LANE_CHILD`), a headless `claude -p` process whose background Bash tasks are killed when the turn ends \u2014 so a backgrounded `josh gate` / `josh git` / `josh followup` never re-invokes you; it dies at `exit code 143` (joshuafolkken/kit#2704, measured on the #2606 child: implementation, review and live verification done, the run parked instead of merged). Hand the gate-to-merge region to the detached supervisor instead: `pnpm josh ship --detach --review "<title> #<N>"` (add `--cite <N>`), then end the turn on `launched` / `busy` \u2014 `.claude/skills/workflow-commands/chain-rule.md` step 0 is the single source. A single check you must read before continuing runs in the foreground within the tool timeout; the commit-push step does not \u2014 in a child it too belongs to the detached ship, in either spelling. This rule fires on every occurrence, not once per run.';
 var LANE_BACKGROUND_STOP_REASON = "\u26D4 lane background stop: this is a dispatched lane child (`JOSH_LANE_CHILD`) and a background task it launched has not finished \u2014 ending this headless turn kills it, and nothing re-invokes you afterwards (joshuafolkken/kit#2704). Do not send a notification and do not stop: wait for the task in the foreground and act on its result, or re-issue the work through `pnpm josh ship --detach`, whose supervisor outlives the turn (`.claude/skills/workflow-commands/chain-rule.md` step 0). Do not repeat your previous reply.";
 var ROW2 = {
@@ -1621,17 +1647,91 @@ var lane_background = {
   LANE_BACKGROUND_STOP_REASON,
   ROW: ROW2,
   is_background_long_run,
+  pending_agent_ids,
   pending_background_ids
 };
 
 // scripts/git/issue-labels.ts
+var EPIC_LABEL = "epic";
 var BUG_LABEL = "bug";
 var ENHANCEMENT_LABEL = "enhancement";
 var BREAKING_CHANGE_LABEL = "breaking-change";
 var IN_PROGRESS_LABEL = "in-progress";
 var NEEDS_DECISION_LABEL = "needs-decision";
+var RUN_SOLO_LABEL = "run:solo";
+var RUN_LANE_LABEL = "run:lane";
 var NEEDS_HUMAN_REVIEW_LABEL = "needs-human-review";
 var ALREADY_DONE_LABEL = "already-done";
+var INTERRUPT_ROUTE_LABEL = "route:interrupt";
+var REVIEW_CAP_ROUTE_LABEL = "route:review-cap";
+var SPLIT_ROUTE_LABEL = "route:split";
+var TIER_A_ROUTE_LABEL = "route:tier-a";
+var FILING_ROUTE_LABELS = [
+  {
+    name: INTERRUPT_ROUTE_LABEL,
+    // Not `5319e7`, which is the `epic` label's purple: in a listing an interrupt would render as
+    // an epic, and the two are read at a glance rather than by name.
+    color: "1d76db",
+    // Keyed to the tests rather than to severity. "A serious defect" is the self-assessment
+    // `wip-cap.md` bans as a criterion, and this string is what a person reads in `gh label list`.
+    description: "Filed past the WIP cap \u2014 meets one of the three interrupt tests (wip-cap.md)"
+  },
+  {
+    name: REVIEW_CAP_ROUTE_LABEL,
+    color: "eab308",
+    description: "Filed by the review round cap's carry-forward (prompts/review.md \u2192 Review round cap)"
+  },
+  {
+    name: SPLIT_ROUTE_LABEL,
+    color: "0e8a16",
+    description: "A child issue created by a split (split-assessment.md)"
+  },
+  {
+    name: TIER_A_ROUTE_LABEL,
+    color: "d93f0b",
+    description: "Filed Tier A during implementation \u2014 an upstream defect or a prerequisite"
+  }
+];
+var DEPTH_0_LABEL = "depth:0";
+var DEPTH_1_LABEL = "depth:1";
+var DEPTH_2_LABEL = "depth:2";
+var DEPTH_LABELS = [
+  {
+    name: DEPTH_0_LABEL,
+    color: "0e8a16",
+    description: "Depth 0 \u2014 what a consumer of this package touches (SKILL.md \xA72i)"
+  },
+  {
+    name: DEPTH_1_LABEL,
+    color: "fbc02d",
+    description: "Depth 1 \u2014 the run orchestration that executes an Issue (SKILL.md \xA72i)"
+  },
+  {
+    name: DEPTH_2_LABEL,
+    color: "c5def5",
+    description: "Depth 2 \u2014 what measures a run (SKILL.md \xA72i)"
+  }
+];
+var WORKFLOW_LABELS = [
+  {
+    name: EPIC_LABEL,
+    color: "5319e7",
+    description: "Tracks a batch of child issues from one split"
+  },
+  { name: IN_PROGRESS_LABEL, color: "0075ca", description: "Work is actively in progress" },
+  {
+    name: RUN_SOLO_LABEL,
+    color: "b60205",
+    description: "Runs alone in a backlogrun: nothing starts beside it"
+  },
+  {
+    name: RUN_LANE_LABEL,
+    color: "0e8a16",
+    description: "Judged safe to run beside others in a backlogrun"
+  },
+  ...FILING_ROUTE_LABELS,
+  ...DEPTH_LABELS
+];
 function has_any_label(labels, wanted) {
   return (labels ?? []).some((label) => wanted.has(label.name.toLowerCase()));
 }
@@ -3520,6 +3620,8 @@ export {
   BREAKING_CHANGE_LABEL,
   IN_PROGRESS_LABEL,
   NEEDS_DECISION_LABEL,
+  RUN_SOLO_LABEL,
+  RUN_LANE_LABEL,
   NEEDS_HUMAN_REVIEW_LABEL,
   ALREADY_DONE_LABEL,
   has_any_label,

package/dist/hooks/{chunk-EYFJ74MJ.js → chunk-ZPLXLJ7O.js}

@@ -1016,15 +1016,23 @@ var PROJECT_COMMANDS = {
   },
   start: {
     script: "scripts/init/start.ts",
-    description: "Initialize a project for the GitHub Issue workflow",
+    description: "Create a new project for the GitHub Issue workflow, from git init to labels",
     category: "Project",
-    reference: [PROFILE_ARGUMENTS, "developer", ["files", "git", "network"]]
+    reference: [
+      `${PROFILE_ARGUMENTS} [--yes] [--github] [--public]`,
+      "developer",
+      ["files", "git", "network", "processes"]
+    ]
   },
   init: {
     script: "scripts/init/init.ts",
     description: "Initialize config in a new project",
     category: "Project",
-    reference: [PROFILE_ARGUMENTS, "developer", ["files", "processes"]]
+    reference: [
+      `${PROFILE_ARGUMENTS} [--no-install]`,
+      "developer",
+      ["files", "network", "processes"]
+    ]
   },
   sync: {
     script: "scripts/sync/sync.ts",
@@ -1165,9 +1173,9 @@ var WORKFLOW_COMMANDS = {
     reference: ["--task-type <type> --body <text>", "automation", ["notifications"]],
     tsx_arguments: OPTIONAL_ENV_FILE_FLAGS
   },
-  // The observation ledger's only commit path (joshuafolkken/kit#1756). `pnpm josh git` excludes the
-  // ledger from what it stages, so without this command a parent's appended line has no route to the
-  // default branch at all — and the recurrence count the promotion rule reads is a count of main.
+  // The observation ledger's commit path for the lines no run's own commit carried
+  // (joshuafolkken/kit#1756, joshuafolkken/kit#2763): 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",
@@ -1493,6 +1501,7 @@ var time_shell = {
 var NO_BACKGROUND = "";
 var NO_FINISH = 0;
 var LAUNCH_PATTERN = /running in background with ID:\s*([\w-]+)/iu;
+var AGENT_LAUNCH_PATTERN = /^Async agent launched[\s\S]*?\bagentId:\s*([\w-]+)/u;
 var FINISH_PATTERN = /^<task-notification>[\s\S]*?<task-id>([\w-]+)<\/task-id>/u;
 var OUTPUT_PATTERN = /tasks\/([\w-]+)\.output/u;
 var BASH_ID_KEY = "bash_id";
@@ -1507,6 +1516,9 @@ function read_id_of(input) {
 function launch_id(text) {
   return LAUNCH_PATTERN.exec(text)?.[1] ?? NO_BACKGROUND;
 }
+function agent_launch_id(text) {
+  return AGENT_LAUNCH_PATTERN.exec(text)?.[1] ?? NO_BACKGROUND;
+}
 function finished_id(text) {
   return FINISH_PATTERN.exec(text)?.[1] ?? NO_BACKGROUND;
 }
@@ -1571,6 +1583,7 @@ var time_background = {
   NO_BACKGROUND,
   NO_FINISH,
   launch_id,
+  agent_launch_id,
   finished_id,
   finished_at,
   read_id,
@@ -2406,7 +2419,8 @@ function to_block2(raw) {
     followup_stages: time_followup_stage.read_stages(text),
     error_text: is_error === true ? text.slice(0, ERROR_TEXT_LIMIT) : "",
     refusal_guard: is_error === true ? guard_from_refusal(text) : "",
-    background_id: time_background.launch_id(text)
+    background_id: time_background.launch_id(text),
+    agent_id: time_background.agent_launch_id(text)
   };
 }
 function to_blocks2(content) {

package/dist/hooks/{chunk-IBFC25IX.js → chunk-ZYYSBNR6.js}

@@ -1,16 +1,16 @@
 import {
   investigation_reads
-} from "./chunk-M4U4YNRE.js";
+} from "./chunk-F6OM6SIG.js";
 import {
   lane_guard_policy
-} from "./chunk-OM5VDM6F.js";
+} from "./chunk-2K52BRWV.js";
 import {
   hook_decision
-} from "./chunk-O3PEDF3M.js";
+} from "./chunk-KQG4776P.js";
 import {
   json_value,
   time_spans
-} from "./chunk-EYFJ74MJ.js";
+} from "./chunk-ZPLXLJ7O.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";