phasegate 0.160.6 → 0.160.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "phasegate",
-  "version": "0.160.6",
+  "version": "0.160.7",
   "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/ci-governance/presentation/formatters/ci-template-formatter.ts

@@ -1,6 +1,7 @@
 /**
  * @layer presentation
  * @unit ci-governance
+ * @work-item-id WI-200
  */
 
 import type { GenerateCiTemplateOutput } from '../../application/dto/generate-ci-template-output.js';
@@ -15,12 +16,13 @@ export class CiTemplateFormatter {
         lines.push(`  [${err.code}] ${err.message}`);
       }
     } else {
-      lines.push('✓ CI Template Generated');
+      lines.push('✓ CI Template Plan Ready');
       lines.push(`  Template Type: ${output.templateType}`);
       lines.push(`  Preset: ${output.presetRef}`);
       lines.push(`  Trigger: ${output.triggerCondition}`);
       lines.push(`  Validators: ${output.targetValidatorIds.join(', ')}`);
       lines.push(`  Fail on Warning: ${output.failOnWarning}`);
+      lines.push('  Output: no file written; use --render to print template YAML');
     }
 
     return lines.join('\n');

package/scripts/harness/installation/application/usecases/run-install.ts

@@ -2,6 +2,7 @@
 // @layer application
 // @work-item-id WI-146
 // @work-item-id WI-174
+// @work-item-id WI-198
 // @work-item-id WI-175
 // @work-item-id WI-177
 // @work-item-id WI-182
@@ -190,7 +191,7 @@ function renderAgentContextTemplate(
     .replaceAll("{{PHASEGATE_HUSKY_STATE}}", options.includeHusky ? "managed" : "not managed by this setup run")
     .replaceAll("{{PHASEGATE_CI_STATE}}", options.includeCi ? "managed" : "not managed by this setup run")
     .replaceAll("{{PHASEGATE_COMMANDS}}", commands)
-    .replaceAll("{{PHASEGATE_SKILLS}}", options.skillSet === "core" ? "- core skills" : "- all bundled skills")
+    .replaceAll("{{PHASEGATE_SKILLS}}", options.skillSet === "core" ? "- `core skills`" : "- `all bundled skills`")
     .replaceAll("{{PHASEGATE_PRESETS}}", "- `minimal`\n- `standard`\n- `full`\n- `custom`")
     .replaceAll("{{PHASEGATE_USER_SECTION}}", "Project-specific agent instructions go here.");
 }

package/scripts/harness/installation/application/usecases/run-reconcile.ts

@@ -2,6 +2,7 @@
 // @layer application
 // @work-item-id WI-148
 // @work-item-id WI-174
+// @work-item-id WI-198
 
 import { access, chmod, copyFile, lstat, mkdir, readFile, readlink, symlink, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve } from "node:path";
@@ -156,12 +157,12 @@ function reconcileManagedMarkdown(existing: string | null, incoming: string): st
 
 function renderAgentContextTemplate(template: string): string {
   const commands = [
-    "- `phasegate doctor`",
-    "- `phasegate phasegate:check-ready`",
-    "- `phasegate validate --layer L2 --format human`",
-    "- `phasegate setup:agent --dry-run`",
-    "- `phasegate config:plan --intent l4-strict --dry-run`",
-  ].join("\n");
+    "phasegate doctor",
+    "phasegate phasegate:check-ready",
+    "phasegate validate --layer L2 --format human",
+    "phasegate setup:agent --dry-run",
+    "phasegate config:plan --intent l4-strict --dry-run",
+  ].map((command) => `- \`${command}\``).join("\n");
   return template
     .replaceAll("{{PHASEGATE_AGENT}}", "both")
     .replaceAll("{{PHASEGATE_SKILLS_MODE}}", "all")
@@ -169,7 +170,7 @@ function renderAgentContextTemplate(template: string): string {
     .replaceAll("{{PHASEGATE_HUSKY_STATE}}", "managed")
     .replaceAll("{{PHASEGATE_CI_STATE}}", "managed")
     .replaceAll("{{PHASEGATE_COMMANDS}}", commands)
-    .replaceAll("{{PHASEGATE_SKILLS}}", "- all bundled skills")
+    .replaceAll("{{PHASEGATE_SKILLS}}", "- `all bundled skills`")
     .replaceAll("{{PHASEGATE_PRESETS}}", "- `minimal`\n- `standard`\n- `full`\n- `custom`")
     .replaceAll("{{PHASEGATE_USER_SECTION}}", "Project-specific agent instructions go here.");
 }
@@ -299,7 +300,7 @@ export class RunReconcileUseCase {
     const matchesManifest = currentHash.equals(entry.hash);
     const rawTemplate = target.templatePath ? await readFile(join(input.harnessRoot, target.templatePath), "utf8") : "";
     const template = target.strategy === "markdown-managed" ? renderAgentContextTemplate(rawTemplate) : rawTemplate;
-    const next = entry.mode === "created" && target.strategy !== "package-json"
+    const next = entry.mode === "created" && target.strategy !== "package-json" && target.strategy !== "markdown-managed"
       ? template
       : this.reconcileContent(target, before, template, input.phasegateVersion);
     const changed = before !== next;

package/scripts/harness/installation/application/usecases/run-uninstall.ts

@@ -2,6 +2,7 @@
 // @layer application
 // @work-item-id WI-147
 // @work-item-id WI-174
+// @work-item-id WI-199
 
 import { access, copyFile, lstat, mkdir, readFile, readlink, rm, rmdir, writeFile } from "node:fs/promises";
 import { dirname, join, relative, resolve } from "node:path";
@@ -19,6 +20,7 @@ export interface UninstallPlanItem {
   readonly repairMode: RepairMode;
   readonly strategy: StrategyType;
   readonly changed: boolean;
+  readonly protected: boolean;
   readonly summary: string;
   readonly diff: string;
   readonly skillHint: string | null;
@@ -46,6 +48,7 @@ const SHELL_END = "# === phasegate managed (END) ===";
 const MARKDOWN_BEGIN = "<!-- phasegate:managed-section:start -->";
 const MARKDOWN_END = "<!-- phasegate:managed-section:end -->";
 const PHASEGATE_SCRIPT_PREFIX = "phasegate:";
+const PROTECTED_UNINSTALL_PATHS = new Set(["package.json", "package-lock.json"]);
 
 function isRecord(value: unknown): value is Record<string, unknown> {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -175,7 +178,7 @@ export class RunUninstallUseCase {
       const outcome = await this.planEntry(input, entry);
       outcomes.push({ entry, ...outcome });
       plan.push(outcome.item);
-      if (input.apply && outcome.item.changed && (outcome.item.repairMode === "ai-assisted" || outcome.item.repairMode === "manual") && !input.force) {
+      if (input.apply && outcome.item.changed && this.requiresForce(outcome.item) && !input.force) {
         refused.push({ ...outcome.item, action: "refuse" });
       }
     }
@@ -372,6 +375,14 @@ export class RunUninstallUseCase {
     diff: string,
     skillHint: string | null,
   ): UninstallPlanItem {
-    return { path, action, repairMode, strategy, changed, summary, diff, skillHint };
+    return { path, action, repairMode, strategy, changed, protected: this.isProtectedPath(path), summary, diff, skillHint };
+  }
+
+  private requiresForce(item: UninstallPlanItem): boolean {
+    return item.protected || item.repairMode === "ai-assisted" || item.repairMode === "manual";
+  }
+
+  private isProtectedPath(path: string): boolean {
+    return PROTECTED_UNINSTALL_PATHS.has(path);
   }
 }

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

@@ -1,6 +1,7 @@
 // @unit installation
 // @layer presentation
 // @work-item-id WI-147
+// @work-item-id WI-199
 
 import type { RunUninstallUseCase } from "../../application/usecases/run-uninstall.js";
 
@@ -33,14 +34,15 @@ export class UninstallHandler {
       input.apply ? "phasegate uninstall apply" : "phasegate uninstall dry-run",
       ...result.plan.map((item) => {
         const hint = item.skillHint ? `; hint: ${item.skillHint}` : "";
-        return `- ${item.path}: ${item.action} (${item.repairMode}, ${item.strategy}); diff: ${item.diff}${hint}`;
+        const protectedMarker = item.protected ? "; protected: true" : "";
+        return `- ${item.path}: ${item.action} (${item.repairMode}, ${item.strategy}${protectedMarker}); diff: ${item.diff}${hint}`;
       }),
     ];
     if (result.backupDir !== null) lines.push(`backups: ${result.backupDir}`);
     if (result.archivedManifestPath !== null) lines.push(`archived manifest: ${result.archivedManifestPath}`);
     if (result.refused.length > 0) {
       lines.push("");
-      lines.push("Refused ai-assisted/manual targets. Re-run with --force after reviewing the hint.");
+      lines.push("Refused protected, ai-assisted, or manual targets. Re-run with --force after reviewing the plan.");
     }
     return {
       stdout: lines.join("\n"),

package/scripts/harness/main.ts

@@ -11,6 +11,8 @@
  * @work-item-id WI-191
  * @work-item-id WI-195
  * @work-item-id WI-196
+ * @work-item-id WI-197
+ * @work-item-id WI-200
  *
  * Phasegate CLI エントリポイント。
  * 各Unitの Composition Root からハンドラーを取得し、コマンドに応じてディスパッチする。
@@ -2402,6 +2404,16 @@ async function main(): Promise<void> {
         break;
       }
 
+      case "status": {
+        console.error("Warning: 'phasegate status' is deprecated; use 'phasegate phasegate:status'.");
+        const mod = createHarnessApiModule();
+        const flags: Record<string, boolean | string> = {};
+        if (json) flags.json = true;
+        await mod.handlers.status.handle({}, flags);
+        if (!json) await printStoryReflectionStatusLine(rootDir);
+        break;
+      }
+
       case "phasegate:lint": {
         const mod = createHarnessApiModule();
         const flags: Record<string, boolean | string> = {};
@@ -2420,6 +2432,15 @@ async function main(): Promise<void> {
         break;
       }
 
+      case "complete-check": {
+        console.error("Warning: 'phasegate complete-check' is deprecated; use 'phasegate phasegate:complete-check'.");
+        const mod = createHarnessApiModule();
+        const flags: Record<string, boolean | string> = {};
+        if (json) flags.json = true;
+        await mod.handlers.completeCheck.handle({}, flags);
+        break;
+      }
+
       case "phasegate:impact-analysis": {
         const mod = createHarnessApiModule();
         const storyId = args[1] && !args[1].startsWith("--") ? args[1] : (parseFlag(args, "--story-id") ?? "");
@@ -2466,6 +2487,11 @@ Examples:
   phasegate ci:generate-template --preset strict --type pre-commit --render`);
           process.exit(0);
         }
+        const flagError = validateKnownFlags(args.slice(1), ["--preset", "--type", "--render", "--json", "--help"]);
+        if (flagError !== null) {
+          console.error(flagError);
+          process.exit(2);
+        }
         const mod = buildCiGovernance(rootDir, harnessRoot);
         const presetId = parseFlag(args, "--preset") ?? "standard";
         const templateType = parseFlag(args, "--type") ?? "aidlc-gate";