@joshuafolkken/kit 1.2114.0 → 1.3000.0

package/lefthook/base.yml

@@ -106,12 +106,11 @@ pre-push:
   # this back. Removing the barrier while leaving this `true` reopens #813.
   parallel: true
   commands:
-    # Wrapped in `josh reserved-run` so the scan claims a place in the machine-wide core budget
-    # (kit#2351) — eight lanes auditing around the same time as they push spiked a machine the gate
-    # thought it had to itself. The weight is a conservative reservation for the single-process scan,
-    # not a measurement.
+    # Called directly so pnpm starts once (kit#7146): `josh audit` claims its own place in the
+    # machine-wide core budget (kit#2351), and skips the scan while the lockfile's last clean scan is
+    # under a day old (`scripts/security/security-audit-cache.ts`).
     audit:
-      run: pnpm josh reserved-run 1 -- pnpm josh audit
+      run: pnpm josh audit
 
     # Routed through `josh pre-push-unit` rather than a bare `pnpm exec vitest run` so the hook can
     # read the record `pnpm josh gate` leaves behind (kit#1334). A green gate writes down the digest

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.2114.0",
+  "version": "1.3000.0",
   "name": "@joshuafolkken/kit",
   "description": "Hand-off kit for Claude Code and Codex: backlogrun takes your GitHub Issues to tested, reviewed, merged PRs — in parallel and unattended — with the rules, hooks and checks that keep the agent on track",
   "keywords": [
@@ -72,6 +72,7 @@
     "!**/*.golden.txt",
     "!dist/hooks/.inputs-verified.json*",
     "!dist/.hooks-staging-*",
+    "!dist/.hooks-rebuild.*",
     "!dist/.commands-test-*",
     "!dist/.dispatch-test-*"
   ],
@@ -215,14 +216,14 @@
     "@eslint/js": "^10.0.1",
     "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
     "@playwright/test": "^1.64.1",
-    "@secretlint/secretlint-rule-preset-recommend": "^13.0.7",
+    "@secretlint/secretlint-rule-preset-recommend": "^13.1.0",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@types/node": "^26.6.5",
+    "@types/node": "^26.6.6",
     "@types/run-parallel": "^1.1.2",
     "@types/semver": "^7.8.0",
     "cspell": "^10.4.0",
     "esbuild": "^0.28.2",
-    "eslint": "^10.13.0",
+    "eslint": "^10.14.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import-x": "^4.17.1",
@@ -231,28 +232,29 @@
     "eslint-plugin-unicorn": "^79.0.0",
     "eslint_d": "^15.0.3",
     "fast-check": "^4.10.2",
-    "globals": "^17.13.0",
+    "globals": "^17.14.0",
     "lefthook": "^2.2.2",
     "prettier": "^3.9.10",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",
-    "rollup": "^4.64.12",
+    "rollup": "^4.67.4",
     "rollup-plugin-dts": "^6.5.1",
-    "secretlint": "^13.0.7",
+    "secretlint": "^13.1.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.72.0",
-    "vitest": "^5.0.5"
+    "typescript-eslint": "^8.72.1",
+    "vitest": "^5.1.0"
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
     "csv-parse": "^7.0.3",
-    "execa": "^10.2.0",
+    "execa": "^10.2.1",
     "flatted": "^3.4.4",
+    "import-meta-resolve": "^4.2.0",
     "js-yaml": "^5.5.0",
     "jsonc-parser": "^3.3.1",
-    "ora": "^9.4.1",
+    "ora": "^10.0.0",
     "run-parallel": "^1.2.0",
-    "semver": "^7.8.5",
+    "semver": "^7.8.6",
     "string-width": "^8.3.0",
     "terminal-link": "^5.0.0",
     "tsx": "^4.23.15",
@@ -261,12 +263,12 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.14.0+sha512.c18ba6d87993d3d164cb5e8948f32b2c06ee854487e06cd8d86781342fb3e5bb4634367034711e86802baa9c37bea906ce1929ad08d70884c97d801df13389a6",
+      "version": "12.17.0+sha512.b8d223ebec04b580a89ed206daa71d1bccb6a1ee1d52efa95cc3b0db75271561df8f0d8e2c43add39c5ec08018af7a8a95108e7090f95a29f88727b7a40fd53d",
       "onFail": "download"
     }
   },
   "scripts": {
     "build": "tsx scripts/build/build.ts",
-    "josh": "tsx scripts/josh/josh.ts"
+    "josh": "node --disable-warning=ExperimentalWarning tools/josh/josh-ready.ts"
   }
 }

package/pnpm-workspace.yaml

@@ -39,3 +39,18 @@ overrides:
   # major without reintroducing the advisory. The devalue, postcss and nanoid floors were removed once
   # their parents' ranges exceeded them (joshuafolkken/kit#3091).
   vite: ^8.0.16 # OSV — vite 8.0.8 → 8.0.16
+  # kit-only:start — `josh init` / `josh sync` drop this region: the override needs the patch below,
+  # which is not published (joshuafolkken/kit#5500).
+  # The fix is only in the next major, which ESLint and its plugins do not yet accept (user-approved
+  # 2026-10-31, joshuafolkken/kit#5500). Remove it, with the patch below, once eslint-plugin-import-x
+  # declares minimatch 11 (joshuafolkken/kit#5507).
+  minimatch: ^11.0.1 # OSV GHSA-g3hv-75wg-m249 — minimatch 10.2.6 → 11.0.1
+  # kit-only:end
+
+# kit-only:start — not distributed: `patches/` is not published.
+# minimatch 11 removed `makeRe`, which import-x's `no-internal-modules` imports at load time; the patch
+# matches with `Minimatch#match` instead (joshuafolkken/kit#5500). Remove it with the minimatch override
+# once import-x declares minimatch 11 (joshuafolkken/kit#5507).
+patchedDependencies:
+  eslint-plugin-import-x@4.17.1: patches/eslint-plugin-import-x@4.17.1.patch
+# kit-only:end

package/ports/index.js

@@ -209,22 +209,15 @@ function discard_loaded_keys(snapshot) {
 /**
  * Apply the project settings kit's own Playwright config reads from `.env`, and nothing else.
  *
- * Every reader comes through here. `playwright.config.ts` is loaded by Playwright itself — from
- * `pnpm exec playwright test`, the VS Code extension and `josh test:e2e` alike — with nothing on
- * the way in that reads `.env`, and `josh port` calls this rather than the
- * `--env-file-if-exists=.env` tsx flag it used to carry, because that flag resolved the file
- * against the working directory while this resolves it at the project root (#826). Two readers on
- * two rules is how `josh port preview` printed 4176 while Playwright waited on 4173, costing a
- * consumer its whole E2E suite to a webServer timeout (#820).
+ * Every reader comes through here so Playwright and `josh port` resolve `.env` at the same project
+ * root, including calls made from a subdirectory. Agreement prevents a webServer timeout caused
+ * by the command and Playwright choosing different ports (#820, #826).
  *
- * The file is parsed by `loadEnvFile`, so `.env` is read exactly as the flag reads it, and then
- * every key outside `PROJECT_ENVIRONMENT_KEYS` is taken back out. #826: the `webServer` child
- * inherits this process's environment wholesale, so keeping the rest handed a consumer's `.env`
- * secrets to the dev or preview server for the sake of two settings. A `CLOUDFLARE_API_TOKEN`
- * sitting there is not inert: `wrangler` prefers it over the OAuth session it would otherwise use,
- * so a token short of the needed scopes turned a working preview into a 403. A server that wants
- * `.env` still loads it in its own start script, which is where that decision was made before this
- * loader existed.
+ * `loadEnvFile` parses `.env`, and every key outside `PROJECT_ENVIRONMENT_KEYS` is taken back out.
+ * The `webServer` child inherits this process's environment wholesale, so retaining other keys
+ * would pass consumer secrets to
+ * the server. A `CLOUDFLARE_API_TOKEN` can override wrangler's OAuth session with insufficient
+ * scopes. Servers that need `.env` load it in their own start script (#826).
  *
  * A missing file is the documented default and does nothing, and a variable already present in the
  * environment wins over the file, so an explicit `PORT_SEED=2 pnpm josh test:e2e` still overrides

package/prompts/coding-standards.md

@@ -7,7 +7,7 @@
 - Naming: `snake_case` variables / functions / params · `PascalCase` types / classes / interfaces / enums · `UPPER_CASE` enum members · booleans prefixed `is_` / `has_` / `should_` / `can_` / `will_` / `did_` · constants `UPPER_CASE` or `snake_case`
 - Functions & exports: multiple functions → a namespace object `export { my_module }` (constants exempt) · no `export default`
 - Files: Svelte `PascalCase.svelte(.ts)` · TypeScript `kebab-case.ts` · tests `*.test.ts` / `*.svelte.test.ts`, colocated, never `*.spec.ts` (`prompts/testing-guide.md`) · in `scripts/`, no `../` imports — use `#scripts/*`
-- Content rules: user-visible strings use i18n message keys in every locale · comments / test titles English only (`eslint/rules/` may explain rationale in Japanese) · no duplication; `/* @refactor-ignore */` at file top excludes a file from refactoring
+- Content rules: user-visible strings use i18n message keys in every locale · comments / test titles English only (<!-- lint: english-only-exemption -->`eslint/rules/`<!-- /lint --> may explain rationale in Japanese) · no duplication; `/* @refactor-ignore */` at file top excludes a file from refactoring
 
 ## 📝 基本方針
 
@@ -19,45 +19,6 @@
 
 ## 📁 新規作成時の手順
 
-### 1. 既存ファイルを必ず参照
-
-```bash
-# 類似機能の既存ファイルを探す
-find src -name "*.ts" -o -name "*.svelte" | grep -i [関連キーワード]
-```
-
-### 2. ファイル分割の指針
-
-- `CLAUDE.md` → "Quality limits" の上限に近づいたら分割を検討する。編集前に `pnpm josh lines <path>` で余裕を確認する
-- 責任ごと、また他ファイルからも使われうるロジックごとに別ファイルに分け、メインファイルは主要な処理フローに集中させる
-- 小さすぎる分割は避け、関連する機能は同じファイルにまとめる
-
-### 3. 名前空間オブジェクトの名付け方
-
-- ファイル名と名前空間名で意図を明確にする（例: `git-command.ts` → `git_command`）
-- メソッド名は短く、名前空間で補完する（例: `exec_git_branch()` → `git_command.branch()`）
-
-```typescript
-// ✅ ファイル名: git-command.ts / 名前空間名: git_command
-async function branch(): Promise<string> {
-	return await exec_git_command('rev-parse --abbrev-ref HEAD')
-}
-
-async function status(): Promise<string> {
-	return await exec_git_command('status --porcelain')
-}
-
-const git_command = {
-	branch,
-	status,
-}
-
-export { git_command }
-```
-
-```typescript
-// 使用側
-import { git_command } from './git/git-command.js'
-
-const branch_name = await git_command.branch()
-```
+- 書く前に類似機能の既存ファイルを読み、その構成と名付けに合わせる
+- 分割は責任ごと。他ファイルからも使われうるロジックは別ファイルに分け、メインファイルは主要な処理フローに集中させる。小さすぎる分割は避ける。編集前に `pnpm josh lines <path>` で上限までの余裕を見る
+- 名前空間名はファイル名から取る: `git-command.ts` → `git_command`。メソッド名は名前空間で補って短くする（`exec_git_branch()` → `git_command.branch()`）

package/prompts/collaboration-workflow/file-edits.md

@@ -20,7 +20,7 @@ PY
 > **そのコマンドは、置換後のテキストを丸ごとコマンド本文に載せているか。**
 
 - yes → 禁止。Edit を使う
-- no → 許可（短い置換の `sed -i` は下の 4 条件つきで可）
+- no → 許可（短い置換の `sed -i` は下の条件つきで可）
 
 ### 編集は指摘された箇所だけを対象にする（全文書き直しの条件）
 
@@ -32,22 +32,22 @@ PY
 
 既存ファイルへの Write が元の行の過半を残すかは `file-rewrite` ガードが数えて拒否する。
 
-### `sed -i` を使う前に満たす 4 条件
+### `sed -i` を使う前に満たす条件
 
-`sed` は一致した全行を書き換え、一致 0 件でも黙って成功する。使う前に次を満たす。条件 1・2 は `sed-in-place` ガードが判定して拒否する。
+`sed` は一致した全行を書き換え、一致 0 件でも黙って成功する。
 
-1. **出現回数を先に数える** — `grep -o '<pattern>' <file> | wc -l` が `1` であること。`grep -c` は行数を数えるので使わない
-2. **メタ文字を持ち込まない — パターン側と置換語側の両方** — `/`、`&`、`\`、`.` `*` `[` `]` `^` `$` のいずれかが入るなら Edit を使う
-3. **`-i` の引数はプラットフォームで違う** — BSD / macOS は `sed -i '' 's/…/…/' file`、GNU / Linux は `sed -i 's/…/…/' file`。配布ドキュメントに書くときはこの差を明示する
-4. **編集後に自分で整形する** — Bash 経由の編集では `PostToolUse` の整形が走らない（joshuafolkken/kit#1337）ので `pnpm josh format` を走らせる（`format:edited` は手で呼べない）
+一致が 1 件でない置換とメタ文字（`/`、`&`、`\`、`.` `*` `[` `]` `^` `$`）は `sed-in-place` ガードが拒否する。ガードが見ないのは次の 2 つ。
 
-**4 条件のどれかが面倒に見えたら、そこが Edit を使う場所である。**
+1. **`-i` の引数はプラットフォームで違う** — BSD / macOS は `sed -i '' 's/…/…/' file`、GNU / Linux は `sed -i 's/…/…/' file`。配布ドキュメントに書くときはこの差を明示する
+2. **編集後に自分で整形する** — Bash 経由の編集では `PostToolUse` の整形が走らない（joshuafolkken/kit#1337）ので `pnpm josh format` を走らせる（`format:edited` は手で呼べない）
+
+**ガードの拒否やこの 2 つが面倒に見えたら、そこが Edit を使う場所である。**
 
 | 形                                                      | 可否                    |
 | ------------------------------------------------------- | ----------------------- |
 | Edit（数行の old / new）                                | 可                      |
-| `sed -i` の短い置換                                     | 上の 4 条件つきで可     |
-| 同じ識別子・import 指定子の置換が複数ファイルにまたがる | `pnpm josh rename` で可 |
+| `sed -i` の短い置換                                     | 上の条件つきで可        |
+| 識別子・import の置換・付け替えが複数ファイルにまたがる | `pnpm josh rename` で可 |
 | `python3 - <<'PY'` で書き戻す                           | 不可                    |
 | `cat > file <<'EOF'`（既存ファイル）                    | 不可                    |
 | `cat > new-file <<'EOF'`（新規、長文なら Write）        | 可                      |

package/prompts/collaboration-workflow/gh-rest.md

@@ -1,25 +1,32 @@
-# `gh` は REST（`gh api`）で書く — 散文の指示も含む
+# `gh` は `gh api` で書く — 散文の指示も含む
 
 ## 規則
 
-**GitHub への操作は `gh api`（REST）で書く。** `gh issue …` / `gh pr …` / `gh repo …` のサブコマンド形は使わない —
-クラウドセッションでは GraphQL への egress が `403` で拒否される。
+**GitHub への操作は `gh api` で書く。** `gh issue …` / `gh pr …` / `gh repo …` のサブコマンド形は使わない —
+`scripts/gh/` の exec 層（ETag・回数の記録・transport）を迂回する。
 
 例外は 2 つだけ:
 
-- `gh auth token` — ローカルの認証情報を返すだけで、どのエンドポイントにも接続しない
+- `gh auth token` — ローカルの認証情報を返すだけで、どのエンドポイントにも接続しない。スクリプトが自分のプロセス内で読む形に限る。エージェントの `Bash` からは `egress` 行が拒否する（`scripts/rules/egress-guard.ts`）
 - GitHub Actions のワークフロー — ランナー上では `gh` が動き、`gh pr merge --auto` の API は GraphQL にしか無い
 
+## API コールを減らす
+
+`scripts/gh/` に読みを足すとき → ETag の条件付き GET（`304` は REST core を消費しない、`git-gh-etag-read.ts`）、
+バッチ（N 件を 1 回、`git-gh-issue-batch-graphql.ts`）、transport（`git-gh-transport.ts`）のどれかに乗せる。
+GraphQL の読みは `git_gh_transport.query` で送る。`JOSH_GH_TRANSPORT`（既定 `auto`）の `auto` では、
+`403` で拒否されたセッションの読みが 1 時間 REST に戻る。GraphQL の mutation は対象外。
+
 ## 認証は環境によって別物である
 
 **手元では `gh auth login` を一度実行すれば足り、`GH_TOKEN` は要らない**（認証情報は OS のキーチェーン）。
 **CI とクラウドセッションにはキーチェーンが無いので、`GH_TOKEN` を設定する。** 説明を書くときは両方を書く。
 
-## 散文でも「指示の形」なら REST で書く
+## 散文でも「指示の形」なら `gh api` で書く
 
-**文書の散文に書いたコマンドでも、読み手に実行を指示する形なら REST で書く。**
+**文書の散文に書いたコマンドでも、読み手に実行を指示する形なら `gh api` で書く。**
 
-- 指示の形（REST で書く）— 「数えるのはコマンド 1 つで済む: `…`」「各子 Issue に `…` でコメントを書く」のように、
+- 指示の形（`gh api` で書く）— 「数えるのはコマンド 1 つで済む: `…`」「各子 Issue に `…` でコメントを書く」のように、
   読み手がそのまま打つ書き方
 - 引用の形（そのままでよい）— 「`gh issue create` は使わない」のような禁止の引用や、CLI の対応状況の記録
 

package/prompts/collaboration-workflow/issue-template.en.md

@@ -0,0 +1,125 @@
+## Step 1: Issue template (en)
+
+The `en` column of `issue-template.md`'s template; its rules and label table → `issue-template.md`. Keys, fixed values and headings → `scripts/issue/issue-body-keys.ts`, mirrored in the table below. The parentheses `（）`, the minute unit `分` and the `## Expected effect` labels stay as `issue:lint` reads them.
+
+````md
+## Background
+
+<`- Type: defect` for a defect, else `- Type: non-defect`>
+<for a defect `- Cause: #<PR>`, or `- Cause: unknown（<reason>）` when it cannot be traced>
+<`- Human judgement: not needed` or `- Human judgement: needed（<policy decision / external account / visual check>）`>
+<when a measurement picks: `- Decision rule: <condition> then <A>, else <B>（#<measurement Issue>）`, with `Human judgement: not needed`>
+<for a cause that lengthened a lane: `- Cause lane: <minutes> 分（#<N>）`; the minutes from `pnpm josh lane:net <N>`>
+<the minutes this Issue's cause could save: `- Cause loss: <minutes> 分`, one line per recurrence>
+<for a security finding: `- Security: <the bypassed gate, guard or permission>`>
+<for a run-machinery defect that parked an Issue or stopped a run: `- Cause park: #<N>`, one line per number, same repository only>
+<for a behavior change: `- Enforcement: <the hook, lint or gate that stops it>` (none: `- Enforcement: measurement only`)>
+<for a behavior change: `- Measurement: <the number that shows a violation (command name)>`>
+<optional: `- Priority: critical（condition <1-3>）`, `- Priority: high（<basis>）` or `- Priority: normal`>
+<the diff estimate: `- Size estimate: about <N> files / <M> lines (excluding tests)`, counting docs, snapshots and command listings>
+<past the guide, cap or bar (`split-assessment.md` → "The question") as one Issue: `- No-split reason: <reason>`>
+<each figure a decision used: ``- Premise: `<command>` <comparison> <figure>`` (one figure per line)>
+
+<why it is needed>
+
+## Symptom
+
+<the current problem>
+
+## Expected result
+
+<what done looks like>
+
+## Acceptance criteria
+
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+## Trigger
+
+<only for an Issue that changes AI behavior: the one tool call first made when the rule breaks (`Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`; `Stop` for a rule judging the reply)>
+
+## Baseline
+
+<only for an Issue that changes AI behavior: a command and its value>
+
+- `<measurement command>` → <current value>
+
+## Reproduction
+
+<only for an Issue that changes AI behavior, or a defect with `- Cause: unknown（<reason>）`: a command and its actual output, fenced (``` or ~~~)>
+
+- `<reproduction command>`
+
+```
+<actual output>
+```
+
+## Expected effect
+
+<only for `- Purpose: time saving`; the source is a command and its value>
+
+- 効く率: <hit rate>
+- 1 回あたりの得: <gain per hit>
+- 外れたときの損: <loss per miss>
+- 出典: <`pnpm josh lane:stats` → value>
+
+## Origin
+
+<only when filed from another repository's session: the originating Issue as `owner/repo#N`; omit the section otherwise>
+````
+
+### Correspondence table
+
+| Kind    | ja             | en                     |
+| ------- | -------------- | ---------------------- |
+| key     | 種別           | Type                   |
+| key     | 目的           | Purpose                |
+| key     | 互換性         | Compatibility          |
+| key     | リリース分類   | Release classification |
+| key     | 人の判断       | Human judgement        |
+| key     | 判定規則       | Decision rule          |
+| key     | 中止条件       | Close condition        |
+| key     | 優先度         | Priority               |
+| key     | セキュリティ   | Security               |
+| key     | 原因の park    | Cause park             |
+| key     | 原因のレーン   | Cause lane             |
+| key     | 原因の損失     | Cause loss             |
+| key     | 実施順         | Order                  |
+| key     | 原因           | Cause                  |
+| key     | 規模見積もり   | Size estimate          |
+| key     | 分割しない理由 | No-split reason        |
+| key     | 行を増やさない | No added lines         |
+| key     | 先行リファクタ | Refactor first         |
+| key     | 強制           | Enforcement            |
+| key     | 計測           | Measurement            |
+| key     | 計測宣言       | Measure declaration    |
+| key     | 前提           | Premise                |
+| key     | 計測宣言なし   | No measure declaration |
+| key     | 実施可能条件   | Sample gate            |
+| key     | 実施可能日     | Not before             |
+| key     | 出どころ       | Source                 |
+| value   | 不具合         | defect                 |
+| value   | 非不具合       | non-defect             |
+| value   | 振る舞い変更   | behavior change        |
+| value   | 機能追加       | feature                |
+| value   | 機能改善       | improvement            |
+| value   | 時間短縮       | time saving            |
+| value   | 不具合修正     | bug fix                |
+| value   | 破壊的変更     | breaking change        |
+| value   | 不要           | not needed             |
+| value   | 要             | needed                 |
+| value   | 通常           | normal                 |
+| value   | 高             | high                   |
+| value   | 緊急           | critical               |
+| value   | 最後           | last                   |
+| value   | 不明           | unknown                |
+| value   | なし           | none                   |
+| heading | 背景           | Background             |
+| heading | 現象           | Symptom                |
+| heading | 期待結果       | Expected result        |
+| heading | 受け入れ条件   | Acceptance criteria    |
+| heading | 発火点         | Trigger                |
+| heading | ベースライン   | Baseline               |
+| heading | 再現           | Reproduction           |
+| heading | 期待効果       | Expected effect        |

package/prompts/collaboration-workflow/issue-template.md

@@ -1,20 +1,25 @@
 ## Step 1: Issue 作成テンプレ
 
-タイトルは簡潔で明瞭な英語にする（「出力の言語（`JOSH_SESSION_LANG`）」の例外）。日本語や改善できるタイトルは実装開始前に `pnpm josh issue:plan <N> --body-file <path> --title "<title>"` で計画と一緒に書き換える。本文は次のテンプレートの節をすべて含める:
+タイトルは簡潔な英語。実装前に `pnpm josh issue:plan <N> --body-file .josh/tmp/plan.md --title "<title>"` で計画と一緒に改善する。本文は次の節をすべて含める:
 
 ````md
 ## 背景
 
 <不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
 <不具合なら `- 原因: #<PR>`、追えなければ `- 原因: 不明（<理由>）` を宣言する>
-<人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
+<`- 人の判断: 不要` または `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）`>
+<計測で選ぶなら `- 判定規則: <条件> なら <A>、そうでなければ <B>（#<計測 Issue>）`。`人の判断: 不要` とする>
+<調べた結果しだいで実装せず閉じるなら `- 中止条件: <計測で確かめる条件>` を宣言する>
 <レーンを延ばした原因なら `- 原因のレーン: <分> 分（#<N>）` を宣言する。分は `pnpm josh lane:net <N>`>
 <そのうちこの Issue の原因で縮められる分は `- 原因の損失: <分> 分` で宣言する。再発のたびに 1 行足す>
 <セキュリティの指摘なら `- セキュリティ: <迂回される gate・ガード・権限>` を宣言する>
-<Issue を park させた、またはランを止めた run 機構の不具合なら `- 原因の park: #<N>` を宣言する>
+<Issue を park させた、またはランを止めた run 機構の不具合なら `- 原因の park: #<N>` を宣言する。複数なら単一番号行を繰り返す。同じリポジトリの番号だけを書く>
+<振る舞い変更なら `- 強制: <止める hook・lint・gate の名前>`（無ければ `- 強制: 計測のみ`）を宣言する>
+<振る舞い変更なら `- 計測: <違反が見える数字（コマンド名）>` を宣言する>
 <任意。`- 優先度: 緊急（条件 <1-3>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ下限か通常>
-<差分の見積もりを `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` で宣言する>
-<見積もりが分割の目安を超えても 1 件にするなら `- 分割しない理由: <理由>` を宣言する>
+<差分の見積もりを `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` で宣言する。文書・スナップショット・コマンド一覧の追従も数える>
+<実測からの導出・未測定時の fallback・cap・基準（実装予算の 2 倍を宣言行数で）は `split-assessment.md` → "The question" を参照。目安・cap・基準を超えても 1 件にするなら `- 分割しない理由: <理由>` を宣言する>
+<判断に使った数値は ``- 前提: `<command>` <比較> <数値>`` で宣言する（1 数値 1 行。`principles.md` → "measured-figures"）>
 
 <なぜ必要か>
 
@@ -67,31 +72,42 @@
 
 ### `## 背景` 直下の宣言と分類ラベル
 
-起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル>` で行い、本文の検査（`pnpm josh issue:lint <path>` と同じ）と下表のラベル付与はコマンドが行う。**宣言は起票者が選ぶ。** `- 人の判断:` の行は必須で、`issue:file` が検査し `auto-ok` の判定に使う（`scripts/issue/issue-auto-ok.ts`、`docs/how-to/run-backlog.md`）。`不要` を宣言する起票には `--label run:lane`（kit 自身の検証が `main` で毎回決まって誤った答えを出す不具合なら `run:solo`。時々出る誤判定は `run:lane` と `priority:critical`）も付ける — 無ければ `issue:file` が拒否する。
-
-| 宣言                                                     | 付くラベル                             | 選ぶ基準                                                                                              |
-| -------------------------------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| `- 種別: 不具合`                                         | `bug`                                  | 報告された症状を直す（無ければ `- 種別: 非不具合`）                                                   |
-| `- 目的: 機能追加`                                       | `enhancement`                          | 新しい機能。修正・文書・依存更新・保守には書かない                                                    |
-| `- 目的: 機能改善`                                       | `enhancement`                          | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから                                            |
-| `- 目的: 時間短縮`                                       | `enhancement`                          | 所要時間を短くする。`## 期待効果` の 4 行が必須                                                       |
-| `- 互換性: 破壊的変更`                                   | `breaking-change`                      | 契約を変える。移行措置があっても書き、廃止対象と影響を書く                                            |
-| `- 種別: 振る舞い変更`                                   | なし                                   | AI の振る舞いを変える。下の 3 見出しが必須                                                            |
-| `- 人の判断: 不要`                                       | `auto-ok`（除外ラベルが無ければ）      | 方針の判断・外部アカウント・目視確認のどれも要らない                                                  |
-| `- 実施可能条件: #<PR> のマージ後 <K> マージ`            | `not-before`（待つ間）                 | 追跡計測。元の PR のマージ後に lane ledger が K 件のマージを記録するまで着手しない                    |
-| `- 実施可能日: <UTC>`                                    | `not-before`（待つ間）                 | 外部の期限など暦そのものに意味がある待ち（`YYYY-MM-DDTHH:MMZ`）。追跡計測には使わない                 |
-| ``- 計測宣言: `<command>` <= <数値>``                    | なし（閉じたら `measured`）            | 追跡計測の既定。比較は `<=` `<` `>=` `>`                                                              |
-| `- 計測宣言なし: <理由>`                                 | なし                                   | 追跡計測の値を 1 コマンドで出せない（Actions の記録・外部サービスなど）                               |
-| `- 原因のレーン: <分> 分（#<N>）`                        | なし                                   | レーン #N を延ばした原因。並びの代替キーで、下限は作らない（下の F）                                  |
-| `- 原因の損失: <分> 分`                                  | 合計 30 分以上で下限（宣言が無いとき） | 原因ごとの縮められる分。再発ごとの行を合計して並べる（下の F）                                        |
-| `- セキュリティ: <迂回される gate・ガード・権限>`        | 下限（宣言が無いとき）                 | 下の H                                                                                                |
-| `- 原因の park: #<N>`                                    | 下限（宣言が無いとき）                 | 下の I。#N は park された、またはランが止まった Issue                                                 |
-| `- 優先度: 緊急（…）`                                    | `priority:critical`                    | 下の A。条件番号を括弧に書く                                                                          |
-| `- 優先度: 高（…）`                                      | `priority:high`                        | 下の D・E・F・H・I のどれか。根拠を括弧に書く                                                         |
-| `- 優先度: 通常`                                         | なし                                   | どれにも当たらない                                                                                    |
-| `- 実施順: 最後`                                         | なし                                   | 触るファイルが事前に読めない広域 upgrade など、列の末尾でまとめて走らせたい作業。緊急・高と同居しない |
-| `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` | なし                                   | epic 以外は必須。目安の判定は `issue:file`（`scripts/issue/size-estimate.ts`）                        |
-| `- 分割しない理由: <理由>`                               | なし                                   | 目安を超える見積もりを 1 件のまま起票する（`split-assessment.md` → "The question"）                   |
+起票は `pnpm josh issue:file "<title>" --body-file .josh/tmp/issue.md`（置き場は `shell-body.md`）。本文検査は `pnpm josh issue:lint <path>` と共通で、下表のラベルも付与する。宣言は起票者が選ぶ。`- 人の判断:` は必須で `auto-ok` 判定に使う（`scripts/issue/issue-auto-ok.ts`）。`不要` には `--label run:lane` も必須（kit 自身の検証が `main` で毎回誤判定する不具合なら `run:solo`。時々なら `run:lane` と `priority:critical`）。
+
+宣言のキー・固定値とテンプレートの見出しは `scripts/issue/issue-body-keys.ts` が単一ソースで、`scripts/` の検査はそこを参照する。`en` の列のテンプレートと日英の対応表 → `issue-template.en.md`。
+
+| 宣言                                                     | 付くラベル                             | 選ぶ基準                                                                                                  |
+| -------------------------------------------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------- |
+| `- 種別: 不具合`                                         | `bug`                                  | 報告された症状を直す（無ければ `- 種別: 非不具合`）。非不具合で別の分類 → `- リリース分類: <分類>`        |
+| `- 目的: 機能追加`                                       | `enhancement`                          | 新しい機能。修正・文書・依存更新・保守には書かない                                                        |
+| `- 目的: 機能改善`                                       | `enhancement`                          | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから                                                |
+| `- 目的: 時間短縮`                                       | `enhancement`                          | 所要時間を短くする。`## 期待効果` の 4 行が必須                                                           |
+| `- 互換性: 破壊的変更`                                   | `breaking-change`                      | 契約を変える。移行措置があっても書き、廃止対象と影響を書く                                                |
+| `- 種別: 振る舞い変更`                                   | なし                                   | AI の振る舞いを変える。下の 3 見出しと次の 2 行が必須                                                     |
+| `- 強制: <hook・lint・gate>` / `- 強制: 計測のみ`        | なし                                   | 振る舞い変更のみ。検査は `scripts/issue/enforcement-lint.ts`                                              |
+| `- 計測: <コマンド名と数字>`                             | なし                                   | 振る舞い変更のみ。検査は `scripts/issue/enforcement-lint.ts`                                              |
+| `- 人の判断: 不要`                                       | `auto-ok`（除外ラベルが無ければ）      | 方針の判断・外部アカウント・目視確認のどれも要らない                                                      |
+| `- 判定規則: <条件分岐>（#<計測 Issue>）`                | なし                                   | `人の判断: 要` との併記を拒否。適用は `operating-rules.md` → "decision-autonomy"                          |
+| `- 中止条件: <条件>`                                     | なし                                   | 当たったときの出口は `josh issue:premise-unmet`（`scripts/issue/issue-premise-unmet-cli.ts`）             |
+| `- 実施可能条件: #<PR> のマージ後 <K> マージ`            | `not-before`（待つ間）                 | 追跡計測。元の PR のマージ後に lane ledger が K 件（既定 10、上限 30）のマージを記録するまで着手しない    |
+| `- 実施可能日: <UTC>`                                    | `not-before`（待つ間）                 | 外部の期限など暦そのものに意味がある待ち（`YYYY-MM-DDTHH:MMZ`）。追跡計測には使わない（`measurement.md`） |
+| ``- 計測宣言: `<command>` <= <数値>``                    | なし（閉じたら `measured`）            | 追跡計測の既定。比較は `<=` `<` `>=` `>`                                                                  |
+| `- 計測宣言なし: <理由>`                                 | なし                                   | 追跡計測の値を 1 コマンドで出せない（Actions の記録・外部サービスなど）                                   |
+| ``- 前提: `<command>` <= <数値>``                        | なし                                   | 判断に使った数値。書式と解析は `- 計測宣言:` と共有（`scripts/issue/measure-declaration.ts`）。複数行可   |
+| `- 原因のレーン: <分> 分（#<N>）`                        | なし                                   | レーン #N を延ばした原因。並びの代替キーで、下限は作らない（下の F）                                      |
+| `- 原因の損失: <分> 分`                                  | 合計 30 分以上で下限（宣言が無いとき） | 原因ごとの縮められる分。再発ごとの行を合計して並べる（下の F）                                            |
+| `- セキュリティ: <迂回される gate・ガード・権限>`        | 下限（宣言が無いとき）                 | 下の H                                                                                                    |
+| `- 原因の park: #<N>`                                    | 下限（宣言が無いとき）                 | 下の I。#N は park された、またはランが止まった Issue                                                     |
+| `- 優先度: 緊急（…）`                                    | `priority:critical`                    | 下の A。条件番号を括弧に書く                                                                              |
+| `- 優先度: 高（…）`                                      | `priority:high`                        | 下の D・E・F・H・I のどれか。根拠を括弧に書く                                                             |
+| `- 優先度: 通常`                                         | なし                                   | どれにも当たらない                                                                                        |
+| `- 実施順: 最後`                                         | なし                                   | 触るファイルが事前に読めない広域 upgrade など、列の末尾でまとめて走らせたい作業。緊急・高と同居しない     |
+| `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` | なし                                   | epic 以外は必須。目安の判定は `issue:file`（`scripts/issue/size-estimate.ts`）                            |
+| `- 分割しない理由: <理由>`                               | なし                                   | 目安・cap・予算を超える見積もりを 1 件のまま起票する（`split-assessment.md` → "The question"）            |
+| `- 行を増やさない: <理由>`                               | なし                                   | 実コード行が上限の 90% 以上のファイルを名指すが、行を足さない（`scripts/issue/issue-cap-files.ts`）       |
+| `- 先行リファクタ: #<N>`                                 | なし                                   | 同じファイルを先に分割する Issue を待つ（`scripts/issue/issue-cap-files.ts`）                             |
+
+名指すファイルが実コード行で上限の 90% 以上 → 先に分割のリファクタ Issue を起票し、依存に登録する（`issue:file` が拒否して手順を出す。`scripts/issue/issue-cap-files.ts`）。
 
 集計・計測（`計測` / `before` / `変更前後`）を Issue コメントに記録する受け入れ条件と実装の見積もりを併せ持つ本文 → 集計・計測を `--route split` の先行 Issue に分け、そのコメントを `## 背景` に引く（`issue:lint` が拒否する。`scripts/issue/aggregation-split.ts`）。
 
@@ -103,6 +119,7 @@
 - F. `- 原因の損失:` の合計（再発ごとに 1 行足す）が 30 分以上なら高。再発の追記の後は `pnpm josh issue:priority <N>` がラベルを付ける。`- 原因のレーン:` は 1 本のレーンの見積もりなので下限を作らない。同じ優先度の中の並びは `- 原因の損失:` の合計、無ければ `- 原因のレーン:` の分。その次が `## 期待効果` の週あたりの短縮分（`効く率` の週あたりの回数（「2 週間で 10 回」は週 5 回に直す）× `1 回あたりの得`、分）で、どちらかが数値で読めない Issue はその後ろ。% は計算しない。超過調査はそのレーン 1 本の記録から、工程別内訳（`pnpm josh lane:breakdown <N>`）の長い工程の順に、縮められる分の大きい原因を最大 5 件（1 件 1 分以上）起票する（`scripts/lane/lane-overrun-prompt.ts`）
 - H. 信用できない入力が検証 gate・ガード・権限を迂回する経路の指摘。レビューの範囲外の残りを含む（高）
 - I. 実際の Issue を park（`run:stalled`）させた、またはランを止めた run 機構の不具合（高）
+- 同じリポジトリへの起票後、`issue:file` が各停止元の blocked-by と epic 本文を共有 recorder で整える。警告時は依存だけ修復し、再起票しない
 - 下限・拒否・宣言が無いときのラベルは `issue:file` が出す（`scripts/issue/issue-priority.ts`）
 - `- 目的: 時間短縮` の Issue は `## 期待効果` の 4 行を書く。短縮の % は求めず、% による拒否も下限も無い
 - 根拠の無い `緊急` / `高` も `issue:file` が拒否する
@@ -133,30 +150,6 @@
 
 ### 複数 Issue に分割するときの epic Issue
 
-**1 つの要望を 2 件以上の Issue に分割したら、件数や順序の有無にかかわらず常に epic を作る。** 作成は `pnpm josh epic`、点検は `pnpm josh epic:check <E>`、子の追加は `pnpm josh epic --add` で行い、本文を手で編集しない。epic 自体を実装ランに渡さない（`backlogrun #<E> --only` が子を回す）。記法は `epic-commands` スキル →「Creating an epic」。
+**1 つの要望を 2 件以上の Issue に分割したら、件数や順序の有無にかかわらず常に epic を作る。** 作成は `pnpm josh epic`、点検は `pnpm josh epic:check <E>`、子の追加は `pnpm josh epic --add` で行い、本文を手で編集しない。epic 自体を実装ランに渡さない（`pnpm josh backlogrun <E> --only` が子を回す）。記法は `epic-commands` スキル →「Creating an epic」。
 
-`josh` が使えない環境での手作業手順:
-
-1. 子 Issue をすべて起票し、番号を控える。`epic` ラベルは `josh sync` が用意する。
-2. epic を作り、`id` ではなく **number** を控える: `gh api repos/{owner}/{repo}/issues -f title="<epic-title>" -f 'labels[]=epic' -F body=@<body-file> --jq .number`。本文は次の形にする（順序がなければ `Dependencies` に `None — the children are independent; any execution order works.` と書く）:
-
-   ```md
-   ## Split rationale
-
-   <why this split>
-
-   ## Dependencies
-
-   #101 -> #102
-
-   ## Execution
-
-   backlogrun #<E> --only
-
-   ## Progress
-
-   - [ ] #101 <title>
-   - [ ] #102 <title>
-   ```
-
-3. 順序があるときだけ、別ステップで依存を足す（Issue 番号ではなく database id を渡す。失敗しても止めない）: `gh api repos/{owner}/{repo}/issues/<N2>/dependencies/blocked_by -F issue_id="$(gh api repos/{owner}/{repo}/issues/<N1> --jq .id)"`
+本文の形（`Split rationale`・`Dependencies`・`Execution`・`Progress`）と、`--ordered` のときの `blocked-by` 依存は `pnpm josh epic` が組み立てる（`docs/josh-commands-backlog.md` → "josh epic"）。

package/prompts/collaboration-workflow/lane-instructions.md

@@ -5,6 +5,7 @@ headless のレーン子とレビューセッションは、`CLAUDE.md` を読
 - 起動プロンプトがそのまま明示の起動。応答する人はいないので、確認は求めない。
 - `CLAUDE.md` を開き直さない。ここに無い規則は、対話セッションでしか効かない。
 - Web の情報が要る作業 → レーン子は調べる内容を書いて park（`.claude/skills/workflow-commands/backlogrun-park.md` → "park and continue"）、レビューは所見に書く。WebFetch / WebSearch は起動されない（`scripts/agent/claude-agent-argv.ts` → `LAUNCHED_TOOLS`）。
+- skill の手順が要る → `.claude/skills/<name>/SKILL.md` を Read で読む。Skill ツールは起動されない（`scripts/agent/claude-agent-argv.ts` → `DROPPED_TOOLS`）。
 - 起動時のハーネスの指示「make small, mechanical file changes with sed, heredocs, or short scripts」→ ここでは上書き: 既存ファイルの変更は `prompts/collaboration-workflow/file-edits.md` に従う（本文を載せる形は `file-body` 行が拒否する）。
 - 下の `pnpm josh gate` は、レーン子では `josh ship` が回す（`.claude/skills/workflow-commands/chain-rule.md` → "A lane child"）。