phasegate 0.144.0 → 0.145.0

package/scripts/harness/installation/presentation/cli/doctor-handler.ts

@@ -0,0 +1,51 @@
+// @unit installation
+// @layer presentation
+// @work-item-id WI-145
+
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, isAbsolute, join } from "node:path";
+import type { RunDoctorDiagnosticsUseCase } from "../../application/usecases/run-doctor-diagnostics.js";
+import { DiagnosticReportFormatter } from "../formatters/diagnostic-report-formatter.js";
+
+export interface DoctorHandlerInput {
+  readonly projectRoot: string;
+  readonly strict: boolean;
+  readonly json: boolean;
+  readonly reportOut: string | null;
+  readonly phasegateVersion: string;
+}
+
+export interface DoctorHandlerOutput {
+  readonly stdout: string;
+  readonly exitCode: number;
+}
+
+export class DoctorHandler {
+  constructor(
+    private readonly useCase: RunDoctorDiagnosticsUseCase,
+    private readonly formatter = new DiagnosticReportFormatter(),
+  ) {}
+
+  async execute(input: DoctorHandlerInput): Promise<DoctorHandlerOutput> {
+    const result = await this.useCase.execute({
+      projectRoot: input.projectRoot,
+      strict: input.strict,
+    });
+    const formatInput = {
+      report: result.report,
+      phasegateVersion: input.phasegateVersion,
+      projectRoot: input.projectRoot,
+      exitCode: result.exitCode,
+    };
+    const jsonOutput = this.formatter.formatJson(formatInput);
+    if (input.reportOut !== null) {
+      const reportPath = isAbsolute(input.reportOut) ? input.reportOut : join(input.projectRoot, input.reportOut);
+      await mkdir(dirname(reportPath), { recursive: true });
+      await writeFile(reportPath, `${jsonOutput}\n`, "utf8");
+    }
+    return {
+      stdout: input.json ? jsonOutput : this.formatter.formatHuman(formatInput),
+      exitCode: result.exitCode,
+    };
+  }
+}

package/scripts/harness/installation/presentation/formatters/diagnostic-report-formatter.ts

@@ -0,0 +1,53 @@
+// @unit installation
+// @layer presentation
+// @work-item-id WI-145
+
+import type { DiagnosticReport } from "../../domain/diagnostic-report.js";
+
+export interface DiagnosticReportFormatterInput {
+  readonly report: DiagnosticReport;
+  readonly phasegateVersion: string;
+  readonly projectRoot: string;
+  readonly exitCode: number;
+}
+
+export class DiagnosticReportFormatter {
+  formatJson(input: DiagnosticReportFormatterInput): string {
+    return JSON.stringify(
+      {
+        schemaVersion: "1.0",
+        phasegateVersion: input.phasegateVersion,
+        projectRoot: input.projectRoot,
+        overallStatus: input.report.overallStatus,
+        findings: input.report.findings.map((finding) => finding.toJSON()),
+        exitCode: input.exitCode,
+      },
+      null,
+      2,
+    );
+  }
+
+  formatHuman(input: DiagnosticReportFormatterInput): string {
+    const lines = [
+      `phasegate doctor v${input.phasegateVersion}`,
+      `Project: ${input.projectRoot}`,
+      "",
+    ];
+    for (const finding of input.report.findings) {
+      lines.push(`[${finding.severity}] ${finding.checkId}: ${finding.message}`);
+      lines.push(`  target: ${finding.target}`);
+      lines.push(`  repairMode: ${finding.repairMode}`);
+      if (finding.repairHint !== null) lines.push(`  fix: ${finding.repairHint}`);
+      if (finding.suggestedSkill !== null) {
+        lines.push(`  suggested: ${finding.suggestedSkill.skillName} (${finding.suggestedSkill.invokeCommand})`);
+        lines.push(`  rationale: ${finding.suggestedSkill.rationale}`);
+      }
+      lines.push("");
+    }
+    const redCount = input.report.findings.filter((finding) => finding.severity === "red").length;
+    const warnCount = input.report.findings.filter((finding) => finding.severity === "warn").length;
+    lines.push(`Status: ${input.report.overallStatus.toUpperCase()} (${input.report.findings.length} findings: ${redCount} red, ${warnCount} warn)`);
+    lines.push(`Exit: ${input.exitCode}`);
+    return lines.join("\n");
+  }
+}

package/scripts/harness/main.ts

@@ -8,7 +8,7 @@
  * 起動時に config-foundation で設定を解決し、他Unit に注入する（Cross-unit wiring）。
  */
 
-import { access, readFile as fsReadFile } from "node:fs/promises";
+import { access, readFile as fsReadFile, readlink as fsReadlink } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
 import { createAdrFoundationModule } from "./adr-foundation/composition-root.js";
 import { createBiomeAstEngineModule } from "./biome-ast-engine/composition-root.js";
@@ -24,6 +24,9 @@ import {
 } from "./config-foundation/infrastructure/repositories/file-system-config-repository.js";
 import { createHarnessApiModule } from "./harness-api/composition-root.js";
 import { createHarnessErrorModule } from "./harness-error/composition-root.js";
+import { createInstallationModule } from "./installation/composition-root.js";
+import { SkillDeployerManifestBuilder, type DeployManifestRecord } from "./installation/application/wrappers/skill-deployer-manifest-builder.js";
+import { NodeCryptoHashAdapter } from "./installation/infrastructure/adapters/node-crypto-hash-adapter.js";
 import { CheckStoryReflectionUseCase } from "./phase-dependency-model/application/usecases/check-story-reflection-usecase.js";
 import { createPhaseDependencyModelModule } from "./phase-dependency-model/composition-root.js";
 import { StoryReflectionChecker } from "./phase-dependency-model/domain/services/story-reflection-checker.js";
@@ -93,6 +96,10 @@ Setup:
                                (--name <project-name>, --preset <full|standard|minimal|custom>,
                                 --skills <core|all>, --agent <claude|codex|both>, --with-husky, --with-ci, --yes)
   update-skills                Re-deploy skills from current harness version
+  doctor                       Diagnose silent installation failures (--json, --strict, --report-out <path>)
+  install                      Install phasegate managed files (stub until WI-146)
+  uninstall                    Uninstall phasegate managed files (stub until WI-147)
+  reconcile                    Reconcile phasegate managed files (stub until WI-148)
 
 Commands:
   enable-feature <name>        Enable a harness feature
@@ -125,7 +132,7 @@ Commands:
   phasegate:complete-check       Complete L2-L4 check (--json)
   phasegate:impact-analysis      Impact analysis for story (<storyId>, --json)
 
-  ci:generate-template         Generate CI template (--preset <id>, --type <aidlc-gate|consistency-check|pre-commit|agent-context-refresh>, --render, --json)
+  ci:generate-template         Generate CI template (--preset <id>, default: standard; --type <aidlc-gate|consistency-check|pre-commit|agent-context-refresh>, --render, --json)
   ci:migrate-agents-md         Migrate AGENTS.md (--dry-run, --validate-only, --json)
   ci:auto-refresh-agent-context Refresh AGENTS.md / CLAUDE.md (--dry-run, --apply, --json)
   refresh-claude-md            Refresh CLAUDE.md standard sections (--dry-run, --apply, --json)
@@ -181,6 +188,40 @@ function hasFlag(args: readonly string[], flag: string): boolean {
   return args.includes(flag);
 }
 
+async function createFileManifestRecord(
+  rootDir: string,
+  relativePath: string,
+  mode: "created" | "merged" = "created",
+): Promise<DeployManifestRecord | null> {
+  try {
+    const contentForHash = await fsReadFile(join(rootDir, relativePath), "utf8");
+    return { path: relativePath, mode, contentForHash };
+  } catch {
+    return null;
+  }
+}
+
+async function createSymlinkManifestRecord(rootDir: string, relativePath: string): Promise<DeployManifestRecord | null> {
+  try {
+    const target = await fsReadlink(join(rootDir, relativePath));
+    return { path: relativePath, mode: "symlink", contentForHash: target };
+  } catch {
+    return null;
+  }
+}
+
+async function saveInstallationManifest(
+  rootDir: string,
+  version: string,
+  records: readonly (DeployManifestRecord | null | Promise<DeployManifestRecord | null>)[],
+): Promise<void> {
+  const filteredRecords = (await Promise.all(records)).filter((record) => record !== null);
+  if (filteredRecords.length === 0) return;
+  const mod = createInstallationModule();
+  const builder = new SkillDeployerManifestBuilder(new NodeCryptoHashAdapter());
+  await mod.manifestRepository.save(rootDir, builder.build(version, filteredRecords));
+}
+
 /**
  * WI-094 / ADR-017: CLI で boolean フラグを tri-state に解釈する。
  * - `--<flag>` 指定 → true
@@ -367,7 +408,7 @@ Examples:
 Generates a CI template configuration.
 
 Options:
-  --preset <id>    Preset name (e.g. standard, strict). Required.
+  --preset <id>    Preset name (e.g. standard, strict). Default: standard.
   --type <type>    Template purpose (NOT CI platform name). One of:
                      aidlc-gate        — AIDLC phase gate checks
                      consistency-check — Doc/code consistency checks
@@ -377,7 +418,7 @@ Options:
   --json           Output in JSON format
 
 Examples:
-  phasegate ci:generate-template --preset standard --type aidlc-gate
+  phasegate ci:generate-template --type aidlc-gate
   phasegate ci:generate-template --preset strict --type pre-commit --render`,
 };
 
@@ -722,6 +763,27 @@ async function main(): Promise<void> {
         const huskyCommitMsgResult = withHusky ? await deployHuskyCommitMsgHook(harnessRoot, rootDir) : null;
         const huskyPrePushResult = withHusky ? await deployHuskyPrePushHook(harnessRoot, rootDir) : null;
         const ciWorkflowResult = withCi ? await deployCiWorkflows(harnessRoot, rootDir) : null;
+        await saveInstallationManifest(rootDir, result.version, [
+          ...result.deployedSkills.map((skill) => ({
+            path: join("skills", skill),
+            mode: "created" as const,
+            contentForHash: `${result.version}:${skill}`,
+          })),
+          await createFileManifestRecord(rootDir, join("skills", ".harness-version")),
+          configResult.created ? await createFileManifestRecord(rootDir, "phasegate.config.json") : null,
+          hooksResult.settingsCreated ? await createFileManifestRecord(rootDir, join(".claude", "settings.json")) : null,
+          hooksResult.hookConfigGenerated
+            ? await createFileManifestRecord(rootDir, join(".claude", "scripts", "hook-config.json"))
+            : null,
+          skillLinkResult.claude !== null ? await createSymlinkManifestRecord(rootDir, join(".claude", "skills")) : null,
+          codexResult?.created ? await createFileManifestRecord(rootDir, join(".codex", "hooks.json")) : null,
+          skillLinkResult.codex !== null ? await createSymlinkManifestRecord(rootDir, join(".codex", "skills")) : null,
+          ...designDocsResult.copiedFiles.map((path) => createFileManifestRecord(rootDir, path)),
+          huskyResult?.created ? await createFileManifestRecord(rootDir, join(".husky", "pre-commit")) : null,
+          huskyCommitMsgResult?.created ? await createFileManifestRecord(rootDir, join(".husky", "commit-msg")) : null,
+          huskyPrePushResult?.created ? await createFileManifestRecord(rootDir, join(".husky", "pre-push")) : null,
+          ...(ciWorkflowResult?.copiedFiles.map((path) => createFileManifestRecord(rootDir, path)) ?? []),
+        ]);
         console.log(
           `✓ Skills deployed to ${result.targetDir} (${result.deployedSkills.length} skills, set: ${skillSet})`,
         );
@@ -854,11 +916,54 @@ async function main(): Promise<void> {
           claude: shouldLinkClaude,
           codex: shouldLinkCodex,
         });
+        await saveInstallationManifest(rootDir, current, [
+          ...result.deployedSkills.map((skill) => ({
+            path: join("skills", skill),
+            mode: "created" as const,
+            contentForHash: `${current}:${skill}`,
+          })),
+          await createFileManifestRecord(rootDir, join("skills", ".harness-version")),
+          shouldLinkClaude ? await createSymlinkManifestRecord(rootDir, join(".claude", "skills")) : null,
+          shouldLinkCodex ? await createSymlinkManifestRecord(rootDir, join(".codex", "skills")) : null,
+        ]);
         console.log(`✓ Skills updated (${result.deployedSkills.length} skills redeployed, set: ${updateSkillSet})`);
         process.exit(0);
         break;
       }
 
+      case "doctor": {
+        const mod = createInstallationModule();
+        const phasegateVersion = await getHarnessVersion(harnessRoot);
+        const result = await mod.doctorHandler.execute({
+          projectRoot: rootDir,
+          strict: hasFlag(args, "--strict"),
+          json,
+          reportOut: parseFlag(args, "--report-out") ?? null,
+          phasegateVersion,
+        });
+        console.log(result.stdout);
+        process.exit(result.exitCode);
+        break;
+      }
+
+      case "install": {
+        console.error("Not yet implemented: phasegate install is owned by WI-146");
+        process.exit(2);
+        break;
+      }
+
+      case "uninstall": {
+        console.error("Not yet implemented: phasegate uninstall is owned by WI-147");
+        process.exit(2);
+        break;
+      }
+
+      case "reconcile": {
+        console.error("Not yet implemented: phasegate reconcile is owned by WI-148");
+        process.exit(2);
+        break;
+      }
+
       // ── config-foundation ──
       case "enable-feature": {
         const mod = createConfigFoundationModule();
@@ -1253,21 +1358,22 @@ async function main(): Promise<void> {
 Generates a CI template configuration.
 
 Options:
-  --preset <id>    Preset name (e.g. standard, strict). Required.
+  --preset <id>    Preset name (e.g. standard, strict). Default: standard.
   --type <type>    Template purpose (NOT CI platform name). One of:
                      aidlc-gate        — AIDLC phase gate checks
                      consistency-check — Doc/code consistency checks
                      pre-commit        — Pre-commit hook template
+                     agent-context-refresh — AGENTS.md / CLAUDE.md refresh workflow
   --render         Render the template to stdout
   --json           Output in JSON format
 
 Examples:
-  phasegate ci:generate-template --preset standard --type aidlc-gate
+  phasegate ci:generate-template --type aidlc-gate
   phasegate ci:generate-template --preset strict --type pre-commit --render`);
           process.exit(0);
         }
         const mod = buildCiGovernance(rootDir, harnessRoot);
-        const presetId = parseFlag(args, "--preset") ?? "default";
+        const presetId = parseFlag(args, "--preset") ?? "standard";
         const templateType = parseFlag(args, "--type") ?? "aidlc-gate";
         const render = hasFlag(args, "--render");
         const format = json ? "json" : "human";