@joshuafolkken/kit 1.978.0 → 1.983.0

package/dist/hooks/{chunk-NXL3SBXY.js → chunk-P3UX7SFN.js}

@@ -1,10 +1,10 @@
 import {
   lane_guard_policy,
   time_batch_guard
-} from "./chunk-2K52BRWV.js";
+} from "./chunk-ASUZGZFT.js";
 import {
   hook_decision
-} from "./chunk-KQG4776P.js";
+} from "./chunk-APVOACVT.js";
 
 // scripts/hooks/batch-guard.ts
 import { text } from "node:stream/consumers";

package/dist/hooks/{chunk-F6OM6SIG.js → chunk-RFPHKU7C.js}

@@ -1,16 +1,16 @@
 import {
   time_batch_guard
-} from "./chunk-2K52BRWV.js";
+} from "./chunk-ASUZGZFT.js";
 import {
   hook_decision
-} from "./chunk-KQG4776P.js";
+} from "./chunk-APVOACVT.js";
 import {
   cost_blocks,
   cost_transcript,
   time_bundle_call,
   time_shell,
   time_spans
-} from "./chunk-ZPLXLJ7O.js";
+} from "./chunk-47SPMGOD.js";
 
 // scripts/delegation/investigation-reads.ts
 import path from "node:path";
@@ -36,15 +36,15 @@ var DELEGATABLE_STEPS = [
   },
   {
     name: "followup-filing",
-    // The late-run follow-up filing chain — issue:scout → file the Issue → epic:bundle → epic --add
-    // — is a dependency chain `batch:guard` correctly keeps one call per step, and what makes it
-    // expensive is the ~340k context it runs in at the tail of a run, not the step count
-    // (joshuafolkken/kit#1892). A fresh unit runs the same chain at a small context, and the review
-    // round cap already composed the finding text, so what the unit is handed is mechanical: run the
-    // four commands and act on their deterministic answers. This is not `batch:guard`'s business —
-    // the chain stays one call per step; delegation only moves it to a cheaper context.
-    does: "run the late-run follow-up filing chain in an isolated unit \u2014 issue:scout, file the Issue, epic:bundle, epic --add \u2014 given the finding text the parent already composed, and return the new Issue number and the epic:bundle answer",
-    verifier: "the parent reads the filed Issue from GitHub with `pnpm josh issue:state <new>`, not the unit's summary; a follow-up reported filed but not created is still absent, the way `epic-child`'s reported-done-but-not-merged child is still open. The finding text came from the parent and `issue:scout` / `epic:bundle` are deterministic, so the unit's work is the mechanical execution `issue:state` confirms"
+    // The late-run follow-up filing chain — `issue:file` (which scouts, lints, labels and runs
+    // epic:bundle itself, joshuafolkken/kit#2808) → epic --add — is a dependency chain `batch:guard`
+    // correctly keeps one call per step, and what makes it expensive is the ~340k context it runs in
+    // at the tail of a run, not the step count (joshuafolkken/kit#1892). A fresh unit runs the same
+    // chain at a small context, and the review round cap already composed the finding text, so what
+    // the unit is handed is mechanical: run the commands and act on their deterministic answers. This
+    // is not `batch:guard`'s business — delegation only moves the chain to a cheaper context.
+    does: "run the late-run follow-up filing chain in an isolated unit \u2014 issue:file (scout, lint, labels, epic:bundle), then epic --add \u2014 given the finding text the parent already composed, and return the new Issue number and the epic:bundle answer",
+    verifier: "the parent reads the filed Issue from GitHub with `pnpm josh issue:state <new>`, not the unit's summary; a follow-up reported filed but not created is still absent, the way `epic-child`'s reported-done-but-not-merged child is still open. The finding text came from the parent and `issue:file`'s steps are deterministic, so the unit's work is the mechanical execution `issue:state` confirms"
   },
   {
     name: "implementation-unit",

package/dist/hooks/{chunk-ZYYSBNR6.js → chunk-ZT65LR3U.js}

@@ -1,16 +1,16 @@
 import {
   investigation_reads
-} from "./chunk-F6OM6SIG.js";
+} from "./chunk-RFPHKU7C.js";
 import {
   lane_guard_policy
-} from "./chunk-2K52BRWV.js";
+} from "./chunk-ASUZGZFT.js";
 import {
   hook_decision
-} from "./chunk-KQG4776P.js";
+} from "./chunk-APVOACVT.js";
 import {
   json_value,
   time_spans
-} from "./chunk-ZPLXLJ7O.js";
+} from "./chunk-47SPMGOD.js";
 
 // scripts/delegation/duplicate-read-guard.ts
 import { statSync } from "node:fs";

package/dist/hooks/codex-hook-adapter.js

@@ -1,25 +1,25 @@
 #!/usr/bin/env tsx
 import {
   pretool_guard
-} from "./chunk-BNGGEY3Z.js";
-import "./chunk-Q7LE77CO.js";
+} from "./chunk-LBXQHXMC.js";
+import "./chunk-IM3KM25Y.js";
 import {
   build_envelope,
   compose_context,
   format_edited_payload
-} from "./chunk-CRGJTD6E.js";
+} from "./chunk-ERXMJJOV.js";
 import "./chunk-3V37IID6.js";
-import "./chunk-NXL3SBXY.js";
-import "./chunk-BVMSPG3M.js";
-import "./chunk-ZYYSBNR6.js";
-import "./chunk-F6OM6SIG.js";
-import "./chunk-2K52BRWV.js";
+import "./chunk-P3UX7SFN.js";
+import "./chunk-5JX6HXDX.js";
+import "./chunk-ZT65LR3U.js";
+import "./chunk-RFPHKU7C.js";
+import "./chunk-ASUZGZFT.js";
 import {
   hook_decision
-} from "./chunk-KQG4776P.js";
+} from "./chunk-APVOACVT.js";
 import {
   time_density_hook
-} from "./chunk-ZPLXLJ7O.js";
+} from "./chunk-47SPMGOD.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 

package/dist/hooks/duplicate-read-guard.js

@@ -9,11 +9,11 @@ import {
   is_enabled,
   notice_refusal_path,
   refusal_path
-} from "./chunk-ZYYSBNR6.js";
-import "./chunk-F6OM6SIG.js";
-import "./chunk-2K52BRWV.js";
-import "./chunk-KQG4776P.js";
-import "./chunk-ZPLXLJ7O.js";
+} from "./chunk-ZT65LR3U.js";
+import "./chunk-RFPHKU7C.js";
+import "./chunk-ASUZGZFT.js";
+import "./chunk-APVOACVT.js";
+import "./chunk-47SPMGOD.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 export {

package/dist/hooks/format-edited.js

@@ -15,9 +15,9 @@ import {
   relative_to_root,
   resolve_invocations,
   select_invocation
-} from "./chunk-CRGJTD6E.js";
+} from "./chunk-ERXMJJOV.js";
 import "./chunk-3V37IID6.js";
-import "./chunk-ZPLXLJ7O.js";
+import "./chunk-47SPMGOD.js";
 import "./chunk-RKUAD3I6.js";
 export {
   ESLINT_DAEMON,

package/dist/hooks/investigation-guard.js

@@ -10,11 +10,11 @@ import {
   is_enabled,
   load_environment_file,
   refusal_path
-} from "./chunk-BVMSPG3M.js";
-import "./chunk-F6OM6SIG.js";
-import "./chunk-2K52BRWV.js";
-import "./chunk-KQG4776P.js";
-import "./chunk-ZPLXLJ7O.js";
+} from "./chunk-5JX6HXDX.js";
+import "./chunk-RFPHKU7C.js";
+import "./chunk-ASUZGZFT.js";
+import "./chunk-APVOACVT.js";
+import "./chunk-47SPMGOD.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 export {

package/dist/hooks/pretool-guard.js

@@ -3,16 +3,16 @@ import {
   pretool_guard,
   pretool_outcome,
   pretool_outcome_async
-} from "./chunk-BNGGEY3Z.js";
-import "./chunk-Q7LE77CO.js";
+} from "./chunk-LBXQHXMC.js";
+import "./chunk-IM3KM25Y.js";
 import "./chunk-3V37IID6.js";
-import "./chunk-NXL3SBXY.js";
-import "./chunk-BVMSPG3M.js";
-import "./chunk-ZYYSBNR6.js";
-import "./chunk-F6OM6SIG.js";
-import "./chunk-2K52BRWV.js";
-import "./chunk-KQG4776P.js";
-import "./chunk-ZPLXLJ7O.js";
+import "./chunk-P3UX7SFN.js";
+import "./chunk-5JX6HXDX.js";
+import "./chunk-ZT65LR3U.js";
+import "./chunk-RFPHKU7C.js";
+import "./chunk-ASUZGZFT.js";
+import "./chunk-APVOACVT.js";
+import "./chunk-47SPMGOD.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 export {

package/dist/hooks/stop-guard.js

@@ -19,20 +19,20 @@ import {
   run_hold,
   run_invocation,
   run_watcher_guard
-} from "./chunk-Q7LE77CO.js";
+} from "./chunk-IM3KM25Y.js";
 import {
   session_language
 } from "./chunk-6V5OPIUU.js";
 import {
   hook_decision,
   lane_child_marker
-} from "./chunk-KQG4776P.js";
+} from "./chunk-APVOACVT.js";
 import {
   PROJECT_ROOT,
   stamp_file,
   time_density_hook,
   time_hook_transcript
-} from "./chunk-ZPLXLJ7O.js";
+} from "./chunk-47SPMGOD.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 
@@ -1161,7 +1161,7 @@ function build_citation_reason(references) {
   const command = `pnpm josh issue:cite ${issue_citation.cite_arguments(references).join(" ")}`;
   return `\u26D4 issue citation: your reply names an Issue as a bare \`#N\` (${numbers}). Run \`${command}\` to print the paste-ready citation lines, then print the corrected citation lines alone \u2014 do not repeat your previous reply. ${ISSUE_CITATION_REASON}`;
 }
-var FILING_OFFER_REASON = '\u26D4 filing offer: your reply offers to file an Issue instead of filing it. Filing into a first-party repository is Tier A \u2014 the trigger is the judgement that it is worth filing, not the run\'s progress (`.claude/skills/workflow-commands/SKILL.md` \u2192 \xA72i, `observation-filing.md`). Run `pnpm josh issue:scout "<title>"`, file it, run `pnpm josh epic:bundle <new>`, then end with the one-line citation of what was filed \u2014 do not repeat your previous reply. If it is not worth filing after all, say so in one line instead.';
+var FILING_OFFER_REASON = '\u26D4 filing offer: your reply offers to file an Issue instead of filing it. Filing into a first-party repository is Tier A \u2014 the trigger is the judgement that it is worth filing, not the run\'s progress (`.claude/skills/workflow-commands/SKILL.md` \u2192 \xA72i, `observation-filing.md`). Run `pnpm josh issue:file "<title>" --body-file <path> --depth <0|1|2>` \u2014 it scouts, lints, labels and runs `epic:bundle` itself \u2014 then end with the one-line citation of what was filed; do not repeat your previous reply. If it is not worth filing after all, say so in one line instead.';
 var HEADLESS_WAIT_MARKER = "\u26D4 headless parent:";
 var HEADLESS_REFUSAL_CAP = 3;
 var HEADLESS_WAIT_CALLS = ['"command":"pnpm josh lane:await', '"command":"pnpm josh run:progress'];

package/dist/josh.js

@@ -447,6 +447,16 @@ var ISSUE_COMMANDS = {
     description: "Post one comment to an issue from a file, so no shell expands the body",
     category: "AI tools",
     reference: ["<issue> --body <text> | --body-file <path>", "automation", ["network"]]
+  },
+  "issue:file": {
+    script: "scripts/issue/issue-file-cli.ts",
+    description: "File an Issue with every filing step: lint, Origin, duplicate scout, labels, then epic:bundle",
+    category: "AI tools",
+    reference: [
+      "<title> --body-file <path> --depth <0|1|2> [--route <route>] [--label <name>] [--repo <owner/repo>] [--distinct <N,\u2026>]",
+      "automation",
+      ["network"]
+    ]
   }
 };
 
@@ -1225,7 +1235,11 @@ var PROJECT_COMMANDS = {
     script: "scripts/propagate/propagate.ts",
     description: "Carry the published release into every consumer repository next to this one",
     category: "Project",
-    reference: ["[--dry-run] [--skip-publish-wait]", "maintainer", ["files", "network"]]
+    reference: [
+      "[--dry-run] [--skip-publish-wait] [--target <repo>]",
+      "maintainer",
+      ["files", "network"]
+    ]
   },
   adopt: {
     script: "scripts/adopt/adopt.ts",
@@ -1472,6 +1486,7 @@ var ALIASES = {
   ird: "issue:read",
   ist: "issue:state",
   isc: "issue:scout",
+  ifl: "issue:file",
   isf: "issue:fold",
   isfe: "issue:fold-existing",
   dfr: "defect:rate",

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.978.0",
+  "version": "1.983.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": [

package/prompts/collaboration-workflow/epic-bundle.md

@@ -12,18 +12,18 @@
 
 **Issue を新規に起票した直後**に、既存の open Issue を調べる。`kickoff` / `fullrun` / `halfrun` が起票したとき、および実装中に Tier A で起票したとき（`backlogrun` 実行中を含む）。
 
-`pnpm josh epic:bundle <N>`（エイリアス `eb`）が候補を探して推奨を表示する。**このコマンドは何も書き込まない** — 候補を出すのが機械、束ねるかを決めるのは AI である。
+`pnpm josh epic:bundle <N>`（エイリアス `eb`）が候補を探して推奨を表示する。起票は `pnpm josh issue:file` で行い、このコマンドが最終段として `epic:bundle` を実行して答えを表示するので、別に呼ぶのは `⚠` で再実行を案内されたときだけである。**このコマンドは何も書き込まない** — 候補を出すのが機械、束ねるかを決めるのは AI である。
 
 ### 起票の「前」に答えるのは `issue:scout`
 
 `pnpm josh issue:scout "<title>"`（エイリアス `isc`）は、まだ存在しない Issue について同じ配属先の問いに答える（joshuafolkken/kit#1252）。**配属の判定は `epic:bundle` のものをそのまま呼んでおり、実装は 1 つしかない。** 加えて、`epic:bundle` が意図的に採らないシグナル — タイトルの語の重なりによる**重複候補** — を返す。既存 Issue の束ね直しに似た見出しが立つのは強シグナルだけで十分だからだが、「もう起票されていないか」は起票前にしか意味を持たない別の問いであり、しきい値を混ぜていない。
 
-**両方を実行する。順番が違うだけである。**
+**両方を実行する。順番が違うだけである。** どちらも `pnpm josh issue:file` が 1 回の呼び出しの中で実行する。
 
-| いつ                       | コマンド                | 何について答えるか                                 |
-| -------------------------- | ----------------------- | -------------------------------------------------- |
-| `gh api … issues` の**前** | `issue:scout "<title>"` | まだ番号を持たない下書き。タイトルと要約だけがある |
-| 起票の**直後**             | `epic:bundle <N>`       | 実在する Issue。番号と、それに記録された関係がある |
+| いつ           | コマンド                | 何について答えるか                                 |
+| -------------- | ----------------------- | -------------------------------------------------- |
+| 起票の**前**   | `issue:scout "<title>"` | まだ番号を持たない下書き。タイトルと本文がある     |
+| 起票の**直後** | `epic:bundle <N>`       | 実在する Issue。番号と、それに記録された関係がある |
 
 手順上の位置づけと、重複候補が見つかったときに起票せず止まる規則は `.claude/skills/workflow-commands/SKILL.md` → §2e が単一ソースである。
 
@@ -41,8 +41,8 @@
 
 **これは「レビューを CI と並走させる」ではない。**（ここで言うレビューは 1 周目のことであり、2 周目については下の段落で別に扱う。） joshuafolkken/kit#1216 の (b) は不採用と決定済みであり、却下の理由は規則ではなく仕組みである — あちらは**コードを変える作業**を CI と重ねるため、修正を push するたびに CI がやり直しになり、重ねた分をそのまま払い戻す。起票はコードを 1 行も変えないので、走っている CI がそのまま使える。**1 周目のレビュー**はコミットの前のままで、「コミット前セルフレビュー」は書き換えていない。**2 周目だけは CI と並走する**（joshuafolkken/kit#1261）— 同じ仕組みを逆から読んだ結果であり、2 周目は fix delta しか読まず、通常はコードを 1 行も変えない。変えた場合は同一ブランチへの追加コミット 1 つと CI のやり直し 1 回を払う。単一ソースは `.claude/skills/workflow-commands/chain-rule.md` → "The pull request opens between the rounds, so CI runs beside round 2"。
 
-1. 残指摘を後追い Issue として起票し、現在の Issue を参照する
-2. **現在の Issue が閉じる前に** `pnpm josh epic:bundle <新規>` を実行する。候補探索は open Issue しか読まないため、親が閉じた後では恒久的に `none` になる（joshuafolkken/kit#947）
+1. 残指摘を後追い Issue として起票し、現在の Issue を参照する。起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n> --route review-cap` で行う
+2. **現在の Issue が閉じる前に**起票する。`issue:file` が新規 Issue について `epic:bundle` を実行する。候補探索は open Issue しか読まないため、親が閉じた後では恒久的に `none` になる（joshuafolkken/kit#947）
 3. 答えに従う。**`epic:bundle` は推奨するだけで何も書き込まない**ので、「実行する」とは書き込みコマンドを自分で打つことである。**epic 本文の手編集は禁止** — タスクリストと `blocked-by` が食い違い、`epic:next` が `error` を返す
 
    | 答え                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | すること                                                                                                                                                                                                                                            | Tier             |

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

@@ -71,14 +71,14 @@ Issue には次の要素を必ず含める。
 
 - **起票前に不具合かどうかを必ず選ぶ。** `## 背景` の直下に、不具合なら `- 種別: 不具合`、非不具合なら `- 種別: 非不具合` を置く。両方の併記も省略も `pnpm josh issue:lint` が拒否する。故障を述べる本文でも単語から自動判定せず、起票者が判断する。振る舞い変更、機能改善、互換性の宣言はこの判断と併記できる
 - **不具合修正の Issue は `- 種別: 不具合` を宣言する。** この宣言がある Issue では、`pnpm josh git -y` が追加・変更したテストを修正前のツリー（merge-base）に当てて `pnpm josh test:red` で実行し、1 本も赤にならない（`green`）ときはコミットを拒否する。修正前でも緑の回帰テストは、報告された症状を再現していないためである（joshuafolkken/kit#2448）。回帰テストは、利用者が症状を見たのと同じ粒度で書く
-- **起票時の `bug` ラベルは本文の宣言から決める。** `pnpm josh issue:lint <本文ファイル>` の後、同じファイルを `gh api …/issues -F body=@<本文ファイル>` で送る。`labels:` に `bug` が含まれたら `-f 'labels[]=bug'` を同じ作成呼び出しに追加する。`depth`・`route` は併記する。`bugfix` は PR のリリース分類であり、Issue の `bug` の代わりにしない
-- **機能追加・機能改善は目的を本文で宣言する。** `## 背景` の直下に `- 目的: 機能追加` または `- 目的: 機能改善` を書く。`pnpm josh issue:lint <本文ファイル>` が `labels: enhancement` を返したら、同じ作成呼び出しに `-f 'labels[]=enhancement'` を付ける。不具合修正、文書のみ、依存更新、保守作業はタイトルの単語から推測して宣言しない。目的が曖昧なら起票文案の期待結果と受け入れ条件を具体化してから分類する
-- **互換性を壊す変更は影響を本文で宣言する。** 既存の利用者、API、設定の契約を変える場合は、`## 背景` の直下に `- 互換性: 破壊的変更` を書き、廃止対象と影響を説明する。移行措置や事前案内があっても破壊的変更なら宣言する。`pnpm josh issue:lint <本文ファイル>` が `labels: breaking-change` を返したら、同じ作成呼び出しに `-f 'labels[]=breaking-change'` を付ける。互換性を保つ変更には付けない。影響が曖昧なら起票文案で対象の利用者と契約を明確にしてから分類する
-- **`issue:lint` が返す分類ラベルをすべて起票時に指定する。** `bug`、`enhancement`、`breaking-change` は組み合わせて表示されることがある。`depth`・`route` など既存のラベルを残し、`labels: none` のときは分類ラベルを付けない。Issue が `enhancement` と `breaking-change` の両方を持つとき、PR のリリース分類は `breaking-change` 一つにする。Issue の目的の分類と PR のリリース分類を区別する
+- **起票時の `bug` ラベルは本文の宣言から決める。** 起票は `pnpm josh issue:file "<title>" --body-file <本文ファイル> --depth <n>` で行い、このコマンドが `issue:lint` と同じ検査をしたうえで、`- 種別: 不具合` の宣言があれば `bug` ラベルを同じ作成リクエストに付ける。`depth`・`route` も同じ呼び出しで付く。`bugfix` は PR のリリース分類であり、Issue の `bug` の代わりにしない
+- **機能追加・機能改善は目的を本文で宣言する。** `## 背景` の直下に `- 目的: 機能追加` または `- 目的: 機能改善` を書く。この宣言があれば `pnpm josh issue:file` が `enhancement` ラベルを同じ作成リクエストに付ける。不具合修正、文書のみ、依存更新、保守作業はタイトルの単語から推測して宣言しない。目的が曖昧なら起票文案の期待結果と受け入れ条件を具体化してから分類する
+- **互換性を壊す変更は影響を本文で宣言する。** 既存の利用者、API、設定の契約を変える場合は、`## 背景` の直下に `- 互換性: 破壊的変更` を書き、廃止対象と影響を説明する。移行措置や事前案内があっても破壊的変更なら宣言する。この宣言があれば `pnpm josh issue:file` が `breaking-change` ラベルを同じ作成リクエストに付ける。互換性を保つ変更には付けない。影響が曖昧なら起票文案で対象の利用者と契約を明確にしてから分類する
+- **本文が宣言する分類ラベルは `pnpm josh issue:file` がすべて起票時に付ける。** `bug`、`enhancement`、`breaking-change` は組み合わせて付くことがある。`depth`・`route` などのラベルと併せて 1 回の作成リクエストで付け、宣言が無いとき（`issue:lint` の `labels: none`）は分類ラベルを付けない。Issue が `enhancement` と `breaking-change` の両方を持つとき、PR のリリース分類は `breaking-change` 一つにする。Issue の目的の分類と PR のリリース分類を区別する
 - **`## 発火点`** には、その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つ書く。名前は `prompts/collaboration-workflow/rule-delivery.md` の配送表に載る、フックで配送可能なツール（`Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`）と突き合わせる。**表に無い名前**（そもそもツールコール名でない）と**不一致**（既知のツールだが配送できない）は区別して印字され、joshuafolkken/kit#2201 の「規則は正しいが名指ししたコールが実際に破れるコールの 1 つ後ろ」を起票時に検出する
 - **`## ベースライン`** は **「コマンド + 値」** で書く。``- `<測定コマンド>` → <現在の値>`` の形に限り、自然文だけの測定説明は受け付けない（再実行できないため）。マージ後に `pnpm josh measure:rerun` が同じコマンドをやり直し、**before / after の対**を印字する。値が動かなかったとき、反証された前提として `docs/maintainers/observations.md` に 1 行追記される（既存の append-only 台帳を使い、別の台帳は作らない）
 - **`## 再現`** は **「コマンド + 実際の出力」** で書く。コマンドを backtick、出力をフェンス（``` または ~~~）で囲む。自然文の「確認した」は再実行できないため受け付けない（`## ベースライン` と同じ理由）。読みだけの起票を起票時に弾くためである
-- **検査は `pnpm josh issue:lint <path>` が行う。** 対象判定・3 見出しの有無・発火点の配送可否・ベースラインが「コマンド + 値」か・再現が「コマンド + 実際の出力」かと、起票時に必要な分類ラベルを、起票前の本文ファイルからまとめて答える（未リントの起票は `pnpm josh rule:guard` が拒否する）
+- **検査は `pnpm josh issue:lint <path>` が行う。** 対象判定・3 見出しの有無・発火点の配送可否・ベースラインが「コマンド + 値」か・再現が「コマンド + 実際の出力」かと、起票時に必要な分類ラベルを、起票前の本文ファイルからまとめて答える（`pnpm josh issue:file` は起票前に同じ検査を行い、問題があれば起票しない）
 
 ### 起票元へのバックリンク（`## Origin` / `## Upstream issues`）
 

package/prompts/collaboration-workflow/rule-delivery.md

@@ -53,33 +53,33 @@
 
 ## 配送されている規則
 
-| 規則                                                                                                                                                                   | 引き金                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 引き金が発火しないターンでは                                                                                                                                                                                                    |
-| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **ターン内バッチング**（`turn-batching.md`）                                                                                                                           | `pnpm josh batch:guard` — 単発呼び出しのターンが 3 つ続いた次の `Bash` / `Edit` / `Read`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | 往復あたりの呼び出し数が下限を上回っている ＝ 規則は既に守られている                                                                                                                                                            |
-| **調査の委譲しきい値**（`SKILL.md` → §2b）                                                                                                                             | `pnpm josh investigation:guard` — 編集しないファイルの読み取りが 3 件目に達した `Read` / `Bash`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 読み取りがしきい値未満 ＝ 委譲する対象がまだ無い                                                                                                                                                                                |
-| **バックログ WIP 上限**（`wip-cap.md`）                                                                                                                                | `pnpm josh rule:guard` — Issue を作成する `Bash`（`gh issue create`、または `…/issues` への `title` 付き POST）                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Issue が起票されていない ＝ 上限に触れる行為が無い                                                                                                                                                                              |
-| **起票前の下調べ**（`.claude/skills/workflow-commands/SKILL.md` → §2e）                                                                                                | `pnpm josh rule:guard` — Issue を作成する `Bash`。そのランのトランスクリプト末尾に `pnpm josh issue:scout` が見当たらないときに拒否する。拒否文は走らせるべき `issue:scout` コマンドそのものを渡す                                                                                                                                                                                                                                                                                                                                                                                      | 起票の前に `issue:scout` を走らせている ＝ 規則は既に守られている（`issue-comments` と同じく 1 ラン 1 回）                                                                                                                      |
-| **1 ラン 10 件の起票上限**（`.claude/skills/workflow-commands/SKILL.md` → §2d、`observation-filing.md`）                                                               | `pnpm josh rule:guard` — Issue を作成する `Bash`。そのランで**拒否されていない**起票が既に 10 件あるとき、11 件目を拒否する。`is_issue_filing` を再利用し、新しい述語は作らない                                                                                                                                                                                                                                                                                                                                                                                                         | 拒否されていない起票が 10 件未満 ＝ 上限に触れていない。**繰り返す行為を止める行なので毎回発火する**（下の「例外」に従う）                                                                                                      |
-| **Issue コメントの読み取り**（`SKILL.md` → §2g）                                                                                                                       | `pnpm josh rule:guard` — Issue 本文だけを読む `Bash`（`gh issue view <N>`、または `…/issues/<N>` で終わる GET）                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Issue を読んでいない、または最初から `--comments` 付きで読んでいる                                                                                                                                                              |
-| **本文をシェルに載せない**（`shell-body.md`）                                                                                                                          | `pnpm josh rule:guard` — 二重引用符の本文値（`-f body="…"` ／ `-f "body=…"` ／ `--body "…"` ／ `--notify-message "…"`）にバッククォートか `$` を含む `Bash`                                                                                                                                                                                                                                                                                                                                                                                                                             | 本文がシェルに評価されない ＝ 規則は既に守られている                                                                                                                                                                            |
-| **@path をリテラル投稿する誤射**（`shell-body.md`、joshuafolkken/kit#2304）                                                                                            | `pnpm josh rule:guard` — 生フィールド（`-f` ／ `--raw-field`）で `body=@<path>` を渡した `Bash`。`@` で始まる値をそのまま送るため `@<path>` がコメントとして投稿される。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                                                                | `-F` ／ `--field body=@`（ファイルを読む正しい綴り）・`@` を含まない本文・`pnpm josh issue:comment` ＝ リテラルの `@path` が送出されない                                                                                        |
-| **検証コマンドのパイプ**（`output-bounds.md`）                                                                                                                         | `pnpm josh rule:guard` — 合否を意味する josh のチェック（`gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval` ／ `overrides` ／ `ranges`）がパイプの手前に立った `Bash`                                                                                                                                                                                                                                                                                                                                                                                                       | 検証の終了コードが握りつぶされていない ＝ 失敗が失敗として伝わる                                                                                                                                                                |
-| **早すぎる進捗報告**（`.claude/skills/workflow-commands/backlogrun-progress.md` → 「Progress while the run is quiet」）                                                | `pnpm josh rule:guard` — 待つことだけが目的の `Bash`（全区間が `sleep`、または `sleep` に `echo` ／ `:` ／ `date` が並ぶだけ）。既に生きているタイマーがある回、またはその報告が間隔前に着地する回に拒否する                                                                                                                                                                                                                                                                                                                                                                            | 待機タイマーを自前で張っていない ＝ 時計は `run:progress` が 1 本だけ持っている                                                                                                                                                 |
-| **run 末尾の空転**（`background-commands.md`）                                                                                                                         | `pnpm josh rule:guard` — commit・push・PR 作成をまとめる段（`pnpm josh git -y` ／ 別名 `josh g`、`--yes` も同じ）を**前景**で出した `Bash`。`run_in_background` が付いていれば引き金に当たらない                                                                                                                                                                                                                                                                                                                                                                                        | 背景で発行している ＝ 完了通知が run を再開させ、push とマージのあいだが空かない                                                                                                                                                |
-| **gate 手前の cut**（`.claude/skills/workflow-commands/pre-gate-cut.md`）                                                                                              | `pnpm josh rule:guard` — レーンの作業ツリーに居て、目印 `JOSH_LANE_CHILD` がその Issue を指し、cut 記録がまだ無いまま `pnpm josh gate`（別名 `josh ga` も同じ）を走らせる `Bash`                                                                                                                                                                                                                                                                                                                                                                                                        | レーン以外の checkout に居る、目印が無い（レーン内の人）、または既に cut 済み ＝ 規則が守られている状態                                                                                                                         |
-| **実装フェーズの cut**（`.claude/skills/workflow-commands/pre-gate-cut.md` → 「It is a guard, fired at the edit that crosses the threshold」、joshuafolkken/kit#2310） | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）で cut 記録がまだ無く、直近文脈のコスト（`pnpm josh cost --cut` と同一の統計・同一のしきい値 `CONTEXT_CUT_THRESHOLD`、測定不能は `!== UNDER` で安全側に発火）が超過しているときに出した `Edit` ／ `Write`。編集の直前で拒否し `pnpm josh run:cut --impl <N> --handoff <path>` を返す。**しきい値を跨ぐたびに発火する**（`decide`、joshuafolkken/kit#2385）。直後の同じ編集の出し直しは通すので `busy` ／ `failed` でも空回りしない                                                           | レーンの子でない（レーン外・目印なし・レーン内の人）、非編集ツール、既に cut 済み、またはコストがしきい値未満 ＝ 打ち切りが要らない状態                                                                                         |
-| **レーンの子の保留**（`.claude/skills/workflow-commands/pre-gate-cut.md`）                                                                                             | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）が、判断待ちの停止通知 `pnpm josh notify --task-type confirmation` を出した `Bash`                                                                                                                                                                                                                                                                                                                                                                                                           | レーンの子でない（レーン外・目印なし・レーン内の人）、または停止通知でない ＝ 保留を記録すべき停止が無い                                                                                                                        |
-| **レーンの子の対話質問**（`.claude/skills/workflow-commands/pre-gate-cut.md` → 「The interactive ask is refused one call earlier」）                                   | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）が `AskUserQuestion` を呼んだ呼び出し。停止通知の 1 つ手前で拒否し park 手順を返す。ハーネスは対話質問をターン終了で拒否するので、この 1 つ前が正しい引き金である。**毎回発火する**                                                                                                                                                                                                                                                                                                          | レーンの子でない（レーン外・目印なし・レーン内の人）、または対話ツールでない ＝ 握りつぶされる質問が無い                                                                                                                        |
-| **テストの宣言**（`CLAUDE.md` → Code Change Rules）                                                                                                                    | `pnpm josh rule:guard` — commit・push・PR 段（`pnpm josh git -y` ／ 別名 `josh g`）を出した瞬間に `pnpm josh test:declared` が作業ツリーを `required`（テストでも機械的免除パスでもない変更ファイルがある）と読む `Bash`。`run_tail` の commit 段照合を再利用し、新しい配送経路は作らない                                                                                                                                                                                                                                                                                               | 差分が `exempt`（`*.md` 等の非ランタイム）または `satisfied`（`*.test.ts` ／ `*.e2e.ts` を含む）＝ テストが要らない、または既に伴っている。免除は人が Step 0 で宣言するため 1 ラン 1 回だけ配送する                             |
-| **force push / ブランチ削除**（`operating-rules.md`、joshuafolkken/kit#2120）                                                                                          | `pnpm josh rule:guard` — `git push` / `git branch` を argv として解析し、force（`--force` ／ `-f` ／ 結合クラスタ `-uf`）・削除（`--delete` ／ `-d` ／ `-D` ／ コロン形 `:branch`）・`git -C` 前置を綴りによらず判定した `Bash`。**毎回発火する**                                                                                                                                                                                                                                                                                                                                       | force / 削除でない通常の `git push` / `git branch` ＝ 破壊的操作が無い                                                                                                                                                          |
-| **認可外の作業ツリー変更**（`operating-rules.md`、joshuafolkken/kit#2120）                                                                                             | `pnpm josh rule:guard` — `git checkout -- <path>` ／ `git restore <path>`（worktree）／ 認可外の `git stash`（bare・メッセージ無し push・位置指定 pop 等）を出した `Bash`。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                                                             | メッセージ付き `git stash push -m` ・`git stash list` ・`pnpm josh git` ・`pnpm josh stash:pop` ＝ 認可された退避                                                                                                               |
-| **ファイル本文をシェルに載せない**（`file-edits.md`、joshuafolkken/kit#2120）                                                                                          | `pnpm josh rule:guard` — 既存ファイルを対象としたヒアドキュメント書き込み・書き込みを伴う `node -e` ／ インタプリタ heredoc・in-place `perl -0pi -e` を出した `Bash`。既存判定は `stat` 1 回。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                                          | 新規ファイル作成・読み取り専用のヒアドキュメント・短い `sed -i` ＝ 本文を丸ごと運んでいない                                                                                                                                     |
-| **停止時の通知**（`CLAUDE.md` →「Mid-workflow stop notification」、joshuafolkken/kit#2121）                                                                            | `pnpm josh stop:guard` — `Stop` フックで、作業ツリーを押さえたまま（`run:hold` 記録あり）その turn に `confirmation` 通知を出さずに止まろうとする。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                                                               | 押さえを持っていない、`confirmation` 通知が末尾にある、または pre-gate cut を取った回（レーンの子の自動継続）＝ 人待ちの停止ではない（`stop_hook_active` が無限ループの歯止め）                                                 |
-| **hold の解放**（`.claude/skills/workflow-commands/SKILL.md` → §2f、joshuafolkken/kit#2121）                                                                           | `pnpm josh stop:guard` — `Stop` フックで、ツリーが綺麗（`git status --porcelain` が空）なのに `run:hold` 記録が残ったまま止まる。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                                                                                 | ツリーが汚れている（`halfrun` の commit 前停止・`needs-human-review` 停止）、または既に解放済み ＝ 次のランが踏まない                                                                                                           |
-| **Issue 引用の書式**（`prompts/collaboration-workflow/issue-citation.md`、joshuafolkken/kit#2121・joshuafolkken/kit#2247）                                             | `pnpm josh stop:guard` — `Stop` フックで、`last_assistant_message` の地の文に裸の `#N` を含む。**停止をブロックする**（モデルに差し戻し、引用を直して返信を出し直させる）                                                                                                                                                                                                                                                                                                                                                                                                               | リンク形式で引用している、コードフェンス／インラインコード／引用行の中、`PR` ／ `pull request` 直後の `#N`、または GitHub 向け成果物（`gh` 引数として渡る）、あるいは `stop_hook_active` が立っている ＝ 差し戻す裸の番号が無い |
-| **起票の申し出**（`.claude/skills/workflow-commands/SKILL.md` → §2i、joshuafolkken/kit#2422）                                                                          | `pnpm josh stop:guard` — `Stop` フックで、`last_assistant_message` の地の文が起票を申し出る（「起票してよければ」等）のに、transcript 末尾に起票（`filing_cap` の数え方）が無い。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                                 | 起票済み、フェンス／引用行の中、第三者の `owner/repo` を名指す（`repo_party.classify`）、owner 不明、または `stop_hook_active` ＝ 保留された Tier A 起票が無い                                                                  |
-| **規則本文を散文に書き足す前の第 0 問・順序の問い**（`residency.md`、joshuafolkken/kit#2272・joshuafolkken/kit#2324）                                                  | `pnpm josh rule:guard` — `CLAUDE.md` ／ `prompts/**/*.md` ／ `.claude/skills/**/*.md` を対象とする `Edit` ／ `Write` で、リンク・URL を除いた正味の追記が閾値以上（規則本文の追記）。誤字・リンク張り替え・削除は当たらない。第 0 問（`oracle:list`）と順序の問い（`run:step`）を突きつける。1 ラン 1 回。**#2324 で stand-down** — `oracle:list` と `run:step` の両方を走らせた記録が末尾にあれば通す（リマインダではなく「問いに答えたか」で通す）                                                                                                                                    | 規則ドキュメントを編集していない、追記が閾値未満、または両方の配置判定コマンドを実行済み ＝ 散文の規則が増えていない、または配置の問いに答え済み                                                                                |
-| **オラクル未参照の行為**（`decision-oracle.ts`、joshuafolkken/kit#2324）                                                                                               | `pnpm josh rule:guard` — 発火点を宣言したオラクルが支配する `Bash`（`pkg:scout` ＝ `pnpm add`、`issue:lint` ＝ Issue 起票）を、そのオラクルの `pnpm josh <command>` 無しで出したとき拒否。拒否文は登録簿（判断・コマンド・回答語彙・単一ソース）から組み立て手書きしない。1 ラン 1 回、実行済みで stand-down。発火点を名指しできないオラクルは理由を宣言し**可視化された未強制**として残る（`oracle:list` が発火点／理由を印字）。`release:scope` は理由側で、`pnpm josh followup` のマージ**後**に owe されるリリースを読むためマージを gate せず trail する（joshuafolkken/kit#2334） | 支配下の行為を出していない、またはそのオラクルを実行済み ＝ 規則は既に守られている                                                                                                                                              |
+| 規則                                                                                                                                                                   | 引き金                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 引き金が発火しないターンでは                                                                                                                                                                                                    |
+| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **ターン内バッチング**（`turn-batching.md`）                                                                                                                           | `pnpm josh batch:guard` — 単発呼び出しのターンが 3 つ続いた次の `Bash` / `Edit` / `Read`                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 往復あたりの呼び出し数が下限を上回っている ＝ 規則は既に守られている                                                                                                                                                            |
+| **調査の委譲しきい値**（`SKILL.md` → §2b）                                                                                                                             | `pnpm josh investigation:guard` — 編集しないファイルの読み取りが 3 件目に達した `Read` / `Bash`                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 読み取りがしきい値未満 ＝ 委譲する対象がまだ無い                                                                                                                                                                                |
+| **バックログ WIP 上限**（`wip-cap.md`）                                                                                                                                | `pnpm josh rule:guard` — Issue を起票する `Bash`（`pnpm josh issue:file`）                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Issue が起票されていない ＝ 上限に触れる行為が無い                                                                                                                                                                              |
+| **直接起票の禁止**（`docs/josh-commands.md` → `josh issue:file`、joshuafolkken/kit#2808）                                                                              | `pnpm josh rule:guard` — `josh issue:file` を通さずに Issue を作成する `Bash`（`gh issue create`、または `…/issues` への `title` 付き POST）。拒否文は `pnpm josh issue:file` の書式を渡す。重複探し・本文の検査と分類ラベル・`## Origin` の確認・`epic:bundle` はこのコマンドが実行するので、それぞれを別の行で見張らない。**毎回発火する**                                                                                                                                                                                                                           | `pnpm josh issue:file` で起票している ＝ 起票の全段がそろっている                                                                                                                                                               |
+| **1 ラン 10 件の起票上限**（`.claude/skills/workflow-commands/SKILL.md` → §2d、`observation-filing.md`）                                                               | `pnpm josh rule:guard` — Issue を起票する `Bash`（`pnpm josh issue:file`）。そのランで**拒否されていない**起票が既に 10 件あるとき、11 件目を拒否する。終了コードが 0 でない `issue:file` 呼び出しは起票に数えない。`is_issue_filing` を再利用し、新しい述語は作らない                                                                                                                                                                                                                                                                                                 | 拒否されていない起票が 10 件未満 ＝ 上限に触れていない。**繰り返す行為を止める行なので毎回発火する**（下の「例外」に従う）                                                                                                      |
+| **Issue コメントの読み取り**（`SKILL.md` → §2g）                                                                                                                       | `pnpm josh rule:guard` — Issue 本文だけを読む `Bash`（`gh issue view <N>`、または `…/issues/<N>` で終わる GET）                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Issue を読んでいない、または最初から `--comments` 付きで読んでいる                                                                                                                                                              |
+| **本文をシェルに載せない**（`shell-body.md`）                                                                                                                          | `pnpm josh rule:guard` — 二重引用符の本文値（`-f body="…"` ／ `-f "body=…"` ／ `--body "…"` ／ `--notify-message "…"`）にバッククォートか `$` を含む `Bash`                                                                                                                                                                                                                                                                                                                                                                                                            | 本文がシェルに評価されない ＝ 規則は既に守られている                                                                                                                                                                            |
+| **@path をリテラル投稿する誤射**（`shell-body.md`、joshuafolkken/kit#2304）                                                                                            | `pnpm josh rule:guard` — 生フィールド（`-f` ／ `--raw-field`）で `body=@<path>` を渡した `Bash`。`@` で始まる値をそのまま送るため `@<path>` がコメントとして投稿される。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                                               | `-F` ／ `--field body=@`（ファイルを読む正しい綴り）・`@` を含まない本文・`pnpm josh issue:comment` ＝ リテラルの `@path` が送出されない                                                                                        |
+| **検証コマンドのパイプ**（`output-bounds.md`）                                                                                                                         | `pnpm josh rule:guard` — 合否を意味する josh のチェック（`gate` ／ `check` ／ `lint*` ／ `cspell*` ／ `test*` ／ `eval` ／ `overrides` ／ `ranges`）がパイプの手前に立った `Bash`                                                                                                                                                                                                                                                                                                                                                                                      | 検証の終了コードが握りつぶされていない ＝ 失敗が失敗として伝わる                                                                                                                                                                |
+| **早すぎる進捗報告**（`.claude/skills/workflow-commands/backlogrun-progress.md` → 「Progress while the run is quiet」）                                                | `pnpm josh rule:guard` — 待つことだけが目的の `Bash`（全区間が `sleep`、または `sleep` に `echo` ／ `:` ／ `date` が並ぶだけ）。既に生きているタイマーがある回、またはその報告が間隔前に着地する回に拒否する                                                                                                                                                                                                                                                                                                                                                           | 待機タイマーを自前で張っていない ＝ 時計は `run:progress` が 1 本だけ持っている                                                                                                                                                 |
+| **run 末尾の空転**（`background-commands.md`）                                                                                                                         | `pnpm josh rule:guard` — commit・push・PR 作成をまとめる段（`pnpm josh git -y` ／ 別名 `josh g`、`--yes` も同じ）を**前景**で出した `Bash`。`run_in_background` が付いていれば引き金に当たらない                                                                                                                                                                                                                                                                                                                                                                       | 背景で発行している ＝ 完了通知が run を再開させ、push とマージのあいだが空かない                                                                                                                                                |
+| **gate 手前の cut**（`.claude/skills/workflow-commands/pre-gate-cut.md`）                                                                                              | `pnpm josh rule:guard` — レーンの作業ツリーに居て、目印 `JOSH_LANE_CHILD` がその Issue を指し、cut 記録がまだ無いまま `pnpm josh gate`（別名 `josh ga` も同じ）を走らせる `Bash`                                                                                                                                                                                                                                                                                                                                                                                       | レーン以外の checkout に居る、目印が無い（レーン内の人）、または既に cut 済み ＝ 規則が守られている状態                                                                                                                         |
+| **実装フェーズの cut**（`.claude/skills/workflow-commands/pre-gate-cut.md` → 「It is a guard, fired at the edit that crosses the threshold」、joshuafolkken/kit#2310） | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）で cut 記録がまだ無く、直近文脈のコスト（`pnpm josh cost --cut` と同一の統計・同一のしきい値 `CONTEXT_CUT_THRESHOLD`、測定不能は `!== UNDER` で安全側に発火）が超過しているときに出した `Edit` ／ `Write`。編集の直前で拒否し `pnpm josh run:cut --impl <N> --handoff <path>` を返す。**しきい値を跨ぐたびに発火する**（`decide`、joshuafolkken/kit#2385）。直後の同じ編集の出し直しは通すので `busy` ／ `failed` でも空回りしない                                          | レーンの子でない（レーン外・目印なし・レーン内の人）、非編集ツール、既に cut 済み、またはコストがしきい値未満 ＝ 打ち切りが要らない状態                                                                                         |
+| **レーンの子の保留**（`.claude/skills/workflow-commands/pre-gate-cut.md`）                                                                                             | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）が、判断待ちの停止通知 `pnpm josh notify --task-type confirmation` を出した `Bash`                                                                                                                                                                                                                                                                                                                                                                                          | レーンの子でない（レーン外・目印なし・レーン内の人）、または停止通知でない ＝ 保留を記録すべき停止が無い                                                                                                                        |
+| **レーンの子の対話質問**（`.claude/skills/workflow-commands/pre-gate-cut.md` → 「The interactive ask is refused one call earlier」）                                   | `pnpm josh rule:guard` — 派遣されたレーンの子（目印 `JOSH_LANE_CHILD` がその Issue を指す）が `AskUserQuestion` を呼んだ呼び出し。停止通知の 1 つ手前で拒否し park 手順を返す。ハーネスは対話質問をターン終了で拒否するので、この 1 つ前が正しい引き金である。**毎回発火する**                                                                                                                                                                                                                                                                                         | レーンの子でない（レーン外・目印なし・レーン内の人）、または対話ツールでない ＝ 握りつぶされる質問が無い                                                                                                                        |
+| **テストの宣言**（`CLAUDE.md` → Code Change Rules）                                                                                                                    | `pnpm josh rule:guard` — commit・push・PR 段（`pnpm josh git -y` ／ 別名 `josh g`）を出した瞬間に `pnpm josh test:declared` が作業ツリーを `required`（テストでも機械的免除パスでもない変更ファイルがある）と読む `Bash`。`run_tail` の commit 段照合を再利用し、新しい配送経路は作らない                                                                                                                                                                                                                                                                              | 差分が `exempt`（`*.md` 等の非ランタイム）または `satisfied`（`*.test.ts` ／ `*.e2e.ts` を含む）＝ テストが要らない、または既に伴っている。免除は人が Step 0 で宣言するため 1 ラン 1 回だけ配送する                             |
+| **force push / ブランチ削除**（`operating-rules.md`、joshuafolkken/kit#2120）                                                                                          | `pnpm josh rule:guard` — `git push` / `git branch` を argv として解析し、force（`--force` ／ `-f` ／ 結合クラスタ `-uf`）・削除（`--delete` ／ `-d` ／ `-D` ／ コロン形 `:branch`）・`git -C` 前置を綴りによらず判定した `Bash`。**毎回発火する**                                                                                                                                                                                                                                                                                                                      | force / 削除でない通常の `git push` / `git branch` ＝ 破壊的操作が無い                                                                                                                                                          |
+| **認可外の作業ツリー変更**（`operating-rules.md`、joshuafolkken/kit#2120）                                                                                             | `pnpm josh rule:guard` — `git checkout -- <path>` ／ `git restore <path>`（worktree）／ 認可外の `git stash`（bare・メッセージ無し push・位置指定 pop 等）を出した `Bash`。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                                            | メッセージ付き `git stash push -m` ・`git stash list` ・`pnpm josh git` ・`pnpm josh stash:pop` ＝ 認可された退避                                                                                                               |
+| **ファイル本文をシェルに載せない**（`file-edits.md`、joshuafolkken/kit#2120）                                                                                          | `pnpm josh rule:guard` — 既存ファイルを対象としたヒアドキュメント書き込み・書き込みを伴う `node -e` ／ インタプリタ heredoc・in-place `perl -0pi -e` を出した `Bash`。既存判定は `stat` 1 回。**毎回発火する**                                                                                                                                                                                                                                                                                                                                                         | 新規ファイル作成・読み取り専用のヒアドキュメント・短い `sed -i` ＝ 本文を丸ごと運んでいない                                                                                                                                     |
+| **停止時の通知**（`CLAUDE.md` →「Mid-workflow stop notification」、joshuafolkken/kit#2121）                                                                            | `pnpm josh stop:guard` — `Stop` フックで、作業ツリーを押さえたまま（`run:hold` 記録あり）その turn に `confirmation` 通知を出さずに止まろうとする。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                                              | 押さえを持っていない、`confirmation` 通知が末尾にある、または pre-gate cut を取った回（レーンの子の自動継続）＝ 人待ちの停止ではない（`stop_hook_active` が無限ループの歯止め）                                                 |
+| **hold の解放**（`.claude/skills/workflow-commands/SKILL.md` → §2f、joshuafolkken/kit#2121）                                                                           | `pnpm josh stop:guard` — `Stop` フックで、ツリーが綺麗（`git status --porcelain` が空）なのに `run:hold` 記録が残ったまま止まる。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                                                                | ツリーが汚れている（`halfrun` の commit 前停止・`needs-human-review` 停止）、または既に解放済み ＝ 次のランが踏まない                                                                                                           |
+| **Issue 引用の書式**（`prompts/collaboration-workflow/issue-citation.md`、joshuafolkken/kit#2121・joshuafolkken/kit#2247）                                             | `pnpm josh stop:guard` — `Stop` フックで、`last_assistant_message` の地の文に裸の `#N` を含む。**停止をブロックする**（モデルに差し戻し、引用を直して返信を出し直させる）                                                                                                                                                                                                                                                                                                                                                                                              | リンク形式で引用している、コードフェンス／インラインコード／引用行の中、`PR` ／ `pull request` 直後の `#N`、または GitHub 向け成果物（`gh` 引数として渡る）、あるいは `stop_hook_active` が立っている ＝ 差し戻す裸の番号が無い |
+| **起票の申し出**（`.claude/skills/workflow-commands/SKILL.md` → §2i、joshuafolkken/kit#2422）                                                                          | `pnpm josh stop:guard` — `Stop` フックで、`last_assistant_message` の地の文が起票を申し出る（「起票してよければ」等）のに、transcript 末尾に起票（`filing_cap` の数え方）が無い。**停止をブロックする**                                                                                                                                                                                                                                                                                                                                                                | 起票済み、フェンス／引用行の中、第三者の `owner/repo` を名指す（`repo_party.classify`）、owner 不明、または `stop_hook_active` ＝ 保留された Tier A 起票が無い                                                                  |
+| **規則本文を散文に書き足す前の第 0 問・順序の問い**（`residency.md`、joshuafolkken/kit#2272・joshuafolkken/kit#2324）                                                  | `pnpm josh rule:guard` — `CLAUDE.md` ／ `prompts/**/*.md` ／ `.claude/skills/**/*.md` を対象とする `Edit` ／ `Write` で、リンク・URL を除いた正味の追記が閾値以上（規則本文の追記）。誤字・リンク張り替え・削除は当たらない。第 0 問（`oracle:list`）と順序の問い（`run:step`）を突きつける。前提を満たすまで毎回拒否する（下の「例外」）。**#2324 で stand-down** — `oracle:list` と `run:step` の両方を走らせた記録が末尾にあれば通す（リマインダではなく「問いに答えたか」で通す）                                                                                  | 規則ドキュメントを編集していない、追記が閾値未満、または両方の配置判定コマンドを実行済み ＝ 散文の規則が増えていない、または配置の問いに答え済み                                                                                |
+| **オラクル未参照の行為**（`decision-oracle.ts`、joshuafolkken/kit#2324）                                                                                               | `pnpm josh rule:guard` — 発火点を宣言したオラクルが支配する `Bash`（`pkg:scout` ＝ `pnpm add`）を、そのオラクルの `pnpm josh <command>` 無しで出したとき拒否。拒否文は登録簿（判断・コマンド・回答語彙・単一ソース）から組み立て手書きしない。実行するまで毎回拒否し、実行済みで stand-down。発火点を名指しできないオラクルは理由を宣言し**可視化された未強制**として残る（`oracle:list` が発火点／理由を印字）。`release:scope` は理由側で、`pnpm josh followup` のマージ**後**に owe されるリリースを読むためマージを gate せず trail する（joshuafolkken/kit#2334） | 支配下の行為を出していない、またはそのオラクルを実行済み ＝ 規則は既に守られている                                                                                                                                              |
 
 **引き金はシェルのコマンド文字列しか見えない。** したがって node の中から REST で Issue を作る経路（`pnpm josh propagate` など）は上の正規表現に掛からない。同じ理由で、本文をファイルで渡す `gh api --input <file>` もタイトルが文字列に現れないため掛からない（`-f` / `-F` / `--field` / `--raw-field` の 4 綴りは覆う）。**これが、規則本文を配送に移したうえで常駐側にトリガ 1 行を残す理由の 1 つである** — 常駐の 1 行は経路によらず効き、配送はそれを効く瞬間に補強する。引き金つきの配送だけにすると、正規表現が知っている綴りだけが規則の適用範囲になる。
 
@@ -95,7 +95,7 @@ WIP 上限の引き金は Issue の**作成**だけを見る。`…/issues/<N>/c
 
 **拒否文は「コメントも読め」という要求ではなく、読み直しのコマンドそのものを渡す。** 散文の要求は joshuafolkken/kit#1344 が 3 ラン連続で「数値がまったく動かなかった」と実測した形式であり、この行がそれを避けるのは、本文だけの読み取りが**通らない**ことによる。ランの次の一手はコメント込みの読み取りになり、コメントは「読むべきもの」ではなく実際に手元にある。ただし `PreToolUse` の拒否が運べるのは文字列 1 本だけなので、**フックがコメント本文を注入するわけではない** — 1 往復ぶん遅れて、ランが自分で取りに行く。
 
-**この行は `batch:guard` と引き金が重なる唯一の行である。** `time_batch_guard.is_guarded_call` は `gh issue view` を候補として扱う（`gh issue create` は扱わない）。したがって `is_first_delivery` の待避分岐は、WIP 上限では一度も発火しない不活性な保険だったが、この行で初めて実際に働く — バッチングの拒否が出るターンでは何も配送せず（記録も残さず）、再発行で配送する。`delivered-rules.test.ts` が両方向を固定している。
+**この行は `batch:guard` と引き金が重なる唯一の行である。** `time_batch_guard.is_guarded_call` は `gh issue view` を候補として扱う（`gh issue create` は扱わない）。ただしこの行は前提を満たすまで毎回拒否するので（下の「例外」）、`is_first_delivery` の待避分岐を通らず、バッチングの拒否が出るターンでも拒否する。`delivered-rules.test.ts` がこれを固定している。
 
 **判定はコマンド 1 件ごとに、行頭に錨を打って行う。** シェル 1 行は複数のコマンドを運ぶため、`&&` ／ `||` ／ `;` ／ 改行で区切った各区間をそれぞれ判定する（`|` は区切りに使わない — `--jq` の中に現れる方がはるかに多い）。これがないと 2 つの誤りが同時に出る。引用符の中に `gh issue view` を含む書き込み（`gh issue comment <N> -b "…"`）が読み取りと誤認され、逆に `gh issue view <N> && grep -c x` のように無関係な `-c` を含む行が「コメント込み」と誤認されて配送が消える。
 
@@ -117,6 +117,19 @@ WIP 上限の引き金は Issue の**作成**だけを見る。`…/issues/<N>/c
 
 **`batch:guard` との待避分岐は、そういう行では守る対象が変わる。** 1 ラン 1 回の行では**記録**を守っていた — レースに負ければ、そのランに 1 度しかない配送を無駄打ちするからである。毎回発火する行はその形では消えない。一方で待機タイマーを張る呼び出しは定義上「単発の `Bash`」であり、まさにバッチングガードも候補として扱う形なので、**拒否まで待避させると、10 秒の窓とその中の再発行で規則がまるごと黙る**。したがって**拒否は無条件に行い、待避は「記録してよいか」として行へ渡す** — 他のフックが止めうる呼び出しでしてはならないのは、走らなかったタイマーを生きていると書き残すことだからである。配送文には「これは毎回発火する」と明記する（1 回きりだと読まれると、再発行すれば通ると誤解される）。
 
+### 例外 — 前提を求める行は、前提が満たされるまで毎回拒否する（joshuafolkken/kit#2807）
+
+**`already_satisfied`（前提の行為がトランスクリプト末尾にあるか）を持つ行は、1 ラン 1 回の対象から外れる。** 前提が末尾に現れるまで、毎回拒否する。1 ラン 1 回のままだと、前提を飛ばしたランの再発行がそのまま通る。手順を読み飛ばしたランほどガードを素通りしてしまい、ガードの意味がない。対象は `issue-fold`・`issue-comments`・`rule-body`・`oracle-consulted:*` である。
+
+従うランが詰まることはない。前提の行為を済ませれば、stand-down が先に答えて通すからである。記録を使い切る心配もないので、`batch:guard` との待避もしない。待避すると、10 秒の窓の中の再発行が前提を満たさないまま通ってしまう。配送文には「前提が末尾に現れるまで拒否する」と明記する。
+
+**前提の証拠を読めないときは、拒否を基本とする。** たとえば前提の行為を確かめるための記録が読めないときがこれに当たる。意図して通す例外は、理由をコードのコメントに残す。現在の例外は次のとおりである。
+
+- トランスクリプト自体を読めないとき（`hook-decision.ts`）
+- 初回の起票で、畳み込む相手がないとき（`issue-fold.ts`）
+- 進捗の記録がないとき（`early-heartbeat.ts`）
+- git の読み取りに失敗して、変更なしとして扱うとき（`delivered-rules.ts` の `test-declared` 行）
+
 ## 本文のシェル評価は同じ機構の 1 行で覆った（joshuafolkken/kit#1198）
 
 コメント本文をシェルに載せるとバッククォートがコマンドとして実行される問題は、**この機構の追加 1 行で覆った**。起票時の見込みどおり新しい機構は要らず、`delivered-rules.ts` の `shell-body` 行と、その発火・非発火を固定するテストで足りている（実装先として書いていた joshuafolkken/kit#1542 は #1198 の重複として閉じられたため、実装は #1198 側で行った）。
@@ -136,11 +149,11 @@ WIP 上限の引き金は Issue の**作成**だけを見る。`…/issues/<N>/c
 - `scripts/rules/piped-verification-rule.test.ts` — 検証コマンドのパイプが `output-bounds.md` に単一ソースとして存在し、配送文が仕組み・逃げ道・境界の 3 つを運び、読み取り専用の一覧を巻き込んでいないこと
 - `scripts/rules/pre-gate-cut-rule.test.ts` — gate 手前の cut の手順が `.claude/skills/workflow-commands/pre-gate-cut.md` に単一ソースとして存在し、この文書と `docs/josh-commands.md` の双方が引き金を書いていること。発火・非発火（レーンかつ目印ありかつ未 cut でのみ拒否し、目印の無い人・レーン外・cut 済みでは無言）は `scripts/rules/pre-gate-cut.test.ts` が固定する
 - `scripts/rules/implementation-cut-rule.test.ts` — 実装フェーズの cut の手順が `.claude/skills/workflow-commands/pre-gate-cut.md` →「It is a guard, fired at the edit that crosses the threshold」に単一ソースとして存在し、配送文がその節・命令・再武装の契約（再開で記録を消して両ガードを再武装させること、joshuafolkken/kit#2310）を運ぶこと。発火・非発火（レーンの子かつ目印ありかつ未 cut かつしきい値超過の `Edit` ／ `Write` でのみ拒否し、レーン外・目印なし・非編集・cut 済み・しきい値未満では無言）は `scripts/rules/implementation-cut.test.ts` が固定する
-- `scripts/rules/issue-scout.test.ts` — 起票前の下調べの述語（`runs_the_scout` ／ `already_scouted`）を固定する。発火・非発火（下調べのない起票で発火し、直前に `issue:scout` があるターンでは無言、`#N` の読み取り・更新では無言）は `scripts/rules/delivered-rules.test.ts` が固定する
+- `scripts/rules/delivered-rules-filing.test.ts` — 直接起票（`gh issue create`、`…/issues` への `title` 付き POST）が毎回拒否されて `pnpm josh issue:file` を案内され、`issue:file` の呼び出し自体は拒否されないこと。起票上限と畳み込みの行が `issue:file` の呼び出しで発火し、失敗した `issue:file` 呼び出しを起票に数えないことも同じスイートが固定する
 - `scripts/rules/filing-cap.test.ts` — 起票回数の計数（拒否された起票を数に入れないこと）を固定する。発火・非発火（10 件目まで無言・11 件目で拒否・毎回発火する）は `scripts/rules/delivered-rules.test.ts` が固定する
 - `scripts/rules/lane-park-rule.test.ts` — レーンの子の保留の手順が `.claude/skills/workflow-commands/pre-gate-cut.md` に単一ソースとして存在し、配送文がその節を指すこと。発火・非発火（レーンの子かつ停止通知でのみ拒否し、レーン外・目印なし・停止通知でないときは無言）は `scripts/rules/lane-park.test.ts` が固定する
 - `scripts/rules/lane-interactive-ask-rule.test.ts` — レーンの子の対話質問の手順が `.claude/skills/workflow-commands/pre-gate-cut.md` → 「The interactive ask is refused one call earlier」に単一ソースとして存在し、配送文がその節を指すこと（joshuafolkken/kit#2201）。発火・非発火（レーンの子の `AskUserQuestion` でのみ拒否し、レーン外・目印なし・対話ツールでないときは無言）と毎回発火は `scripts/rules/lane-interactive-ask.test.ts` が、終了記録からの質問・選択肢の取り出しは `scripts/agent/interactive-ask.test.ts` が固定する
 - `scripts/rules/lane-switch-main.test.ts` — レーンの子の `git switch main`（joshuafolkken/kit#2313）を、失敗する前に拒否する述語（`switch_target` ／ `is_switch_away_from_lane`）と配送文の文言を固定する。手順の単一ソースは `.claude/skills/workflow-commands/backlogrun-lanes.md` ／ `backlogrun-child.md`。発火・非発火（レーンの子が自分のレーンブランチ以外へ切り替えるときのみ拒否し、自ブランチ・作成/デタッチ・レーン外・主チェックアウトでは無言）と毎回発火、「1 コマンドを 1 行だけが主張する」ことは同スイートが固定する
 - `scripts/rules/git-argv.test.ts` ／ `scripts/rules/git-force.test.ts` ／ `scripts/rules/worktree-guard.test.ts` ／ `scripts/rules/file-body.test.ts` — Bash 文字列の 3 群（joshuafolkken/kit#2120）の述語と配送文の文言を固定する。実際の配送経路での発火・無言と「1 コマンドを 1 行だけが主張する」ことは `scripts/rules/delivered-rules-bash.test.ts` が固定する
-- `scripts/rules/rule-body-guard.test.ts` — 規則本文を散文に書き足す `Edit` ／ `Write`（joshuafolkken/kit#2272）の述語・配送文・列挙表掲載を固定する。発火（規則ドキュメントへの追記）と無言（誤字・リンク張り替え・削除・非規則ファイル・非 Edit/Write）、および実際の配送経路での 1 ラン 1 回はこの 1 スイートが固定する。配送文が第 0 問（`oracle:list`）と順序の問い（`run:step`）を運び、単一ソースが `residency.md` であることも同じスイートが押さえる
+- `scripts/rules/rule-body-guard.test.ts` — 規則本文を散文に書き足す `Edit` ／ `Write`（joshuafolkken/kit#2272）の述語・配送文・列挙表掲載を固定する。発火（規則ドキュメントへの追記）と無言（誤字・リンク張り替え・削除・非規則ファイル・非 Edit/Write）、および実際の配送経路での「2 つのコマンドを実行するまで毎回拒否」はこの 1 スイートが固定する。配送文が第 0 問（`oracle:list`）と順序の問い（`run:step`）を運び、単一ソースが `residency.md` であることも同じスイートが押さえる
 - `scripts/rules/stop-rules-rule.test.ts` — 停止時 4 規則の単一ソース（`CLAUDE.md` の停止通知・`SKILL.md` → §2f・`SKILL.md` → §2i・`issue-citation.md`）と `rule-delivery.md` の列挙表掲載を固定する。発火・無言（押さえ×未通知でブロック／綺麗×押さえでブロック／汚れ・通知済みで無言／`stop_hook_active` で無言／起票の申し出×未起票でブロック・起票済み／第三者リポジトリ／owner 不明で無言／裸 `#N` でブロック・リンク形式やコードフェンス／インラインコード／引用行／PR 参照の中で無言）は `scripts/rules/stop-rules.test.ts`・`scripts/rules/filing-offer.test.ts`・`scripts/rules/issue-citation.test.ts` が、`Stop` フックの配線は `scripts/claude/claude-settings-hooks.test.ts` が固定する