phasegate 0.73.0 → 0.74.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.74.0] - 2026-04-22
+
+### Fixed
+
+- ISSUE-007 Wave 9 — phase-gate ブロック時に出力される `scaffold:` 行に含まれる `<unit-id>` プレースホルダを、実 unit ID に置換するようにした。従来は L2-001 registry (`l2-error-definitions.ts`) の `defaultScaffoldCommand` が静的文字列 `npx phasegate scaffold-design --unit <unit-id> --phase logical` のまま出力されていたため、ユーザーが手で unit 名に書き換える必要があった。PHASE_GATE の場合は `metadata.unitId`、FULL_MODE_REQUIRED の場合は `targetFilePaths` から `WriteTargetScope.fromPath` で導出した unit ID を使って置換する。
+- IT-AI-GUIDE-UID-001 / IT-AI-GUIDE-UID-002 を追加（PHASE_GATE と FULL_MODE_REQUIRED の両経路で `<unit-id>` が実 unit に置換されることを検証）。
+
 ## [0.73.0] - 2026-04-22
 
 ### Added

package/package.json

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

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

@@ -103,7 +103,14 @@ export class HandlePreToolUseUseCase {
           // fallthrough: continue to full-mode / story-reflection checks (which may also grandfather)
         } else {
           const guidance = await this.resolveGuidance('L2-001');
-          return HandlePreToolUseUseCase.buildPhaseGateBlockOutput(blockedFilePath, metadata, guidance);
+          const unitIdForGuidance =
+            metadata?.unitId ?? this.deriveUnitIdFromPaths(input.targetFilePaths);
+          return HandlePreToolUseUseCase.buildPhaseGateBlockOutput(
+            blockedFilePath,
+            metadata,
+            guidance,
+            unitIdForGuidance,
+          );
         }
       } else {
         return {
@@ -125,10 +132,12 @@ export class HandlePreToolUseUseCase {
         const fullModeResult = await this.fullModeRequirementQueryPort.check(input.targetFilePaths);
         if (fullModeResult.requiresFullMode) {
           const guidance = await this.resolveGuidance('L2-001');
+          const unitIdForGuidance = this.deriveUnitIdFromPaths(input.targetFilePaths);
           return HandlePreToolUseUseCase.buildFullModeRequiredBlockOutput(
             input.targetFilePaths[0],
             fullModeResult,
             guidance,
+            unitIdForGuidance,
           );
         }
       }
@@ -198,6 +207,7 @@ export class HandlePreToolUseUseCase {
       dominantCategory?: string;
     },
     guidance: ErrorGuidance | null,
+    unitId: string | undefined,
   ): HandlePreToolUseOutput {
     const fp = blockedFilePath ?? '不明なファイル';
     const lines: string[] = [
@@ -214,7 +224,7 @@ export class HandlePreToolUseUseCase {
     }
     const suggestedSkill = guidance?.suggestedSkill ?? '/story-implementor';
     lines.push(`次のアクション: ${suggestedSkill} スキルを使用して設計フェーズから開始してください。`);
-    HandlePreToolUseUseCase.appendGuidanceLines(lines, guidance);
+    HandlePreToolUseUseCase.appendGuidanceLines(lines, guidance, unitId);
 
     return {
       shouldBlock: true,
@@ -227,16 +237,34 @@ export class HandlePreToolUseUseCase {
     };
   }
 
-  private static appendGuidanceLines(lines: string[], guidance: ErrorGuidance | null): void {
+  private static appendGuidanceLines(
+    lines: string[],
+    guidance: ErrorGuidance | null,
+    unitId?: string,
+  ): void {
     if (guidance === null) return;
     if (guidance.scaffoldCommand !== null) {
-      lines.push(`  scaffold: ${guidance.scaffoldCommand}`);
+      const command = unitId !== undefined && unitId !== ''
+        ? guidance.scaffoldCommand.replaceAll('<unit-id>', unitId)
+        : guidance.scaffoldCommand;
+      lines.push(`  scaffold: ${command}`);
     }
     if (guidance.templatePath !== null) {
       lines.push(`  テンプレ: ${guidance.templatePath}`);
     }
   }
 
+  private deriveUnitIdFromPaths(targetFilePaths: readonly string[]): string | undefined {
+    const projectPaths = this.configQueryPort.getProjectPaths();
+    for (const targetFilePath of targetFilePaths) {
+      const scope = WriteTargetScope.fromPath(targetFilePath, projectPaths);
+      if (scope?.unitId !== undefined) {
+        return scope.unitId;
+      }
+    }
+    return undefined;
+  }
+
   private resolveStoryReflectionScope(input: HandlePreToolUseInput): WriteTargetScope | null {
     if (!HandlePreToolUseUseCase.WRITE_TOOLS.has(input.toolName)) {
       return null;
@@ -264,6 +292,7 @@ export class HandlePreToolUseUseCase {
     blockedFilePath: string | undefined,
     metadata: BlockMetadata,
     guidance: ErrorGuidance | null,
+    unitId: string | undefined,
   ): HandlePreToolUseOutput {
     const levelLabel = metadata.scopeLevel
       ? HandlePreToolUseUseCase.LEVEL_LABELS[metadata.scopeLevel] ?? `Level ${metadata.scopeLevel}`
@@ -286,7 +315,7 @@ export class HandlePreToolUseUseCase {
     if (metadata.unitId) {
       lines.push(`  実行例: ${suggestedSkill} --unit ${metadata.unitId}`);
     }
-    HandlePreToolUseUseCase.appendGuidanceLines(lines, guidance);
+    HandlePreToolUseUseCase.appendGuidanceLines(lines, guidance, unitId);
 
     return {
       shouldBlock: true,