@joshuafolkken/kit 1.1229.0 → 1.1240.0

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

@@ -117,7 +117,7 @@ In the **primary checkout**, in this order, and never again per lane:
 1. `git switch main && git pull` — every lane branches from this ref.
 2. `pnpm josh latest:scope`, and the update on `required` — `backlogrun-child.md` → "`josh latest`
    runs once per session, not once per child".
-3. `pnpm josh lane:prune` — closes the lanes an interruption left registered without a work tree.
+3. `pnpm josh lane:prune` — closes lanes left without a work tree, sweeps unregistered leftovers.
 4. `pnpm josh run:tidy` — sweeps merged lanes and stashes (as `run:hold` does).
 
 **`pnpm josh latest` is never run inside a lane, whatever `latest:scope` answers there** — the command

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

@@ -218,8 +218,8 @@ ever.
 - **Every in-flight lane records a path** — **record the cut and hand the session off.** `backlogrun`
   declares a budget — `--max`, `--idle` and the 8-hour bound — so the cut is an execution detail: count
   everything the session has, then run `pnpm josh run:carry --cut --owner "$PPID"`. **Unless it answers
-  `capped`** (below), `pnpm josh run:wake` then starts the next session, which polls the still-running
-  lanes from `lane:list`. Post the progress comment naming **every lane in flight and the path each
+  `capped`** (below), the `pnpm josh run:wake` driver starts at its next poll even while this session
+  lives on, and polls the still-running lanes from `lane:list`. Post the progress comment naming **every lane in flight and the path each
   records**, name `pnpm josh run:event --watch` for a pane, and end the turn — nothing is relayed (#2492).
   `backlogrun-steps.md` → "The session cut is inside the invocation" is the single source of the
   carry; this reading is only where the cut is *taken*.

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

@@ -155,3 +155,8 @@ the tag → publish → `production` chain — outward-facing and effectively ir
 Typing `fullrun` authorizes this Issue's merge and nothing past it; a person types the release in the
 primary checkout, on the default branch, with a clean tree. `release:scope` counts nothing of its own —
 it reads the same fetch-then-count `followup` uses for the Telegram line, so the two cannot disagree.
+
+**On `required`, the release request cites the open release Issue** — the one `issue:file --release` / `issue:release <N>` links blockers to — with a number-link
+(`prompts/collaboration-workflow/issue-citation.md`). List it with
+`gh api 'repos/{owner}/{repo}/issues?labels=release&state=open' --jq '.[].number'`; when none is
+open, the request names `pnpm josh release` alone.

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

@@ -86,3 +86,4 @@ split is found.
   `backlogrun #<E> --only`. (5) **Stop** — do not implement.
 
 `pnpm josh issue:file` lints the body and applies the classification labels it declares, following `prompts/collaboration-workflow/issue-template.md` for classification (`docs/josh-commands-backlog.md` → `josh issue:file`).
+An Issue a consumer can use only once it is published is filed with `--release` (`kickoff new`), or linked with `pnpm josh issue:release <N>` (`kickoff #N`) — either makes it a blocker of the repository's `release` Issue, which never gets `auto-ok` on its own.

package/.claude/skills/workflow-commands/latest-gate.md

@@ -1,6 +1,6 @@
 # The dependency update — when `josh latest` runs
 
-`josh latest` updates corepack, every dependency, the published ranges and `pnpm audit`, in that
+`josh latest` updates every dependency, the published ranges, `pnpm audit` and pnpm, in that
 order and over the network. Until joshuafolkken/kit#1215 every entry point put it at the head of
 every run and called it **mandatory, never skip** — so a standalone `fullrun` paid 60–120 seconds
 for it before touching the issue, and a batch that ran ten children paid it ten times unless the

package/.github/workflows/publish.yml

@@ -183,3 +183,5 @@ jobs:
           RELEASE_START_TAG: v1.887.0
           RELEASE_WORKFLOW: publish.yml
           RELEASE_JOBS: pack,publish-github,publish-npm,update-production
+          # This run creates its tag's release, so a lower tag whose run finished without one is lost.
+          RELEASE_RUN_WORKFLOW: publish.yml

package/README.md

@@ -5,9 +5,9 @@
 [![npm version](https://img.shields.io/npm/v/@joshuafolkken/kit)](https://www.npmjs.com/package/@joshuafolkken/kit)
 [![License](https://img.shields.io/github/license/joshuafolkken/kit)](./LICENSE)
 
-[![Node.js](https://img.shields.io/node/v/@joshuafolkken/kit?logo=nodedotjs)](https://nodejs.org/)
+[![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/github/package-json/packageManager/joshuafolkken/kit?logo=pnpm&label=pnpm)](https://pnpm.io/)
+[![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/)
 
 [![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)
@@ -16,41 +16,46 @@
 
 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.
 
-**Only want the AI assistant, without the GitHub workflow?** Set it up here: [Node projects](./docs/setup/full.md#2-install-and-initialize-with-josh-init) · [Other projects](./docs/setup/basic.md)
-
 ## Sound familiar?
 
 Each pain links to how it is solved — or read [the whole story](./docs/why.md).
 
-kit solves these in every project — and so do [app-kit] and [game-kit], which build on it:
+### Working with an AI agent
 
-- [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)
 - [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)
-- [Some changes need a human eye](./docs/why.md#some-changes-need-a-human-eye)
-- [I spend all day talking to the agent](./docs/why.md#i-spend-all-day-talking-to-the-agent)
-- [Big requests come back sloppy](./docs/why.md#big-requests-come-back-sloppy)
-- [I want many Issues solved at once](./docs/why.md#i-want-many-issues-solved-at-once)
+- [I can't tell if the agent is stuck or done](./docs/why.md#i-cant-tell-if-the-agent-is-stuck-or-done)
 - [AI costs keep climbing](./docs/why.md#ai-costs-keep-climbing)
-- [Writing Issues is a chore](./docs/why.md#writing-issues-is-a-chore)
+
+### Working on GitHub
+
 - [Wiring AI up to GitHub is a chore](./docs/why.md#wiring-ai-up-to-github-is-a-chore)
-- [I can't tell if the agent is stuck or done](./docs/why.md#i-cant-tell-if-the-agent-is-stuck-or-done)
+- [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)
+- [I spend all day talking to the agent](./docs/why.md#i-spend-all-day-talking-to-the-agent)
+- [I want many Issues solved at once](./docs/why.md#i-want-many-issues-solved-at-once)
+- [Some changes need a human eye](./docs/why.md#some-changes-need-a-human-eye)
 - [One task overwrote another's work](./docs/why.md#one-task-overwrote-anothers-work)
 - [A session cut off and I lost track](./docs/why.md#a-session-cut-off-and-i-lost-track)
 - [The backlog fills with duplicate Issues](./docs/why.md#the-backlog-fills-with-duplicate-issues)
 
-The app and game kits add:
+### 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)
+
+### The app and game kits add
 
-| Your pain                                                                                                                  | kit | [app-kit] | [game-kit] |
-| -------------------------------------------------------------------------------------------------------------------------- | :-: | :-------: | :--------: |
-| [Setting up SvelteKit on Cloudflare takes a day](https://github.com/joshuafolkken/app-kit/blob/main/docs/setup/install.md) |  —  |    ✅     |     ✅     |
-| [I'm not sure the app is secure](https://github.com/joshuafolkken/app-kit/blob/main/docs/security-headers.md)              |  —  |    ✅     |     ✅     |
-| [Nobody looked at the screen](https://github.com/joshuafolkken/app-kit/blob/main/docs/shot.md)                             |  —  |    ✅     |     ✅     |
-| [Starting a 3D game means building it all first](https://github.com/joshuafolkken/game-kit/blob/main/docs/install.md)      |  —  |     —     |     ✅     |
+| Your pain                                                                                                                  | [app-kit] | [game-kit] |
+| -------------------------------------------------------------------------------------------------------------------------- | :-------: | :--------: |
+| [Setting up SvelteKit on Cloudflare takes a day](https://github.com/joshuafolkken/app-kit/blob/main/docs/setup/install.md) |    ✅     |     ✅     |
+| [I'm not sure the app is secure](https://github.com/joshuafolkken/app-kit/blob/main/docs/security-headers.md)              |    ✅     |     ✅     |
+| [Nobody looked at the screen](https://github.com/joshuafolkken/app-kit/blob/main/docs/shot.md)                             |    ✅     |     ✅     |
+| [Starting a 3D game means building it all first](https://github.com/joshuafolkken/game-kit/blob/main/docs/install.md)      |     —     |     ✅     |
 
-Each kit includes the one to its left: app-kit builds on kit, game-kit builds on app-kit.
+app-kit builds on kit and game-kit builds on app-kit, so each includes everything in the kits beneath it.
 
 [app-kit]: https://github.com/joshuafolkken/app-kit
 [game-kit]: https://github.com/joshuafolkken/game-kit
@@ -67,27 +72,21 @@ Each kit includes the one to its left: app-kit builds on kit, game-kit builds on
 
 Each keyword in full: [Run Issues with the workflow keywords](./docs/how-to/run-issues.md). When a run needs you, it [notifies you on Telegram](./docs/how-to/set-up-notifications.md).
 
-## Why you can trust "done"
-
-- **Checks are commands.** Lint, types, spelling and tests run as one gate — "it should pass" doesn't count.
-- **No test, no commit.** kit decides from the changed files whether a test is required.
-
 ## Quick start
 
-Requires Node.js, pnpm (kit is installed and run with pnpm only) and the gh CLI — [how to install them](./docs/setup/prerequisites.md). Sign in once with `gh auth login` before `josh start`.
+Requires Node.js, pnpm and the gh CLI — [how to install them](./docs/setup/prerequisites.md).
 
 ```bash
+gh auth login # once, before josh start
 pnpm add -D --allow-build=esbuild --allow-build=unrs-resolver @joshuafolkken/kit
 pnpm exec josh start
 ```
 
-`josh start` picks the project's profile, writes kit's rules and checks, and creates the GitHub repository and workflow labels when they are missing. On a repository that already has history it opens a setup pull request instead of committing to `main` — merge it before your first run ([what it does](./docs/init.md#josh-init-or-josh-start)).
-
-Add the two Telegram credentials to `.env` so a run that needs you can reach you, or `JOSH_NOTIFY=off` to go without — [Set up notifications](./docs/how-to/set-up-notifications.md).
+`josh start` sets kit up and creates the GitHub repository when it is missing. A repository with history gets a setup pull request instead — merge it before your first run ([what it does](./docs/init.md#josh-init-or-josh-start)).
 
 Then open your agent and follow the [tutorial](./docs/tutorial.md).
 
-AI assistant only, no GitHub workflow? [Node projects](./docs/setup/full.md#2-install-and-initialize-with-josh-init) · [Other projects](./docs/setup/basic.md)
+**Only want the AI assistant, without the GitHub workflow?** [TypeScript projects](./docs/setup/full.md#2-install-and-initialize-with-josh-init) · [Other projects](./docs/setup/basic.md) — other projects get short AI rules and formatting only ([what each profile gets](./docs/init.md#project-profiles)).
 
 ## Docs
 

package/dist/hooks/batch-guard.js

@@ -9,10 +9,10 @@ import {
   load_environment_file,
   notice_refusal_path,
   refusal_path
-} from "./chunk-RNWHN5BP.js";
-import "./chunk-VC3PZPZO.js";
-import "./chunk-6HJJXRBX.js";
-import "./chunk-55HHG5PX.js";
+} from "./chunk-F3ELQ2AF.js";
+import "./chunk-GPTFMK5E.js";
+import "./chunk-ZQGD4GBY.js";
+import "./chunk-WK2XSHSI.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 import "./chunk-ELCN5LCH.js";

package/dist/hooks/{chunk-JUDKDCDP.js → chunk-4TZVB44A.js}

@@ -1,6 +1,6 @@
 import {
   duplicate_read_outcome
-} from "./chunk-TQNPDZNH.js";
+} from "./chunk-QVSWU24O.js";
 import {
   ALREADY_DONE_LABEL,
   CONTEXT_CUT_THRESHOLD,
@@ -36,7 +36,7 @@ import {
   run_tail_rule,
   shell_segments,
   tail_commands
-} from "./chunk-NV2JRZZO.js";
+} from "./chunk-KHX4U3BG.js";
 import {
   ancestor_directories,
   find_local_bin_upwards
@@ -46,21 +46,21 @@ import {
 } from "./chunk-CDY4NFQG.js";
 import {
   batch_outcome
-} from "./chunk-RNWHN5BP.js";
+} from "./chunk-F3ELQ2AF.js";
 import {
   investigation_refusal
-} from "./chunk-F56MFS4B.js";
+} from "./chunk-KRBERBBI.js";
 import {
   investigation_reads
-} from "./chunk-5VMKCCC4.js";
+} from "./chunk-XZYKEM6J.js";
 import {
   lane_guard_policy
-} from "./chunk-VC3PZPZO.js";
+} from "./chunk-GPTFMK5E.js";
 import {
   hook_decision,
   lane_child_marker,
   run_issue_number
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 import {
   cost_attribute,
   cost_blocks,
@@ -73,7 +73,7 @@ import {
   time_batch_guard,
   time_density_hook,
   time_shell
-} from "./chunk-55HHG5PX.js";
+} from "./chunk-WK2XSHSI.js";
 import {
   PLATFORM_TEMP_ROOT,
   PROBE_TIMEOUT_MS,

package/dist/hooks/{chunk-RNWHN5BP.js → chunk-F3ELQ2AF.js}

@@ -1,12 +1,12 @@
 import {
   lane_guard_policy
-} from "./chunk-VC3PZPZO.js";
+} from "./chunk-GPTFMK5E.js";
 import {
   hook_decision
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 import {
   time_batch_guard
-} from "./chunk-55HHG5PX.js";
+} from "./chunk-WK2XSHSI.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-VC3PZPZO.js → chunk-GPTFMK5E.js}

@@ -1,6 +1,6 @@
 import {
   lane_child_marker
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 
 // scripts/lane/lane-guard-policy.ts
 var DEFAULT_MODE = "refuse";

package/dist/hooks/{chunk-FIVDHQGT.js → chunk-KHGB5S3Y.js}

@@ -6,7 +6,7 @@ import {
   ESLINT_EDIT_CACHE_FLAGS,
   file_reader,
   time_density_hook
-} from "./chunk-55HHG5PX.js";
+} from "./chunk-WK2XSHSI.js";
 import {
   HOOK_PROCESS_TIMEOUT_MS
 } from "./chunk-ELCN5LCH.js";

package/dist/hooks/{chunk-NV2JRZZO.js → chunk-KHX4U3BG.js}

@@ -4,7 +4,7 @@ import {
 import {
   lane_child_marker,
   run_issue_number
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 import {
   CHECK_STATUS_FAIL,
   CHECK_STATUS_PENDING,
@@ -30,7 +30,7 @@ import {
   time_density_hook,
   time_shell,
   time_transcript_line
-} from "./chunk-55HHG5PX.js";
+} from "./chunk-WK2XSHSI.js";
 import {
   ENV_FILE_NAME,
   LANE_SEAT_KEY,
@@ -3062,6 +3062,10 @@ var EVENT_KIND = {
   SPLIT: "split",
   OUTAGE: "outage",
   CUT: "cut",
+  // A fresh session adopted an implementation cut — `run:cut --resume` answered `resume-impl`
+  // (joshuafolkken/kit#3375). The resume clears the cut record, so without this the `cut` stayed the
+  // newest position and `run:step` kept answering the resume command it had just run.
+  RESUME: "resume",
   // The backlog emptied while nothing of the run's own was in flight — the drain
   // (joshuafolkken/kit#2335). It marks the position at which the end-of-run retrospective is owed,
   // *before* the idle watch opens, so `run:step` fires the retrospective at the drain rather than after
@@ -3585,6 +3589,7 @@ var RUN_LANE_LABEL = "run:lane";
 var PRIORITY_HIGH_LABEL = "priority:high";
 var NEEDS_HUMAN_REVIEW_LABEL = "needs-human-review";
 var ALREADY_DONE_LABEL = "already-done";
+var RELEASE_LABEL = "release";
 var INTERRUPT_ROUTE_LABEL = "route:interrupt";
 var REVIEW_CAP_ROUTE_LABEL = "route:review-cap";
 var SPLIT_ROUTE_LABEL = "route:split";
@@ -3658,6 +3663,11 @@ var WORKFLOW_LABELS = [
     color: "e99695",
     description: "Offered first in a backlogrun; only a person removes it"
   },
+  {
+    name: RELEASE_LABEL,
+    color: "fef2c0",
+    description: "Tracks the next release; its blockers are the merged work it publishes"
+  },
   ...FILING_ROUTE_LABELS,
   ...DEPTH_LABELS
 ];
@@ -4418,6 +4428,10 @@ async function list_lanes() {
   const lanes = blocks.map((block) => parse_block(block, root)).filter(is_lane);
   return lanes.toSorted((left, right) => Number(left.issue) - Number(right.issue));
 }
+async function registered_directories() {
+  const blocks = await worktree_blocks();
+  return blocks.flatMap((block) => line_value(block.split("\n"), WORKTREE_PREFIX) ?? []);
+}
 async function has_lanes_in_flight() {
   const lanes = await list_lanes();
   return lanes.some((lane) => !lane.is_stranded);
@@ -4442,6 +4456,7 @@ var lane_registry = {
   main_repository_root,
   parse_block,
   read_environment,
+  registered_directories,
   unreadable_lanes,
   used_seats
 };

package/dist/hooks/{chunk-F56MFS4B.js → chunk-KRBERBBI.js}

@@ -1,12 +1,12 @@
 import {
   investigation_reads
-} from "./chunk-5VMKCCC4.js";
+} from "./chunk-XZYKEM6J.js";
 import {
   lane_guard_policy
-} from "./chunk-VC3PZPZO.js";
+} from "./chunk-GPTFMK5E.js";
 import {
   hook_decision
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 
 // scripts/delegation/investigation-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-TQNPDZNH.js → chunk-QVSWU24O.js}

@@ -1,16 +1,16 @@
 import {
   investigation_reads
-} from "./chunk-5VMKCCC4.js";
+} from "./chunk-XZYKEM6J.js";
 import {
   lane_guard_policy
-} from "./chunk-VC3PZPZO.js";
+} from "./chunk-GPTFMK5E.js";
 import {
   hook_decision
-} from "./chunk-6HJJXRBX.js";
+} from "./chunk-ZQGD4GBY.js";
 import {
   json_value,
   time_spans
-} from "./chunk-55HHG5PX.js";
+} from "./chunk-WK2XSHSI.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";