@joshuafolkken/kit 1.1784.0 → 1.2116.0

package/dist/version/index.js

@@ -581,6 +581,11 @@ var version_check_logic = {
 };
 
 // scripts/git/git-execa-error.ts
+function get_exit_code(error) {
+  if (typeof error !== "object" || error === null || !("exitCode" in error)) return void 0;
+  const { exitCode: exit_code } = error;
+  return typeof exit_code === "number" ? exit_code : void 0;
+}
 function has_timed_out(error) {
   if (typeof error !== "object" || error === null || !("timedOut" in error)) return false;
   return error.timedOut === true;
@@ -681,6 +686,75 @@ function trace_swallowed(where, error) {
 }
 var error_text = { message_of, trace_swallowed };
 
+// scripts/lib/token-shape.ts
+var REDACTED = "[REDACTED]";
+var GITHUB_RULE = "@secretlint/secretlint-rule-github";
+var ANTHROPIC_OAUTH_TOKEN = /sk-ant-oat\d+-[\w-]+/u;
+var SHAPES = [
+  {
+    name: "GitHub token",
+    pattern: new RegExp("(?<!\\p{L})(?:ghp|gho|ghu|ghs|ghr)_\\w{36}(?!\\w)", "u"),
+    secretlint: GITHUB_RULE
+  },
+  {
+    name: "GitHub App installation token",
+    pattern: new RegExp("(?<!\\p{L})ghs_\\d{1,20}_[\\w-]{1,1000}\\.[\\w-]{1,10000}\\.[\\w-]{1,1000}(?![\\w-])", "u"),
+    secretlint: GITHUB_RULE
+  },
+  {
+    name: "GitHub fine-grained token",
+    pattern: new RegExp("(?<!\\p{L})github_pat_\\w{82}(?!\\w)", "u"),
+    secretlint: GITHUB_RULE
+  },
+  {
+    name: "Slack token",
+    pattern: /\b(?:xoxb|xoxp|xapp|xoxa|xoxo|xoxr)-(?:\d-)?(?:[a-zA-Z0-9]{1,40}-)+[a-zA-Z0-9]{1,40}\b/u,
+    secretlint: "@secretlint/secretlint-rule-slack"
+  },
+  {
+    name: "Anthropic API key",
+    pattern: new RegExp("(?<!\\p{L})sk-ant-api0\\d-[\\w-]{90,128}AA(?![\\w-])", "u"),
+    secretlint: "@secretlint/secretlint-rule-anthropic"
+  },
+  { name: "Anthropic OAuth token", pattern: ANTHROPIC_OAUTH_TOKEN, secretlint: void 0 }
+];
+var EVERY_SHAPE = new RegExp(SHAPES.map((shape) => shape.pattern.source).join("|"), "gu");
+function find(text) {
+  return SHAPES.find((shape) => shape.pattern.test(text));
+}
+function holds(text) {
+  return SHAPES.some((shape) => shape.pattern.test(text));
+}
+function refuse(text, subject) {
+  const shape = find(text);
+  if (shape === void 0) return;
+  throw new Error(
+    `${subject} holds a ${shape.name}-shaped string, so it was not sent. Remove the credential and send it again.`
+  );
+}
+function redact(text) {
+  return text.replaceAll(EVERY_SHAPE, () => REDACTED);
+}
+function string_leaves(value) {
+  if (typeof value === "string") return [value];
+  if (typeof value !== "object" || value === null) return [];
+  return Object.values(value).flatMap((entry) => string_leaves(entry));
+}
+function decoded(body) {
+  const value = json_value.parse_or_undefined(body);
+  return value === void 0 ? body : string_leaves(value).join("\n");
+}
+var token_shape = {
+  ANTHROPIC_OAUTH_TOKEN,
+  REDACTED,
+  SHAPES,
+  decoded,
+  find,
+  holds,
+  refuse,
+  redact
+};
+
 // scripts/gh/git-gh-exec.ts
 import { execa as execa2, execaSync } from "execa";
 
@@ -743,6 +817,78 @@ function failure_of(error) {
 }
 var gh_failure = { attach, classify_stdout, failure_of, parse_response_status };
 
+// scripts/gh/git-gh-retry.ts
+import { setTimeout as delay } from "node:timers/promises";
+var FIRST_RETRY_DELAY_MS = 2e3;
+var SECOND_RETRY_DELAY_MS = 5e3;
+var RETRY_DELAYS_MS = [FIRST_RETRY_DELAY_MS, SECOND_RETRY_DELAY_MS];
+var MAX_ATTEMPTS = RETRY_DELAYS_MS.length + 1;
+var SERVER_ERROR_FLOOR = 500;
+var GH_AUTH_REQUIRED_EXIT_CODE = 4;
+var SPENT_NOTE = "gh: request failed transiently on every attempt";
+var SUMMARY_STATUS_PATTERN = /\(HTTP (?<status>\d{3})\)/u;
+var DEFAULT_HOOKS = {
+  wait: async (milliseconds) => {
+    await delay(milliseconds);
+  },
+  note: (text) => {
+    process.stderr.write(`${text}
+`);
+  }
+};
+function summary_status(error) {
+  const { status } = SUMMARY_STATUS_PATTERN.exec(error.message)?.groups ?? {};
+  return status === void 0 ? void 0 : Number(status);
+}
+function has_answer(spawn_error) {
+  if (!(spawn_error instanceof Error) || !("stdout" in spawn_error)) return false;
+  return typeof spawn_error.stdout === "string" && spawn_error.stdout.trim().length > 0;
+}
+function is_transient_status(status, spawn_error) {
+  if (status === void 0) return !has_answer(spawn_error);
+  return status >= SERVER_ERROR_FLOOR;
+}
+function is_final_spawn(spawn_error) {
+  return has_timed_out(spawn_error) || get_exit_code(spawn_error) === GH_AUTH_REQUIRED_EXIT_CODE;
+}
+function is_transient(error) {
+  const failure = gh_failure.failure_of(error);
+  if (failure === void 0 || !(error instanceof Error)) return false;
+  const status = failure.status ?? summary_status(error);
+  return !is_final_spawn(error.cause) && is_transient_status(status, error.cause);
+}
+function first_line(error) {
+  return error_text.message_of(error).split("\n", 1)[0] ?? "";
+}
+function retry_note(error, attempt, wait_ms) {
+  const ordinal = `${String(attempt)}/${String(MAX_ATTEMPTS)}`;
+  return `gh: request failed transiently (attempt ${ordinal}: ${first_line(error)}) \u2014 retrying in ${String(wait_ms)} ms`;
+}
+function retry_delay(error, attempt) {
+  return is_transient(error) ? RETRY_DELAYS_MS[attempt - 1] : void 0;
+}
+function spent_note(message) {
+  return `${SPENT_NOTE} (${message})`;
+}
+function note_spent(error, attempt, hooks) {
+  if (attempt === MAX_ATTEMPTS && is_transient(error)) hooks.note(spent_note(first_line(error)));
+}
+async function with_retry(request, hooks = DEFAULT_HOOKS, attempt = 1) {
+  try {
+    return await request();
+  } catch (error) {
+    const wait_ms = retry_delay(error, attempt);
+    if (wait_ms === void 0) {
+      note_spent(error, attempt, hooks);
+      throw error;
+    }
+    hooks.note(retry_note(error, attempt, wait_ms));
+    await hooks.wait(wait_ms);
+    return await with_retry(request, hooks, attempt + 1);
+  }
+}
+var gh_retry = { MAX_ATTEMPTS, RETRY_DELAYS_MS, is_transient, spent_note, with_retry };
+
 // scripts/gh/git-gh-exec.ts
 var BODY_FROM_STDIN = "-";
 var GH_REQUEST_TIMEOUT_MS = 6e4;
@@ -833,13 +979,20 @@ var INPUT_FLAG = "--input";
 var PAGINATE_FLAG = "--paginate";
 var SLURP_FLAG = "--slurp";
 var JQ_FLAG = "--jq";
+var ALLOW_ESCAPES_FLAG = "--allow-escape-sequences";
 function optional_flag(flag, value) {
   return value === void 0 ? [] : [flag, value];
 }
+function refuse_credential_body(request) {
+  if (request.body !== void 0) {
+    token_shape.refuse(token_shape.decoded(request.body), `The gh api ${request.path} body`);
+  }
+}
 function to_gh_api_args(request) {
   const body_args = request.body === void 0 ? [] : [INPUT_FLAG, BODY_FROM_STDIN];
   const paginate_args = request.should_paginate === true ? [PAGINATE_FLAG] : [];
   const slurp_args = request.should_slurp === true ? [SLURP_FLAG] : [];
+  const escape_args = request.should_allow_escapes === true ? [ALLOW_ESCAPES_FLAG] : [];
   return [
     "api",
     request.path,
@@ -847,10 +1000,11 @@ function to_gh_api_args(request) {
     ...body_args,
     ...paginate_args,
     ...slurp_args,
+    ...escape_args,
     ...optional_flag(JQ_FLAG, request.jq_filter)
   ];
 }
-async function exec_gh_api(request) {
+async function send_gh_api(request) {
   const args = to_gh_api_args(request);
   if (request.body === void 0) {
     return await exec_gh_command(args, request.timeout_ms, request.cwd);
@@ -862,7 +1016,13 @@ async function exec_gh_api(request) {
     cwd: request.cwd
   });
 }
+async function exec_gh_api(request) {
+  refuse_credential_body(request);
+  if (request.should_retry === false) return await send_gh_api(request);
+  return await gh_retry.with_retry(async () => await send_gh_api(request));
+}
 function exec_gh_api_sync(request) {
+  refuse_credential_body(request);
   const body_option = request.body === void 0 ? {} : { input: request.body };
   const options = { ...body_option, ...to_spawn_options(request.timeout_ms, request.cwd) };
   try {

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/package.json

@@ -1,14 +1,17 @@
 {
-  "version": "1.1784.0",
+  "version": "1.2116.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"
@@ -68,7 +71,9 @@
     "!**/__snapshots__",
     "!**/*.golden.txt",
     "!dist/hooks/.inputs-verified.json*",
-    "!dist/.hooks-staging-*"
+    "!dist/.hooks-staging-*",
+    "!dist/.commands-test-*",
+    "!dist/.dispatch-test-*"
   ],
   "imports": {
     "#eslint/*": "./eslint/*",
@@ -140,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",
@@ -213,6 +218,7 @@
     "@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",
@@ -222,7 +228,7 @@
     "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",
@@ -230,21 +236,22 @@
     "prettier": "^3.9.10",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",
-    "rollup": "^4.64.7",
+    "rollup": "^4.65.0",
     "rollup-plugin-dts": "^6.5.1",
     "secretlint": "^13.0.7",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.71.2",
+    "typescript-eslint": "^8.72.0",
     "vitest": "^5.0.5"
   },
   "dependencies": {
     "cli-spinners": "^3.4.0",
     "csv-parse": "^7.0.3",
-    "execa": "^10.1.1",
+    "execa": "^10.2.1",
     "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",
@@ -254,7 +261,7 @@
   "devEngines": {
     "packageManager": {
       "name": "pnpm",
-      "version": "12.14.0+sha512.c18ba6d87993d3d164cb5e8948f32b2c06ee854487e06cd8d86781342fb3e5bb4634367034711e86802baa9c37bea906ce1929ad08d70884c97d801df13389a6",
+      "version": "12.15.0+sha512.b3951d6d6ff4a9f13dc7cf56cd28d2b8eb37dbcc9c68e52e1e1191873ea9f82a017287ab50baadc5ccc494f036c67c0e47eb13608c2fa36f47711b61ea128e61",
       "onFail": "download"
     }
   },

package/prompts/coding-standards.md

@@ -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,6 +1,6 @@
 ## ファイル編集はコマンド本文に本文を載せない
 
-`pnpm josh rule:list` の `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` は以下に従う。
 
 ### 何を禁じているか
 
@@ -30,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 を使う
@@ -41,12 +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）
-
-裸の `#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

@@ -8,7 +8,13 @@
 <不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
 <不具合なら `- 原因: #<PR>`、追えなければ `- 原因: 不明（<理由>）` を宣言する>
 <人の判断が要らなければ `- 人の判断: 不要`、要るなら `- 人の判断: 要（<方針の判断 / 外部アカウント / 目視確認>）` を宣言する>
-<任意。`- 優先度: 緊急（条件 <1-3> / 短縮 <値>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ通常>
+<レーンを延ばした原因なら `- 原因のレーン: <分> 分（#<N>）` を宣言する。分は `pnpm josh lane:net <N>`>
+<そのうちこの Issue の原因で縮められる分は `- 原因の損失: <分> 分` で宣言する。再発のたびに 1 行足す>
+<セキュリティの指摘なら `- セキュリティ: <迂回される gate・ガード・権限>` を宣言する>
+<Issue を park させた、またはランを止めた run 機構の不具合なら `- 原因の park: #<N>` を宣言する>
+<任意。`- 優先度: 緊急（条件 <1-3>）`、`- 優先度: 高（<根拠>）`、`- 優先度: 通常` のどれか。無ければ下限か通常>
+<差分の見積もりを `- 規模見積もり: 約 <N> ファイル / <M> 行（テスト除く）` で宣言する>
+<見積もりが分割の目安を超えても 1 件にするなら `- 分割しない理由: <理由>` を宣言する>
 
 <なぜ必要か>
 
@@ -27,7 +33,7 @@
 
 ## 発火点
 
-<AI の振る舞いを変える Issue のみ。その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つだけ書く（例 `Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`）>
+<AI の振る舞いを変える Issue のみ。その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つだけ書く（例 `Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`、回答を判定する規則は `Stop`）>
 
 ## ベースライン
 
@@ -37,7 +43,7 @@
 
 ## 再現
 
-<AI の振る舞いを変える Issue のみ。「コマンド + 実際の出力」で書き、出力はフェンス（``` または ~~~）で囲む>
+<AI の振る舞いを変える Issue、および `- 原因: 不明（<理由>）` の不具合のみ。「コマンド + 実際の出力」で書き、出力はフェンス（``` または ~~~）で囲む>
 
 - `<再現コマンド>`
 
@@ -53,7 +59,6 @@
 - 1 回あたりの得: <値>
 - 外れたときの損: <値>
 - 出典: <`pnpm josh lane:stats` → 値>
-- 1 マージあたりの短縮: <分>（レーン中央値 <分> の <%>）
 
 ## Origin
 
@@ -64,29 +69,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`）。追跡計測には使わない |
-| `- 優先度: 緊急（…）`                         | `priority:critical`               | 下の A か B。条件番号か短縮値を括弧に書く                                             |
-| `- 優先度: 高（…）`                           | `priority:high`                   | 下の C・D・E のどれか。根拠を括弧に書く                                               |
-| `- 優先度: 通常`                              | なし                              | どれにも当たらない（宣言が無いときも同じ）                                            |
+| 宣言                                                     | 付くラベル                             | 選ぶ基準                                                                                              |
+| -------------------------------------------------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| `- 種別: 不具合`                                         | `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 条件 — 該当するかは判断ではない」）
-- 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 なら高）を出して、それより低い宣言も拒否する
+- 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` が拒否する
 
 - **持ち主の意図と違う動きは、コード・コメント・テストに書かれた設計どおりでも `- 種別: 不具合` とする。** 例: コメントとテストに固定されたまま意図より広く働く自動付与、文書だけでも意図と違う分類を生む基準
@@ -94,6 +112,7 @@
 - `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`）

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

@@ -4,7 +4,9 @@ headless のレーン子とレビューセッションは、`CLAUDE.md` を読
 
 - 起動プロンプトがそのまま明示の起動。応答する人はいないので、確認は求めない。
 - `CLAUDE.md` を開き直さない。ここに無い規則は、対話セッションでしか効かない。
-- 下の `pnpm josh gate` は、レーン子では `josh ship` が回す（`.claude/skills/workflow-commands/chain-rule.md` → "Run the review-to-merge chain" step 0）。
+- 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

@@ -20,7 +20,8 @@
 
 PR の効果を測る後続 Issue を起票するとき:
 
-- 開始条件は日数でなく標本数で書く: `## 背景` に `- 実施可能条件: #<PR> のマージ後 <K> マージ`（`issue-template.md`）。`#<PR>` は元の PR の番号で、Issue の番号は `issue:file` が refuse する。
+- 開始条件は日数でなく標本数で書く: `## 背景` に `- 実施可能条件: #<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。
@@ -29,6 +30,12 @@ PR の効果を測る後続 Issue を起票するとき:
 
 計測を記録し終えた → `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>]`。
+
 ## 手元で再実行してよいとき
 
 記録で答えられない問い（記録の無い変更前後の比較など）に限る。