phasegate 0.125.0 → 0.126.0

package/CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.126.0] - 2026-05-08
+
+### Fixed
+
+- **WI-090 — `phasegate init` が unknown flag を silent ignore する問題を解消** — 例えば `phasegate init --skill-set core` (typo: 正しくは `--skills core`) を実行すると、従来は `--skill-set` 値が無視されて default の `all` で deploy されていた。本リリースで unknown flag を **exit 2 + suggestion** として error 化。
+  - **新規ヘルパー**: `scripts/harness/main.ts` に `validateKnownFlags` / `findClosestFlag` / `levenshtein` の 3 関数を inline 追加 (presentation layer の zero-dep CLI parser に組み込み、commander/yargs などの外部依存は追加しない方針を維持)。
+  - **挙動**: `init` 冒頭で `KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--yes"]` と照合し、未知の `--xxx` または `--xxx=value` を検出すると Levenshtein 距離 ≤ 4 の closest flag を `Did you mean '...'?` で提示、該当無しなら known flags の列挙を提示して exit 2。
+  - **互換性**: 既存の正しい flag 利用 (`--skills core` / `--name foo` 等) には一切影響しない。`--yes` は既存 user の script 互換のため known flag として受理 (no-op)。
+  - **help line 修正**: `main.ts` の `printUsage()` で表示される `init` 説明行に `--skills <core|all>` と `--yes` を追記 (従来 `--skills` が help から欠落していた)。
+  - **テスト追加**: 4 integration ケース (`scripts/harness/__tests__/integration/harness-api/init-flag-validation.integration.test.ts`):
+    - `--skill-set core` typo は `Did you mean '--skills'?` を出して exit 2
+    - `--skill-set=core` (=value 形式の typo) も同様に検出
+    - `--xyz-totally-unknown` は known flags の列挙を出して exit 2
+    - 正しい組み合わせ `--name foo --skills all --agent claude --yes` は flag validation で reject されない
+  - 全 3503 テスト (前回 3499 + 新規 4) グリーン、L1 lint 違反なし。
+  - **スコープ外**: 他 subcommand (update-skills / migrate / lint / validate / etc.) への validateKnownFlags 展開は段階適用のため別 WI。`--help` per subcommand 実装も別 WI。
+
 ## [0.125.0] - 2026-05-08
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.125.0",
+  "version": "0.126.0",
   "packageManager": "pnpm@10.30.1",
   "description": "Phasegate — AI-agnostic quality defense toolkit. Enforces structural integrity between design intent and code.",
   "license": "MIT",

package/scripts/harness/main.ts

@@ -81,7 +81,8 @@ Usage: phasegate <command> [options]
 
 Setup:
   init                         Initialize project: deploy skills + design docs + phasegate.config.json
-                               (--name <project-name>, --preset <full|standard|minimal|custom>, --agent <claude|codex|both>, --with-husky)
+                               (--name <project-name>, --preset <full|standard|minimal|custom>,
+                                --skills <core|all>, --agent <claude|codex|both>, --with-husky, --yes)
   update-skills                Re-deploy skills from current harness version
 
 Commands:
@@ -166,6 +167,58 @@ function hasFlag(args: readonly string[], flag: string): boolean {
   return args.includes(flag);
 }
 
+function levenshtein(a: string, b: string): number {
+  const m = a.length;
+  const n = b.length;
+  if (m === 0) return n;
+  if (n === 0) return m;
+  const dp: number[][] = Array.from({ length: m + 1 }, () => Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(dp[i - 1][j] + 1, dp[i][j - 1] + 1, dp[i - 1][j - 1] + cost);
+    }
+  }
+  return dp[m][n];
+}
+
+function findClosestFlag(input: string, known: readonly string[]): string | undefined {
+  let best: string | undefined;
+  let bestDist = Number.POSITIVE_INFINITY;
+  for (const flag of known) {
+    const dist = levenshtein(input, flag);
+    if (dist < bestDist) {
+      bestDist = dist;
+      best = flag;
+    }
+  }
+  return bestDist <= 4 ? best : undefined;
+}
+
+function validateKnownFlags(args: readonly string[], known: readonly string[]): string | null {
+  const knownSet = new Set(known);
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (!arg.startsWith("--")) {
+      i++;
+      continue;
+    }
+    const flagName = arg.includes("=") ? arg.slice(0, arg.indexOf("=")) : arg;
+    if (knownSet.has(flagName)) {
+      i++;
+      continue;
+    }
+    const suggestion = findClosestFlag(flagName, known);
+    return suggestion
+      ? `Error: unknown flag '${flagName}'. Did you mean '${suggestion}'?`
+      : `Error: unknown flag '${flagName}'. Known flags: ${known.join(", ")}`;
+  }
+  return null;
+}
+
 /** フラグとその値を除いた位置引数のみを返す */
 function parsePositionalArgs(args: readonly string[], flagsWithValues: readonly string[] = []): string[] {
   const result: string[] = [];
@@ -434,6 +487,12 @@ async function main(): Promise<void> {
     switch (command) {
       // ── harness setup ──
       case "init": {
+        const KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--yes"];
+        const flagError = validateKnownFlags(args, KNOWN_INIT_FLAGS);
+        if (flagError) {
+          console.error(flagError);
+          process.exit(2);
+        }
         const projectName = parseFlag(args, "--name") ?? "my-project";
         const rawPhasePreset = parseFlag(args, "--preset");
         if (