@joshuafolkken/kit 1.887.0 → 1.929.0

package/playwright.config.ts

@@ -1,5 +1,6 @@
 import { environment_flags } from '@joshuafolkken/kit/env'
 import { ports } from '@joshuafolkken/kit/ports'
+import { web_server } from '@joshuafolkken/kit/web-server'
 import { defineConfig, devices, type ReporterDescription } from '@playwright/test'
 
 // Both ports come from kit's single definition (`@joshuafolkken/kit/ports`), offset by the personal
@@ -17,7 +18,7 @@ import { defineConfig, devices, type ReporterDescription } from '@playwright/tes
 // the file, and a project with no `.env` is untouched.
 //
 // The working directory is the anchor, and the loader ascends from it to the project root — the
-// same root `pnpm run` hands the `webServer` command, so both sides name one file from anywhere
+// same root `node --run` hands the `webServer` command, so both sides name one file from anywhere
 // inside the project. The one layout that escapes that is a run whose working directory sits in a
 // *different* package from this config, as `playwright test --config ../../playwright.config.ts`
 // does in a workspace: Playwright would default `webServer.cwd` to this file's directory while the
@@ -31,13 +32,6 @@ const PREVIEW_PORT = ports.resolve_preview_port()
 
 const CI_TIMEOUT = 120_000
 const LOCAL_TIMEOUT = 30_000
-// pnpm 11.27.1+ places a script it runs without a controlling terminal in its own process group, so
-// Playwright's default teardown — SIGKILL to the webServer's group — no longer reaches the `vite dev`
-// / `preview` child: it survives holding Playwright's stdio pipes open, and Playwright blocks forever
-// on the `close` event (#2386). SIGTERM, unlike SIGKILL, is relayed by that pnpm to the child, so a
-// graceful shutdown lets the server exit and the pipes close. The timeout must stay well above the
-// observed ~40ms shutdown, or Playwright falls back to killProcess() (SIGKILL) and the hang returns.
-const SHUTDOWN_TIMEOUT = 10_000
 const CI_TEST_TIMEOUT = 30_000
 const ACTION_TIMEOUT = 10_000
 const NAV_TIMEOUT = 30_000
@@ -74,7 +68,7 @@ const IS_CI = environment_flags.is_ci_enabled(process.env['CI'])
 // run whose report is unreachable unless the developer already knows `playwright show-report`.
 // (`CI/1` in the Playwright user agent and the MCP headless force share the same root cause.)
 // Deleting the variable once this config has judged the run local is what makes every downstream
-// reader agree with that verdict, the `pnpm run dev` child process included: leaving `CI=0` set for
+// reader agree with that verdict, the `dev` script's child process included: leaving `CI=0` set for
 // the child would only re-introduce the same bare-truthiness bug one process down. The guard is
 // what keeps this safe — a real provider value such as `CI=woodpecker` is never touched, and the
 // deletion cannot fire on the CI branch.
@@ -91,24 +85,22 @@ if (!IS_CI) delete process.env['CI']
 // application; a seed reduces how often a foreign server is on the port at all.
 const IS_REUSE_ENABLED = environment_flags.is_flag_enabled(process.env['PLAYWRIGHT_REUSE_SERVER'])
 
-// Both branches share one shutdown policy — see SHUTDOWN_TIMEOUT for why SIGTERM rather than the
-// SIGKILL default. `as const` keeps the signal a literal so it satisfies Playwright's signal union.
-const GRACEFUL_SHUTDOWN = { signal: 'SIGTERM', timeout: SHUTDOWN_TIMEOUT } as const
-
+// The scripts run through `node --run` rather than `pnpm run`, so the server stays in the process
+// group Playwright signals on teardown and its default SIGKILL reaches it directly — no package
+// manager relays the signal, and no graceful-shutdown timeout has to be tuned around one (#2392).
+// Each script's `pre` hook is chained in explicitly, since `node --run` does not run it.
 const web_server_config = IS_CI
 	? {
-			command: 'pnpm run build && pnpm run preview',
+			command: web_server.script_command(['build', 'preview']),
 			port: PREVIEW_PORT,
 			timeout: CI_TIMEOUT,
 			reuseExistingServer: IS_REUSE_ENABLED,
-			gracefulShutdown: GRACEFUL_SHUTDOWN,
 		}
 	: {
-			command: 'pnpm run dev',
+			command: web_server.script_command(['dev']),
 			port: DEV_PORT,
 			timeout: LOCAL_TIMEOUT,
 			reuseExistingServer: IS_REUSE_ENABLED,
-			gracefulShutdown: GRACEFUL_SHUTDOWN,
 		}
 
 const env_config: EnvConfig = IS_CI

package/ports/index.d.ts

@@ -7,6 +7,7 @@ declare const PROJECT_ENVIRONMENT_KEYS: ReadonlySet<string>
 
 declare const ports: {
 	load_environment_file: (directory?: string) => boolean
+	resolve_project_directory: (directory: string) => string
 	resolve_seed: (environment?: PortEnvironment) => number
 	resolve_lane: (environment?: PortEnvironment) => number
 	resolve_development_port: (environment?: PortEnvironment) => number

package/ports/index.js

@@ -247,6 +247,7 @@ function load_environment_file(directory = process.cwd()) {
 
 const ports = {
 	load_environment_file,
+	resolve_project_directory,
 	resolve_seed,
 	resolve_lane,
 	resolve_development_port,

package/ports/web-server.d.ts

@@ -0,0 +1,5 @@
+declare const web_server: {
+	script_command: (names: Array<string>, directory?: string) => string
+}
+
+export { web_server }

package/ports/web-server.js

@@ -0,0 +1,73 @@
+// The command Playwright's `webServer` runs, built so no package manager stands between Playwright
+// and the server it starts.
+//
+// Playwright spawns the command detached and tears it down by signalling that process group. pnpm
+// 11.27.1+ moves a script it runs without a controlling terminal into a group of its own, so the
+// teardown reached pnpm alone and the dev / preview server survived holding Playwright's stdio pipes
+// open — a hang #2386 patched by relying on pnpm to relay SIGTERM. `node --run` executes the same
+// `package.json` script in the caller's process group, so the teardown signal reaches the server
+// itself and there is no relay left to depend on (#2392).
+//
+// The script names stay the interface rather than a hard-coded `vite` invocation: a consumer's
+// `preview` is not necessarily `vite preview` (wrangler serves the Cloudflare build), and each script
+// resolves its own port through `josh port`. What `node --run` does not do is run `pre<name>` hooks,
+// which a consumer can rely on — a `prepreview` applying local database migrations, say — so the hook
+// is chained explicitly here instead of being dropped without a word. `post<name>` is not: a server
+// script never ends on its own, so its post hook would never have run under pnpm either.
+import { existsSync, readFileSync } from 'node:fs'
+import path from 'node:path'
+import { ports } from './index.js'
+
+const PACKAGE_FILE_NAME = 'package.json'
+const PRE_HOOK_PREFIX = 'pre'
+const STEP_SEPARATOR = ' && '
+
+/**
+ * The `scripts` of the project root's `package.json` — the same file `node --run` resolves from the
+ * working directory — or an empty record when there is none.
+ *
+ * @param {string} directory
+ * @returns {Record<string, unknown>}
+ */
+function read_scripts(directory) {
+	const file = path.join(ports.resolve_project_directory(directory), PACKAGE_FILE_NAME)
+	if (!existsSync(file)) return {}
+
+	const { scripts } = JSON.parse(readFileSync(file, 'utf8'))
+
+	return typeof scripts === 'object' && scripts !== null ? scripts : {}
+}
+
+/**
+ * @param {string} name
+ * @param {Record<string, unknown>} scripts
+ * @returns {string[]}
+ */
+function steps_for(name, scripts) {
+	const hook = `${PRE_HOOK_PREFIX}${name}`
+
+	return Object.hasOwn(scripts, hook) ? [hook, name] : [name]
+}
+
+/**
+ * Chain the named `package.json` scripts, each preceded by its `pre` hook when the project defines
+ * one, into a single shell command run through `node --run`.
+ *
+ * @param {string[]} names
+ * @param {string} [directory]
+ * @returns {string}
+ */
+function script_command(names, directory = process.cwd()) {
+	const scripts = read_scripts(directory)
+
+	return names
+		.flatMap((name) => steps_for(name, scripts))
+		.map((step) => `node --run ${step}`)
+		.join(STEP_SEPARATOR)
+}
+
+const web_server = {
+	script_command,
+}
+
+export { web_server }

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/agent/agent-role-profile.ts

@@ -201,6 +201,16 @@ function resolve_provider(environment: AgentEnvironment = process.env): Provider
 	return detected_provider(environment) ?? handed_provider(environment)
 }
 
+// Whether this session is woken when a background command it started completes
+// (joshuafolkken/kit#2653). Claude Code re-invokes the session at the completion; a Codex session is not
+// re-invoked, so a parent there can only wait by polling, each poll a model call over its whole context.
+// Only a resolved Codex session answers no — an unresolved one keeps the behavior it had before.
+function has_completion_callback(environment: AgentEnvironment = process.env): boolean {
+	const selected = resolve_provider(environment)
+
+	return selected.kind !== 'provider' || selected.provider !== OPENAI_PROVIDER
+}
+
 // The mark a detached launch sets on its child: the provider this session resolved, or nothing when it
 // resolved none — the child then fails the same way this session would have.
 function handoff_environment(
@@ -309,6 +319,7 @@ const agent_role_profile = {
 	WORKER,
 	describe,
 	handoff_environment,
+	has_completion_callback,
 	is_safe_value,
 	parse,
 	phase_effort,

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
 }

package/scripts/ci/pr-classification.ts

@@ -0,0 +1,114 @@
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { z } from 'zod'
+
+const BUGFIX = 'bugfix'
+const BREAKING = 'breaking-change'
+const CLASSIFICATION_LABELS = [
+	BREAKING,
+	'enhancement',
+	BUGFIX,
+	'other-change',
+	'ignore-for-release',
+] as const
+type ReleaseClassification = (typeof CLASSIFICATION_LABELS)[number]
+const CLASSIFICATION_SET: ReadonlySet<string> = new Set(CLASSIFICATION_LABELS)
+const ISSUE_BUG_LABEL = 'bug'
+const DECLARATION = /^- リリース分類: (.+)$/gmu
+const LEGACY_LABELS: ReadonlySet<string> = new Set(['semver-major', 'semver-minor'])
+
+const LABEL = z.object({ name: z.string() })
+const USER = z.object({ login: z.string() })
+const PULL_REQUEST = z.object({ user: USER, labels: z.array(LABEL) })
+const EVENT = z.object({
+	pull_request: PULL_REQUEST,
+})
+
+function classification_error(labels: ReadonlyArray<string>, author: string): string | undefined {
+	const legacy = labels.filter((label) => LEGACY_LABELS.has(label.toLowerCase()))
+	if (legacy.length > 0) return `Remove legacy release labels: ${legacy.join(', ')}`
+
+	const selected = labels.filter((label) => CLASSIFICATION_SET.has(label.toLowerCase()))
+
+	if (selected.length > 1) {
+		return `Choose exactly one release classification; found: ${selected.join(', ')}`
+	}
+
+	if (selected.length === 1 || author.endsWith('[bot]')) return undefined
+
+	return `Choose one release classification: ${CLASSIFICATION_LABELS.join(', ')}`
+}
+
+function is_classification(value: string): value is ReleaseClassification {
+	return CLASSIFICATION_SET.has(value)
+}
+
+function release_candidates(
+	candidates: ReadonlyArray<ReleaseClassification>,
+): ReadonlyArray<ReleaseClassification> {
+	if (!candidates.includes(BREAKING)) return candidates
+
+	return candidates.filter((candidate) => candidate !== 'enhancement')
+}
+
+function issue_candidates(issue_json: string): ReadonlyArray<ReleaseClassification> {
+	const issue = z
+		.object({ labels: z.array(LABEL), body: z.string().nullable() })
+		.parse(JSON.parse(issue_json))
+	const names = issue.labels.map((label) => label.name.toLowerCase())
+	const declared = [...(issue.body ?? '').matchAll(DECLARATION)].map((match) => match[1] ?? '')
+	const candidates = [...release_candidates([...names, ...declared].filter(is_classification))]
+	const unknown = declared.filter((value) => !is_classification(value))
+
+	if (unknown.length > 0) throw new Error(`Unknown release classification: ${unknown.join(', ')}`)
+
+	if (names.includes(ISSUE_BUG_LABEL) && !candidates.includes(BREAKING)) {
+		candidates.push(BUGFIX)
+	}
+
+	return candidates
+}
+
+function select_issue_classification(issue_json: string): ReleaseClassification {
+	const candidates = issue_candidates(issue_json)
+	const selected = [...new Set(candidates)]
+	const [label] = selected
+
+	if (label === undefined || selected.length > 1) {
+		throw new Error(
+			`Choose one release classification before opening the PR: ${CLASSIFICATION_LABELS.join(', ')}; found: ${selected.join(', ') || 'none'}. Add "- リリース分類: <label>" to the Issue body.`,
+		)
+	}
+
+	return label
+}
+
+function check_event(event_path: string): string | undefined {
+	const event = EVENT.parse(JSON.parse(readFileSync(event_path, 'utf8')))
+
+	return classification_error(
+		event.pull_request.labels.map((label) => label.name),
+		event.pull_request.user.login,
+	)
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+	const event_path = process.env['GITHUB_EVENT_PATH']
+	if (!event_path) throw new Error('GITHUB_EVENT_PATH is required')
+
+	const error = check_event(event_path)
+
+	if (error) {
+		console.error(`::error::${error}`)
+		process.exitCode = 1
+	}
+}
+
+const pr_classification = {
+	classification_error,
+	check_event,
+	is_classification,
+	select_issue_classification,
+}
+
+export { pr_classification, CLASSIFICATION_LABELS, type ReleaseClassification }

package/scripts/document/document-byte-budget.ts

@@ -95,7 +95,8 @@ const DOCUMENT_BYTE_BUDGET: ReadonlyArray<DocumentBudget> = [
 	{ path: 'prompts/collaboration-workflow/file-edits.md', bytes: 12_288 },
 	{ path: 'prompts/collaboration-workflow/gh-rest.md', bytes: 8192 },
 	{ path: 'prompts/collaboration-workflow/issue-citation.md', bytes: 8192 },
-	{ path: 'prompts/collaboration-workflow/issue-template.md', bytes: 24_576 },
+	// #2662 adds the feature and compatibility declarations to the canonical filing procedure.
+	{ path: 'prompts/collaboration-workflow/issue-template.md', bytes: 28_672 },
 	{ path: 'prompts/collaboration-workflow/latest-first.md', bytes: 4096 },
 	{ path: 'prompts/collaboration-workflow/no-clones.md', bytes: 4096 },
 	{ path: 'prompts/collaboration-workflow/operating-rules.md', bytes: 24_576 },
@@ -116,7 +117,7 @@ const DOCUMENT_BYTE_BUDGET: ReadonlyArray<DocumentBudget> = [
 	{ path: 'prompts/review-rubric.md', bytes: 20_480 },
 	{ path: 'prompts/review.md', bytes: 20_480 },
 	{ path: 'prompts/sonar-hotspot-handling.md', bytes: 8192 },
-	{ path: 'prompts/testing-guide.md', bytes: 20_480 },
+	{ path: 'prompts/testing-guide.md', bytes: 24_576 },
 ]
 
 // The recorded ceiling for one path, or undefined when it carries no budget entry.

package/scripts/gate/gate-report.ts

@@ -16,6 +16,8 @@ const { FAIL_ICON, PASS_ICON } = status_icons
 interface GateStep {
 	label: string
 	command_args: ReadonlyArray<string>
+	cwd?: string | undefined
+	skip_reason?: string | undefined
 }
 
 interface GateStepResult extends BufferedProcessResult {

package/scripts/gate/gate-steps.ts

@@ -0,0 +1,50 @@
+import { gate_plan, type GateCheck, type GatePlan } from './gate-plan'
+import type { GateStep } from './gate-report'
+import { project_checks } from './project-checks'
+import { type_check_step } from './type-check-step'
+
+const JOSH = 'josh'
+const { TYPE_CHECK_LABEL, UNIT_LABEL } = gate_plan
+const UNIT_WORKER_FLAG = '--maxWorkers'
+
+function unit_worker_args(check: GateCheck, plan: GatePlan): ReadonlyArray<string> {
+	if (check.label !== UNIT_LABEL || plan.unit_worker_cap === undefined) return []
+
+	return [`${UNIT_WORKER_FLAG}=${String(plan.unit_worker_cap)}`]
+}
+
+// Resolve the type checker per project and run every static check from its package root.
+async function build_gate_step(
+	check: GateCheck,
+	start_directory: string,
+	plan: GatePlan = gate_plan.resolve_gate_plan(),
+): Promise<GateStep> {
+	const cwd = project_checks.is_static(start_directory)
+		? project_checks.project_root(start_directory)
+		: undefined
+
+	if (check.label !== TYPE_CHECK_LABEL) {
+		return {
+			label: check.label,
+			command_args: [JOSH, check.target, ...unit_worker_args(check, plan)],
+			cwd,
+		}
+	}
+
+	const command_args = await type_check_step.resolve_type_check_args(start_directory)
+	const skip_reason =
+		command_args[0] === JOSH ? project_checks.type_check_skip_reason(start_directory) : undefined
+
+	return { label: check.label, command_args, cwd, skip_reason }
+}
+
+async function build_gate_steps(
+	start_directory: string,
+	plan: GatePlan = gate_plan.resolve_gate_plan(),
+): Promise<ReadonlyArray<GateStep>> {
+	return await Promise.all(
+		plan.checks.map(async (check) => await build_gate_step(check, start_directory, plan)),
+	)
+}
+
+export { build_gate_step, build_gate_steps, UNIT_WORKER_FLAG }