@joshuafolkken/kit 1.1471.0 → 1.1784.0

package/eslint/base.js

@@ -34,7 +34,7 @@ import { unicorn_rules, unicorn_test_rules } from './rules/unicorn.js'
 const FILE_PATTERNS = {
 	d_ts: ['**/*.d.ts'],
 	typescript: ['**/*.ts', '**/*.tsx'],
-	scripts: ['scripts/**/*.ts', 'scripts/**/*.js'],
+	scripts: ['scripts/**/*.ts', 'scripts/**/*.js', 'tools/**/*.ts', 'tools/**/*.js'],
 	// joshuafolkken/kit#1414: `**/*.spec.ts` is deliberately absent. The same config bans that name
 	// outright, so handing it the test relaxation (`max-lines-per-function` 35 and the rest) is the
 	// config contradicting itself, and it is what makes `*.spec.ts` read as supported. A banned file

package/lefthook/base.yml

@@ -5,9 +5,11 @@ pre-commit:
       skip: git diff --cached --quiet
       run: pnpm josh prevent-main-commit
 
+    # cspell, prettier and eslint go through `josh pre-commit-lint`, which owns their flags so each
+    # cache location comes from the constant its ignore rules are asserted against (kit#3948).
     cspell:
       glob: '*.{ts,tsx,js,jsx,md,mdx,html,css,scss,yml,yaml,json,properties}'
-      run: pnpm exec cspell lint --no-must-find-files --no-progress {staged_files}
+      run: pnpm josh pre-commit-lint cspell {staged_files}
 
     # Scans only staged files, so a secret is caught before it ever enters history —
     # GitHub push protection and the CodeRabbit gitleaks pass both fire after the fact,
@@ -22,11 +24,11 @@ pre-commit:
 
     prettier:
       glob: '*.{js,jsx,ts,tsx,mjs,cjs,html,css,scss,md,mdx,json,jsonc,yaml,yml}'
-      run: pnpm exec prettier --check --ignore-unknown {staged_files}
+      run: pnpm josh pre-commit-lint prettier {staged_files}
 
     eslint:
       glob: '*.{js,jsx,ts,tsx,mjs,cjs}'
-      run: pnpm exec eslint --quiet --cache --cache-strategy content {staged_files}
+      run: pnpm josh pre-commit-lint eslint {staged_files}
 
     # Routed through `josh pre-commit-type-check` rather than a bare `pnpm exec tsc --noEmit` so the
     # hook can read the record `pnpm josh gate` leaves behind (kit#1381) — the same reader the
@@ -116,7 +118,9 @@ pre-push:
     # of every changed file it passed on and the commit that map is a diff against; where that record
     # covers the tree this push carries — and the working tree is clean, so the tree and the commit
     # are the same thing — the suite is not run again. Measured: 15.9s of a 40s `josh git -y`, spent
-    # 40 seconds after the same tree went green. Anything else runs the whole suite exactly as before,
+    # 40 seconds after the same tree went green. Since kit#4065 the gate's unit check runs only the
+    # tests the change can reach, so such a push runs no local whole suite at all; CI's sharded whole
+    # suite is what covers the rest before the merge. Anything else runs the whole suite exactly as before,
     # and `JOSH_PRE_PUSH_FORCE=1 git push` runs it regardless. A push whose last gate ran before
     # `josh bump` rewrote package.json is one of those "anything else" cases, not a regression.
     test-unit:

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.1471.0",
+  "version": "1.1784.0",
   "name": "@joshuafolkken/kit",
   "description": "Development toolkit for AI-assisted projects: formatting, AI assistant rules and a Git/GitHub Issue workflow for any repository, plus lint, type check, tests and hooks for Node projects",
   "keywords": [
@@ -57,61 +57,23 @@
     ".coderabbit.yaml",
     ".gitattributes",
     ".mcp.json",
-    ".ncurc.json",
     ".prettierignore",
     "pnpm-workspace.yaml",
     ".pnpmfile.mjs",
     "tsconfig.sonar.json",
     "playwright.config.ts",
     "!**/*.test.ts",
-    "!scripts/gh/gh-subcommand-guard.ts",
     "!**/*.spec.ts",
     "!**/*-fixture*.ts",
     "!**/__snapshots__",
     "!**/*.golden.txt",
-    "!scripts/eval",
-    "!scripts/time",
-    "!scripts/cost",
-    "!scripts/retrospective",
-    "!scripts/dogfood",
-    "!scripts/metrics",
-    "!scripts/test/classify-isolation.ts",
-    "!scripts/test/hanging-execa.ts",
-    "!scripts/test/http-fault-injection.ts",
-    "!scripts/test/josh-harness*.ts",
-    "!scripts/test/pure-files.ts",
-    "!scripts/test/test-machine-guard.ts",
-    "!scripts/test/test-network-guard.ts",
-    "!scripts/test/test-repository-guard.ts",
-    "!scripts/test/test-state-guard.ts",
-    "!scripts/test/test-stdout-guard.ts",
-    "!scripts/test/test-telegram-guard.ts",
-    "!scripts/test/unit-guard-environment.ts",
-    "!scripts/test/unit-projects.ts",
-    "!scripts/test/untested-sources.ts",
-    "!scripts/test/vitest-include-globs.ts",
-    "!scripts/build/shim-shell.ts",
-    "!scripts/claude/skill-meta.ts",
-    "!scripts/exports/member-usage.ts",
-    "!scripts/exports/namespace-escape.ts",
-    "!scripts/exports/namespace-members.ts",
-    "!scripts/exports/unused-members.ts",
-    "!scripts/document/generate-catalog.ts",
-    "!scripts/document/issue-citation-budget.ts",
-    "!scripts/document/retired-phrases.ts",
-    "!scripts/document/review-agent-type.ts",
-    "!scripts/document/single-source.ts",
-    "!scripts/hooks/hook-bundle-ready.ts",
-    "!scripts/hooks/prompt-hooks.ts",
-    "!scripts/josh/josh-script-reader.ts",
-    "!scripts/package/engine-range.ts",
-    "!scripts/package/production-dependency-graph.ts",
-    "!scripts/rules/delivered-rules-harness.ts",
-    "!scripts/rules/top-level-scripts-guard.ts"
+    "!dist/hooks/.inputs-verified.json*",
+    "!dist/.hooks-staging-*"
   ],
   "imports": {
     "#eslint/*": "./eslint/*",
     "#scripts/*": "./scripts/*.ts",
+    "#tools/*": "./tools/*.ts",
     "#playwright-config": "./playwright.config.ts",
     "#ports": "./ports/index.js",
     "#ports/*": "./ports/*.ts"
@@ -247,14 +209,14 @@
     "@eslint/compat": "^2.1.1",
     "@eslint/js": "^10.0.1",
     "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
-    "@playwright/test": "^1.64.0",
+    "@playwright/test": "^1.64.1",
     "@secretlint/secretlint-rule-preset-recommend": "^13.0.7",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/node": "^26.6.5",
     "@types/semver": "^7.8.0",
-    "cspell": "^10.3.6",
+    "cspell": "^10.4.0",
     "esbuild": "^0.28.2",
-    "eslint": "^10.12.0",
+    "eslint": "^10.13.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.5",
     "eslint-plugin-import-x": "^4.17.1",
@@ -262,35 +224,37 @@
     "eslint-plugin-sonarjs": "^4.2.2",
     "eslint-plugin-unicorn": "^78.0.0",
     "eslint_d": "^15.0.3",
+    "fast-check": "^4.10.2",
     "globals": "^17.13.0",
-    "lefthook": "^2.2.1",
+    "lefthook": "^2.2.2",
     "prettier": "^3.9.10",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",
-    "rollup": "^4.64.5",
+    "rollup": "^4.64.7",
     "rollup-plugin-dts": "^6.5.1",
     "secretlint": "^13.0.7",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.71.1",
-    "vitest": "^5.0.3"
+    "typescript-eslint": "^8.71.2",
+    "vitest": "^5.0.5"
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
     "csv-parse": "^7.0.3",
-    "execa": "^10.1.0",
-    "js-yaml": "^5.4.3",
+    "execa": "^10.1.1",
+    "flatted": "^3.4.4",
+    "js-yaml": "^5.5.0",
     "jsonc-parser": "^3.3.1",
     "ora": "^9.4.1",
     "semver": "^7.8.5",
     "string-width": "^8.3.0",
     "terminal-link": "^5.0.0",
     "tsx": "^4.23.15",
-    "zod": "^4.6.6"
+    "zod": "^4.6.7"
   },
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.12.1+sha512.b7f98934c0b1f29a65f5da52f2d7f994e7faad573ffdddea1497fb4dcb5aec051590ee7c7d95a38172b4bfae103a5b83edf2ee866e11731c2cafa96063610ac5",
+      "version": "12.14.0+sha512.c18ba6d87993d3d164cb5e8948f32b2c06ee854487e06cd8d86781342fb3e5bb4634367034711e86802baa9c37bea906ce1929ad08d70884c97d801df13389a6",
       "onFail": "download"
     }
   },

package/pnpm-workspace.yaml

@@ -8,8 +8,10 @@ allowBuilds:
   '@joshuafolkken/kit': false # project postinstall handles lefthook install
 
 # pnpm 12 reads these settings from this file only; the same lines in .npmrc are ignored (kit #3267).
-# A release must be a day old before pnpm resolves it, and an unsatisfied `engines` fails the install.
-minimumReleaseAge: 1440
+# A release must be three days old before pnpm resolves it, and an unsatisfied `engines` fails the
+# install. `josh init` / `josh sync` mirror the window to `.aikido` and to Dependabot's `cooldown`
+# (kit #4023): an upstream hijack can take days to come to light, so one day is not enough.
+minimumReleaseAge: 4320
 engineStrict: true
 
 # Skip the install-time supply-chain re-verification of the already-committed, reviewed lockfile.

package/prompts/coding-standards.md

@@ -1,6 +1,6 @@
 # コーディング指針 — lint では表せない書き方
 
-関数の構文・品質上限・型安全・早期 return・マジックナンバーは `CLAUDE.md` → "Critical Conventions (non-standard — always apply)"、lint・型検査の実行は `CLAUDE.md` → "Code Change Rules"（`pnpm josh gate`、実装中は `pnpm josh lint:related` / `pnpm josh test:related`）に従う。ここにない命名の細目（クラスのプロパティ・メソッドの `snake_case` など）は `eslint/rules/naming-convention.js` が持つ。**`function` 構文（アロー関数を使わない）と早期 return の 1 行形式は lint が検査しない**ので、書き手とレビューが確かめる。
+関数の構文・品質上限・型安全・早期 return・マジックナンバーは `CLAUDE.md` → "Critical Conventions (non-standard — always apply)"、lint・型検査の実行は `CLAUDE.md` → "Code Change Rules"（`pnpm josh gate`、実装中は `pnpm josh lint:related` / `pnpm josh test:related`）に従う。ここにない命名の細目（クラスのプロパティ・メソッドの `snake_case` など）は `eslint/rules/naming-convention.js` が持つ。`function` 構文と早期 return の 1 行形式は lint が検査する。
 
 ## Conventions
 

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

@@ -1,8 +1,6 @@
 ## ファイル編集はコマンド本文に本文を載せない
 
-`CLAUDE.md` からは [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」を経て届く。
-
-`pnpm josh rule:guard`（file-body の行）が、既存ファイルを書き戻すヒアドキュメント・書き込むインタプリタ heredoc / `node -e`・書き込むスクリプトを作るヒアドキュメント・`perl -0pi -e` を拒否する。ガードに見えない Edit / Write の全文書き直しと `sed -i` は以下に従う。
+`pnpm josh rule:list` の `file-body` 行が、既存ファイルを書き戻すヒアドキュメント・書き込むインタプリタ heredoc / `node -e`・書き込むスクリプトを作るヒアドキュメント・`perl -0pi -e` を拒否する。ガードに見えない Edit / Write の全文書き直しと `sed -i` は以下に従う。
 
 ### 何を禁じているか
 
@@ -32,8 +30,6 @@ PY
 - ファイル全体の作り直し — 変更後の本文が元とほとんど共有しない場合
 - 部分編集のほうが大きくなる場合 — `old_string` / `new_string` の合計が全文を超えるとき（このときも Write で書く）
 
-実測は `docs/maintainers/file-edits-rationale.md` → "Measured cost of whole-file rewrites"（joshuafolkken/kit#1260）。
-
 ### `sed -i` を使う前に満たす 4 条件
 
 `sed` は一致した全行を書き換え、一致 0 件でも黙って成功する。使う前に次を満たす。
@@ -54,7 +50,3 @@ PY
 | `cat > new-file <<'EOF'`（新規、長文なら Write） | 可                  |
 | `cat > edit.py <<'EOF'`（書き込むスクリプト）    | 不可                |
 | 読み取り（`cat` / `sed -n` / `grep`）            | 可                  |
-
-### なぜコストが二重になるか
-
-書き戻す形は本文がコマンドとファイルの両方に載り、コマンドは以降の全リクエストで読み直される。内訳は `docs/maintainers/file-edits-rationale.md` → "Measured breakdown of command text"、常駐の根拠は `docs/maintainers/file-edits-rationale.md` → "Why it is resident"、固定内容は `docs/maintainers/file-edits-rationale.md` → "Marker tests"。

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

@@ -23,8 +23,7 @@
   読み手がそのまま打つ書き方
 - 引用の形（そのままでよい）— 「`gh issue create` は使わない」のような禁止の引用や、CLI の対応状況の記録
 
-文書ガードはフェンス付きコードブロックだけを走査するので、散文は書き手がこの区別で守る
-（`docs/maintainers/gh-rest-rationale.md` → "Why the document guard scans fences only"）。
+文書ガードはフェンス付きコードブロックだけを走査するので、散文は書き手がこの区別で守る。
 
 書き換えるときは先に `pnpm josh` のコマンドで置き換えられないかを見る（例: `gh issue view` ではなく
 `pnpm josh issue:state <N>`）。

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

@@ -2,8 +2,6 @@
 
 ## セッション向け出力で Issue はリンク＋セッション言語の短い要約で参照する（joshuafolkken/kit#1758）
 
-理由は `docs/maintainers/issue-citation-rationale.md` → "Why the rule exists"、発火点の常駐理由は `docs/maintainers/issue-citation-rationale.md` → "Why the trigger is resident in CLAUDE.md"。
-
 **規則**: セッション向け出力で Issue を指すときは、次の 2 つを必ず添える（対応前の「これから走らせる」「待機中」「対象外」の言及も含む）。
 
 1. 番号にチケットへの markdown リンク
@@ -11,7 +9,7 @@
 
 - `[#<N>](https://github.com/<owner>/<repo>/issues/<N>) — <その Issue が何をするものかの短い要約>`
 
-**この引用行は `pnpm josh issue:cite <N> [<N> ...]` が出す。** 複数 Issue は 1 呼び出しにまとめ、他リポジトリは `--repo <owner/repo>` か `owner/repo#N` 表記（`docs/maintainers/issue-citation-rationale.md` → "Why issue:cite prints the line"、詳細は [docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh issue:cite`）。タイトルは必要ならセッション言語に言い換える。素の `#N` の行（コミットメッセージ・PR 本文・イベント行・Telegram 本文）を写すときは引用形に直す（`docs/maintainers/issue-citation-rationale.md` → "Why josh prints the citation form itself"）。
+**この引用行は `pnpm josh issue:cite <N> [<N> ...]` が出す。** 複数 Issue は 1 呼び出しにまとめ、他リポジトリは `--repo <owner/repo>` か `owner/repo#N` 表記（詳細は [docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh issue:cite`）。タイトルは必要ならセッション言語に言い換える。素の `#N` の行（コミットメッセージ・PR 本文・イベント行・Telegram 本文）を写すときは引用形に直す。
 
 ### 適用範囲
 
@@ -25,4 +23,4 @@
 
 ### 停止時の担保（joshuafolkken/kit#2247）
 
-`Stop` フック `pnpm josh stop:guard` は返信の地の文に裸の `#N` があると停止をブロックし、`pnpm josh issue:cite <N...>` の実行形を差し戻す。差し戻されたらその実行形で引用し直す（`docs/maintainers/issue-citation-rationale.md` → "How the Stop hook delivers it"、検出が外す範囲は [docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh stop:guard`）。
+裸の `#N` は `pnpm josh stop:guard` が引用行にする。差し戻されたら、その実行形で引用し直す（[docs/josh-commands.md](https://github.com/joshuafolkken/kit/blob/main/docs/josh-commands.md) の `josh stop:guard`）。

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

@@ -1,12 +1,14 @@
 ## Step 1: Issue 作成テンプレ
 
-タイトルは簡潔で明瞭な英語にする（「出力の言語（`JOSH_SESSION_LANG`）」の例外）。日本語や改善できるタイトルは実装開始前に `gh api -X PATCH repos/{owner}/{repo}/issues/<N> -f title="<title>"` で書き換える。本文は次のテンプレートの節をすべて含める:
+タイトルは簡潔で明瞭な英語にする（「出力の言語（`JOSH_SESSION_LANG`）」の例外）。日本語や改善できるタイトルは実装開始前に `pnpm josh issue:plan <N> --body-file <path> --title "<title>"` で計画と一緒に書き換える。本文は次のテンプレートの節をすべて含める:
 
 ````md
 ## 背景
 
 <不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
+<不具合なら `- 原因: #<PR>`、追えなければ `- 原因: 不明（<理由>）` を宣言する>
 <人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
+<任意。`- 優先度: 緊急（条件 <1-3> / 短縮 <値>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ通常>
 
 <なぜ必要か>
 
@@ -43,6 +45,16 @@
 <実際の出力>
 ```
 
+## 期待効果
+
+<`- 目的: 時間短縮` のみ。出典はコマンドと値>
+
+- 効く率: <値>
+- 1 回あたりの得: <値>
+- 外れたときの損: <値>
+- 出典: <`pnpm josh lane:stats` → 値>
+- 1 マージあたりの短縮: <分>（レーン中央値 <分> の <%>）
+
 ## Origin
 
 <別リポジトリのセッションから起票した場合のみ。起票元 Issue を `owner/repo#N` 形式で書く。自リポジトリ発の Issue では節ごと省略する>
@@ -50,16 +62,32 @@
 
 ### `## 背景` 直下の宣言と分類ラベル
 
-起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n>` で行い、本文の検査（`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 自身の検証の不具合なら `run:solo`）も付ける — 無ければ `issue:file` が拒否する。
-
-| 宣言                   | 付くラベル                        | 選ぶ基準                                                   |
-| ---------------------- | --------------------------------- | ---------------------------------------------------------- |
-| `- 種別: 不具合`       | `bug`                             | 報告された症状を直す（無ければ `- 種別: 非不具合`）        |
-| `- 目的: 機能追加`     | `enhancement`                     | 新しい機能。修正・文書・依存更新・保守には書かない         |
-| `- 目的: 機能改善`     | `enhancement`                     | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから |
-| `- 互換性: 破壊的変更` | `breaking-change`                 | 契約を変える。移行措置があっても書き、廃止対象と影響を書く |
-| `- 種別: 振る舞い変更` | なし                              | AI の振る舞いを変える。下の 3 見出しが必須                 |
-| `- 人の判断: 不要`     | `auto-ok`（除外ラベルが無ければ） | 方針の判断・外部アカウント・目視確認のどれも要らない       |
+起票は `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`）。追跡計測には使わない |
+| `- 優先度: 緊急（…）`                         | `priority:critical`               | 下の A か B。条件番号か短縮値を括弧に書く                                             |
+| `- 優先度: 高（…）`                           | `priority:high`                   | 下の C・D・E のどれか。根拠を括弧に書く                                               |
+| `- 優先度: 通常`                              | なし                              | どれにも当たらない（宣言が無いときも同じ）                                            |
+
+優先度の基準（`scripts/issue/issue-priority.ts`）。`kickoff new critical` / `high` と打った優先度があれば本文は判定しない:
+
+- A. 割り込み起票の 3 条件のどれか（`wip-cap.md` →「3 条件 — 該当するかは判断ではない」）
+- B. 1 マージあたりの短縮がレーン中央値の 10% 以上
+- C. 同じく 3% 以上 10% 未満
+- D. 人が示した期限や方針がある
+- E. ほかの open Issue 2 件以上の前提（blocked-by）になっている
+- 短縮は `効く率 × 1 回あたりの得 × 1 マージあたりの回数`、中央値は `pnpm josh lane:stats` の `lane median` 列。`- 目的: 時間短縮` の Issue は `- 1 マージあたりの短縮:` 行に % を書く。`issue:file` は行が無いか % が無ければ拒否し、その % から下限（B なら緊急、C なら高）を出して、それより低い宣言も拒否する
+- 根拠の無い `緊急` / `高` も `issue:file` が拒否する
 
 - **持ち主の意図と違う動きは、コード・コメント・テストに書かれた設計どおりでも `- 種別: 不具合` とする。** 例: コメントとテストに固定されたまま意図より広く働く自動付与、文書だけでも意図と違う分類を生む基準
 - `- 種別: 不具合` の回帰テストは、利用者が症状を見たのと同じ粒度で書く。修正前のツリーでも緑になるテストは `pnpm josh git -y` が拒否する（joshuafolkken/kit#2448）
@@ -90,9 +118,8 @@
 
 `josh` が使えない環境での手作業手順:
 
-1. 子 Issue をすべて起票し、番号を控える。
-2. ラベルを用意する: `gh api repos/{owner}/{repo}/labels -f name=epic -f color=5319e7 -f description="Tracks a batch of child issues from one split" --silent 2>/dev/null || true`
-3. 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.` と書く）:
+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
@@ -113,6 +140,4 @@
    - [ ] #102 <title>
    ```
 
-4. 順序があるときだけ、別ステップで依存を足す（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)"`
-
-各手順の理由は kit の `docs/maintainers/epic-commands-rationale.md` →「Creating an epic by hand」。
+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)"`

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

@@ -0,0 +1,34 @@
+# Lane session instructions
+
+headless のレーン子とレビューセッションは、`CLAUDE.md` を読み込まずにこの文書を起動引数で受け取る（`scripts/agent/lane-instructions.ts`）。`include` 行は起動時に `CLAUDE.md` の節・項目へ置き換わるので、規則の単一ソースは `CLAUDE.md` のまま。
+
+- 起動プロンプトがそのまま明示の起動。応答する人はいないので、確認は求めない。
+- `CLAUDE.md` を開き直さない。ここに無い規則は、対話セッションでしか効かない。
+- 下の `pnpm josh gate` は、レーン子では `josh ship` が回す（`.claude/skills/workflow-commands/chain-rule.md` → "Run the review-to-merge chain" step 0）。
+
+## Communication
+
+<!-- include: CLAUDE.md → "Fix root causes, not symptoms." -->
+<!-- include: CLAUDE.md → "Cross-package problems" -->
+<!-- include: CLAUDE.md → "Third-party repositories are Tier C." -->
+<!-- include: CLAUDE.md → "No clones" -->
+<!-- include: CLAUDE.md → "Design for elegance and simplicity first." -->
+<!-- include: CLAUDE.md → "Write concise prose" -->
+<!-- include: CLAUDE.md → "Route distributed-doc / config changes upstream to kit." -->
+<!-- include: CLAUDE.md → "Latest-first" -->
+<!-- include: CLAUDE.md → "Output language follows" -->
+<!-- include: CLAUDE.md → "Hook-delivered rules" -->
+
+<!-- include: CLAUDE.md → "Decision autonomy" -->
+
+<!-- include: CLAUDE.md → "Critical Conventions" -->
+
+<!-- include: CLAUDE.md → "Package-First Development" -->
+
+<!-- include: CLAUDE.md → "Code Change Rules" -->
+
+<!-- include: CLAUDE.md → "Completion gate" -->
+
+<!-- include: CLAUDE.md → "Pre-commit Self-Review" -->
+
+<!-- include: CLAUDE.md → "Git Rules" -->

package/prompts/collaboration-workflow/measurement.md

@@ -0,0 +1,37 @@
+# 所要時間は記録から測る
+
+**CI と gate の所要時間は記録から読む。計測のために全ツリーのツールを手元で再実行しない。**
+
+再実行はコア予算の外で走り、並走する lane と重なる。`timed-rerun` 行（`rule-delivery.md`）が配送する。
+
+## 記録の読み方
+
+- CI のジョブとステップ: Actions の記録を読む。
+
+  ```bash
+  gh api --method GET "repos/<owner>/<repo>/actions/runs?branch=<branch>&per_page=5" --jq '.workflow_runs[] | [.id, .name, .conclusion, .run_started_at, .updated_at] | @tsv'
+  gh api --method GET "repos/<owner>/<repo>/actions/runs/<run_id>/jobs?per_page=100" --jq '.jobs[] | [.name, .started_at, .completed_at] | @tsv'
+  gh api --method GET "repos/<owner>/<repo>/actions/runs/<run_id>/jobs?per_page=100" --jq '.jobs[] | select(.name == "<job>") | .steps[] | [.name, .started_at, .completed_at] | @tsv'
+  ```
+
+- 手元の gate とチェックごとの所要時間: `pnpm josh lane:stats --period <days>`（gate の記録、`docs/josh-commands-run.md`）。
+
+## 効果を測る後続 Issue
+
+PR の効果を測る後続 Issue を起票するとき:
+
+- 開始条件は日数でなく標本数で書く: `## 背景` に `- 実施可能条件: #<PR> のマージ後 <K> マージ`（`issue-template.md`）。`#<PR>` は元の PR の番号で、Issue の番号は `issue:file` が refuse する。
+- K は測る値の種類で決める:
+  - 事象の回数の率（停止・再利用など）: 変更前の率で 10 件以上見込める最小のマージ数（K ≥ 10 ÷ 変更前の率）。変更前の標本数を上限の目安にする。
+  - 連続値の平均・差（所要時間など）: 5〜10。
+  - 最大値・裾: 変更前の標本数と同程度。
+- 受け入れ条件の集計は固定日数でなく `pnpm josh lane:stats --period <days>` とし、`<days>` は元 PR のマージからの経過日数（小数可）にする。
+
+計測を記録し終えた → `pnpm josh issue:measured <N> --evidence-file <path>`。`.claude/skills/workflow-commands/issue-comments.md` →「A measurement-only Issue」。
+
+## 手元で再実行してよいとき
+
+記録で答えられない問い（記録の無い変更前後の比較など）に限る。
+
+- 1 回だけ実行する。lane 子は `pnpm josh reserved-run <weight> -- <command>` で包み、コア予算に数えさせる。ESLint は `--concurrency off` で走らせ、並列度の計測はレーン外で行う（`lane-direct-tool`）。
+- 結果を Issue のコメントに残し、以後はそれを使い回す。

package/prompts/collaboration-workflow/operating-rules.md

@@ -2,7 +2,6 @@
 
 - 通知は CI チェック成功後に投稿する
 - 通知投稿に失敗しても、実装完了の事実をログで確認できるようにする
-- 自動投稿する Issue コメントは `JOSH_SESSION_LANG` の言語（未設定なら `ja`）で書く。Issue タイトルだけは英語
 
 ### CI チェック失敗時の対応
 
@@ -12,10 +11,6 @@
 - 修正できたら修正内容を、できなかったら失敗チェック名・原因・未解決である旨を `--notify-message` に書く。**完了コメントに失敗を隠してはならない**
 - ユーザーへの報告でも失敗を「成功」として扱わない
 
-### ほかの単一ソースにある規則
-
-auto-merge と `completion` 通知・明示的な起動・`confirmation` 通知・作業ツリーの保持・overrides の保護の置き場は `docs/maintainers/operating-rules-rationale.md` → "Rules that moved to their single source"。
-
 ### 指示されていない行動は取らない
 
 `CLAUDE.md` → "Git Rules" の細則。対象には共有ブランチへの push・外部通知の追加送信・リポジトリ設定の変更も含む。
@@ -23,12 +18,12 @@ auto-merge と `completion` 通知・明示的な起動・`confirmation` 通知
 - auto-merge の本文は [`followup.md`](../../.claude/skills/workflow-commands/followup.md)、`backlogrun` の子への継承は [`backlogrun-child.md`](../../.claude/skills/workflow-commands/backlogrun-child.md)
 - `kickoff` / `pnpm josh followup` 単独実行は文書化されたスコープで終了する。PR が OPEN のまま完了したら状態を報告して停止する
 - 「チェックが全部 green」は次へ進む承認ではない
-- **deny と配送ガードは実装であって規則ではない。** `gh pr merge`・force push・ブランチ削除は `.claude/settings.json` の `permissions.deny` と `pnpm josh rule:guard` が拒否する（一覧は [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」）が、規則より狭い。ツールが通したことを許可と読まない。`fullrun` の auto-merge は `pnpm josh followup` の内部から gh を起動するため影響を受けない
+- **deny と配送ガードは実装であって規則ではない。** `gh pr merge`・force push・ブランチ削除は `.claude/settings.json` の `permissions.deny` と `pnpm josh rule:list` の `git-force` 行が拒否する（一覧は [`rule-delivery.md`](./rule-delivery.md) →「配送されている規則」）が、規則より狭い。ツールが通したことを許可と読まない。`fullrun` の auto-merge は `pnpm josh followup` の内部から gh を起動するため影響を受けない
 - 共有状態に影響する操作（Tier C）は、迷ったら確認する。可逆な実装・設計判断（Tier A）は下記 "decision-autonomy" に従う
 
 ### no-self-staging — git index を勝手に変更しない（自律 staging の禁止）
 
-`CLAUDE.md` → "Git Rules" の細則。index には履歴がなく、上書きされたステージ状態は復元できない（`docs/maintainers/operating-rules-rationale.md` → "Why the index is the user's"）。
+`CLAUDE.md` → "Git Rules" の細則。index には履歴がなく、上書きされたステージ状態は復元できない。
 
 - **調査目的の staging はしない。** 読み取り専用コマンドを使う: `git status --short`、`git diff` / `git diff --stat` / `git diff HEAD`、`git diff --staged`、未追跡ファイルは `git diff --no-index /dev/null <new-file>` か直接読む
 - staging してよいのは次の 2 ケースだけ。それ以外は実行せずに確認する:
@@ -42,22 +37,21 @@ auto-merge と `completion` 通知・明示的な起動・`confirmation` 通知
   3. 「別パッケージ起因の問題は割り込み Issue で対応する」
   4. `backlogrun` が epic の子を始める前の preflight（`pnpm josh run:hold <N>` が `reclaim` と答えたときの回収 — joshuafolkken/kit#926, joshuafolkken/kit#1965）
 
-  1〜3 は直後に `pnpm josh stash:pop "<メッセージ>"` で復元する。stash は全 work tree が共有する 1 本のスタックなので、位置指定や引数なしの `git stash pop` は使わない（joshuafolkken/kit#2050）。4 は復元しない — 代わりに stash を子の Issue にコメントで記録する（`prerequisite.md` の stash と同じく、記録だけが後で pop させる手がかり）
+  1〜3 は直後に `pnpm josh stash:pop "<メッセージ>"` で復元する（位置指定の pop は `worktree-mutation` 行が拒否する）。4 は復元しない — 代わりに stash を子の Issue にコメントで記録する（`prerequisite.md` の stash と同じく、記録だけが後で pop させる手がかり）
 
-- **会話で作った実装をランへ渡す「引き渡し用の stash」も `pnpm josh stash:pop "<メッセージ>"` で復元する。当てたあと stash は消える**（`docs/maintainers/operating-rules-rationale.md` → "Why a handed-over stash is popped"）
+- **会話で作った実装をランへ渡す「引き渡し用の stash」も `pnpm josh stash:pop "<メッセージ>"` で復元する。当てたあと stash は消える**
   - 計画には復元手順としてこの 1 行だけを書く。`git stash apply` / `git stash pop` も「drop しない」という条件も書かない
   - 計画がガードの拒否する復元形を指していたら、実行側は `stash:pop` に読み替えて続行し、Issue コメントに残す（Tier A）。`needs-decision` では止まらない
   - stash を残すのは持ち主の判断だけ。持ち主が計画に理由を書き、ランはそこで止まって確認する
 - staging・index の書き換え・`git commit` の直接実行は deny されており、deny には「そのターンでユーザーが明示指示した」という例外がない。ケース 1 はユーザー自身の端末で実行してもらう。コミットを指示されたら `pnpm josh git` を通す
-- index を守る deny と `pnpm josh rule:guard`（`worktree-mutation`・`index-mutation`・`destructive-command`・`protected-file` 行）も実装である（→「deny と配送ガードは実装であって規則ではない」）
 
 ### decision-autonomy — 意思決定の自律ポリシー（確認停止を減らす）
 
 `CLAUDE.md` → "Decision autonomy" の境界の細則。
 
 - **A と B の判定**: 確認するのは「差が僅差 かつ 後戻りしにくい／アーキテクチャに長く影響する」ときだけ。明確に優位な選択肢は自動で選び、僅差でも安価に巻き戻せる選択は決めて記録して進む
-- 起票した Issue の所属先は、候補が複数の epic に散っていても Tier B ではない（joshuafolkken/kit#1339）。1 つを選び、採用・却下・理由・決定日を Issue と epic の両方に記録する。止まるのは 2 つが本当に甲乙つけがたいときだけ
+- 起票した Issue の所属先は、候補が複数の epic に散っていても Tier A（`.claude/skills/epic-commands/epic-bundle.md`）
 - 自己修正（自分が公開した成果物の事実誤りの訂正、同じセッションで自分が特定した自分の作業の抜けの穴埋め）は Tier A。承認済みの作業の完了・修復に限り、目標の表明や問いで動いてよい意味ではない（→ `principles.md` → "consult-vs-execute"）
 - **Tier C との境界**: マージ・ブランチ削除・force push・スコープ外の変更は、自分が招いた問題でも Tier C。確認を外しても監査証跡は外さない
 - **major のバージョン bump は Tier C**: `pnpm josh bump major` は自分の判断で実行も提案もしない。既定は minor / patch で、major はユーザーがそのターンで明示したときだけ（0.x の major は 1.0.0 になり戻せない）。`josh bump` が版を変えたら、変わった挙動の `docs/` をコミット前に更新する
-- 自動判断の記録: Issue 駆動ワークフロー内では `pnpm josh issue:comment <N> --body-file <path>` で、採用案・不採用の代替案・採用案が優位な理由を書く
+- 自動判断を記録する Issue コメントは `pnpm josh issue:comment <N> --body-file <path>` で投稿する

package/prompts/collaboration-workflow/output-bounds.md

@@ -8,7 +8,7 @@
 }
 ```
 
-**8,000 文字**（harness の既定は 30,000、最大は 150,000。根拠は `docs/maintainers/output-bounds-rationale.md` → "Why 8,000"）。効くのは Bash ツールだけで、`Read` と `Agent` の結果には効かない。
+**8,000 文字**（harness の既定は 30,000、最大は 150,000）。効くのは Bash ツールだけで、`Read` と `Agent` の結果には効かない。
 
 ## 切り詰められたときにどうするか
 
@@ -27,15 +27,10 @@
 
 ## 検証コマンドをパイプに繋がない（joshuafolkken/kit#1556）
 
-**パイプラインの終了コードは最後のコマンドのものである。** `pnpm josh gate 2>&1 | tail -40` は赤いゲートを成功として返す。**これは `josh gate` の欠陥ではない。** 直すのは呼び出し方である。
+**パイプラインの終了コードは最後のコマンドのものである。** `pnpm josh gate 2>&1 | tail -40` は赤いゲートを成功として返す。**これは `josh gate` の欠陥ではない。** **既定はパイプなしで実行する。** 避けられないなら `set -o pipefail` を前置する。どの形でも、印字された判定行を読む。`piped-verification` 行（`rule-delivery.md`）が強制する。
 
-- **既定はパイプなしで実行する。** 判定行は末尾に出るので、省略されても残る
-- 絞るなら、ファイルへ落として範囲で読む（`pnpm josh gate > /tmp/gate.log 2>&1; tail -40 /tmp/gate.log`）
-- パイプが避けられないなら `set -o pipefail` を前置する
-- どの形でも、印字された判定行を読む。終了コードだけを答えにしない
-
-対象は結果が合否を意味するコマンドだけ — `gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval`。**`git log | head` や `gh issue list | head` は対象外であり、意図的にそうしている。** `latest:scope` ／ `review:brief` も、判定ではなく答えを印字するので `$(...)` で受けてよい。`pnpm josh pretool:guard` は、後段が `tail` ／全行読みの `grep` だけの検証パイプラインを `(set -o pipefail; …)` で包み、他のパイプは拒否する（`rule-delivery.md`、`docs/maintainers/output-bounds-rationale.md` → "Why the pipe rule is delivered by a trigger"）。
+対象は結果が合否を意味するコマンドだけ — `gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval`。**`git log | head` や `gh issue list | head` は対象外であり、意図的にそうしている。** `latest:scope` ／ `review:brief` も、判定ではなく答えを印字するので `$(...)` で受けてよい。
 
 ## 検査
 
-`scripts/lib/bash-output-cap.test.ts` が、配布設定の上限がこの文書の値と一致し、既定より小さく最大を超えないことを固定する（`docs/maintainers/output-bounds-rationale.md` → "What the tests pin"）。
+`scripts/lib/bash-output-cap.test.ts` が、配布設定の上限がこの文書の値と一致し、既定より小さく最大を超えないことを固定する。

package/prompts/collaboration-workflow/overview.md

@@ -24,7 +24,7 @@
   2. コード内コメント、テストタイトル（`describe` / `it` / `expect`）、コミットメッセージ
   3. スクリプトが出力する固定文字列: Telegram のヘッダーラベル（`Planning` / `Completion` など）、`Issue:` / `PR:` の URL ラベル、`--notify-message` 省略時の既定メッセージ
 
-`JOSH_SESSION_LANG` は開発者個人の設定で、`.env`（gitignore 済み）に置く。設定値は毎ターン `UserPromptSubmit` フック（`scripts/hooks/run-hook.sh session-lang`、Codex は `.codex/hooks.json`）が差し込み、未設定なら出さない。フックが走らないハーネス（Gemini / Cursor）は `.env` を読む。既定の理由は `docs/maintainers/overview-rationale.md` → "Why the session language defaults the way it does"。
+`JOSH_SESSION_LANG` は開発者個人の設定で、`.env`（gitignore 済み）に置く。設定値は毎ターン `UserPromptSubmit` フック（`scripts/hooks/run-hook.sh session-lang`、Codex は `.codex/hooks.json`）が差し込み、未設定なら出さない。フックが走らないハーネス（Gemini / Cursor）は `.env` を読む。
 
 ### 配布ドキュメントの層ごとの言語（joshuafolkken/kit#2997）
 

package/prompts/collaboration-workflow/plan-comment.md

@@ -1,8 +1,9 @@
 ## Step 3: 計画コメントを記録して通知する
 
 1. 提案を人間が判断する
-2. 採用した計画を Issue に記録する。body が空なら計画をファイルに書き `gh api -X PATCH repos/{owner}/{repo}/issues/<N> --field body=@<path>` で書き込む（本文はパスで渡す — `shell-body.md`）。body があれば `pnpm josh issue:comment <N> --body-file <path>` でコメントする
+2. 採用した計画をファイルに書き、`pnpm josh issue:plan <N> --body-file <path>` で Issue に記録する。body が空なら本文に、空でなければコメントになる（本文はパスで渡す — `shell-body.md`）
    - 計画が stash の復元を含むときの書き方: `operating-rules.md` → "no-self-staging"
+   - 計画には `### 影響を受ける既存の利用者` が必須（`pnpm josh plan:consumers <識別子...>` が下書きを出す。書き方: `kickoff.md` の手順 4）
 3. Telegram で計画開始を通知する:
 
    ```bash
@@ -15,44 +16,4 @@
    - Issue URL を必ず含め、箇条書きの間に改行を入れる
    - `kickoff` はここで**停止**する（実装に進まない）
 
-4. 作業ツリーに変更（ステージ済みを含む）が既にあれば退避する:
-   ```bash
-   git stash push -u -m "plan: pre-existing changes"
-   ```
-5. メインブランチへ切り替えて最新を取得する:
-   ```bash
-   pnpm josh ms
-   ```
-6. `pnpm josh latest:scope` が `required` と答えたときだけ `pnpm josh latest` を実行し、`dependency-update` スキルに従う（`.claude/skills/workflow-commands/latest-gate.md`）。脆弱性への override は `pnpm-workspace.yaml` の `overrides` に書く（pnpm 11/12 は `package.json` の `pnpm.overrides` を無視する）。
-   ステップ 4 で stash したら、ここでメッセージ指定で復元する（位置指定や引数なしの `git stash pop` は使わない — joshuafolkken/kit#2050）:
-   ```bash
-   pnpm josh stash:pop "plan: pre-existing changes"
-   ```
-7. **作業サマリを提示してから**実装を開始する（`report-format.md` → "作業前サマリはいつ・どう出すか"）。Issue body が埋まっていても提示し、Issue コメントとしては投稿しない。
-8. 実装完了後、lint/test より前に `prompts/refactoring.md` に従い、高・中優先度項目が残らなくなるまでリファクタリングする
-9. 検証ゲート（`CLAUDE.md` の Completion gate）を実行する
-
-`pnpm josh git` を実行する（`-y` で確認プロンプトをスキップ）。**子はバージョンを上げない** — 版を決めるのは `pnpm josh release` だけ（joshuafolkken/kit#1486）。Issue タイトルは実行前に `issue-template.md` の Step 1 冒頭に沿って整える。
-
-```bash
-pnpm josh git -y "<issue-title> #<issue-number>"
-```
-
-### Recovery after failed push (pre-push hook blocked)
-
-If `pnpm josh git -y` fails at the push step, fix the blocking issue and recover with:
-
-```bash
-# 1. Push manually after fixing the issue
-git push --set-upstream origin <branch>
-
-# 2. Create the PR only — closes #N keyword is preserved
-pnpm josh pr
-# equivalent: pnpm josh git -y --skip-commit --skip-push
-```
-
-Do not run `gh pr create` directly — it bypasses `build_body`, which writes `closes #N`.
-
-### レビューからマージまで
-
-レビューは実装したセッションがコミットの前に `pnpm josh review:brief` で始め、`/code-review` は `Agent` ツールのサブエージェントが実行する。周回の上限、残った指摘の振り分けと `pnpm josh epic:bundle`、マージを打つターンは `.claude/skills/workflow-commands/chain-rule.md` → "Run the review-to-merge chain"、"The review runs in a subagent, never a main-line skill load"、方針は `prompts/review.md` → "Review round cap"。**`/code-review` の出力で停止しない。**
+実装からマージまでは [`fullrun-steps.md`](../../.claude/skills/workflow-commands/fullrun-steps.md) の手順に従う。