phasegate 0.135.0 → 0.137.0

package/scripts/harness/main.ts

@@ -41,6 +41,7 @@ import type { SkillSet } from "./setup/skill-deployer.js";
 import {
   deployAgentSkillLinks,
   deployCodexHooks,
+  deployCiWorkflows,
   deployDesignDocs,
   deployHookScripts,
   deployHuskyCommitMsgHook,
@@ -89,7 +90,7 @@ Usage: phasegate <command> [options]
 Setup:
   init                         Initialize project: deploy skills + design docs + phasegate.config.json
                                (--name <project-name>, --preset <full|standard|minimal|custom>,
-                                --skills <core|all>, --agent <claude|codex|both>, --with-husky, --yes)
+                                --skills <core|all>, --agent <claude|codex|both>, --with-husky, --with-ci, --yes)
   update-skills                Re-deploy skills from current harness version
 
 Commands:
@@ -122,8 +123,11 @@ 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>, --render, --json)
+  ci:generate-template         Generate CI template (--preset <id>, --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)
+  p2:check-agent-context       Check AGENTS.md / CLAUDE.md freshness (--threshold-days <n>, --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>, --force, --json)
@@ -251,6 +255,7 @@ Options:
   --skills <core|all>             Skill set to deploy (default: "all")
   --agent <claude|codex|both>     Agent integration target (default: "claude")
   --with-husky                    Install Husky pre-commit hooks
+  --with-ci                       Install GitHub Actions workflows
   --yes                           Skip confirmation prompts
   --help, -h                      Show this help`,
   "update-skills": `Usage: phasegate update-skills [options]
@@ -344,6 +349,7 @@ Options:
                      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
 
@@ -636,7 +642,7 @@ async function main(): Promise<void> {
     switch (command) {
       // ── harness setup ──
       case "init": {
-        const KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--yes"];
+        const KNOWN_INIT_FLAGS = ["--name", "--preset", "--skills", "--agent", "--with-husky", "--with-ci", "--yes"];
         const flagError = validateKnownFlags(args, KNOWN_INIT_FLAGS);
         if (flagError) {
           console.error(flagError);
@@ -674,7 +680,8 @@ async function main(): Promise<void> {
           claude: deployClaude,
           codex: deployCodex,
         });
-        const configResult = await initHarnessConfig(rootDir, projectName, phasePreset);
+        const withCi = hasFlag(args, "--with-ci");
+        const configResult = await initHarnessConfig(rootDir, projectName, phasePreset, { ciEnabled: withCi });
         const hooksResult = deployClaude
           ? await deployHookScripts(harnessRoot, rootDir)
           : {
@@ -689,6 +696,7 @@ async function main(): Promise<void> {
         const withHusky = hasFlag(args, "--with-husky");
         const huskyResult = withHusky ? await deployHuskyHook(harnessRoot, rootDir) : null;
         const huskyCommitMsgResult = withHusky ? await deployHuskyCommitMsgHook(harnessRoot, rootDir) : null;
+        const ciWorkflowResult = withCi ? await deployCiWorkflows(harnessRoot, rootDir) : null;
         console.log(
           `✓ Skills deployed to ${result.targetDir} (${result.deployedSkills.length} skills, set: ${skillSet})`,
         );
@@ -753,6 +761,14 @@ async function main(): Promise<void> {
             console.log(`  .husky/commit-msg already exists, skipped`);
           }
         }
+        if (ciWorkflowResult !== null) {
+          if (ciWorkflowResult.copiedFiles.length > 0) {
+            console.log(`✓ CI workflows deployed (${ciWorkflowResult.copiedFiles.length} files)`);
+          }
+          for (const skipped of ciWorkflowResult.skippedFiles) {
+            console.log(`  ${skipped} already exists, skipped`);
+          }
+        }
         console.log(`✓ Harness v${result.version} initialized (agent: ${agent})`);
         console.log("");
         console.log("Next steps:");
@@ -1199,7 +1215,7 @@ Examples:
   phasegate ci:generate-template --preset strict --type pre-commit --render`);
           process.exit(0);
         }
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const presetId = parseFlag(args, "--preset") ?? "default";
         const templateType = parseFlag(args, "--type") ?? "aidlc-gate";
         const render = hasFlag(args, "--render");
@@ -1211,7 +1227,7 @@ Examples:
       }
 
       case "ci:migrate-agents-md": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const dryRun = hasFlag(args, "--dry-run");
         const validateOnly = hasFlag(args, "--validate-only");
         const format = json ? "json" : "human";
@@ -1221,8 +1237,41 @@ Examples:
         break;
       }
 
+      case "ci:auto-refresh-agent-context": {
+        const mod = buildCiGovernance(rootDir, harnessRoot);
+        const dryRun = hasFlag(args, "--dry-run");
+        const apply = hasFlag(args, "--apply");
+        const format = json ? "json" : "human";
+        const result = await mod.refreshAgentContextHandler.handle({ dryRun, apply, format });
+        console.log(result.output);
+        process.exit(result.exitCode);
+        break;
+      }
+
+      case "refresh-claude-md": {
+        const mod = buildCiGovernance(rootDir, harnessRoot);
+        const dryRun = hasFlag(args, "--dry-run");
+        const apply = hasFlag(args, "--apply");
+        const format = json ? "json" : "human";
+        const result = await mod.refreshClaudeMdHandler.handle({ dryRun, apply, format });
+        console.log(result.output);
+        process.exit(result.exitCode);
+        break;
+      }
+
+      case "p2:check-agent-context": {
+        const mod = buildCiGovernance(rootDir, harnessRoot);
+        const thresholdRaw = parseFlag(args, "--threshold-days");
+        const thresholdDays = thresholdRaw === undefined ? undefined : Number(thresholdRaw);
+        const format = json ? "json" : "human";
+        const result = await mod.checkAgentContextHandler.handle({ thresholdDays, format });
+        console.log(result.output);
+        process.exit(result.exitCode);
+        break;
+      }
+
       case "ci:check-repetition": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const errorCode = parseFlag(args, "--code") ?? "";
         const reset = hasFlag(args, "--reset");
         const format = json ? "json" : "human";
@@ -1233,7 +1282,7 @@ Examples:
       }
 
       case "baseline": {
-        const mod = buildCiGovernance(rootDir);
+        const mod = buildCiGovernance(rootDir, harnessRoot);
         const dryRun = hasFlag(args, "--dry-run");
         const force = hasFlag(args, "--force");
         const pathsFlag = parseFlag(args, "--paths");

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

@@ -420,10 +420,15 @@ export async function deployHookScripts(harnessRoot: string, projectRoot: string
   };
 }
 
+export interface InitHarnessConfigOptions {
+  ciEnabled?: boolean;
+}
+
 export async function initHarnessConfig(
   projectRoot: string,
   projectName: string,
   phasePreset?: "full" | "standard" | "minimal" | "custom",
+  options: InitHarnessConfigOptions = {},
 ): Promise<{ created: boolean; path: string }> {
   const configPath = join(projectRoot, HARNESS_CONFIG_FILE);
   try {
@@ -461,6 +466,7 @@ export async function initHarnessConfig(
       format: "json",
       outputDir: "reports",
     },
+    ...(options.ciEnabled ? { ci: { enabled: true } } : {}),
   };
 
   await fs.writeFile(configPath, JSON.stringify(template, null, 2) + "\n", "utf-8");
@@ -532,6 +538,50 @@ export interface DeployHuskyHookResult {
   path: string;
 }
 
+export interface DeployCiWorkflowsResult {
+  copiedFiles: string[];
+  skippedFiles: string[];
+}
+
+export async function deployCiWorkflows(harnessRoot: string, projectRoot: string): Promise<DeployCiWorkflowsResult> {
+  const copiedFiles: string[] = [];
+  const skippedFiles: string[] = [];
+  const workflows = [
+    {
+      relativeSource: join("docs", "templates", "ci", "aidlc-gate.yml"),
+      relativeTarget: join(".github", "workflows", "aidlc-gate.yml"),
+    },
+    {
+      relativeSource: join("docs", "templates", "ci", "consistency-check.yml"),
+      relativeTarget: join(".github", "workflows", "consistency-check.yml"),
+    },
+    {
+      relativeSource: join("docs", "templates", "ci", "agent-context-refresh.yml"),
+      relativeTarget: join(".github", "workflows", "agent-context-refresh.yml"),
+    },
+  ];
+
+  await fs.mkdir(join(projectRoot, ".github", "workflows"), { recursive: true });
+
+  for (const workflow of workflows) {
+    const sourcePath = join(harnessRoot, workflow.relativeSource);
+    const targetPath = join(projectRoot, workflow.relativeTarget);
+
+    try {
+      await fs.access(targetPath);
+      skippedFiles.push(workflow.relativeTarget);
+      continue;
+    } catch {
+      // ファイルが存在しない場合のみコピーする
+    }
+
+    await fs.copyFile(sourcePath, targetPath);
+    copiedFiles.push(workflow.relativeTarget);
+  }
+
+  return { copiedFiles, skippedFiles };
+}
+
 export async function deployHuskyHook(harnessRoot: string, projectRoot: string): Promise<DeployHuskyHookResult> {
   const targetPath = join(projectRoot, ".husky", "pre-commit");
 
@@ -540,7 +590,7 @@ export async function deployHuskyHook(harnessRoot: string, projectRoot: string):
     return { created: false, path: targetPath };
   } catch {}
 
-  const sourcePath = join(harnessRoot, "templates", ".husky", "pre-commit");
+  const sourcePath = join(harnessRoot, "docs", "templates", "hooks", "pre-commit");
   await fs.mkdir(join(projectRoot, ".husky"), { recursive: true });
   await fs.copyFile(sourcePath, targetPath);
   await fs.chmod(targetPath, 0o755);
@@ -559,7 +609,7 @@ export async function deployHuskyCommitMsgHook(
     return { created: false, path: targetPath };
   } catch {}
 
-  const sourcePath = join(harnessRoot, "templates", ".husky", "commit-msg");
+  const sourcePath = join(harnessRoot, "docs", "templates", "hooks", "commit-msg");
   await fs.mkdir(join(projectRoot, ".husky"), { recursive: true });
   await fs.copyFile(sourcePath, targetPath);
   await fs.chmod(targetPath, 0o755);

package/scripts/harness/traceability-model/domain/value-objects/work-item-frontmatter.ts

@@ -13,7 +13,8 @@ export type WorkItemStatus =
   | 'drafted'
   | 'reflected'
   | 'implemented'
-  | 'tested';
+  | 'tested'
+  | 'completed';
 
 export interface WorkItemFrontmatter {
   readonly id: string;
@@ -54,4 +55,5 @@ export const WORK_ITEM_STATUSES: ReadonlySet<WorkItemStatus> = new Set([
   'reflected',
   'implemented',
   'tested',
+  'completed',
 ]);

package/scripts/harness/validator-system/infrastructure/adapters/phase-dependency-phase-gate-policy-adapter.ts

@@ -12,6 +12,10 @@ export class PhaseDependencyPhaseGatePolicyAdapter implements PhaseGatePolicyPor
     satisfied: boolean;
     violations: readonly HarnessErrorLike[];
   }> {
+    if (context.unitName.trim().length === 0) {
+      return { satisfied: true, violations: [] };
+    }
+
     try {
       // WI-085: paths config を phase-dependency-model に流入させる
       const { createConfigFoundationModule } = await import('../../../config-foundation/composition-root.js');