@joshuafolkken/kit 1.1514.0 → 1.2114.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/eslint/rules/comment-why-only.js

@@ -0,0 +1,108 @@
+// Enforce the comment rule of prompts/coding-standards.md → 基本方針: a comment states why, so the
+// history of how the code got here ("Previously, …", "used to …") and measured values with a unit
+// ("about 16,000 tokens", "1.9 seconds") are reported — git history and the Issue hold both. An Issue
+// citation such as `joshuafolkken/kit#5282` is allowed: it is where the why is recorded. The two
+// checks are separate rules so a repository can switch each on once its own comments are clean.
+
+// A bare "previously" often means "earlier in this run" ("a previously parked lane"); only the
+// sentence-opening "Previously," narrates the past. "is used to" describes a purpose, not a
+// history, so the look-behind skips it.
+const HISTORY_PATTERNS = [
+	/\bpreviously,/iu,
+	/\bformerly\b/iu,
+	/(?<!\b(?:is|are|be|been|being|was|were|get|gets|got|getting|only|also|not|just) )\bused to\b/iu,
+	/以前は/u,
+]
+
+// A sentence opening with "Used to" describes a purpose too, so that opening is cut off before the
+// history check. A sentence opens at a line start (after a block comment's `*`) or after `.`, `!`,
+// `?` or `:`; the capital `U` keeps a lowercase "used to" that wraps onto the next line of a
+// sentence a history.
+const SENTENCE_BOUNDARY = /(?<=[.!?:\n])/u
+const OPENING_PURPOSE_PATTERN = /^[\s*]*Used to\b/u
+
+// A number with a time, size or token unit, `12k tokens` and `10-second` included. The look-behind
+// keeps `#1234` and the tail of a longer number or identifier from matching. A bare `s` is left out:
+// it would read `1990s` and `502s` as durations.
+const MEASUREMENT_PATTERNS = [
+	/(?<![#\w.,])\d[\d.,]*[\s-]?(?:ms|secs?|mins?)(?!\w)/u,
+	/(?<![#\w.,])\d[\d.,]*[\s-]?(?:seconds?|minutes?|hours?)(?!\w)/u,
+	/(?<![#\w.,])\d[\d.,]*[\s-]?(?:[KMG]i?B|kB|bytes?)(?!\w)/u,
+	/(?<![#\w.,])\d[\d.,]*[kKM]?[\s-]?tokens?(?!\w)/u,
+]
+
+/**
+ * @param {string} sentence
+ * @returns {boolean}
+ */
+function sentence_has_history(sentence) {
+	const opening = OPENING_PURPOSE_PATTERN.exec(sentence)
+	const rest = opening ? sentence.slice(opening[0].length) : sentence
+
+	return HISTORY_PATTERNS.some((pattern) => pattern.test(rest))
+}
+
+/**
+ * @param {string} text
+ * @returns {boolean}
+ */
+function has_history(text) {
+	return text.split(SENTENCE_BOUNDARY).some((sentence) => sentence_has_history(sentence))
+}
+
+/**
+ * @param {string} text
+ * @returns {boolean}
+ */
+function has_measurement(text) {
+	return MEASUREMENT_PATTERNS.some((pattern) => pattern.test(text))
+}
+
+/**
+ * @param {(text: string) => boolean} is_violation
+ * @param {string} message_id
+ * @param {string} message
+ * @returns {import('eslint').Rule.RuleModule}
+ */
+function comment_rule(is_violation, message_id, message) {
+	return {
+		meta: {
+			type: 'suggestion',
+			docs: { description: message },
+			messages: { [message_id]: message },
+			schema: [],
+		},
+		create(context) {
+			return {
+				Program() {
+					for (const comment of context.sourceCode.getAllComments()) {
+						if (!is_violation(comment.value)) continue
+						context.report({ loc: comment.loc, messageId: message_id })
+					}
+				},
+			}
+		},
+	}
+}
+
+const no_history_comment_rule = comment_rule(
+	has_history,
+	'history',
+	'Drop the history from this comment ("Previously, …", "used to …"); state why the code is as it is now. git history and the Issue keep the past (prompts/coding-standards.md → 基本方針).',
+)
+
+const no_measurement_comment_rule = comment_rule(
+	has_measurement,
+	'measurement',
+	'Drop the measured value from this comment (a number with a time, size or token unit); cite the Issue that recorded it instead (prompts/coding-standards.md → 基本方針).',
+)
+
+// The plugin wrapper a flat config merges into its `kit` namespace.
+const comment_why_only_plugin = {
+	rules: {
+		'no-history-comment': no_history_comment_rule,
+		'no-measurement-comment': no_measurement_comment_rule,
+	},
+}
+
+export { comment_why_only_plugin }

package/lefthook/base.yml

@@ -118,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,14 +1,17 @@
 {
-  "version": "1.1514.0",
+  "version": "1.2114.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",
+  "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": [
     "ai",
+    "automation",
+    "backlogrun",
     "claude-code",
     "cli",
     "codex",
     "developer-tools",
     "eslint",
+    "github-issues",
     "prettier",
     "toolkit",
     "workflow"
@@ -57,63 +60,25 @@
     ".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/cost-audit",
-    "!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/generate-command-usage.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-*",
+    "!dist/.commands-test-*",
+    "!dist/.dispatch-test-*"
   ],
   "imports": {
     "#eslint/*": "./eslint/*",
     "#scripts/*": "./scripts/*.ts",
+    "#tools/*": "./tools/*.ts",
     "#playwright-config": "./playwright.config.ts",
     "#ports": "./ports/index.js",
     "#ports/*": "./ports/*.ts"
@@ -180,7 +145,7 @@
     "eslint-plugin-import-x": "^4.17.1",
     "eslint-plugin-promise": "^7.3.0",
     "eslint-plugin-sonarjs": "^4.2.1",
-    "eslint-plugin-unicorn": "^78.0.0",
+    "eslint-plugin-unicorn": "^79.0.0",
     "globals": "^17.12.0",
     "prettier": "^3.9.9",
     "prettier-plugin-svelte": "^4.1.1",
@@ -253,36 +218,40 @@
     "@secretlint/secretlint-rule-preset-recommend": "^13.0.7",
     "@stylistic/eslint-plugin": "^5.10.0",
     "@types/node": "^26.6.5",
+    "@types/run-parallel": "^1.1.2",
     "@types/semver": "^7.8.0",
     "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",
     "eslint-plugin-promise": "^7.3.0",
     "eslint-plugin-sonarjs": "^4.2.2",
-    "eslint-plugin-unicorn": "^78.0.0",
+    "eslint-plugin-unicorn": "^79.0.0",
     "eslint_d": "^15.0.3",
+    "fast-check": "^4.10.2",
     "globals": "^17.13.0",
     "lefthook": "^2.2.2",
     "prettier": "^3.9.10",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",
-    "rollup": "^4.64.7",
+    "rollup": "^4.64.12",
     "rollup-plugin-dts": "^6.5.1",
     "secretlint": "^13.0.7",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.71.2",
-    "vitest": "^5.0.4"
+    "typescript-eslint": "^8.72.0",
+    "vitest": "^5.0.5"
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
     "csv-parse": "^7.0.3",
-    "execa": "^10.1.1",
-    "js-yaml": "^5.4.3",
+    "execa": "^10.2.0",
+    "flatted": "^3.4.4",
+    "js-yaml": "^5.5.0",
     "jsonc-parser": "^3.3.1",
     "ora": "^9.4.1",
+    "run-parallel": "^1.2.0",
     "semver": "^7.8.5",
     "string-width": "^8.3.0",
     "terminal-link": "^5.0.0",
@@ -292,7 +261,7 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.13.0+sha512.1e55719bf26e809dce5c5084fdebaa64efb3da9038ae5d68a9f8a68311f1a45841c8c3b76a37298c3b66f6bcc80409a9b7f33c78a7168a3e90fb65a5d8235ae4",
+      "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
 
@@ -12,7 +12,7 @@
 ## 📝 基本方針
 
 - **意図が不明瞭な処理は関数に抽出する**: 1 行でも抽出し、関数名で意図を表す（`if (is_eligible_for_service(user))`）
-- **コメントは「なぜ」だけ**: 一行の理由だけを残す。「以前は…」の経緯・Issue 番号・計測値は書かない（git 履歴と Issue が持つ）
+- **コメントは「なぜ」だけ**: 一行の理由だけを残す。Issue の引用は「なぜ」の出典として書いてよい。「以前は…」の経緯と単位付きの計測値は書かない（git 履歴と Issue が持つ。`eslint/rules/comment-why-only.js`）
 - **文字列も定数化する**: 繰り返す文字列や識別子にも意味の分かる名前の定数を付ける
 - **既存のコード体系に寄り添う**: そのうえで、より良く書けるなら目指す
 - **仕組みを足す前に原因を問う**: `prompts/collaboration-workflow/principles.md` → "elegant-design"。重複の撲滅は "no-clones"

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,9 +30,11 @@ PY
 - ファイル全体の作り直し — 変更後の本文が元とほとんど共有しない場合
 - 部分編集のほうが大きくなる場合 — `old_string` / `new_string` の合計が全文を超えるとき（このときも Write で書く）
 
+既存ファイルへの Write が元の行の過半を残すかは `file-rewrite` ガードが数えて拒否する。
+
 ### `sed -i` を使う前に満たす 4 条件
 
-`sed` は一致した全行を書き換え、一致 0 件でも黙って成功する。使う前に次を満たす。
+`sed` は一致した全行を書き換え、一致 0 件でも黙って成功する。使う前に次を満たす。条件 1・2 は `sed-in-place` ガードが判定して拒否する。
 
 1. **出現回数を先に数える** — `grep -o '<pattern>' <file> | wc -l` が `1` であること。`grep -c` は行数を数えるので使わない
 2. **メタ文字を持ち込まない — パターン側と置換語側の両方** — `/`、`&`、`\`、`.` `*` `[` `]` `^` `$` のいずれかが入るなら Edit を使う
@@ -43,16 +43,13 @@ PY
 
 **4 条件のどれかが面倒に見えたら、そこが Edit を使う場所である。**
 
-| 形                                               | 可否                |
-| ------------------------------------------------ | ------------------- |
-| Edit（数行の old / new）                         | 可                  |
-| `sed -i` の短い置換                              | 上の 4 条件つきで可 |
-| `python3 - <<'PY'` で書き戻す                    | 不可                |
-| `cat > file <<'EOF'`（既存ファイル）             | 不可                |
-| `cat > new-file <<'EOF'`（新規、長文なら Write） | 可                  |
-| `cat > edit.py <<'EOF'`（書き込むスクリプト）    | 不可                |
-| 読み取り（`cat` / `sed -n` / `grep`）            | 可                  |
-
-### なぜコストが二重になるか
-
-書き戻す形は本文がコマンドとファイルの両方に載り、コマンドは以降の全リクエストで読み直される。
+| 形                                                      | 可否                    |
+| ------------------------------------------------------- | ----------------------- |
+| Edit（数行の old / new）                                | 可                      |
+| `sed -i` の短い置換                                     | 上の 4 条件つきで可     |
+| 同じ識別子・import 指定子の置換が複数ファイルにまたがる | `pnpm josh rename` で可 |
+| `python3 - <<'PY'` で書き戻す                           | 不可                    |
+| `cat > file <<'EOF'`（既存ファイル）                    | 不可                    |
+| `cat > new-file <<'EOF'`（新規、長文なら Write）        | 可                      |
+| `cat > edit.py <<'EOF'`（書き込むスクリプト）           | 不可                    |
+| 読み取り（`cat` / `sed -n` / `grep`）                   | 可                      |

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

@@ -20,7 +20,3 @@
 ### 英語固定の 3 つとは衝突しない
 
 要約はタイトルではなくセッション内の散文なので、`overview.md` →「出力の言語（`JOSH_SESSION_LANG`）」の英語固定とは矛盾しない。
-
-### 停止時の担保（joshuafolkken/kit#2247）
-
-`Stop` フック `pnpm josh stop:guard` は返信の地の文に裸の `#N` があると、`issue:cite` と同じ処理で引用行を作り `systemMessage` として表示する（モデルの手番は使わない）。引用できない番号があったときだけ停止をブロックし、`pnpm josh issue:cite <N...>` の実行形を差し戻す。差し戻されたらその実行形で引用し直す（検出が外す範囲は [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,20 @@
 ## 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>`、追えなければ `- 原因: 不明（<理由>）` を宣言する>
 <人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
+<レーンを延ばした原因なら `- 原因のレーン: <分> 分（#<N>）` を宣言する。分は `pnpm josh lane:net <N>`>
+<そのうちこの Issue の原因で縮められる分は `- 原因の損失: <分> 分` で宣言する。再発のたびに 1 行足す>
+<セキュリティの指摘なら `- セキュリティ: <迂回される gate・ガード・権限>` を宣言する>
+<Issue を park させた、またはランを止めた run 機構の不具合なら `- 原因の park: #<N>` を宣言する>
+<任意。`- 優先度: 緊急（条件 <1-3>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ下限か通常>
+<差分の見積もりを `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` で宣言する>
+<見積もりが分割の目安を超えても 1 件にするなら `- 分割しない理由: <理由>` を宣言する>
 
 <なぜ必要か>
 
@@ -25,7 +33,7 @@
 
 ## 発火点
 
-<AI の振る舞いを変える Issue のみ。その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つだけ書く（例 `Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`）>
+<AI の振る舞いを変える Issue のみ。その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つだけ書く（例 `Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`、回答を判定する規則は `Stop`）>
 
 ## ベースライン
 
@@ -35,7 +43,7 @@
 
 ## 再現
 
-<AI の振る舞いを変える Issue のみ。「コマンド + 実際の出力」で書き、出力はフェンス（``` または ~~~）で囲む>
+<AI の振る舞いを変える Issue、および `- 原因: 不明（<理由>）` の不具合のみ。「コマンド + 実際の出力」で書き、出力はフェンス（``` または ~~~）で囲む>
 
 - `<再現コマンド>`
 
@@ -59,23 +67,52 @@
 
 ### `## 背景` 直下の宣言と分類ラベル
 
-起票は `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`                     | 既存機能の改善。目的が曖昧なら受け入れ条件を具体化してから |
-| `- 目的: 時間短縮`     | `enhancement`                     | 所要時間を短くする。`## 期待効果` の 4 行が必須            |
-| `- 互換性: 破壊的変更` | `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`）。追跡計測には使わない                 |
+| ``- 計測宣言: `<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"）                   |
+
+集計・計測（`計測` / `before` / `変更前後`）を Issue コメントに記録する受け入れ条件と実装の見積もりを併せ持つ本文 → 集計・計測を `--route split` の先行 Issue に分け、そのコメントを `## 背景` に引く（`issue:lint` が拒否する。`scripts/issue/aggregation-split.ts`）。
+
+優先度の基準（`scripts/issue/issue-priority.ts`）。`kickoff new critical` / `high` と打った優先度があれば本文は判定しない:
+
+- A. 割り込み起票の 3 条件のどれか（`wip-cap.md` →「3 条件 — 該当するかは判断ではない」）
+- D. 人が示した期限や方針がある
+- E. ほかの open Issue 2 件以上の前提（blocked-by）になっている
+- 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` が出す（`scripts/issue/issue-priority.ts`）
+- `- 目的: 時間短縮` の Issue は `## 期待効果` の 4 行を書く。短縮の % は求めず、% による拒否も下限も無い
+- 根拠の無い `緊急` / `高` も `issue:file` が拒否する
 
 - **持ち主の意図と違う動きは、コード・コメント・テストに書かれた設計どおりでも `- 種別: 不具合` とする。** 例: コメントとテストに固定されたまま意図より広く働く自動付与、文書だけでも意図と違う分類を生む基準
 - `- 種別: 不具合` の回帰テストは、利用者が症状を見たのと同じ粒度で書く。修正前のツリーでも緑になるテストは `pnpm josh git -y` が拒否する（joshuafolkken/kit#2448）
 - `bugfix`（PR のリリース分類）を Issue の `bug` の代わりにしない。`enhancement` と `breaking-change` の両方を持つ Issue の PR は `breaking-change` にする
 - `## 発火点` の名前は `prompts/collaboration-workflow/rule-delivery.md` の配送表と突き合わされる
 - `## ベースライン` の測定コマンドは、マージ後に `pnpm josh measure:rerun <N>` が再実行して before / after を印字する（作者が `OWNER` / `MEMBER` / `COLLABORATOR` の Issue に限る）
+- `- 計測宣言:` は `backlog:drive` がレーンを起こす前に実行し、基準内なら閉じる（`scripts/backlog/backlog-measure-close.ts`）
 - 公開しないと利用側が使えない変更には `--release` を付ける（既存 Issue は `pnpm josh issue:release <N>`、`docs/josh-commands-backlog.md` → `josh issue:release`）
 
 ### 起票元へのバックリンク（`## Origin` / `## Upstream issues`）
@@ -100,9 +137,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
@@ -123,4 +159,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)"`
+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

@@ -4,8 +4,9 @@ headless のレーン子とレビューセッションは、`CLAUDE.md` を読
 
 - 起動プロンプトがそのまま明示の起動。応答する人はいないので、確認は求めない。
 - `CLAUDE.md` を開き直さない。ここに無い規則は、対話セッションでしか効かない。
-
-<!-- include: CLAUDE.md → "Project" -->
+- Web の情報が要る作業 → レーン子は調べる内容を書いて park（`.claude/skills/workflow-commands/backlogrun-park.md` → "park and continue"）、レビューは所見に書く。WebFetch / WebSearch は起動されない（`scripts/agent/claude-agent-argv.ts` → `LAUNCHED_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"）。
 
 ## Communication
 

package/prompts/collaboration-workflow/measurement.md

@@ -0,0 +1,44 @@
+# 所要時間は記録から測る
+
+**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 する。元の PR がまだ無い（レーンが `josh ship` の前に起票する）→ `- 実施可能条件: #<Issue> を閉じる PR のマージ後 <K> マージ` と書く。`#<Issue>` を閉じたマージ済み PR から数える。`- 計測宣言:` のある Issue と、見積もりが 0 ファイルで受け入れ条件が `#<N>` の後・以降か記録（`lane:stats` 等）を読む Issue に条件が無いときも、`issue:file` が refuse する。
+- 判定は既定で `## 背景` の `- 計測宣言:` に書く（`issue-template.md`）。`lane:stats` の表の 1 セル → `pnpm josh lane:value cell`（`docs/josh-commands-run.md` → "`josh lane:value`"）。1 コマンドで出せない値 → `- 計測宣言なし: <理由>`。どちらも無ければ `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」。
+
+## 期待効果に届かなかったとき
+
+- 計測が期待効果に届かなかった → `pnpm josh issue:measured <N> --unmet --evidence-file <path>`。
+- 届かなかった機構の撤去候補を起票する → `pnpm josh effect:audit --draft <元 Issue>`（元 Issue が 30 日より前に閉じたときは `--days <N>` を足す）、表示された `issue:file` の行で起票する（重複は scout が止める）。
+- 時間短縮 Issue の効果を一覧する → `pnpm josh effect:audit [--days <N>]`。
+
+## 手元で再実行してよいとき
+
+記録で答えられない問い（記録の無い変更前後の比較など）に限る。
+
+- 1 回だけ実行する。lane 子は `pnpm josh reserved-run <weight> -- <command>` で包み、コア予算に数えさせる。ESLint は `--concurrency off` で走らせ、並列度の計測はレーン外で行う（`lane-direct-tool`）。
+- 結果を Issue のコメントに残し、以後はそれを使い回す。