phasegate 0.160.10 → 0.160.11

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.160.11] - 2026-05-17
+
+### Fixed
+
+- **WI-202 / WI-204 — Quick Mode strict recovery** — aligns strict init Quick Mode categories with quick-implementor scope, adds `config:plan --intent quick-mode-relax` for managed `allowedCategories` recovery, updates config edit block guidance to the matching recovery intent, and excludes CWD-external runtime paths from project-local hook policy.
+
 ## [0.160.10] - 2026-05-16
 
 ### Fixed

package/docs/guide/cli-reference.md

@@ -28,7 +28,7 @@ Command names in this document are split into three surfaces:
 | `uninstall --dry-run` / `--apply` | Remove PhaseGate-managed files and managed blocks using `.phasegate/manifest.json`; `--force` handles managed conflict cases. |
 | `reconcile --dry-run` / `--apply` | Update PhaseGate-managed files to current package templates and refresh manifest hashes; `--force` allows managed-file replacement with backup. |
 | `setup:agent` | Agent-readable setup planner and optional apply path. Options: `--intent <minimal\|recommended\|strict\|ci-only\|agent-hooks\|retrofit>`, `--agent <claude\|codex\|both>`, `--workflow <standard\|strict>`, `--with-husky`, `--with-ci`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-172 --> |
-| `config:plan` | Agent-readable configuration change planner. Options: `--intent <l4-strict\|codex-hooks\|ci-fail-on-warning\|baseline-reset\|quick-mode-strict\|retrofit-bootstrap\|planning-mode-relax>`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-201 --> |
+| `config:plan` | Agent-readable configuration change planner. Options: `--intent <l4-strict\|codex-hooks\|ci-fail-on-warning\|baseline-reset\|quick-mode-strict\|quick-mode-relax\|retrofit-bootstrap\|planning-mode-relax>`, `--dry-run`, `--apply`, `--json`. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-201 --> <!-- @work-item-id WI-204 --> |
 | `update-skills` | Compatibility alias for `reconcile`; use `reconcile` for new automation. |
 | `scaffold-wi <unit> <type>` | Create `docs/inception/{unit}/WI-XXX/description.md` using the next free WI number. |
 | `emit-agent-rules` | Print the AGENTS.md / CLAUDE.md WI workflow rules block. |

package/docs/guide/configuration.md

@@ -13,9 +13,10 @@ For agent-assisted changes, preview the intent before editing the config:
 ```bash
 npx phasegate config:plan --intent l4-strict --dry-run --json
 npx phasegate config:plan --intent quick-mode-strict --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
 ```
 
-The plan identifies target fields, managed artifacts, commands, validation, risks, and rollback so an agent can explain the change before applying it. <!-- @work-item-id WI-173 -->
+The plan identifies target fields, managed artifacts, commands, validation, risks, and rollback so an agent can explain the change before applying it. Use `quick-mode-relax` to restore the supported Quick Mode category set after an over-narrowed strict configuration. <!-- @work-item-id WI-173 --> <!-- @work-item-id WI-204 -->
 
 ### Full Reference
 

package/docs/guide/recipes.md

@@ -58,8 +58,9 @@ Only enable fail-on-warning after reviewing the drift, consistency, dead-code, p
 
 ```bash
 npx phasegate config:plan --intent quick-mode-strict --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
 npx phasegate check-change-category --paths <changed-files> --format json
 npx phasegate ci-check --quick --dry-run
 ```
 
-Use `config:plan` before changing `phasegate.config.json`. It separates repo-managed artifacts from user-level settings, previews the local config before/after for config-backed intents, and lists the checks needed after the change. <!-- @work-item-id WI-175 -->
+Use `config:plan` before changing `phasegate.config.json`. It separates repo-managed artifacts from user-level settings, previews the local config before/after for config-backed intents, and lists the checks needed after the change. `quick-mode-relax` is the managed recovery path when strict category narrowing blocks docs/test/config changes. <!-- @work-item-id WI-175 --> <!-- @work-item-id WI-204 -->

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.10",
+  "version": "0.160.11",
   "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/agent-integration/application/dto/handle-pre-tool-use-dto.ts

@@ -6,6 +6,7 @@
 export interface HandlePreToolUseInput {
   toolName: string;
   targetFilePaths: string[];
+  callerSkill?: string;
   targetChanges?: {
     filePath: string;
     beforeContent?: string | null;

package/scripts/harness/agent-integration/application/usecases/handle-pre-tool-use-usecase.ts

@@ -160,6 +160,7 @@ export class HandlePreToolUseUseCase {
               fullModeResult,
               guidance,
               unitIdForGuidance,
+              input.callerSkill,
             );
           }
         } else {
@@ -236,11 +237,12 @@ export class HandlePreToolUseUseCase {
     },
     guidance: ErrorGuidance | null,
     unitId: string | undefined,
+    callerSkill?: string,
   ): HandlePreToolUseOutput {
     const fp = blockedFilePath ?? "不明なファイル";
     if (result.dominantCategory === "config" && /(?:^|\/)phasegate\.config\.json$/.test(fp)) {
-      const dryRunCommand = "phasegate config:plan --intent retrofit-bootstrap --dry-run --json";
-      const applyCommand = "phasegate config:plan --intent retrofit-bootstrap --apply --json";
+      const dryRunCommand = "phasegate config:plan --intent quick-mode-relax --dry-run --json";
+      const applyCommand = "phasegate config:plan --intent quick-mode-relax --apply --json";
       const lines = [
         `Full mode 必須変更が検出されました: ${fp}`,
         "カテゴリ: config",
@@ -263,6 +265,33 @@ export class HandlePreToolUseUseCase {
         nextAction: `${dryRunCommand} && ${applyCommand}`,
       };
     }
+    if (
+      callerSkill === "quick-implementor" &&
+      result.dominantCategory !== undefined &&
+      ["bugfix", "docs", "test", "config"].includes(result.dominantCategory)
+    ) {
+      const dryRunCommand = "phasegate config:plan --intent quick-mode-relax --dry-run --json";
+      const applyCommand = "phasegate config:plan --intent quick-mode-relax --apply --json";
+      const lines: string[] = [`Full mode 必須変更が検出されました: ${fp}`];
+      lines.push(`カテゴリ: ${result.dominantCategory}`);
+      if (result.rejectionRule) {
+        lines.push(`判定ルール: ${result.rejectionRule}`);
+      }
+      if (result.rejectionReason) {
+        lines.push(`理由: ${result.rejectionReason}`);
+      }
+      lines.push(`次のアクション: Quick Mode の許可カテゴリを確認してください。緩和する場合は ${dryRunCommand} で差分を確認し、承認後に ${applyCommand} を実行してください。`);
+
+      return {
+        shouldBlock: true,
+        blockedFilePath,
+        blockReason: "FULL_MODE_REQUIRED",
+        error: { message: lines.join("\n") },
+        fullModeRejectionRule: result.rejectionRule,
+        fullModeDominantCategory: result.dominantCategory,
+        nextAction: `${dryRunCommand} && ${applyCommand}`,
+      };
+    }
     const lines: string[] = [`Full mode 必須変更が検出されました: ${fp}`];
     if (result.dominantCategory) {
       lines.push(`カテゴリ: ${result.dominantCategory}`);
@@ -402,7 +431,7 @@ export class HandlePreToolUseUseCase {
     {
       pattern: /(?:^|\/)phasegate\.config\.json$/,
       message: (fp) =>
-        `保護ファイルへの書き込みがブロックされました: ${fp}\n設定変更は CLI 経由で計画・適用してください: phasegate config:plan --intent retrofit-bootstrap --dry-run --json / phasegate config:plan --intent retrofit-bootstrap --apply --json`,
+        `保護ファイルへの書き込みがブロックされました: ${fp}\nQuick Mode 設定の復旧は CLI 経由で計画・適用してください: phasegate config:plan --intent quick-mode-relax --dry-run --json / phasegate config:plan --intent quick-mode-relax --apply --json`,
     },
     {
       pattern: /(?:^|\/)harness\.config\.json$/,

package/scripts/harness/agent-integration/presentation/pre-tool-use-hook.ts

@@ -22,6 +22,7 @@ import * as fs from 'node:fs/promises';
 interface PreToolUseHookInput {
   cwd?: string;
   tool_name?: string;
+  caller_skill?: string;
   tool_input?: {
     path?: string;
     file_path?: string;
@@ -50,8 +51,8 @@ async function readStdin(): Promise<string> {
   return Buffer.concat(chunks).toString('utf8');
 }
 
-async function findConfigPath(): Promise<string> {
-  let dir = process.cwd();
+async function findConfigPath(startDir: string): Promise<string> {
+  let dir = startDir;
   while (true) {
     const candidate = path.join(dir, 'phasegate.config.json');
     try {
@@ -63,7 +64,11 @@ async function findConfigPath(): Promise<string> {
       dir = parent;
     }
   }
-  return path.join(process.cwd(), 'phasegate.config.json');
+  return path.join(startDir, 'phasegate.config.json');
+}
+
+function isProjectExternalAbsolutePath(filePath: string): boolean {
+  return path.isAbsolute(filePath);
 }
 
 async function main(): Promise<void> {
@@ -89,7 +94,7 @@ async function main(): Promise<void> {
     process.exit(2);
   }
 
-  const cwd = input.cwd ?? process.cwd();
+  const cwd = path.resolve(input.cwd ?? process.cwd());
   const toRelative = (p: string): string => {
     if (path.isAbsolute(p)) {
       const rel = path.relative(cwd, p);
@@ -128,7 +133,9 @@ async function main(): Promise<void> {
   }
 
   try {
-    const configPath = await findConfigPath();
+    const configPath = await findConfigPath(cwd);
+    const projectTargetFilePaths = targetFilePaths.filter((filePath) => !isProjectExternalAbsolutePath(filePath));
+    const projectTargetChanges = targetChanges.filter((change) => !isProjectExternalAbsolutePath(change.filePath));
     const configQueryPort = new HarnessConfigConfigQueryAdapter(configPath);
     const phaseGateQueryPort = new PhaseGateQueryAdapter();
     const storyReflectionQueryPort = new FileSystemStoryReflectionQueryAdapter({
@@ -154,7 +161,13 @@ async function main(): Promise<void> {
       errorGuidanceQueryPort,
     });
 
-    const output = await useCase.execute({ toolName: effectiveToolName, targetFilePaths, targetChanges });
+    const callerSkill = input.caller_skill ?? process.env.PHASEGATE_CALLER_SKILL;
+    const output = await useCase.execute({
+      toolName: effectiveToolName,
+      targetFilePaths: projectTargetFilePaths,
+      callerSkill,
+      targetChanges: projectTargetChanges,
+    });
 
     if (output.shouldBlock) {
       const msg = output.error?.message

package/scripts/harness/main.ts

@@ -219,7 +219,7 @@ Gate semantics:
   refresh-claude-md            Refresh CLAUDE.md standard sections (--dry-run, --apply, --json)
   p2:check-agent-context       Check AGENTS.md / CLAUDE.md freshness (--threshold-days <n>, --json)
   setup:agent                  Plan agent-driven setup (--intent <minimal|recommended|strict|ci-only|agent-hooks|retrofit>, --agent <claude|codex|both>, --dry-run|--apply, --json)
-  config:plan                  Plan safe config changes (--intent <l4-strict|codex-hooks|ci-fail-on-warning|baseline-reset|quick-mode-strict|retrofit-bootstrap|planning-mode-relax>, --dry-run|--apply, --json)
+  config:plan                  Plan safe config changes (--intent <l4-strict|codex-hooks|ci-fail-on-warning|baseline-reset|quick-mode-strict|quick-mode-relax|retrofit-bootstrap|planning-mode-relax>, --dry-run|--apply, --json)
   ci:check-repetition          Check error repetition (--code <errorCode>, --reset, --json)
   baseline                     Create retrofit baseline snapshot (--dry-run, --force, --paths <glob,glob,...>, --json)
   scaffold-design              Scaffold a design doc (--unit <id>, --phase <logical|domain|uiux|unit-test|it-test>, --dry-run|--apply, --force, --json)
@@ -536,7 +536,7 @@ Options:
 Produce an agent-readable configuration change plan.
 
 Intents:
-  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict, retrofit-bootstrap, planning-mode-relax
+  l4-strict, codex-hooks, ci-fail-on-warning, baseline-reset, quick-mode-strict, quick-mode-relax, retrofit-bootstrap, planning-mode-relax
 
 Options:
   --dry-run
@@ -779,7 +779,7 @@ function parseCoverageThreshold(raw: string | undefined): number {
 type InitPhasePreset = "full" | "standard" | "minimal" | "custom";
 type AgentTarget = "claude" | "codex" | "both";
 type SetupIntent = "minimal" | "recommended" | "strict" | "ci-only" | "agent-hooks" | "retrofit";
-type ConfigChangeIntent = "l4-strict" | "codex-hooks" | "ci-fail-on-warning" | "baseline-reset" | "quick-mode-strict" | "retrofit-bootstrap" | "planning-mode-relax";
+type ConfigChangeIntent = "l4-strict" | "codex-hooks" | "ci-fail-on-warning" | "baseline-reset" | "quick-mode-strict" | "quick-mode-relax" | "retrofit-bootstrap" | "planning-mode-relax";
 type SetupCompletenessStatus = "configured" | "planned" | "manual" | "not-applicable" | "unknown";
 
 interface SetupCompletenessEntry {
@@ -864,6 +864,7 @@ function parseConfigChangeIntent(value: string | undefined): ConfigChangeIntent
     value === "ci-fail-on-warning" ||
     value === "baseline-reset" ||
     value === "quick-mode-strict" ||
+    value === "quick-mode-relax" ||
     value === "retrofit-bootstrap" ||
     value === "planning-mode-relax"
   ) {
@@ -1229,9 +1230,12 @@ function buildConfigPatchPreview(intent: ConfigChangeIntent, before: unknown | n
       { pointer: "/layers/L4/failOnWarning", path: ["layers", "L4", "failOnWarning"], value: true },
     ],
     "quick-mode-strict": [
-      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["chore"] },
+      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["bugfix"] },
       { pointer: "/quickMode/relaxedGates", path: ["quickMode", "relaxedGates"], value: [] },
     ],
+    "quick-mode-relax": [
+      { pointer: "/quickMode/allowedCategories", path: ["quickMode", "allowedCategories"], value: ["bugfix", "docs", "test", "config"] },
+    ],
     "codex-hooks": [],
     "baseline-reset": [],
     "retrofit-bootstrap": [
@@ -1363,6 +1367,14 @@ async function buildConfigChangePlan(rootDir: string, intent: ConfigChangeIntent
       validations: ["phasegate ci-check --quick --dry-run", "phasegate phasegate:check-ready"],
       risks: ["More changes will require Full Mode validation before commit."],
     },
+    "quick-mode-relax": {
+      targets: ["phasegate.config.json: quickMode.allowedCategories"],
+      managedTargets: ["phasegate.config.json"],
+      externalActions: [],
+      commands: ["phasegate config:plan --intent quick-mode-relax --json", "phasegate config:plan --intent quick-mode-relax --apply --json", "phasegate check-change-category --paths <changed-files> --format json"],
+      validations: ["phasegate ci-check --quick --dry-run", "phasegate phasegate:check-ready"],
+      risks: ["Small bugfix/docs/test/config changes can proceed through Quick Mode again; protected files remain governed by hook and managed command policies."],
+    },
     "retrofit-bootstrap": {
       targets: ["phasegate.config.json: planningMode.default", "phasegate.config.json: phaseDependencies.override", "phasegate.config.json: quickMode.relaxedGates"],
       managedTargets: ["phasegate.config.json"],
@@ -1722,7 +1734,7 @@ async function main(): Promise<void> {
         if (configResult.created) {
           console.log(`✓ phasegate.config.json created`);
           if (workflow === "strict") {
-            console.log(`✓ strict workflow configured (quickMode.relaxedGates: [], allowedCategories: ["chore"])`);
+            console.log(`✓ strict workflow configured (quickMode.relaxedGates: [], allowedCategories: ["bugfix","docs","test","config"])`);
           }
         } else {
           console.log(`  phasegate.config.json already exists, skipped`);

package/scripts/harness/quick-mode/domain/services/quick-mode-judgment-engine.ts

@@ -26,6 +26,16 @@ const RISK_PRIORITY: Record<string, number> = {
 function categorizeFile(file: ChangedFile): ChangeCategory {
   const { filePath, changeKind } = file;
 
+  // Config files must stay config even when Edit payload snippets look like
+  // comment/whitespace-only diffs. Config recovery guidance depends on this.
+  if (
+    filePath.endsWith('.config.json') ||
+    filePath.endsWith('.config.ts') ||
+    filePath.endsWith('phasegate.config.json')
+  ) {
+    return ChangeCategory.fromString('config');
+  }
+
   if (isCommentOnlyDiff(file)) {
     return ChangeCategory.fromString('docs');
   }
@@ -54,15 +64,6 @@ function categorizeFile(file: ChangedFile): ChangeCategory {
     return ChangeCategory.fromString('docs');
   }
 
-  // config: *.config.json / *.config.ts / phasegate.config.json
-  if (
-    filePath.endsWith('.config.json') ||
-    filePath.endsWith('.config.ts') ||
-    filePath.endsWith('phasegate.config.json')
-  ) {
-    return ChangeCategory.fromString('config');
-  }
-
   // feature: domain/ 以外の CREATE
   if (changeKind === 'CREATE') {
     return ChangeCategory.fromString('feature');

package/scripts/harness/setup/skill-deployer.ts

@@ -481,7 +481,7 @@ export async function initHarnessConfig(
     layers: {},
     quickMode: strictWorkflow
       ? {
-          allowedCategories: ["chore"],
+          allowedCategories: ["bugfix", "docs", "test", "config"],
           relaxedGates: [],
         }
       : {},

package/skills/phasegate-config-doctor/SKILL.md

@@ -13,7 +13,7 @@ phasegate を導入した直後の config は単純な default で、実プロ
 
 ## 設計原則
 
-1. **silent 書き換え禁止** — 提案は diff として提示し、`AskUserQuestion` で承認を取ってから Edit
+1. **silent 書き換え禁止** — 提案は diff として提示し、`AskUserQuestion` で承認を取ってから適用する。`config:plan` で表現できる変更は managed command を優先し、直接 `Edit` は hook が許可する範囲に限定する
 2. **検出結果を優先** — 機械的に決定可能な部分 (workspace 構造、formatter、bash 互換性) は AI 推論ではなく検出結果を採用
 3. **AI 推論は判断要素のみ** — architecture preset 選定、relaxedGates 推奨値などは AI が判断するが根拠を必ず示す
 4. **schema は enum 違反確認時のみ Read** — 日常診断は本 SKILL 内の判定基準で十分。schema 全文 Read は値域不明時に限定する
@@ -200,7 +200,14 @@ options:
   - label: "適用しない (情報のみ受け取る)"
 ```
 
-ユーザーが適用対象を確定したら `Edit` で `phasegate.config.json` を変更。
+ユーザーが適用対象を確定したら、対応する managed intent がある場合は `config:plan` で適用する。
+
+```bash
+npx phasegate config:plan --intent quick-mode-relax --dry-run --json
+npx phasegate config:plan --intent quick-mode-relax --apply --json
+```
+
+managed intent がない個別提案のみ、hook が `config` category を許可していることを確認したうえで `Edit` で `phasegate.config.json` を変更する。
 
 **変更後の検証**: