sddx-workflow 0.9.0 → 0.10.0

package/dist/cli.js

@@ -40,41 +40,88 @@ function ensureDir(dir) {
     import_fs.default.mkdirSync(dir, { recursive: true });
   }
 }
+function displayPath(filePath) {
+  const relative = import_path.default.relative(process.cwd(), filePath);
+  return relative && !relative.startsWith("..") ? relative : filePath;
+}
 function copyTemplate(src, dest, force) {
-  const exists = import_fs.default.existsSync(dest);
-  if (exists && !force) {
-    console.log(`  skip     ${dest}`);
+  const exists2 = import_fs.default.existsSync(dest);
+  if (exists2 && !force) {
+    console.log(`  skip     ${displayPath(dest)}`);
     return;
   }
   import_fs.default.copyFileSync(import_path.default.join(TEMPLATES_DIR, src), dest);
-  console.log(`  ${exists ? "overwrite" : "create  "}  ${dest}`);
+  console.log(`  ${exists2 ? "overwrite" : "create  "}  ${displayPath(dest)}`);
 }
 
-// src/commands/init.ts
+// src/commands/command-names.ts
+var COMMAND_NAMES = [
+  "bootstrap",
+  "ask",
+  "assume",
+  "bugfix",
+  "refactor",
+  "spec-new",
+  "spec-plan",
+  "spec-tasks",
+  "review",
+  "finish",
+  "spec-amend",
+  "impl-gap",
+  "research",
+  "verify",
+  "scan",
+  "conventions-sync",
+  "spec-status",
+  "spec-conflicts",
+  "spec-clarify",
+  "spec-analyze"
+];
+
+// src/providers.ts
 var CORE_FILES = [
   { src: "workflow.md", dest: ".sdd/workflow.md" },
   { src: "project-overview.md", dest: ".sdd/project-overview.md" },
   { src: "conventions/base.md", dest: ".sdd/conventions.md" },
-  { src: "CLAUDE.md", dest: "CLAUDE.md" },
   { src: "specs/_template/1-requirements.md", dest: "specs/_template/1-requirements.md" },
   { src: "specs/_template/2-plan.md", dest: "specs/_template/2-plan.md" },
-  { src: "specs/_template/3-tasks.md", dest: "specs/_template/3-tasks.md" }
+  { src: "specs/_template/3-tasks.md", dest: "specs/_template/3-tasks.md" },
+  { src: "specs/_template/amendments.md", dest: "specs/_template/amendments.md" },
+  { src: "specs/_template/impl-gaps.md", dest: "specs/_template/impl-gaps.md" },
+  { src: "specs/_template/verify-report.md", dest: "specs/_template/verify-report.md" },
+  { src: "specs/_template/analysis.md", dest: "specs/_template/analysis.md" },
+  { src: "specs/_template/2a-data-model.md", dest: "specs/_template/2a-data-model.md" },
+  { src: "specs/_template/2b-api-contracts.md", dest: "specs/_template/2b-api-contracts.md" },
+  { src: "specs/_template/2c-research.md", dest: "specs/_template/2c-research.md" }
 ];
+var claudeCommandFiles = COMMAND_NAMES.map((name) => ({
+  src: `claude-commands/${name}.md`,
+  dest: `.claude/commands/${name}.md`
+}));
+var copilotPromptFiles = COMMAND_NAMES.map((name) => ({
+  src: `copilot-prompts/${name}.prompt.md`,
+  dest: `.github/prompts/${name}.prompt.md`
+}));
+var geminiCommandFiles = COMMAND_NAMES.map((name) => ({
+  src: `gemini-commands/${name}.toml`,
+  dest: `.gemini/commands/${name}.toml`
+}));
+var windsurfWorkflowFiles = COMMAND_NAMES.map((name) => ({
+  src: `windsurf-workflows/${name}.md`,
+  dest: `.windsurf/workflows/${name}.md`
+}));
+var codexSkillDirs = COMMAND_NAMES.map((name) => `.agents/skills/${name}`);
+var codexSkillFiles = COMMAND_NAMES.map((name) => ({
+  src: `codex-skills/${name}/SKILL.md`,
+  dest: `.agents/skills/${name}/SKILL.md`
+}));
 var PROVIDERS = {
   "claude-code": {
     name: "Claude Code",
     dirs: [".claude/commands"],
     files: [
-      { src: "claude-commands/bootstrap.md", dest: ".claude/commands/bootstrap.md" },
-      { src: "claude-commands/ask.md", dest: ".claude/commands/ask.md" },
-      { src: "claude-commands/assume.md", dest: ".claude/commands/assume.md" },
-      { src: "claude-commands/bugfix.md", dest: ".claude/commands/bugfix.md" },
-      { src: "claude-commands/refactor.md", dest: ".claude/commands/refactor.md" },
-      { src: "claude-commands/spec-new.md", dest: ".claude/commands/spec-new.md" },
-      { src: "claude-commands/spec-plan.md", dest: ".claude/commands/spec-plan.md" },
-      { src: "claude-commands/spec-tasks.md", dest: ".claude/commands/spec-tasks.md" },
-      { src: "claude-commands/review.md", dest: ".claude/commands/review.md" },
-      { src: "claude-commands/finish.md", dest: ".claude/commands/finish.md" }
+      { src: "CLAUDE.md", dest: "CLAUDE.md" },
+      ...claudeCommandFiles
     ]
   },
   cursor: {
@@ -86,61 +133,34 @@ var PROVIDERS = {
   },
   windsurf: {
     name: "Windsurf",
-    dirs: [".windsurf/rules"],
+    dirs: [".windsurf/rules", ".windsurf/workflows"],
     files: [
-      { src: "windsurf-rules/sddx-workflow.md", dest: ".windsurf/rules/sddx-workflow.md" }
+      { src: "windsurf-rules/sddx-workflow.md", dest: ".windsurf/rules/sddx-workflow.md" },
+      ...windsurfWorkflowFiles
     ]
   },
   copilot: {
     name: "GitHub Copilot",
     dirs: [".github/prompts"],
     files: [
-      { src: "copilot-prompts/bootstrap.prompt.md", dest: ".github/prompts/bootstrap.prompt.md" },
-      { src: "copilot-prompts/ask.prompt.md", dest: ".github/prompts/ask.prompt.md" },
-      { src: "copilot-prompts/assume.prompt.md", dest: ".github/prompts/assume.prompt.md" },
-      { src: "copilot-prompts/bugfix.prompt.md", dest: ".github/prompts/bugfix.prompt.md" },
-      { src: "copilot-prompts/refactor.prompt.md", dest: ".github/prompts/refactor.prompt.md" },
-      { src: "copilot-prompts/spec-new.prompt.md", dest: ".github/prompts/spec-new.prompt.md" },
-      { src: "copilot-prompts/spec-plan.prompt.md", dest: ".github/prompts/spec-plan.prompt.md" },
-      { src: "copilot-prompts/spec-tasks.prompt.md", dest: ".github/prompts/spec-tasks.prompt.md" },
-      { src: "copilot-prompts/review.prompt.md", dest: ".github/prompts/review.prompt.md" },
-      { src: "copilot-prompts/finish.prompt.md", dest: ".github/prompts/finish.prompt.md" },
+      ...copilotPromptFiles,
       { src: "copilot-instructions.md", dest: ".github/copilot-instructions.md" }
     ]
   },
   codex: {
     name: "OpenAI Codex",
-    dirs: [
-      ".agents/skills/bootstrap",
-      ".agents/skills/ask",
-      ".agents/skills/assume",
-      ".agents/skills/bugfix",
-      ".agents/skills/refactor",
-      ".agents/skills/spec-new",
-      ".agents/skills/spec-plan",
-      ".agents/skills/spec-tasks",
-      ".agents/skills/review",
-      ".agents/skills/finish"
-    ],
+    dirs: codexSkillDirs,
     files: [
       { src: "AGENTS.md", dest: "AGENTS.md" },
-      { src: "codex-skills/bootstrap/SKILL.md", dest: ".agents/skills/bootstrap/SKILL.md" },
-      { src: "codex-skills/ask/SKILL.md", dest: ".agents/skills/ask/SKILL.md" },
-      { src: "codex-skills/assume/SKILL.md", dest: ".agents/skills/assume/SKILL.md" },
-      { src: "codex-skills/bugfix/SKILL.md", dest: ".agents/skills/bugfix/SKILL.md" },
-      { src: "codex-skills/refactor/SKILL.md", dest: ".agents/skills/refactor/SKILL.md" },
-      { src: "codex-skills/spec-new/SKILL.md", dest: ".agents/skills/spec-new/SKILL.md" },
-      { src: "codex-skills/spec-plan/SKILL.md", dest: ".agents/skills/spec-plan/SKILL.md" },
-      { src: "codex-skills/spec-tasks/SKILL.md", dest: ".agents/skills/spec-tasks/SKILL.md" },
-      { src: "codex-skills/review/SKILL.md", dest: ".agents/skills/review/SKILL.md" },
-      { src: "codex-skills/finish/SKILL.md", dest: ".agents/skills/finish/SKILL.md" }
+      ...codexSkillFiles
     ]
   },
   gemini: {
     name: "Gemini CLI",
-    dirs: [],
+    dirs: [".gemini/commands"],
     files: [
-      { src: "gemini.md", dest: "GEMINI.md" }
+      { src: "gemini.md", dest: "GEMINI.md" },
+      ...geminiCommandFiles
     ]
   },
   zed: {
@@ -152,7 +172,43 @@ var PROVIDERS = {
   }
 };
 var ALL_PROVIDER_IDS = Object.keys(PROVIDERS);
-async function selectProviders() {
+var COMMAND_PROVIDER_IDS = ["claude-code", "copilot", "codex", "gemini", "windsurf"];
+var WORKFLOW_FILES = [
+  { src: "workflow.md", dest: ".sdd/workflow.md" },
+  ...Object.values(PROVIDERS).flatMap((provider) => provider.files)
+];
+function parseProviderList(value) {
+  const rawIds = value.split(",").map((id) => id.trim()).filter(Boolean);
+  if (rawIds.length === 0) {
+    throw new Error("Provider list cannot be empty");
+  }
+  const invalid = rawIds.filter((id) => !ALL_PROVIDER_IDS.includes(id));
+  if (invalid.length > 0) {
+    throw new Error(`Unknown provider: ${invalid.join(", ")}`);
+  }
+  return [...new Set(rawIds)];
+}
+
+// src/commands/init.ts
+async function selectProviders(options) {
+  if (options.provider && options.all) {
+    console.error("\n  error    Use either --provider or --all, not both.\n");
+    process.exit(1);
+  }
+  if (options.provider) {
+    try {
+      return parseProviderList(options.provider);
+    } catch (error) {
+      console.error(`
+  error    ${error.message}`);
+      console.error(`  valid    ${ALL_PROVIDER_IDS.join(", ")}
+`);
+      process.exit(1);
+    }
+  }
+  if (options.all) {
+    return ALL_PROVIDER_IDS;
+  }
   if (!process.stdout.isTTY) {
     return ALL_PROVIDER_IDS;
   }
@@ -167,13 +223,16 @@ async function selectProviders() {
   });
   return selected;
 }
+function formatList(items) {
+  return items.length > 0 ? items.join(", ") : "none";
+}
 async function initCommand(options) {
   const cwd = process.cwd();
-  const { force } = options;
+  const { force, existing } = options;
   console.log("");
-  console.log("  SDD Workflow \u2014 initializing");
+  console.log(`  SDD Workflow \u2014 initializing${existing ? " (existing project mode)" : ""}`);
   console.log("");
-  const selectedProviders = await selectProviders();
+  const selectedProviders = await selectProviders(options);
   console.log("");
   ensureDir(import_path2.default.join(cwd, ".sdd/domains"));
   ensureDir(import_path2.default.join(cwd, "specs/_template"));
@@ -193,41 +252,58 @@ async function initCommand(options) {
       copyTemplate(file.src, import_path2.default.join(cwd, file.dest), force);
     }
   }
+  const providerNames = selectedProviders.map((id) => PROVIDERS[id].name);
+  const commandProviders = selectedProviders.filter((id) => COMMAND_PROVIDER_IDS.includes(id));
+  const rulesOnly = selectedProviders.filter((id) => !COMMAND_PROVIDER_IDS.includes(id));
+  console.log("");
+  console.log("  SDD Workflow initialized");
+  console.log("");
+  console.log(`  Providers: ${formatList(providerNames)}`);
+  console.log(`  Core:      .sdd/workflow.md, .sdd/project-overview.md, .sdd/conventions.md, specs/_template/`);
+  if (commandProviders.length > 0) {
+    const names = commandProviders.map((id) => PROVIDERS[id].name);
+    console.log(`  Commands:  ${formatList(names)}`);
+  }
+  if (rulesOnly.length > 0) {
+    const names = rulesOnly.map((id) => PROVIDERS[id].name);
+    console.log(`  Rules:     ${formatList(names)}`);
+  }
   console.log("");
-  console.log("  Done. Next steps:");
+  console.log("  Next steps:");
   console.log("");
-  console.log("  1. Run /bootstrap to populate project context (new project)");
-  console.log("     or /bootstrap --scan to let the agent analyze the codebase (existing project)");
-  if (!claudeExisted) {
-    console.log("  2. CLAUDE.md was created \u2014 share it with your AI agent as context");
+  if (existing) {
+    console.log("  1. Run /scan to discover the codebase (no .sdd/ writes \u2014 produces scan-report.md)");
+    console.log("     then /bootstrap --scan to populate .sdd/project-overview.md and .sdd/conventions.md");
   } else {
-    console.log("  2. CLAUDE.md already exists \u2014 add a reference to .sdd/ files manually");
+    console.log("  1. Run /bootstrap to populate project context (new project)");
+    console.log("     or /bootstrap --scan to let the agent analyze the codebase (existing project)");
+  }
+  const entryMessages = [];
+  if (selectedProviders.includes("claude-code")) {
+    entryMessages.push(claudeExisted ? "CLAUDE.md already exists \u2014 add a reference to .sdd/ files manually" : "CLAUDE.md was created \u2014 Claude Code will read it automatically");
   }
   if (selectedProviders.includes("gemini")) {
-    if (!geminiExisted) {
-      console.log("     GEMINI.md was created \u2014 Gemini CLI will read it automatically");
-    } else {
-      console.log("     GEMINI.md already exists \u2014 add a reference to .sdd/ files manually");
-    }
+    entryMessages.push(geminiExisted ? "GEMINI.md already exists \u2014 add a reference to .sdd/ files manually" : "GEMINI.md was created \u2014 Gemini CLI will read it automatically");
   }
   if (selectedProviders.includes("codex")) {
-    if (!agentsExisted) {
-      console.log("     AGENTS.md was created \u2014 Codex will read it automatically");
-    } else {
-      console.log("     AGENTS.md already exists \u2014 add a reference to .sdd/ files manually");
+    entryMessages.push(agentsExisted ? "AGENTS.md already exists \u2014 add a reference to .sdd/ files manually" : "AGENTS.md was created \u2014 Codex will read it automatically");
+  }
+  let nextStep = 2;
+  if (entryMessages.length > 0) {
+    console.log(`  ${nextStep}. ${entryMessages[0]}`);
+    for (const message of entryMessages.slice(1)) {
+      console.log(`     ${message}`);
     }
+    nextStep++;
   }
-  const commandProviders = ["claude-code", "copilot", "codex"];
-  const withCommands = selectedProviders.filter((id) => commandProviders.includes(id));
-  const rulesOnly = selectedProviders.filter((id) => !commandProviders.includes(id));
-  if (withCommands.length > 0) {
-    const names = withCommands.map((id) => PROVIDERS[id].name).join(", ");
-    console.log(`  3. Slash commands ready in: ${names}. Type / to see them.`);
+  if (commandProviders.length > 0) {
+    const names = commandProviders.map((id) => PROVIDERS[id].name).join(", ");
+    console.log(`  ${nextStep}. Slash commands ready in: ${names}. Type / to see them.`);
+    nextStep++;
   }
   if (rulesOnly.length > 0) {
     const names = rulesOnly.map((id) => PROVIDERS[id].name).join(", ");
-    const step = withCommands.length === 0 ? "3." : "   ";
-    console.log(`  ${step} Context rules installed for: ${names}. The agent reads workflow.md on every task.`);
+    console.log(`  ${nextStep}. Context rules installed for: ${names}. The agent reads workflow.md on every task.`);
   }
   console.log("");
 }
@@ -265,52 +341,57 @@ function addCommand(type, name) {
 // src/commands/update.ts
 var import_fs4 = __toESM(require("fs"));
 var import_path4 = __toESM(require("path"));
-var WORKFLOW_FILES = [
-  { src: "workflow.md", dest: ".sdd/workflow.md" },
-  { src: "claude-commands/bootstrap.md", dest: ".claude/commands/bootstrap.md" },
-  { src: "claude-commands/ask.md", dest: ".claude/commands/ask.md" },
-  { src: "claude-commands/assume.md", dest: ".claude/commands/assume.md" },
-  { src: "claude-commands/bugfix.md", dest: ".claude/commands/bugfix.md" },
-  { src: "claude-commands/refactor.md", dest: ".claude/commands/refactor.md" },
-  { src: "claude-commands/spec-new.md", dest: ".claude/commands/spec-new.md" },
-  { src: "claude-commands/spec-plan.md", dest: ".claude/commands/spec-plan.md" },
-  { src: "claude-commands/spec-tasks.md", dest: ".claude/commands/spec-tasks.md" },
-  { src: "claude-commands/review.md", dest: ".claude/commands/review.md" },
-  { src: "claude-commands/finish.md", dest: ".claude/commands/finish.md" },
-  { src: "cursor-rules/sddx-workflow.mdc", dest: ".cursor/rules/sddx-workflow.mdc" },
-  { src: "windsurf-rules/sddx-workflow.md", dest: ".windsurf/rules/sddx-workflow.md" },
-  { src: "copilot-prompts/bootstrap.prompt.md", dest: ".github/prompts/bootstrap.prompt.md" },
-  { src: "copilot-prompts/ask.prompt.md", dest: ".github/prompts/ask.prompt.md" },
-  { src: "copilot-prompts/assume.prompt.md", dest: ".github/prompts/assume.prompt.md" },
-  { src: "copilot-prompts/bugfix.prompt.md", dest: ".github/prompts/bugfix.prompt.md" },
-  { src: "copilot-prompts/refactor.prompt.md", dest: ".github/prompts/refactor.prompt.md" },
-  { src: "copilot-prompts/spec-new.prompt.md", dest: ".github/prompts/spec-new.prompt.md" },
-  { src: "copilot-prompts/spec-plan.prompt.md", dest: ".github/prompts/spec-plan.prompt.md" },
-  { src: "copilot-prompts/spec-tasks.prompt.md", dest: ".github/prompts/spec-tasks.prompt.md" },
-  { src: "copilot-prompts/review.prompt.md", dest: ".github/prompts/review.prompt.md" },
-  { src: "copilot-prompts/finish.prompt.md", dest: ".github/prompts/finish.prompt.md" },
-  { src: "copilot-instructions.md", dest: ".github/copilot-instructions.md" },
-  { src: "zed-rules/sddx-workflow.md", dest: ".rules" }
-];
-function updateCommand() {
+function fileChanged(src, dest) {
+  const template = import_fs4.default.readFileSync(import_path4.default.join(TEMPLATES_DIR, src), "utf8");
+  const current = import_fs4.default.readFileSync(dest, "utf8");
+  return template !== current;
+}
+function updateCommand(options = {}) {
   const cwd = process.cwd();
   if (!import_fs4.default.existsSync(import_path4.default.join(cwd, ".sdd"))) {
-    console.error("\n  error    .sdd/ not found. Run `npx sddx-workflow init` first.\n");
+    console.error("\n  error    No SDD installation found in this directory.");
+    console.error("  next     Run `npx sddx-workflow init` or cd into a project that already has .sdd/.\n");
     process.exit(1);
   }
   console.log("");
-  console.log("  SDD Workflow \u2014 updating workflow files");
-  console.log("  (project-overview.md, conventions.md, CLAUDE.md, and domains are yours \u2014 untouched)");
+  console.log(`  SDD Workflow \u2014 ${options.check ? "checking" : options.dryRun ? "previewing" : "updating"} workflow files`);
+  console.log("  (project-overview.md, conventions.md, and domains are yours \u2014 untouched)");
+  console.log("  (only files that already exist are updated \u2014 run `init --force` to add new commands)");
   console.log("");
   let updated = 0;
+  let unchanged = 0;
+  let missing = 0;
   for (const file of WORKFLOW_FILES) {
     const dest = import_path4.default.join(cwd, file.dest);
-    if (!import_fs4.default.existsSync(dest)) continue;
+    if (!import_fs4.default.existsSync(dest)) {
+      missing++;
+      continue;
+    }
+    if (!fileChanged(file.src, dest)) {
+      unchanged++;
+      continue;
+    }
+    if (options.check || options.dryRun) {
+      console.log(`  update   ${displayPath(dest)}`);
+      updated++;
+      continue;
+    }
     copyTemplate(file.src, dest, true);
     updated++;
   }
   console.log("");
-  console.log(`  Done. ${updated} file${updated !== 1 ? "s" : ""} updated.
+  if (options.check) {
+    console.log(`  ${updated === 0 ? "ok" : "outdated"}      ${updated} outdated, ${unchanged} current, ${missing} not installed`);
+    if (updated > 0) process.exit(1);
+    console.log("");
+    return;
+  }
+  if (options.dryRun) {
+    console.log(`  Preview. ${updated} file${updated !== 1 ? "s" : ""} would be updated, ${unchanged} current, ${missing} not installed.
+`);
+    return;
+  }
+  console.log(`  Done. ${updated} file${updated !== 1 ? "s" : ""} updated, ${unchanged} current, ${missing} not installed.
 `);
 }
 
@@ -320,28 +401,97 @@ var import_path5 = __toESM(require("path"));
 function isBootstrapped(cwd) {
   const file = import_path5.default.join(cwd, ".sdd/project-overview.md");
   if (!import_fs5.default.existsSync(file)) return false;
-  const lines = import_fs5.default.readFileSync(file, "utf8").split("\n");
+  const withoutComments = import_fs5.default.readFileSync(file, "utf8").replace(/<!--[\s\S]*?-->/g, "");
+  const lines = withoutComments.split("\n");
   return lines.some((line) => {
     const t = line.trim();
-    return t.length > 0 && !t.startsWith("#") && !t.startsWith("<!--") && !t.startsWith("-->");
+    return t.length > 0 && !t.startsWith("#") && !t.startsWith(">");
   });
 }
+function stripComments(content) {
+  return content.replace(/<!--[\s\S]*?-->/g, "");
+}
+function isPlanApproved(specDir) {
+  const planFile = import_path5.default.join(specDir, "2-plan.md");
+  const tasksFile = import_path5.default.join(specDir, "3-tasks.md");
+  if (import_fs5.default.existsSync(planFile)) {
+    const plan = stripComments(import_fs5.default.readFileSync(planFile, "utf8"));
+    if (/^- \[x\]\s+\*\*Approved\*\*/im.test(plan)) return true;
+  }
+  if (import_fs5.default.existsSync(tasksFile)) {
+    const tasks = import_fs5.default.readFileSync(tasksFile, "utf8");
+    const match = tasks.match(/^Plan approved:\s*(.+)$/im);
+    return Boolean(match && match[1].trim() && !match[1].includes("<!--"));
+  }
+  return false;
+}
+function countPendingCrs(specDir) {
+  const file = import_path5.default.join(specDir, "amendments.md");
+  if (!import_fs5.default.existsSync(file)) return 0;
+  const content = stripComments(import_fs5.default.readFileSync(file, "utf8"));
+  return (content.match(/\*\*Status:\*\*\s*Pending approval/gi) ?? []).length;
+}
+function countUnresolvedGaps(specDir) {
+  const file = import_path5.default.join(specDir, "impl-gaps.md");
+  if (!import_fs5.default.existsSync(file)) return 0;
+  const content = stripComments(import_fs5.default.readFileSync(file, "utf8"));
+  const entries = content.split(/^##\s+GAP-\d+/gim).slice(1);
+  return entries.filter((entry) => {
+    const resolution = entry.match(/\*\*Resolution:\*\*\s*(.*)/i);
+    return !resolution || resolution[1].trim().length === 0 || /filled|pending|tbd/i.test(resolution[1]);
+  }).length;
+}
+function inferPhase(specDir, planApproved, tasksDone, tasksTotal) {
+  const requirementsFile = import_path5.default.join(specDir, "1-requirements.md");
+  const planFile = import_path5.default.join(specDir, "2-plan.md");
+  const tasksFile = import_path5.default.join(specDir, "3-tasks.md");
+  const verifyFile = import_path5.default.join(specDir, "verify-report.md");
+  if (!import_fs5.default.existsSync(requirementsFile)) return "missing requirements";
+  if (!import_fs5.default.existsSync(planFile)) return "drafting requirements";
+  if (!planApproved) return "awaiting plan approval";
+  if (!import_fs5.default.existsSync(tasksFile)) return "awaiting tasks";
+  if (tasksTotal === 0) return "tasks not planned";
+  if (tasksDone < tasksTotal) return "in /spec-tasks";
+  if (!import_fs5.default.existsSync(verifyFile)) return "awaiting /verify";
+  const verify = import_fs5.default.readFileSync(verifyFile, "utf8");
+  return /\bFAIL\b/i.test(verify) ? "verify failed" : "review pending";
+}
 function readSpec(specDir) {
   const name = import_path5.default.basename(specDir);
   const tasksFile = import_path5.default.join(specDir, "3-tasks.md");
+  const planApproved = isPlanApproved(specDir);
+  const pendingCrs = countPendingCrs(specDir);
+  const unresolvedGaps = countUnresolvedGaps(specDir);
   if (!import_fs5.default.existsSync(tasksFile)) {
-    return { name, planApproved: false, tasksDone: 0, tasksTotal: 0 };
+    return {
+      name,
+      phase: inferPhase(specDir, planApproved, 0, 0),
+      planApproved,
+      tasksDone: 0,
+      tasksTotal: 0,
+      pendingCrs,
+      unresolvedGaps
+    };
   }
   const content = import_fs5.default.readFileSync(tasksFile, "utf8");
-  const planApproved = !content.includes("<!-- date -->");
-  const tasksDone = (content.match(/^- \[x\]/gim) ?? []).length;
-  const tasksPending = (content.match(/^- \[ \]/gim) ?? []).length;
-  return { name, planApproved, tasksDone, tasksTotal: tasksDone + tasksPending };
+  const taskMatches = [...content.matchAll(/^- \[(x| )\]\s+\*\*(?:T\d+|Task\b)/gim)];
+  const tasksDone = taskMatches.filter((match) => match[1].toLowerCase() === "x").length;
+  const tasksTotal = taskMatches.length;
+  return {
+    name,
+    phase: inferPhase(specDir, planApproved, tasksDone, tasksTotal),
+    planApproved,
+    tasksDone,
+    tasksTotal,
+    pendingCrs,
+    unresolvedGaps
+  };
 }
 function statusCommand() {
   const cwd = process.cwd();
   if (!import_fs5.default.existsSync(import_path5.default.join(cwd, ".sdd"))) {
-    console.error("\n  error    .sdd/ not found. Run `npx sddx-workflow init` first.\n");
+    console.error("\n  error    No SDD installation found in this directory.");
+    console.error("  next     Run `npx sddx-workflow init` or cd into a project that already has .sdd/.\n");
     process.exit(1);
   }
   console.log("");
@@ -357,14 +507,103 @@ function statusCommand() {
   console.log(`  open specs   ${specs.length}`);
   for (const spec of specs) {
     const label = spec.name.padEnd(14);
-    if (!spec.planApproved) {
-      console.log(`    ${label} awaiting approval`);
-    } else if (spec.tasksDone === spec.tasksTotal && spec.tasksTotal > 0) {
-      console.log(`    ${label} ${spec.tasksDone}/${spec.tasksTotal} tasks \xB7 done`);
-    } else {
-      console.log(`    ${label} ${spec.tasksDone}/${spec.tasksTotal} tasks \xB7 in progress`);
+    const progress = spec.tasksTotal > 0 ? `${spec.tasksDone}/${spec.tasksTotal} tasks` : "no tasks";
+    const outstanding = [
+      spec.pendingCrs > 0 ? `${spec.pendingCrs} pending CR${spec.pendingCrs === 1 ? "" : "s"}` : "",
+      spec.unresolvedGaps > 0 ? `${spec.unresolvedGaps} unresolved gap${spec.unresolvedGaps === 1 ? "" : "s"}` : ""
+    ].filter(Boolean).join(" \xB7 ");
+    const suffix = outstanding ? ` \xB7 ${outstanding}` : "";
+    console.log(`    ${label} ${spec.phase} \xB7 ${progress}${suffix}`);
+  }
+  console.log("");
+}
+
+// src/commands/doctor.ts
+var import_fs6 = __toESM(require("fs"));
+var import_path6 = __toESM(require("path"));
+var OBSOLETE_PATHS = [
+  "src/commands/snapshot.ts",
+  "templates/claude-commands/spec-restore.md",
+  "templates/codex-skills/spec-restore/SKILL.md",
+  "templates/copilot-prompts/spec-restore.prompt.md",
+  "templates/gemini-commands/spec-restore.toml",
+  "templates/windsurf-workflows/spec-restore.md",
+  ".claude/commands/spec-restore.md",
+  ".agents/skills/spec-restore/SKILL.md",
+  ".github/prompts/spec-restore.prompt.md",
+  ".gemini/commands/spec-restore.toml",
+  ".windsurf/workflows/spec-restore.md"
+];
+function exists(cwd, relativePath) {
+  return import_fs6.default.existsSync(import_path6.default.join(cwd, relativePath));
+}
+function providerHealth(cwd) {
+  return Object.entries(PROVIDERS).map(([id, provider]) => ({
+    id,
+    name: provider.name,
+    installed: provider.files.filter((file) => exists(cwd, file.dest)).length,
+    missing: provider.files.filter((file) => !exists(cwd, file.dest)).map((file) => file.dest)
+  })).filter((provider) => provider.installed > 0);
+}
+function doctorCommand() {
+  const cwd = process.cwd();
+  const issues = [];
+  const warnings = [];
+  console.log("");
+  console.log("  SDD Workflow doctor");
+  console.log("");
+  const hasSdd = exists(cwd, ".sdd");
+  console.log(`  install       ${hasSdd ? "found" : "missing"}`);
+  if (!hasSdd) {
+    console.log("");
+    console.log("  error        No .sdd/ directory found. Run `npx sddx-workflow init`.");
+    console.log("");
+    process.exit(1);
+  }
+  const missingCore = CORE_FILES.map((file) => file.dest).filter((dest) => !exists(cwd, dest));
+  console.log(`  core files    ${missingCore.length === 0 ? "ok" : `${missingCore.length} missing`}`);
+  for (const missing of missingCore) {
+    warnings.push(`Missing core file: ${missing}`);
+  }
+  const providers = providerHealth(cwd);
+  console.log(`  providers     ${providers.length > 0 ? providers.map((provider) => provider.name).join(", ") : "none detected"}`);
+  if (providers.length === 0) {
+    warnings.push("No provider files detected. Run `npx sddx-workflow init --provider <id>` or `npx sddx-workflow init --all`.");
+  }
+  for (const provider of providers) {
+    if (provider.missing.length > 0) {
+      warnings.push(`${provider.name} appears partially installed (${provider.missing.length} missing file${provider.missing.length === 1 ? "" : "s"}). Run \`npx sddx-workflow init --force --provider ${provider.id}\` to reinstall it.`);
     }
   }
+  const obsolete = OBSOLETE_PATHS.filter((relativePath) => exists(cwd, relativePath));
+  console.log(`  obsolete      ${obsolete.length === 0 ? "none" : `${obsolete.length} found`}`);
+  for (const item of obsolete) {
+    warnings.push(`Obsolete snapshot/restore file remains: ${item}`);
+  }
+  console.log("");
+  if (issues.length === 0 && warnings.length === 0) {
+    console.log("  ok           installation looks healthy");
+    console.log("");
+    return;
+  }
+  for (const issue of issues) {
+    console.log(`  error        ${issue}`);
+  }
+  for (const warning of warnings) {
+    console.log(`  warn         ${warning}`);
+  }
+  console.log("");
+  if (issues.length > 0) process.exit(1);
+}
+
+// src/commands/commands.ts
+function commandsCommand() {
+  console.log("");
+  console.log("  Agent commands");
+  console.log("");
+  for (const name of COMMAND_NAMES) {
+    console.log(`  /${name}`);
+  }
   console.log("");
 }
 
@@ -373,8 +612,10 @@ var import_module = require("module");
 var pkg = (0, import_module.createRequire)(__filename)("../package.json");
 var program = new import_commander.Command();
 program.name("sddx-workflow").description("Spec-Driven Development CLI").version(pkg.version);
-program.command("init").description("Initialize SDD protocol in the current project").option("--force", "Overwrite files that already exist").action(initCommand);
+program.command("init").description("Initialize SDD protocol in the current project").option("--force", "Overwrite files that already exist").option("--existing", "Brownfield mode: prints next-steps that start with /scan and /bootstrap --scan").option("--provider <ids>", "Comma-separated providers to install (claude-code,cursor,windsurf,copilot,codex,gemini,zed)").option("--all", "Install all provider integrations without prompting").action(initCommand);
 program.command("add <type> <name>").description("Add an SDD component to an existing installation").addHelpText("after", "\nExamples:\n  $ sddx-workflow add domain auth\n  $ sddx-workflow add domain payments").action(addCommand);
-program.command("update").description("Update protocol files to the latest version (leaves your config files untouched)").action(updateCommand);
+program.command("update").description("Update protocol files to the latest version").option("--dry-run", "Show which installed workflow files would change").option("--check", "Exit non-zero when installed workflow files are outdated").action(updateCommand);
 program.command("status").description("Show bootstrap status and open specs progress").action(statusCommand);
+program.command("doctor").description("Check SDD installation health and provider files").action(doctorCommand);
+program.command("commands").description("List agent commands installed by provider integrations").action(commandsCommand);
 program.parseAsync();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sddx-workflow",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Spec-Driven Development CLI — installs an SDD system in any project",
   "keywords": [
     "sdd",