@joshuafolkken/kit 1.978.0 → 1.998.0

package/dist/hooks/stop-guard.js

@@ -19,20 +19,22 @@ import {
   run_hold,
   run_invocation,
   run_watcher_guard
-} from "./chunk-Q7LE77CO.js";
+} from "./chunk-7WAOP42A.js";
 import {
   session_language
 } from "./chunk-6V5OPIUU.js";
 import {
   hook_decision,
   lane_child_marker
-} from "./chunk-KQG4776P.js";
+} from "./chunk-GBJUERYK.js";
 import {
   PROJECT_ROOT,
+  json_value,
   stamp_file,
   time_density_hook,
-  time_hook_transcript
-} from "./chunk-ZPLXLJ7O.js";
+  time_hook_transcript,
+  time_reported_failure
+} from "./chunk-PAXMLGSS.js";
 import "./chunk-WPALEIRX.js";
 import "./chunk-RKUAD3I6.js";
 
@@ -329,6 +331,17 @@ function bare_references(message2) {
   for (const line of prose_lines(message2)) collect_line_references(line, found);
   return [...new Set(found)];
 }
+function prompt_references(prompt) {
+  const found = /* @__PURE__ */ new Set();
+  for (const match of prompt.matchAll(ISSUE_NUMBER)) {
+    found.add(repo_prefix(prompt, match.index) + match[0]);
+  }
+  return found;
+}
+function unquoted_references(message2, prompt) {
+  const quoted = prompt_references(prompt);
+  return bare_references(message2).filter((reference) => !quoted.has(reference));
+}
 function has_bare_reference(message2) {
   return bare_references(message2).length > 0;
 }
@@ -366,7 +379,14 @@ function linkify(message2, slug) {
   }
   return out.join("\n");
 }
-var issue_citation = { bare_references, cite_arguments, has_bare_reference, linkify, prose_lines };
+var issue_citation = {
+  bare_references,
+  cite_arguments,
+  has_bare_reference,
+  linkify,
+  prose_lines,
+  unquoted_references
+};
 
 // scripts/epic/epic-triage.ts
 var TRIAGE_VERDICT = "triage";
@@ -684,6 +704,8 @@ var TASK_DEFINITIONS = {
   stalled: { icon: "\u23F3", label: "Ready work is sitting undispatched" },
   stranded: { icon: "\u{1F6A8}", label: "Run stranded \u2014 nobody is driving it" }
 };
+var NOTIFY_SWITCH_KEY = "JOSH_NOTIFY";
+var NOTIFY_OFF_VALUE = "off";
 var NOT_CONFIGURED_PREFIX = "Telegram is not configured";
 var SEND_FAILED_PREFIX = "Telegram notification failed";
 var REDACTED = "<redacted>";
@@ -720,6 +742,9 @@ function load_config() {
   }
   return { bot_token: result.data.telegram_bot_token, chat_id: result.data.telegram_chat_id };
 }
+function is_notify_disabled() {
+  return parse_environment_string(process.env[NOTIFY_SWITCH_KEY]).toLowerCase() === NOTIFY_OFF_VALUE;
+}
 function build_header(task_type, repo_name) {
   const { icon, label: label2 } = TASK_DEFINITIONS[task_type];
   if (repo_name === void 0 || repo_name.length === 0) return `${icon} ${label2}`;
@@ -767,6 +792,12 @@ function build_send_failure(error, config) {
   return new Error(`${SEND_FAILED_PREFIX}: ${reason}`, { cause: new Error(reason) });
 }
 async function send(input) {
+  if (is_notify_disabled()) {
+    console.info(
+      `\u{1F515} Telegram notifications are disabled (${NOTIFY_SWITCH_KEY}=${NOTIFY_OFF_VALUE}).`
+    );
+    return;
+  }
   const config = load_config();
   const text2 = build_text(input);
   try {
@@ -1038,8 +1069,48 @@ async function run_stall_check(ready = backlog_ready.DEFAULT_PORTS) {
 }
 var backlog_stalled_detect = { DEFAULT_PORTS: DEFAULT_PORTS2, detect_and_report, gather, report, run_stall_check };
 
-// scripts/rules/stop-rules.ts
+// scripts/rules/last-prompt.ts
 import { z as z3 } from "zod";
+var WORKFLOW_KEYWORDS = /* @__PURE__ */ new Set([
+  "kickoff",
+  "fullrun",
+  "halfrun",
+  "backlogrun"
+]);
+var NO_PROMPT = "";
+var HUMAN_ORIGIN = "human";
+var KEYWORD_BEFORE_ARGUMENT = -2;
+var PROMPT_LINE_SCHEMA = z3.object({
+  isMeta: z3.boolean().nullish(),
+  origin: z3.object({ kind: z3.string().nullish() }).nullish(),
+  message: z3.object({ content: z3.unknown() })
+});
+function is_person(line) {
+  if (line.isMeta === true) return false;
+  return line.origin === null || line.origin === void 0 || line.origin.kind === HUMAN_ORIGIN;
+}
+function person_text(line) {
+  const parsed = PROMPT_LINE_SCHEMA.safeParse(json_value.parse_or_undefined(line));
+  if (!parsed.success || !is_person(parsed.data)) return void 0;
+  return time_reported_failure.result_text(parsed.data.message.content);
+}
+function is_invocation(prompt) {
+  const words = prompt.trim().split(/\s+/u);
+  return [words.at(0), words.at(KEYWORD_BEFORE_ARGUMENT)].some(
+    (word) => WORKFLOW_KEYWORDS.has(word ?? NO_PROMPT)
+  );
+}
+function prompt_line_text(line) {
+  return filing_cap.is_prompt_line(line) ? person_text(line) : void 0;
+}
+function prompt_text(tail) {
+  const text2 = tail.split("\n").map((line) => prompt_line_text(line)).findLast((one) => one !== void 0);
+  return text2 === void 0 || is_invocation(text2) ? NO_PROMPT : text2;
+}
+var last_prompt = { prompt_text };
+
+// scripts/rules/stop-rules.ts
+import { z as z4 } from "zod";
 
 // scripts/rules/filing-offer.ts
 var OFFER_PATTERNS = [
@@ -1147,10 +1218,10 @@ var reply_language = { MIN_PROSE_LETTERS, is_mismatch, script_of };
 // scripts/rules/stop-rules.ts
 var SWITCH_ENV_KEY = "JOSH_STOP_GUARD";
 var BLOCK_DECISION = "block";
-var stop_payload_schema = z3.object({
-  transcript_path: z3.string().min(1),
-  stop_hook_active: z3.boolean().nullish(),
-  last_assistant_message: z3.string().nullish()
+var stop_payload_schema = z4.object({
+  transcript_path: z4.string().min(1),
+  stop_hook_active: z4.boolean().nullish(),
+  last_assistant_message: z4.string().nullish()
 });
 var NO_OUTCOME = { reason: void 0 };
 var STOP_NOTIFY_REASON = '\u26D4 mid-workflow stop notification: this working tree is still held by a run and no `confirmation` Telegram was sent this turn, so a person is being left to wait off-screen without knowing the run paused. `CLAUDE.md` \u2192 "Mid-workflow stop notification" requires `pnpm josh notify --task-type confirmation --issue-url "<url>" --body=$\'<reason>\'` before any mid-workflow pause. Send it, then end with a one-line confirmation that it was sent \u2014 do not repeat your previous reply. This fires only while the hold is held and no notify is on the transcript, and `stop_hook_active` lets a second stop through so a run is never wedged.';
@@ -1161,7 +1232,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'];
@@ -1199,14 +1270,14 @@ function needs_notify(context) {
 function needs_release(context) {
   return is_held_idle(context) && context.tree_clean;
 }
-function citation_reason(message2) {
-  const references = issue_citation.bare_references(message2);
+function citation_reason(context) {
+  const references = issue_citation.unquoted_references(context.message, context.prompt);
   if (references.length === 0) return void 0;
   return build_citation_reason(references);
 }
 function reply_reason(context) {
   if (needs_filing(context)) return FILING_OFFER_REASON;
-  return citation_reason(context.message) ?? language_reason(context);
+  return citation_reason(context) ?? language_reason(context);
 }
 function is_headless_held(context) {
   if (!context.headless_waiting) return false;
@@ -1302,7 +1373,7 @@ var run_stranded = {
 };
 
 // scripts/run/run-wake.ts
-import { z as z4 } from "zod";
+import { z as z5 } from "zod";
 var WAKE_PREFIX = "josh-run-wake-";
 var WAKE_LOG_PREFIX = "josh-run-wake-log-";
 var WAKE_LOG_SUFFIX = ".log";
@@ -1322,21 +1393,21 @@ var STOP_REASONS = {
   expired: "expired",
   unreadable: "unreadable"
 };
-var run_wake_schema = z4.object({
-  invocation: z4.string(),
-  started_at: z4.string(),
-  pid: z4.number(),
-  process_start: z4.string().optional(),
-  woke: z4.number(),
-  woke_at: z4.string().optional(),
+var run_wake_schema = z5.object({
+  invocation: z5.string(),
+  started_at: z5.string(),
+  pid: z5.number(),
+  process_start: z5.string().optional(),
+  woke: z5.number(),
+  woke_at: z5.string().optional(),
   // **Every optional field of `RunWake` has to be listed here.** `z.object` strips what it does not
   // declare, so a field added to the interface alone round-trips through disk as `undefined` — which
   // reads as "no attempt has been made yet" and would restart the retry count on every pass.
-  attempts: z4.number().optional(),
-  woke_pid: z4.number().optional(),
-  held_at: z4.string().optional(),
-  spawned: z4.array(z4.string()).optional(),
-  idle_since: z4.string().optional(),
+  attempts: z5.number().optional(),
+  woke_pid: z5.number().optional(),
+  held_at: z5.string().optional(),
+  spawned: z5.array(z5.string()).optional(),
+  idle_since: z5.string().optional(),
   profile: agent_role_profile.PROFILE_SCHEMA.optional()
 });
 function is_overdue(marked_at, now, limit_ms = WAKE_GRACE_MS) {
@@ -1585,6 +1656,7 @@ async function build_context(transcript_path, payload_tail) {
     tree_clean: !await run_hold.is_tree_dirty(),
     notified: lane_park.mentions_confirmation_notify(tail),
     message: payload_tail.message,
+    prompt: last_prompt.prompt_text(tail),
     stop_hook_active: payload_tail.stop_hook_active,
     cut_pending: run_cut.carried_cut_sync() !== void 0,
     filed: was_filed(tail),

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"]
+    ]
   }
 };
 
@@ -859,7 +869,7 @@ var DEV_COMMANDS = {
   },
   lint: {
     script: "scripts/lint/lint-parallel.ts",
-    description: "Check code with prettier and eslint (skips a tool a static project lacks)",
+    description: "Check code with prettier and eslint (skips a tool a basic project lacks)",
     category: "Development",
     reference: ["", "developer", ["processes"]]
   },
@@ -895,7 +905,7 @@ var DEV_COMMANDS = {
   },
   format: {
     script: "scripts/lint/format.ts",
-    description: "Format code with prettier and eslint (skips a tool a static project lacks)",
+    description: "Format code with prettier and eslint (skips a tool a basic project lacks)",
     category: "Development",
     reference: ["", "developer", ["files", "processes"]]
   },
@@ -1008,7 +1018,7 @@ var DEV_COMMANDS = {
   },
   check: {
     script: "scripts/gate/type-check-command.ts",
-    description: "Type-check with tsc (skips a static project with no TypeScript to check)",
+    description: "Type-check with tsc (skips a basic project with no TypeScript to check)",
     category: "Development",
     reference: ["[arguments...]", "developer", ["processes"]]
   },
@@ -1163,7 +1173,7 @@ var MAINTENANCE_COMMANDS = {
 };
 
 // scripts/josh/josh-commands-project.ts
-var PROFILE_ARGUMENTS = "[--profile static|node]";
+var PROFILE_ARGUMENTS = "[--profile basic|full]";
 var PROJECT_COMMANDS = {
   profile: {
     script: "scripts/init/project-profile-cli.ts",
@@ -1173,7 +1183,7 @@ var PROJECT_COMMANDS = {
   },
   start: {
     script: "scripts/init/start.ts",
-    description: "Create a new project for the GitHub Issue workflow, from git init to labels",
+    description: "Set a project up for the GitHub Issue workflow, from git init to the setup PR",
     category: "Project",
     reference: [
       `${PROFILE_ARGUMENTS} [--yes] [--github] [--public]`,
@@ -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.998.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": [
@@ -97,6 +97,10 @@
       "types": "./prettier/index.d.ts",
       "default": "./prettier/index.js"
     },
+    "./prettier/basic": {
+      "types": "./prettier/basic.d.ts",
+      "default": "./prettier/basic.js"
+    },
     "./prettier/static": {
       "types": "./prettier/static.d.ts",
       "default": "./prettier/static.js"

package/prettier/basic.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from 'prettier'
+
+export const config: Config

package/prettier/basic.js

@@ -0,0 +1,10 @@
+export const config = {
+	useTabs: true,
+	singleQuote: true,
+	trailingComma: 'all',
+	printWidth: 100,
+	semi: false,
+	arrowParens: 'always',
+	bracketSpacing: true,
+	endOfLine: 'lf',
+}

package/prettier/index.js

@@ -1,7 +1,7 @@
-import { config as static_config } from './static.js'
+import { config as basic_config } from './basic.js'
 
 export const config = {
-	...static_config,
+	...basic_config,
 	plugins: [
 		'@ianvs/prettier-plugin-sort-imports',
 		'prettier-plugin-svelte',

package/prettier/static.js

@@ -1,10 +1,3 @@
-export const config = {
-	useTabs: true,
-	singleQuote: true,
-	trailingComma: 'all',
-	printWidth: 100,
-	semi: false,
-	arrowParens: 'always',
-	bracketSpacing: true,
-	endOfLine: 'lf',
-}
+// The basic profile's preset under the name it had before joshuafolkken/kit#2829. A project
+// initialized earlier imports this path from its `prettier.config.mjs`, so it stays exported.
+export { config } from './basic.js'

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`）