@joshuafolkken/kit 1.883.0 → 1.921.0

package/dist/josh.js

@@ -155,8 +155,8 @@ var doctor_consumer = {
 };
 
 // scripts/josh/josh-logic.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
-import path3 from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import path4 from "node:path";
 import { fileURLToPath } from "node:url";
 
 // scripts/build/local-bin.ts
@@ -225,7 +225,7 @@ function resolve_package_bin(base_directory, package_name, bin_name) {
 }
 
 // scripts/josh/josh-logic.ts
-import { execaSync as execaSync2 } from "execa";
+import { execaSync as execaSync3 } from "execa";
 
 // scripts/josh/command-suggest.ts
 var MAX_SUGGESTION_DISTANCE = 3;
@@ -841,6 +841,12 @@ var FILTER_ARGUMENTS = "[filters...]";
 var MATCH_ARGUMENTS = "[--match]";
 var PATH_ARGUMENTS = "<path...>";
 var DEV_COMMANDS = {
+  "pr:classification": {
+    script: "scripts/ci/pr-classification.ts",
+    description: "Require one release classification on a pull request",
+    category: "Development",
+    reference: ["", "automation", ["none"]]
+  },
   [GATE_COMMAND]: {
     script: "scripts/gate/verification-gate.ts",
     description: "Run lint, type check, spell check and unit tests concurrently",
@@ -1160,12 +1166,25 @@ var MAINTENANCE_COMMANDS = {
 };
 
 // scripts/josh/josh-commands-project.ts
+var PROFILE_ARGUMENTS = "[--profile static|node]";
 var PROJECT_COMMANDS = {
+  profile: {
+    script: "scripts/init/project-profile-cli.ts",
+    description: "Show the project profile and the reason for it",
+    category: "Project",
+    reference: [PROFILE_ARGUMENTS, "developer", ["files"]]
+  },
+  start: {
+    script: "scripts/init/start.ts",
+    description: "Initialize a project for the GitHub Issue workflow",
+    category: "Project",
+    reference: [PROFILE_ARGUMENTS, "developer", ["files", "git", "network"]]
+  },
   init: {
     script: "scripts/init/init.ts",
     description: "Initialize config in a new project",
     category: "Project",
-    reference: ["", "developer", ["files", "processes"]]
+    reference: [PROFILE_ARGUMENTS, "developer", ["files", "processes"]]
   },
   sync: {
     script: "scripts/sync/sync.ts",
@@ -1408,11 +1427,14 @@ var ALIASES = {
   c: "check",
   pt: "port",
   i: "init",
+  pf: "profile",
+  st: "start",
   sy: "sync",
   rmi: "registry:migrate",
   sys: "sync:scope",
   g: "git",
   gp: "pr",
+  prc: "pr:classification",
   fu: "followup",
   nf: "notify",
   obf: "observations:flush",
@@ -1608,6 +1630,118 @@ var kit_only = {
   notice: kit_only_notice
 };
 
+// scripts/josh/run-github-prerequisite.ts
+import { existsSync as existsSync3 } from "node:fs";
+import path3 from "node:path";
+
+// scripts/discovery/repo-origin.ts
+var GITHUB_HOST = "github.com";
+var SSH_ALIAS_PATTERN = /^github(?:-\w+)*$/u;
+var GIT_SUFFIX = ".git";
+var PATH_SEPARATOR2 = "/";
+var USER_SEPARATOR = "@";
+var HOST_SEPARATOR = ":";
+var OWNER_INDEX = 0;
+var REPO_INDEX = 1;
+var REPO_PATH_SEGMENTS = 2;
+var NOT_FOUND = -1;
+var SECTION_PREFIX = "[";
+var ORIGIN_SECTION = /^\[remote\s+"origin"\]$/u;
+var URL_KEY = "url";
+function is_github_hostname(host) {
+  return host.toLowerCase() === GITHUB_HOST;
+}
+function is_github_ssh_host(host) {
+  const normalized = host.toLowerCase();
+  return is_github_hostname(normalized) || SSH_ALIAS_PATTERN.test(normalized);
+}
+function strip_git_suffix(name) {
+  return name.endsWith(GIT_SUFFIX) ? name.slice(0, -GIT_SUFFIX.length) : name;
+}
+function to_identity(repository_path) {
+  const segments = repository_path.split(PATH_SEPARATOR2).filter((segment) => segment !== "");
+  if (segments.length !== REPO_PATH_SEGMENTS) return void 0;
+  const owner = segments[OWNER_INDEX] ?? "";
+  const repo = strip_git_suffix(segments[REPO_INDEX] ?? "");
+  return repo === "" ? void 0 : { owner, repo };
+}
+function parse_scp_like(url) {
+  const user_end = url.indexOf(USER_SEPARATOR);
+  const authority = user_end === NOT_FOUND ? url : url.slice(user_end + 1);
+  const host_end = authority.indexOf(HOST_SEPARATOR);
+  if (host_end === NOT_FOUND) return void 0;
+  if (!is_github_ssh_host(authority.slice(0, host_end))) return void 0;
+  return to_identity(authority.slice(host_end + 1));
+}
+function parse_url_like(url) {
+  try {
+    const parsed = new URL(url);
+    return is_github_hostname(parsed.hostname) ? to_identity(parsed.pathname) : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parse_origin_url(url) {
+  const trimmed = url.trim();
+  if (trimmed === "") return void 0;
+  return parse_url_like(trimmed) ?? parse_scp_like(trimmed);
+}
+function is_section_header(line) {
+  return line.startsWith(SECTION_PREFIX);
+}
+function origin_section_lines(lines) {
+  const start = lines.findIndex((line) => ORIGIN_SECTION.test(line));
+  if (start === NOT_FOUND) return [];
+  const rest = lines.slice(start + 1);
+  const end = rest.findIndex((line) => is_section_header(line));
+  return end === NOT_FOUND ? rest : rest.slice(0, end);
+}
+function entry_value(line, key) {
+  const separator = line.indexOf("=");
+  if (separator === NOT_FOUND) return void 0;
+  if (line.slice(0, separator).trim() !== key) return void 0;
+  return line.slice(separator + 1).trim();
+}
+function parse_origin_from_config(content) {
+  const lines = content.split("\n").map((line) => line.trim());
+  return origin_section_lines(lines).map((line) => entry_value(line, URL_KEY)).find((url) => url !== void 0);
+}
+function format_identity(identity) {
+  return `${identity.owner}${PATH_SEPARATOR2}${identity.repo}`.toLowerCase();
+}
+var repo_origin = {
+  GITHUB_HOST,
+  is_github_hostname,
+  is_github_ssh_host,
+  parse_origin_from_config,
+  parse_origin_url,
+  format_identity
+};
+
+// scripts/josh/run-github-prerequisite.ts
+import { execaSync as execaSync2 } from "execa";
+var GITHUB_RUN_COMMANDS = /* @__PURE__ */ new Set([
+  "run:entry",
+  "run:prep",
+  "run:next",
+  "run:step",
+  "run:merge",
+  "run:tail"
+]);
+function explanation(root, command) {
+  if (!GITHUB_RUN_COMMANDS.has(command)) return void 0;
+  if (!existsSync3(path3.join(root, ".git"))) {
+    return `${command} requires Git and a GitHub origin. Run git init and add a GitHub origin first.`;
+  }
+  const result = execaSync2("git", ["config", "--get", "remote.origin.url"], {
+    cwd: root,
+    reject: false
+  });
+  if (result.exitCode === 0 && repo_origin.parse_origin_url(result.stdout)) return void 0;
+  return `${command} requires a GitHub origin. Add an origin pointing to GitHub first.`;
+}
+var run_github_prerequisite = { explanation };
+
 // scripts/josh/josh-logic.ts
 var COLUMN_WIDTH = 26;
 var ALIAS_PAD_WIDTH = 2;
@@ -1617,20 +1751,20 @@ var PACKAGE_JSON2 = "package.json";
 var UNKNOWN_COMMAND_EXIT_CODE = -1;
 function find_package_directory(start_directory) {
   let current = start_directory;
-  while (!existsSync3(path3.join(current, PACKAGE_JSON2))) {
-    const parent = path3.dirname(current);
+  while (!existsSync4(path4.join(current, PACKAGE_JSON2))) {
+    const parent = path4.dirname(current);
     if (parent === current) return start_directory;
     current = parent;
   }
   return current;
 }
-var PACKAGE_DIR = find_package_directory(path3.dirname(fileURLToPath(import.meta.url)));
+var PACKAGE_DIR = find_package_directory(path4.dirname(fileURLToPath(import.meta.url)));
 function resolve_tsx_executable() {
   const candidates = [
     resolve_local_bin(PACKAGE_DIR, TSX_BIN),
     resolve_local_bin(process.cwd(), TSX_BIN)
   ];
-  return candidates.find(existsSync3) ?? TSX_BIN;
+  return candidates.find(existsSync4) ?? TSX_BIN;
 }
 function resolve_tsx_cli_entry() {
   for (const base_directory of [PACKAGE_DIR, process.cwd()]) {
@@ -1647,7 +1781,7 @@ function resolve_tsx_runner() {
   return { executable: resolve_tsx_executable(), leading_arguments: [] };
 }
 function read_package_version() {
-  const raw = readFileSync3(path3.join(PACKAGE_DIR, PACKAGE_JSON2), "utf8");
+  const raw = readFileSync3(path4.join(PACKAGE_DIR, PACKAGE_JSON2), "utf8");
   return package_version_schema.parse(JSON.parse(raw)).version;
 }
 var HEADER = `josh v${read_package_version()} \u2014 Joshua Folkken's dev toolkit`;
@@ -1706,7 +1840,7 @@ function should_use_shell(executable) {
   return process.platform === "win32" && executable !== process.execPath;
 }
 function spawn_script(tsx_executable, script_arguments) {
-  const result = execaSync2(tsx_executable, script_arguments, {
+  const result = execaSync3(tsx_executable, script_arguments, {
     stdio: "inherit",
     shell: should_use_shell(tsx_executable),
     reject: false
@@ -1715,7 +1849,7 @@ function spawn_script(tsx_executable, script_arguments) {
 }
 function run_shell_command(shell, extra) {
   const [executable = "", ...rest_arguments] = shell;
-  const result = execaSync2(executable, [...rest_arguments, ...extra], {
+  const result = execaSync3(executable, [...rest_arguments, ...extra], {
     stdio: "inherit",
     reject: false
   });
@@ -1731,18 +1865,27 @@ function spawn_script_entry(entry, script_path, script_arguments) {
   ]);
 }
 async function run_script_entry(entry, subcommand_arguments) {
-  const script_path = path3.join(PACKAGE_DIR, entry.script ?? "");
+  const script_path = path4.join(PACKAGE_DIR, entry.script ?? "");
   const script_arguments = [...entry.default_script_arguments ?? [], ...subcommand_arguments];
   if (josh_in_process.can_run_in_process(entry, import.meta.url)) {
     return await josh_in_process.run_in_process(script_path, script_arguments);
   }
   return spawn_script_entry(entry, script_path, script_arguments);
 }
+function github_prerequisite_exit(resolved, is_consumer) {
+  if (!is_consumer) return void 0;
+  const prerequisite = run_github_prerequisite.explanation(process.cwd(), resolved);
+  if (prerequisite === void 0) return void 0;
+  console.error(prerequisite);
+  return USAGE_ERROR_EXIT_CODE;
+}
 function pre_dispatch_exit(resolved, entry, subcommand_arguments, is_consumer) {
   if (is_consumer && kit_only.is_kit_only(entry)) {
     console.error(kit_only.notice(resolved));
     return USAGE_ERROR_EXIT_CODE;
   }
+  const prerequisite_exit = github_prerequisite_exit(resolved, is_consumer);
+  if (prerequisite_exit !== void 0) return prerequisite_exit;
   const rejection = composite_arguments.reject_extra_arguments(
     resolved,
     entry,

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.883.0",
+  "version": "1.921.0",
   "name": "@joshuafolkken/kit",
   "type": "module",
   "license": "MIT",
@@ -82,6 +82,10 @@
       "types": "./prettier/index.d.ts",
       "default": "./prettier/index.js"
     },
+    "./prettier/static": {
+      "types": "./prettier/static.d.ts",
+      "default": "./prettier/static.js"
+    },
     "./tsconfig/base": {
       "types": "./tsconfig/base.json",
       "default": "./tsconfig/base.json"
@@ -106,56 +110,103 @@
   },
   "peerDependencies": {
     "@playwright/test": ">=1.0.0",
-    "eslint": ">=9.18.0",
-    "svelte": ">=5.0.0"
+    "@eslint/compat": "^2.1.1",
+    "@eslint/js": "^10.0.1",
+    "@stylistic/eslint-plugin": "^5.10.0",
+    "eslint": "^10.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-promise": "^7.3.0",
+    "eslint-plugin-sonarjs": "^4.2.1",
+    "eslint-plugin-unicorn": "^76.0.0",
+    "globals": "^17.12.0",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.70.1"
   },
   "peerDependenciesMeta": {
     "@playwright/test": {
       "optional": true
     },
-    "svelte": {
+    "@eslint/compat": {
+      "optional": true
+    },
+    "@eslint/js": {
+      "optional": true
+    },
+    "@stylistic/eslint-plugin": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    },
+    "eslint-config-prettier": {
+      "optional": true
+    },
+    "eslint-import-resolver-typescript": {
+      "optional": true
+    },
+    "eslint-plugin-import-x": {
+      "optional": true
+    },
+    "eslint-plugin-promise": {
+      "optional": true
+    },
+    "eslint-plugin-sonarjs": {
+      "optional": true
+    },
+    "eslint-plugin-unicorn": {
+      "optional": true
+    },
+    "globals": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    },
+    "typescript-eslint": {
       "optional": true
     }
   },
   "devDependencies": {
     "@actions/expressions": "^0.3.61",
+    "@eslint/compat": "^2.1.1",
+    "@eslint/js": "^10.0.1",
     "@ianvs/prettier-plugin-sort-imports": "^4.7.1",
-    "@secretlint/secretlint-rule-preset-recommend": "^13.0.5",
+    "@secretlint/secretlint-rule-preset-recommend": "^13.0.6",
+    "@stylistic/eslint-plugin": "^5.10.0",
     "@types/node": "^26.6.3",
     "@types/semver": "^7.8.0",
     "cspell": "^10.3.4",
     "esbuild": "^0.28.2",
     "eslint": "^10.11.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.17.1",
+    "eslint-plugin-promise": "^7.3.0",
+    "eslint-plugin-sonarjs": "^4.2.1",
+    "eslint-plugin-unicorn": "^76.0.0",
+    "eslint_d": "^15.0.3",
+    "globals": "^17.12.0",
     "lefthook": "^2.1.14",
     "prettier": "^3.9.9",
     "prettier-plugin-svelte": "^4.1.1",
     "prettier-plugin-tailwindcss": "^0.8.1",
     "rollup": "^4.63.5",
     "rollup-plugin-dts": "^6.5.1",
-    "secretlint": "^13.0.5",
+    "secretlint": "^13.0.6",
     "typescript": "^6.0.3",
-    "vitest": "^5.0.1"
+    "vitest": "^5.0.2",
+    "typescript-eslint": "^8.70.1"
   },
   "dependencies": {
-    "@eslint/compat": "^2.1.1",
-    "@eslint/js": "^10.0.1",
-    "@stylistic/eslint-plugin": "^5.10.0",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-typescript": "^4.4.5",
-    "eslint-plugin-import-x": "^4.17.1",
-    "eslint-plugin-promise": "^7.3.0",
-    "eslint-plugin-sonarjs": "^4.2.1",
-    "eslint-plugin-unicorn": "^76.0.0",
-    "eslint_d": "^15.0.3",
     "execa": "^10.0.1",
-    "globals": "^17.12.0",
     "js-yaml": "^5.4.2",
     "jsonc-parser": "^3.3.1",
     "ora": "^9.4.1",
     "semver": "^7.8.5",
     "strip-json-comments": "^5.0.3",
     "tsx": "^4.23.15",
-    "typescript-eslint": "^8.70.1",
     "zod": "^4.6.5"
   },
   "devEngines": {

package/prettier/index.js

@@ -1,12 +1,7 @@
+import { config as static_config } from './static.js'
+
 export const config = {
-	useTabs: true,
-	singleQuote: true,
-	trailingComma: 'all',
-	printWidth: 100,
-	semi: false,
-	arrowParens: 'always',
-	bracketSpacing: true,
-	endOfLine: 'lf',
+	...static_config,
 	plugins: [
 		'@ianvs/prettier-plugin-sort-imports',
 		'prettier-plugin-svelte',

package/prettier/static.d.ts

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

package/prettier/static.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/prompts/collaboration-workflow/issue-template.md

@@ -13,6 +13,8 @@ Issue には次の要素を必ず含める。
 ````md
 ## 背景
 
+<不具合なら `- 種別: 不具合`、そうでなければ `- 種別: 非不具合` を宣言する>
+
 <なぜ必要か>
 
 ## 現象
@@ -57,7 +59,7 @@ Issue には次の要素を必ず含める。
 
 **AI の振る舞いを変えると主張する Issue は、`## 発火点` と `## ベースライン` と `## 再現` の 3 見出しを必ず含める。** 散文の規則は「配って終わり」になりやすく、効いたかどうかがマージ後に読み直されないためである（joshuafolkken/kit#2178）。読みだけを根拠にした起票（既に直った現象の起票・壊れたままの現象の誤読）を防ぐため、再現の実測も課す（joshuafolkken/kit#2353）。
 
-- **対象かどうかは本文の宣言から読み、判断させない。** 本文に `- 種別: 振る舞い変更` の行がある Issue だけが対象で、コードだけを変える Issue（`- 種別: コードのみ`、または宣言なし）には 3 見出しを課さない。宣言は `## 背景` の直下に置く
+- **対象かどうかは本文の宣言から読み、判断させない。** 本文に `- 種別: 振る舞い変更` の行がある Issue だけが対象で、コードだけを変える Issue（`- 種別: コードのみ`、または振る舞い変更の宣言なし）には 3 見出しを課さない。宣言は `## 背景` の直下に置く
 
   ```md
   ## 背景
@@ -67,11 +69,16 @@ Issue には次の要素を必ず含める。
   <なぜ必要か>
   ```
 
-- **不具合修正の Issue は `- 種別: 不具合` を宣言する。** 同じ位置（`## 背景` の直下）に置く。この宣言がある Issue では、`pnpm josh git -y` が追加・変更したテストを修正前のツリー（merge-base）に当てて `pnpm josh test:red` で実行し、1 本も赤にならない（`green`）ときはコミットを拒否する。修正前でも緑の回帰テストは、報告された症状を再現していないためである（joshuafolkken/kit#2448）。回帰テストは、利用者が症状を見たのと同じ粒度で書く
+- **起票前に不具合かどうかを必ず選ぶ。** `## 背景` の直下に、不具合なら `- 種別: 不具合`、非不具合なら `- 種別: 非不具合` を置く。両方の併記も省略も `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 のリリース分類を区別する
 - **`## 発火点`** には、その規則が破れる瞬間に最初に呼ばれるツールコール名を 1 つ書く。名前は `prompts/collaboration-workflow/rule-delivery.md` の配送表に載る、フックで配送可能なツール（`Bash` / `Edit` / `Read` / `Write` / `AskUserQuestion`）と突き合わせる。**表に無い名前**（そもそもツールコール名でない）と**不一致**（既知のツールだが配送できない）は区別して印字され、joshuafolkken/kit#2201 の「規則は正しいが名指ししたコールが実際に破れるコールの 1 つ後ろ」を起票時に検出する
 - **`## ベースライン`** は **「コマンド + 値」** で書く。``- `<測定コマンド>` → <現在の値>`` の形に限り、自然文だけの測定説明は受け付けない（再実行できないため）。マージ後に `pnpm josh measure:rerun` が同じコマンドをやり直し、**before / after の対**を印字する。値が動かなかったとき、反証された前提として `docs/observations.md` に 1 行追記される（既存の append-only 台帳をそのまま使い、第 2 の台帳は作らない）
 - **`## 再現`** は **「コマンド + 実際の出力」** で書く。コマンドを backtick、出力をフェンス（``` または ~~~）で囲む。自然文の「確認した」は再実行できないため受け付けない（`## ベースライン` と同じ理由）。読みだけの起票を起票時に弾くためである
-- **検査は `pnpm josh issue:lint <path>` が行う。** 対象判定・3 見出しの有無・発火点の配送可否・ベースラインが「コマンド + 値」か・再現が「コマンド + 実際の出力」かを、起票前の本文ファイルにまとめて検査する（未リントの起票は `pnpm josh rule:guard` が拒否する）
+- **検査は `pnpm josh issue:lint <path>` が行う。** 対象判定・3 見出しの有無・発火点の配送可否・ベースラインが「コマンド + 値」か・再現が「コマンド + 実際の出力」かと、起票時に必要な分類ラベルを、起票前の本文ファイルからまとめて答える（未リントの起票は `pnpm josh rule:guard` が拒否する）
 
 ### 起票元へのバックリンク（`## Origin` / `## Upstream issues`）
 
@@ -130,7 +137,7 @@ pnpm josh epic "<epic-title>" <N1> <N2> --origin <owner/repo#N>
 
 1. 子 Issue を全て作成し、番号 `<N1> <N2> ...` を控える
 2. `epic` ラベルを用意する（未作成なら `gh api repos/{owner}/{repo}/labels -f name=epic -f color=5319e7 -f description="Tracks a batch of child issues from one split" --silent 2>/dev/null || true`）
-3. epic を作成し、番号 `<E>` を控える: `gh api repos/{owner}/{repo}/issues -f title="<epic-title>" -f 'labels[]=epic' -f body="<body>" --jq .number`（`--jq` を落とすと Issue の JSON 全体が出る。そこには `id` も含まれるが、**控えるのは `number` である** — `id` はデータベース id で、手順 4 が要求する値ではあっても epic の番号ではない）
+3. epic を作成し、番号 `<E>` を控える: `gh api repos/{owner}/{repo}/issues -f title="<epic-title>" -f 'labels[]=epic' -F body=@<body-file> --jq .number`（`--jq` を落とすと Issue の JSON 全体が出る。そこには `id` も含まれるが、**控えるのは `number` である** — `id` はデータベース id で、手順 4 が要求する値ではあっても epic の番号ではない）
 4. 実行順序が**ある場合のみ**、子 Issue に依存関係を付与する（後述の理由により**作成後の独立ステップ**として行う）:
 
    ```bash

package/prompts/collaboration-workflow/upstream-interrupt.md

@@ -16,7 +16,7 @@
 
 1. **現在の作業を退避する**: `git stash push -u -m "upstream-interrupt: paused #<N>"`（WIP コミットでも可）。退避したことを忘れないよう、この時点で stash を作る。メッセージ付きで積むのは、復元をメッセージで特定するため（下記ステップ 5）
 2. **進行中の Issue に状況を明記する**: `pnpm josh issue:comment <N> --body-file <path>` で、(a) 作業を stash したこと、(b) 中断理由（どの別パッケージの・どんな問題で中断したか）、(c) 対象パッケージに作成した新 Issue へのリンクを `## Upstream issues` 見出しの下に `owner/repo#N` 形式で、を記載する。これにより「なぜこの Issue が一時停止しているか」と「何を待っているのか」が後から監査できる（→「起票元へのバックリンク」）
-3. **対象パッケージのリポジトリに新しい Issue を作成する（確認なし）**: `gh api repos/<owner>/<repo>/issues -f title="<root-cause title>" -f 'labels[]=route:tier-a' -f 'labels[]=depth:<n>' -f body="<root cause and context>"`（`route:tier-a` は実装中の Tier A 起票を経路として集計するためのラベル — joshuafolkken/kit#1083。付与するのは first-party の場合だけで、third-party はそもそもこの手順に到達せず起票しない）。根本原因・再現・期待結果を Step 1 のテンプレに沿って記載し、**本文に `## Origin` 節を置いて起票元 Issue を `owner/repo#N` 形式で書く**（→「起票元へのバックリンク」）。上流 Issue は欠陥を、起票元 Issue は証拠を持つため、リンクがないと上流 Issue は後から解釈できなくなる。ここで「起票してよいか」を尋ねて停止してはならない。**ただし確認なしで起票してよいのは対象が first-party のときだけ**で、third-party（owner が自リポジトリと一致しないリポジトリ）なら起票せずに停止する（→「第三者リポジトリへの書き込みは Tier C（明示指示が必要）」）
+3. **対象パッケージのリポジトリに新しい Issue を作成する（確認なし）**: `gh api repos/<owner>/<repo>/issues -f title="<root-cause title>" -f 'labels[]=route:tier-a' -f 'labels[]=depth:<n>' -F body=@<body-file>`（`route:tier-a` は実装中の Tier A 起票を経路として集計するためのラベル — joshuafolkken/kit#1083。付与するのは first-party の場合だけで、third-party はそもそもこの手順に到達せず起票しない）。起票前に `pnpm josh issue:lint <body-file>` を実行し、`labels:` に列挙された分類ラベルをすべて同じ作成呼び出しに付ける。分類の単一ソースは `prompts/collaboration-workflow/issue-template.md`。根本原因・再現・期待結果を Step 1 のテンプレに沿って記載し、**本文に `## Origin` 節を置いて起票元 Issue を `owner/repo#N` 形式で書く**（→「起票元へのバックリンク」）。上流 Issue は欠陥を、起票元 Issue は証拠を持つため、リンクがないと上流 Issue は後から解釈できなくなる。ここで「起票してよいか」を尋ねて停止してはならない。**ただし確認なしで起票してよいのは対象が first-party のときだけ**で、third-party（owner が自リポジトリと一致しないリポジトリ）なら起票せずに停止する（→「第三者リポジトリへの書き込みは Tier C（明示指示が必要）」）
 4. **`confirmation` Telegram を送って停止する**: 上流 Issue の URL と、何が止まっているかを本文に書く（→「確認待ちで停止するときの Telegram 通知（`confirmation`）」）。無人実行でも画面外でユーザーが気付ける。停止は Issue が既に存在する状態で行うので、ユーザーは「待つ / 先送りする」を Issue を見ながら 1 語で答えられる
 5. **元の作業を再開する**: 上流の修正がマージされた、または**ユーザーが先送りを明示判断した**後に `pnpm josh stash:pop "upstream-interrupt: paused #<N>"`（位置指定や引数なしの `git stash pop` は使わない — stash は全 work tree が共有する 1 本のスタックで、別のレーンの stash を取り込む恐れがある）して、退避していた元タスクを続行する。上流 Issue を割り込みで実装するかどうかもユーザーの判断（上流パッケージの実装・PR・マージはそれぞれのワークフロー規則に従う）
 

package/prompts/collaboration-workflow/wip-cap.md

@@ -69,10 +69,10 @@ gh api "repos/{owner}/{repo}/issues?state=open&per_page=100" --paginate \
 
 #### 該当したときの手順
 
-1. **上限に関係なく起票する。** 1 件閉じることを条件にしない。
+1. **上限に関係なく起票する。** 1 件閉じることを条件にしない。起票前に `pnpm josh issue:lint <body-file>` を実行し、その `labels:` に列挙された分類ラベルをすべて同じ作成呼び出しに付ける。`prompts/collaboration-workflow/issue-template.md` の手順に従う。
 
    ```bash
-   gh api repos/{owner}/{repo}/issues -f title="<title>" -f 'labels[]=route:interrupt' -f 'labels[]=depth:<n>' -f body="<body>"
+   gh api repos/{owner}/{repo}/issues -f title="<title>" -f 'labels[]=route:interrupt' -f 'labels[]=depth:<n>' -F body=@<body-file>
    ```
 
 2. **超過している事実と、当たった条件の番号を本文に 1 行書く**（例:「オープン 37 件で起票。3 条件のうち 2（文書化された手順が完了できない）に該当」）。**どちらか一方では足りない** — 件数だけでは判定が再現できず、条件だけでは上限の可視化が効かない。

package/prompts/review.md

@@ -194,8 +194,8 @@ Only branch 2 files an Issue. What follows applies to that branch.
   two questions decide the filing-time fold"). `pnpm josh rule:guard` refuses the second `gh api …
 issues` call until it is folded; the first filing asks nothing.
 
-  1. File the follow-up Issue referencing the current one, tagged `route:review-cap`:
-     `gh api repos/{owner}/{repo}/issues -f title="<title>" -f 'labels[]=route:review-cap' -f 'labels[]=depth:<n>' -f body="<body referencing the current Issue>"`.
+  1. File the follow-up Issue referencing the current one, tagged `route:review-cap`. Run `pnpm josh issue:lint <body-file>` first and apply every label in its `labels:` answer at creation, following `prompts/collaboration-workflow/issue-template.md`:
+     `gh api repos/{owner}/{repo}/issues -f title="<title>" -f 'labels[]=route:review-cap' -f 'labels[]=depth:<n>' -F body=@<body-file>`.
   2. Run `pnpm josh epic:bundle <new>` — **before the current Issue closes.** The candidate search reads
      open issues only, so once the parent has closed the command answers `none` permanently.
   3. Act on its answer. **`epic:bundle` recommends and writes nothing**, so acting means running the

package/prompts/testing-guide.md

@@ -23,6 +23,7 @@ Req N: ...
 
 - **Every user-facing behavior change** (UI interaction, keyboard shortcut, visible state change) must have a corresponding E2E test.
 - **Every logic/utility change** (pure functions, filters, transforms) must have a unit test.
+- **static の HTML/CSS だけの変更:** `package.json` に `josh.profile: static` が記録されていれば自動テストは不要。ブラウザーで対象ページを開き、想定する画面幅でレイアウト・リンク・HTML 内の操作を確認して結果を記録する。同じ変更に JavaScript または TypeScript のファイルが含まれれば自動テストを行う。
 - If a test is genuinely infeasible (e.g., native OS date-picker popup cannot be driven by Playwright), write a comment in the test file explaining why and test the closest observable behavior instead (e.g., that the editor remains open after the `change` event fires).
 - Do **not** report a requirement as done if its test is missing.
 

package/scripts/build/build-claude-md.ts

@@ -6,8 +6,12 @@ import { init_logic } from '#scripts/init/init-logic'
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url))
 const REPO_ROOT = path.resolve(SCRIPT_DIR, '..', '..')
+const DIST_ROOT = path.join(REPO_ROOT, 'dist')
+const STATIC_CLAUDE_FILENAME = 'CLAUDE.static.md'
 const SOURCE_CLAUDE_MD = path.join(REPO_ROOT, 'CLAUDE.md')
-const DIST_CLAUDE_MD = path.join(REPO_ROOT, 'dist', 'CLAUDE.md')
+const DIST_CLAUDE_MD = path.join(DIST_ROOT, 'CLAUDE.md')
+const SOURCE_STATIC_CLAUDE_MD = path.join(REPO_ROOT, 'templates', STATIC_CLAUDE_FILENAME)
+const DIST_STATIC_CLAUDE_MD = path.join(DIST_ROOT, STATIC_CLAUDE_FILENAME)
 
 // Read kit's own CLAUDE.md and apply the distribution path transform. kit's source keeps relative
 // paths so it resolves inside the kit repository; the published copy rewrites them so every backtick
@@ -23,6 +27,7 @@ function generate_distributed_claude_md(): string {
 function build_claude_md(): string {
 	mkdirSync(path.dirname(DIST_CLAUDE_MD), { recursive: true })
 	writeFileSync(DIST_CLAUDE_MD, generate_distributed_claude_md())
+	writeFileSync(DIST_STATIC_CLAUDE_MD, readFileSync(SOURCE_STATIC_CLAUDE_MD, 'utf8'))
 
 	return DIST_CLAUDE_MD
 }