phasegate 0.91.0 → 0.107.0

package/scripts/harness/traceability-model/presentation/cli/migrate-work-items-command-handler.ts

@@ -0,0 +1,186 @@
+// @unit traceability-model
+// @layer presentation
+
+import type { ApplyWorkItemMigrationUseCase } from "../../application/usecases/apply-work-item-migration-usecase.js";
+import type { PlanWorkItemMigrationUseCase } from "../../application/usecases/plan-work-item-migration-usecase.js";
+import type {
+  WorkItemMigrationApplyResult,
+  WorkItemMigrationCandidate,
+  WorkItemMigrationPlan,
+} from "../../domain/value-objects/work-item-migration-candidate.js";
+
+export interface MigrateWorkItemsCommandInput {
+  readonly dryRun?: boolean;
+  readonly apply?: boolean;
+  readonly json?: boolean;
+}
+
+export interface MigrateWorkItemsCommandOutput {
+  readonly exitCode: 0 | 1 | 2;
+  readonly text: string;
+}
+
+type PlanUseCase = Pick<PlanWorkItemMigrationUseCase, "execute">;
+type ApplyUseCase = Pick<ApplyWorkItemMigrationUseCase, "execute">;
+
+export interface MigrateWorkItemsCommandHandlerDeps {
+  readonly planWorkItemMigrationUseCase: PlanUseCase;
+  readonly applyWorkItemMigrationUseCase?: ApplyUseCase;
+}
+
+export class MigrateWorkItemsCommandHandler {
+  private readonly planUseCase: PlanUseCase;
+  private readonly applyUseCase?: ApplyUseCase;
+
+  constructor(deps: MigrateWorkItemsCommandHandlerDeps) {
+    this.planUseCase = deps.planWorkItemMigrationUseCase;
+    this.applyUseCase = deps.applyWorkItemMigrationUseCase;
+  }
+
+  async execute(input: MigrateWorkItemsCommandInput): Promise<Readonly<MigrateWorkItemsCommandOutput>> {
+    if (input.apply && input.dryRun) {
+      return Object.freeze({
+        exitCode: 2,
+        text: "Error: --apply and --dry-run cannot be used together.",
+      });
+    }
+
+    if (input.apply) {
+      return this.executeApply(input);
+    }
+
+    if (!input.dryRun) {
+      return Object.freeze({
+        exitCode: 2,
+        text: "Error: either --dry-run or --apply is required for migrate work-items.",
+      });
+    }
+
+    try {
+      const plan = await this.planUseCase.execute();
+      const hasConflict = plan.candidates.some((candidate) => candidate.conflict);
+      return Object.freeze({
+        exitCode: hasConflict ? 1 : 0,
+        text: input.json ? this.formatJson(plan) : this.formatHuman(plan),
+      });
+    } catch {
+      return Object.freeze({
+        exitCode: 2,
+        text: "Error: failed to plan work item migration unexpectedly.",
+      });
+    }
+  }
+
+  private formatJson(plan: WorkItemMigrationPlan): string {
+    return JSON.stringify(
+      {
+        candidates: plan.candidates,
+        warnings: plan.warnings,
+      },
+      null,
+      2,
+    );
+  }
+
+  private async executeApply(input: MigrateWorkItemsCommandInput): Promise<Readonly<MigrateWorkItemsCommandOutput>> {
+    if (!this.applyUseCase) {
+      return Object.freeze({
+        exitCode: 2,
+        text: "Error: --apply is not configured for migrate work-items.",
+      });
+    }
+
+    try {
+      const result = await this.applyUseCase.execute();
+      return Object.freeze({
+        exitCode: result.blocked ? 1 : 0,
+        text: input.json ? this.formatApplyJson(result) : this.formatApplyHuman(result),
+      });
+    } catch {
+      return Object.freeze({
+        exitCode: 2,
+        text: "Error: failed to apply work item migration unexpectedly.",
+      });
+    }
+  }
+
+  private formatApplyJson(result: WorkItemMigrationApplyResult): string {
+    return JSON.stringify(
+      {
+        applied: result.applied,
+        skipped: result.skipped,
+        warnings: result.warnings,
+        blocked: result.blocked,
+      },
+      null,
+      2,
+    );
+  }
+
+  private formatApplyHuman(result: WorkItemMigrationApplyResult): string {
+    const lines = [
+      "WorkItem migration apply",
+      `applied: ${result.applied.length}`,
+      `skipped: ${result.skipped.length}`,
+      `warnings: ${result.warnings.length}`,
+      `blocked: ${result.blocked ? "yes" : "no"}`,
+      "",
+    ];
+
+    for (const applied of result.applied) {
+      lines.push(`- applied ${applied.legacyId} -> ${applied.nextId}`);
+      lines.push(`  target: ${applied.targetPath}`);
+      lines.push(`  description: ${applied.descriptionPath}`);
+      lines.push("");
+    }
+
+    for (const skipped of result.skipped) {
+      lines.push(`- skipped ${skipped.legacyId} -> ${skipped.nextId}`);
+      lines.push(`  reason: conflict`);
+      lines.push(`  target: ${skipped.targetPath}`);
+      lines.push("");
+    }
+
+    if (result.warnings.length > 0) {
+      lines.push("Warnings:");
+      for (const warning of result.warnings) {
+        lines.push(`  - ${warning}`);
+      }
+    }
+
+    return lines.join("\n").trimEnd();
+  }
+
+  private formatHuman(plan: WorkItemMigrationPlan): string {
+    const lines = [
+      "WorkItem migration dry-run",
+      `candidates: ${plan.candidates.length}`,
+      `warnings: ${plan.warnings.length}`,
+      "",
+    ];
+
+    for (const candidate of plan.candidates) {
+      lines.push(...this.formatCandidate(candidate), "");
+    }
+
+    if (plan.warnings.length > 0) {
+      lines.push("Warnings:");
+      for (const warning of plan.warnings) {
+        lines.push(`  - ${warning}`);
+      }
+    }
+
+    return lines.join("\n").trimEnd();
+  }
+
+  private formatCandidate(candidate: WorkItemMigrationCandidate): string[] {
+    return [
+      `- ${candidate.legacyId} -> ${candidate.nextId}`,
+      `  source: ${candidate.sourcePath}`,
+      `  target: ${candidate.targetPath}`,
+      `  scope: ${candidate.scope}`,
+      `  description: ${candidate.descriptionFileName ?? "missing"}`,
+      `  conflict: ${candidate.conflict ? "yes" : "no"}`,
+    ];
+  }
+}

package/skills/quick-implementor/SKILL.md

@@ -18,6 +18,20 @@ Quick Mode下での軽微変更実装スキル。story-implementorの緩和版
 | `test` | テスト追加・修正（新機能のテストではない） |
 | `config` | 設定変更、依存バージョン更新 |
 
+### WI-aware trivial path（ISSUE-026 Phase D）
+
+作業対象に `WI-XXX` が明示されている場合、最初に `docs/inception/{unit}/WI-XXX/description.md` または `docs/inception/_cross/WI-XXX/description.md` のfrontmatterを確認する。
+
+| WI type | Quick Modeでの扱い |
+|---------|-------------------|
+| `fix` | 適用候補。既存仕様の局所修正として扱う |
+| `chore` | 適用候補。依存更新・運用・ドキュメント整備として扱う |
+| `story` | 適用不可。`story-implementor` にエスカレーション |
+| `issue` | 適用不可。product反映が必要な可能性が高いため `story-implementor` にエスカレーション |
+| `refactor` | 適用不可。設計影響を伴う可能性が高いため `story-implementor` にエスカレーション |
+
+`type: fix | chore` でも、API契約変更・新ドメインモデル追加・レイヤー構造変更・複数Unitにまたがる実装変更が見えた場合は、通常の除外ルールを優先して `story-implementor` に切り替える。
+
 ### 適用除外（フルハーネス必須 → story-implementor を使用）
 
 - 新機能追加
@@ -82,10 +96,12 @@ pnpm test  # 全テスト グリーンを確認
 
 ### Step 5: コミット
 
-Atomic commit で変更をコミットする。コミットメッセージに `[quick]` プレフィックスを付与。
+Atomic commit で変更をコミットする。コミットメッセージに `[quick]` プレフィックスを付与。作業対象WIがある場合は `Work-Item: WI-XXX` trailer を必ず含める。
 
 ```
 [quick] fix: {変更内容の要約}
+
+Work-Item: WI-XXX
 ```
 
 ---

package/templates/.husky/commit-msg

@@ -0,0 +1 @@
+npx phasegate commit-msg "$1"