@joshuafolkken/kit 1.1370.0 → 1.1373.0

package/.claude/skills/workflow-commands/backlogrun-steps.md

@@ -70,7 +70,7 @@ and `--filed 1`, and **`--cut` is the session's last write**.
 
 | It answers | What the run does |
 | --- | --- |
-| `began` | Report the plan and run the decision pass |
+| `began` | Report the plan and run the decision pass, then run what the bare `pnpm josh run:step` prints — an empty plan or a `none` from `backlog:next` included, which the driver's idle watch ends, never the session |
 | `resumed` | Take the budget from `--json`, report the plan again, read `backlogrun-progress.md` → "Resuming after a cut" |
 | `busy` / `mismatch` / `unreadable` / `unknown` | **Stop; do not open a lane** — report what it printed; never resume into another invocation's record |
 | `over` | **End the conversation**; retype the invocation in a fresh session |

package/.claude/skills/workflow-commands/backlogrun.md

@@ -13,7 +13,8 @@ that same backlog. **`--only` stops it after the named list**, draining nothing.
 
 **The loop's current position is computed, not carried in the conversation.** `pnpm josh run:step <N>`
 reads where the run is from the event stream, the carry record and the issue state, and prints the next
-single action — a runnable command, or the one point a person has to judge.
+single action — a runnable command, or the one point a person has to judge. **With no `<N>` it answers
+for the parent itself**, from the carry record alone.
 
 **A named item may be a single issue or an epic.** A single-issue item is one `fullrun`; **a named epic runs its children in
 dependency order across the free lanes, and the run does not advance to the next named item until
@@ -40,10 +41,11 @@ is still that one invocation (`backlogrun-steps.md` → "The session cut is insi
    `run:lane` in the same pass.
 5. **Named issues run first, in order** — each as a delegated `fullrun`, one at a time, then the pool;
    `--only` stops after the list.
-6. **The loop belongs to the supervisor** — `run:wake` runs `backlog:drive`, which returns a branch to
-   an AI session only when it needs judgment.
+6. **The loop belongs to the supervisor — hand it over with what the bare `pnpm josh run:step`
+   prints**, whatever the plan held: `run:wake` runs `backlog:drive`, which returns a branch to an AI
+   session only when it needs judgment.
 7. **End the record when the run ends** — `run:report`, then `run:carry --end` (or `--end --stopped
-   "<reason>"`) and `run:wake --stop`.
+   "<reason>"`) and `run:wake --stop`. An empty plan is not that end; the driver's idle watch decides it.
 
 ## The route table
 

package/README.md

@@ -1,34 +1,25 @@
 # @joshuafolkken/kit
 
-[![npm version](https://img.shields.io/npm/v/@joshuafolkken/kit)](https://www.npmjs.com/package/@joshuafolkken/kit)
-[![CI](https://github.com/joshuafolkken/kit/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/joshuafolkken/kit/actions/workflows/ci.yml)
-[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=joshuafolkken_kit&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=joshuafolkken_kit)
-
 **AI assistant setup, plus an optional GitHub workflow.**
 
-kit gives Claude Code or Codex your project's rules and checks. With the workflow, the agent takes each change from Issue to merged PR.
+kit gives Claude Code or Codex your project's rules and checks.
+
+## The workflow
+
+Type `backlogrun` and the agent takes the Issues you name from plan to merged PR — in parallel, unattended. A live board shows where each one stands:
+
+![The backlogrun board: ten Issues running side by side, seven already merged, each with its stage and elapsed time](./docs/images/backlogrun-board.png)
+
+[Every keyword, including the ones that stop for you earlier](./docs/how-to/run-issues.md)
 
 ## Sound familiar?
 
 [The whole story](./docs/why.md)
 
-### Working with an AI agent
-
 - [I keep repeating the same instructions](./docs/why.md#i-keep-repeating-the-same-instructions)
 - [The agent does things I never asked for](./docs/why.md#the-agent-does-things-i-never-asked-for)
-- [Reviewing every change is a chore](./docs/why.md#reviewing-every-change-is-a-chore)
-
-### With the GitHub workflow
-
 - [Wiring AI up to GitHub is a chore](./docs/why.md#wiring-ai-up-to-github-is-a-chore)
-- [Writing Issues is a chore](./docs/why.md#writing-issues-is-a-chore)
-- [Big requests come back sloppy](./docs/why.md#big-requests-come-back-sloppy)
-
-### Writing TypeScript
-
 - [Done doesn't mean done](./docs/why.md#done-doesnt-mean-done)
-- [Quality slips with every change](./docs/why.md#quality-slips-with-every-change)
-- [Updating dependencies keeps breaking things](./docs/why.md#updating-dependencies-keeps-breaking-things)
 
 ## Quick start
 
@@ -54,24 +45,8 @@ pnpm --allow-build=esbuild dlx @joshuafolkken/kit init
 
 Next: [tutorial](./docs/tutorial.md#without-github-one-change-checked-locally)
 
-## The workflow
-
-| You type     | The agent                                        |
-| ------------ | ------------------------------------------------ |
-| `kickoff`    | Writes the plan on the Issue, then stops         |
-| `halfrun`    | Implements and self-reviews, stops before commit |
-| `prrun`      | Opens a green pull request, stops before merge   |
-| `fullrun`    | Plans if needed, implements through to merge     |
-| `backlogrun` | Runs many Issues unattended                      |
-
-[Each keyword in full](./docs/how-to/run-issues.md) · [Telegram notifications when a run needs you](./docs/how-to/set-up-notifications.md)
-
 ## Docs
 
-[How-to](./docs/how-to.md) · [Commands](./docs/josh-commands.md) · [Troubleshooting](./docs/troubleshooting.md) · [All docs](./docs/overview.md)
-
-[app-kit](https://github.com/joshuafolkken/app-kit) · [game-kit](https://github.com/joshuafolkken/game-kit) · [Releases](https://github.com/joshuafolkken/kit/releases) · [Security](./SECURITY.md) · [Contributing](./docs/maintainers/README.md) · [MIT](./LICENSE)
+[How-to](./docs/how-to.md) · [All docs](./docs/overview.md)
 
-[![Node.js](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoshuafolkken%2Fkit%2Fmain%2Fpackage.json&search=%22node%22%3A%20%22%5C%5E%28%5B0-9%5D%2B%5C.%5B0-9%5D%2B%29%5B0-9.%5D%2A%20%5C%7C%5C%7C%20%5C%5E%28%5B0-9%5D%2B%29%5B0-9.%5D%2A%20%5C%7C%5C%7C%20%3E%3D%28%5B0-9%5D%2B%29&replace=%5E%241%20%7C%20%5E%242%20%7C%20%3E%3D%243&logo=nodedotjs&label=Node.js)](https://nodejs.org/)
-[![TypeScript](https://img.shields.io/npm/dependency-version/@joshuafolkken/kit/peer/typescript?logo=typescript)](https://www.typescriptlang.org/)
-[![pnpm](https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fraw.githubusercontent.com%2Fjoshuafolkken%2Fkit%2Fmain%2Fpackage.json&search=pnpm%40%28%5B0-9.%5D%2B%29&replace=%241&logo=pnpm&label=pnpm)](https://pnpm.io/)
+[app-kit](https://github.com/joshuafolkken/app-kit) · [game-kit](https://github.com/joshuafolkken/game-kit) · [Releases](https://github.com/joshuafolkken/kit/releases) · [Contributing](./docs/maintainers/README.md)

package/dist/commands/document-section-cli.js

@@ -117,7 +117,7 @@ var SECTION_PATTERN = /(?<![\w./:`-])(?<tick>`?)(?<file>[\w./-]+\.md)\k<tick>\s*
 var ADJACENT_PATTERN = /["「](?<heading>[^"「」]+)["」]\s+(?:above|below)\b/gu;
 var BARE_ARROW_PATTERN = /→\s*(?:§\w+,\s*)?["「](?<heading>[^"「」]+)["」]/gu;
 var LINK_TARGET_PATTERN = /\]\([^)\s]*\)/gu;
-var LINK_PATTERN = /\]\(([\w./-]+\.md)(?:#[\w-]+)?\)/gu;
+var LINK_PATTERN = /\]\(([\w./-]+\.(?:md|png|jpe?g|gif|svg|webp))(?:#[\w-]+)?\)/gu;
 var PLACEHOLDER_FILES = /* @__PURE__ */ new Set(["x.md", "foo.md", "file.md", "path.md"]);
 function matches(text, pattern) {
   return [...text.matchAll(pattern)];

package/dist/hooks/batch-guard.js

@@ -9,10 +9,10 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-DZWZ3DKY.js";
+} from "./chunk-JGW24KKM.js";
 import "./chunk-GG72ANKI.js";
-import "./chunk-KPM4YIIX.js";
-import "./chunk-TLJYAGZK.js";
+import "./chunk-7WKYHEGU.js";
+import "./chunk-SLSFIWTX.js";
 import "./chunk-Z5TMJIPW.js";
 import "./chunk-NZN2UFI6.js";
 import "./chunk-NEC4AT4Z.js";

package/dist/hooks/{chunk-43G45XJF.js → chunk-7UBFU3CL.js}

@@ -5,7 +5,7 @@ import {
 import {
   ESLINT_EDIT_CACHE_FLAGS,
   time_density_hook
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   file_reader,
   json_value

package/dist/hooks/{chunk-KPM4YIIX.js → chunk-7WKYHEGU.js}

@@ -1,7 +1,7 @@
 import {
   time_density_hook,
   time_hook_transcript
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   josh_environment_file
 } from "./chunk-Z5TMJIPW.js";

package/dist/hooks/{chunk-4TW4MQUL.js → chunk-AKGCP4LX.js}

@@ -1,6 +1,6 @@
 import {
   duplicate_read_outcome
-} from "./chunk-NZBHG6FW.js";
+} from "./chunk-BZMPVFDY.js";
 import {
   ALREADY_DONE_LABEL,
   CONTEXT_CUT_THRESHOLD,
@@ -28,7 +28,7 @@ import {
   session_cite,
   shell_segments,
   tail_commands
-} from "./chunk-MXVQMLDP.js";
+} from "./chunk-YLBBSSTF.js";
 import {
   ancestor_directories,
   find_local_bin_upwards
@@ -41,25 +41,25 @@ import {
   lane_registry,
   repo_origin,
   run_headless
-} from "./chunk-SYSRHRWU.js";
+} from "./chunk-UTHMB4O2.js";
 import {
   error_text
 } from "./chunk-CDY4NFQG.js";
 import {
   batch_outcome
-} from "./chunk-DZWZ3DKY.js";
+} from "./chunk-JGW24KKM.js";
 import {
   investigation_refusal
-} from "./chunk-R6CRQEAL.js";
+} from "./chunk-V4TKZHER.js";
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-JCRDBQXB.js";
 import {
   lane_guard_policy
 } from "./chunk-GG72ANKI.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 import {
   cost_attribute,
   cost_blocks,
@@ -67,7 +67,7 @@ import {
   time_batch_guard,
   time_density_hook,
   time_shell
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   lane_child_marker
 } from "./chunk-Z5TMJIPW.js";
@@ -1661,7 +1661,7 @@ var BATCH_ORACLES = [
   {
     name: "run:step",
     decision: "The run\u2019s next single action, computed from the event stream, carry and issue state",
-    args: ISSUE_N_ARG,
+    args: `[${ISSUE_N_ARG}]`,
     // The non-command answers: `run:step` prints a runnable command for a phase with one to run, and
     // one of these verdicts otherwise. A command line is not a vocabulary token, exactly as an issue
     // number is not one for `backlog:next`.

package/dist/hooks/{chunk-NZBHG6FW.js → chunk-BZMPVFDY.js}

@@ -1,15 +1,15 @@
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-JCRDBQXB.js";
 import {
   lane_guard_policy
 } from "./chunk-GG72ANKI.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 import {
   time_spans
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   json_value
 } from "./chunk-NZN2UFI6.js";

package/dist/hooks/{chunk-76RK6E3H.js → chunk-JCRDBQXB.js}

@@ -1,13 +1,13 @@
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 import {
   cost_blocks,
   time_batch_guard,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   cost_transcript
 } from "./chunk-NZN2UFI6.js";

package/dist/hooks/{chunk-DZWZ3DKY.js → chunk-JGW24KKM.js}

@@ -3,10 +3,10 @@ import {
 } from "./chunk-GG72ANKI.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 import {
   time_batch_guard
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-TLJYAGZK.js → chunk-SLSFIWTX.js}

@@ -533,7 +533,7 @@ var RUN_COMMANDS = {
     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"]]
+    reference: ["[<issue>]", "automation", ["network", "files"]]
   }
 };
 

package/dist/hooks/{chunk-SYSRHRWU.js → chunk-UTHMB4O2.js}

@@ -1346,6 +1346,7 @@ async function is_backlog_parent(source = process.env, ancestry = lane_reap.own_
 var run_headless = {
   HEADLESS_ENV_KEY,
   current_carry,
+  driven_here,
   driving_carry,
   environment: environment2,
   is_backlog_parent,

package/dist/hooks/{chunk-R6CRQEAL.js → chunk-V4TKZHER.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-76RK6E3H.js";
+} from "./chunk-JCRDBQXB.js";
 import {
   lane_guard_policy
 } from "./chunk-GG72ANKI.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-MXVQMLDP.js → chunk-YLBBSSTF.js}

@@ -8,7 +8,7 @@ import {
   repo_origin,
   repository_lock,
   run_ship_stage
-} from "./chunk-SYSRHRWU.js";
+} from "./chunk-UTHMB4O2.js";
 import {
   error_text
 } from "./chunk-CDY4NFQG.js";
@@ -30,7 +30,7 @@ import {
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import {
   lane_child_marker
 } from "./chunk-Z5TMJIPW.js";

package/dist/hooks/codex-hook-adapter.js

@@ -1,29 +1,29 @@
 #!/usr/bin/env tsx
 import {
   pretool_guard
-} from "./chunk-4TW4MQUL.js";
-import "./chunk-NZBHG6FW.js";
+} from "./chunk-AKGCP4LX.js";
+import "./chunk-BZMPVFDY.js";
 import {
   bounded_pool
-} from "./chunk-MXVQMLDP.js";
+} from "./chunk-YLBBSSTF.js";
 import {
   build_envelope,
   compose_context,
   format_edited_payload
-} from "./chunk-43G45XJF.js";
+} from "./chunk-7UBFU3CL.js";
 import "./chunk-JBBMAPC4.js";
-import "./chunk-SYSRHRWU.js";
+import "./chunk-UTHMB4O2.js";
 import "./chunk-CDY4NFQG.js";
-import "./chunk-DZWZ3DKY.js";
-import "./chunk-R6CRQEAL.js";
-import "./chunk-76RK6E3H.js";
+import "./chunk-JGW24KKM.js";
+import "./chunk-V4TKZHER.js";
+import "./chunk-JCRDBQXB.js";
 import "./chunk-GG72ANKI.js";
 import {
   hook_decision
-} from "./chunk-KPM4YIIX.js";
+} from "./chunk-7WKYHEGU.js";
 import {
   time_density_hook
-} from "./chunk-TLJYAGZK.js";
+} from "./chunk-SLSFIWTX.js";
 import "./chunk-Z5TMJIPW.js";
 import {
   json_value

package/dist/hooks/duplicate-read-guard.js

@@ -9,11 +9,11 @@ import {
   is_enabled,
   notice_refusal_path,
   refusal_path
-} from "./chunk-NZBHG6FW.js";
-import "./chunk-76RK6E3H.js";
+} from "./chunk-BZMPVFDY.js";
+import "./chunk-JCRDBQXB.js";
 import "./chunk-GG72ANKI.js";
-import "./chunk-KPM4YIIX.js";
-import "./chunk-TLJYAGZK.js";
+import "./chunk-7WKYHEGU.js";
+import "./chunk-SLSFIWTX.js";
 import "./chunk-Z5TMJIPW.js";
 import "./chunk-NZN2UFI6.js";
 import "./chunk-NEC4AT4Z.js";

package/dist/hooks/format-edited.js

@@ -2,9 +2,9 @@
 import {
   report_no_payload,
   run_hook
-} from "./chunk-43G45XJF.js";
+} from "./chunk-7UBFU3CL.js";
 import "./chunk-JBBMAPC4.js";
-import "./chunk-TLJYAGZK.js";
+import "./chunk-SLSFIWTX.js";
 import "./chunk-NZN2UFI6.js";
 import "./chunk-NEC4AT4Z.js";