coding-agent-harness 1.0.4 → 1.0.6

package/scripts/commands/preset-command.mjs

@@ -1,73 +0,0 @@
-import {
-  checkPresetPackage,
-  inspectPresetPackage,
-  installPresetPackage,
-  listPresetPackages,
-  seedBundledPresets,
-  uninstallPresetPackage,
-} from "../lib/harness-core.mjs";
-
-export function runPresetCommand({ args, takeFlag, targetArg }) {
-  const subcommand = args.shift() || "list";
-  const json = takeFlag("--json");
-  const project = takeFlag("--project");
-  try {
-    if (subcommand === "list") {
-      const target = targetArg();
-      const presets = listPresetPackages({ targetInput: target }).map((preset) => ({
-        id: preset.id,
-        version: preset.version,
-        purpose: preset.purpose,
-        compatibleBudgets: preset.compatibleBudgets,
-        source: preset.source,
-        manifestPath: preset.manifestRelativePath,
-      }));
-      if (json) console.log(JSON.stringify({ presets }, null, 2));
-      else for (const preset of presets) console.log(`${preset.id}@${preset.version} [${preset.source}] ${preset.compatibleBudgets.join(",")} - ${preset.purpose}`);
-    } else if (subcommand === "inspect") {
-      const id = args.shift();
-      if (!id) throw new Error("Missing preset id");
-      const preset = inspectPresetPackage(id, { targetInput: targetArg() });
-      if (json) console.log(JSON.stringify(preset, null, 2));
-      else console.log(`${preset.id}@${preset.version}\n${preset.purpose}`);
-    } else if (subcommand === "check") {
-      const id = args.shift();
-      if (!id) throw new Error("Missing preset id");
-      const report = checkPresetPackage(id, { targetInput: targetArg() });
-      if (json) console.log(JSON.stringify(report, null, 2));
-      else {
-        for (const failure of report.failures) console.error(`Failure: ${failure}`);
-        for (const warning of report.warnings) console.log(`Warning: ${warning}`);
-        console.log(`Preset check ${report.status}: ${report.id}@${report.version}`);
-      }
-      process.exit(report.status === "pass" ? 0 : 1);
-    } else if (subcommand === "install") {
-      const force = takeFlag("--force");
-      const source = args.shift();
-      if (!source) throw new Error("Missing preset source");
-      const result = installPresetPackage(source, { force, scope: project ? "project" : "user", targetInput: targetArg() });
-      if (json) console.log(JSON.stringify(result, null, 2));
-      else console.log(`Installed preset ${result.id}@${result.version} to ${result.destination}`);
-    } else if (subcommand === "seed") {
-      const force = takeFlag("--force");
-      const dryRun = takeFlag("--dry-run");
-      const result = seedBundledPresets({ force, dryRun, scope: project ? "project" : "user", targetInput: targetArg() });
-      if (json) console.log(JSON.stringify(result, null, 2));
-      else {
-        console.log(`Seeded bundled presets to ${result.target}`);
-        for (const preset of result.presets) console.log(`${preset.action}: ${preset.id}@${preset.version}`);
-      }
-    } else if (subcommand === "uninstall") {
-      const id = args.shift();
-      if (!id) throw new Error("Missing preset id");
-      const result = uninstallPresetPackage(id, { scope: project ? "project" : "user", targetInput: targetArg() });
-      if (json) console.log(JSON.stringify(result, null, 2));
-      else console.log(`${result.removed ? "Removed" : "Preset not installed"}: ${result.id}`);
-    } else {
-      throw new Error(`Unknown preset subcommand: ${subcommand}`);
-    }
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-}

package/scripts/commands/task-command.mjs

@@ -1,327 +0,0 @@
-import fs from "node:fs";
-import {
-  confirmTaskReview,
-  createTask,
-  readPresetPackage,
-  buildTaskIndex,
-  createLessonSedimentationTask,
-  archiveTask,
-  listLifecycleTasks,
-  promoteLessonCandidate,
-  reopenTask,
-  softDeleteTask,
-  supersedeTask,
-  updateModuleStep,
-  updateTaskPhase,
-  updateTaskLifecycle,
-} from "../lib/harness-core.mjs";
-
-export function runTaskCommand(command, { args, takeFlag, takeOption, targetArg }) {
-  if (command === "new-task") {
-    const dryRun = takeFlag("--dry-run");
-    const locale = takeOption("--locale", "");
-    const title = takeOption("--title", "");
-    const moduleKey = takeOption("--module", "");
-    const budget = takeOption("--budget", "standard");
-    const preset = takeOption("--preset", "");
-    const fromSession = takeOption("--from-session", "");
-    const longRunning = takeFlag("--long-running");
-    try {
-      const parsed = parseNewTaskArgs(args, { preset, fromSession });
-      const taskId = parsed.taskId;
-      if (!taskId) {
-        console.error("Missing task id");
-        process.exit(2);
-      }
-      console.log(JSON.stringify(createTask(parsed.target, taskId, { title, locale, dryRun, moduleKey, budget, longRunning, preset, fromSession, presetArgs: parsed.presetArgs }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "task-phase") {
-    const state = takeOption("--state", "");
-    const completion = takeOption("--completion", "");
-    const evidenceStatus = takeOption("--evidence", "");
-    const taskId = args.shift();
-    const phaseId = args.shift();
-    if (!taskId || !phaseId) {
-      console.error("Missing task id or phase id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(updateTaskPhase(targetArg(), taskId, phaseId, { state, completion, evidenceStatus }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (["task-start", "task-log", "task-block", "task-review", "task-complete"].includes(command)) {
-    const message = takeOption("--message", "");
-    const evidence = takeOption("--evidence", "");
-    const taskId = args.shift();
-    if (!taskId) {
-      console.error("Missing task id");
-      process.exit(2);
-    }
-    const lifecycle = {
-      "task-start": { event: "task-start", state: "in_progress" },
-      "task-log": { event: "task-log", state: "" },
-      "task-block": { event: "task-block", state: "blocked" },
-      "task-review": { event: "task-review", state: "review" },
-      "task-complete": { event: "task-complete", state: "done" },
-    }[command];
-    try {
-      console.log(JSON.stringify(updateTaskLifecycle(targetArg(), taskId, { ...lifecycle, message, evidence }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "review-confirm") {
-    const reviewer = takeOption("--reviewer", "Human Reviewer");
-    const message = takeOption("--message", "");
-    const evidence = takeOption("--evidence", "");
-    const confirmText = takeOption("--confirm", "");
-    const taskId = args.shift();
-    if (!taskId) {
-      console.error("Missing task id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(confirmTaskReview(targetArg(), taskId, { reviewer, message, evidence, confirmText }), null, 2));
-    } catch (error) {
-      console.error(formatTaskCommandError(error));
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "lesson-promote") {
-    const dryRun = takeFlag("--dry-run");
-    const apply = takeFlag("--apply");
-    const taskId = args.shift();
-    const candidateId = args.shift();
-    if (!taskId || !candidateId) {
-      console.error("Missing task id or candidate id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(promoteLessonCandidate(targetArg(), taskId, candidateId, { dryRun, apply }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "lesson-sediment") {
-    const dryRun = takeFlag("--dry-run");
-    const title = takeOption("--title", "");
-    const taskId = args.shift();
-    const candidateId = args.shift();
-    if (!taskId || !candidateId) {
-      console.error("Missing task id or candidate id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(createLessonSedimentationTask(targetArg(), taskId, candidateId, { dryRun, title }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "task-list") {
-    const json = takeFlag("--json");
-    const state = takeOption("--state", "");
-    const moduleKey = takeOption("--module", "");
-    const queue = takeOption("--queue", "");
-    const preset = takeOption("--preset", "");
-    const review = takeOption("--review", "");
-    const lesson = takeOption("--lesson", "");
-    const search = takeOption("--search", "");
-    const missingMaterials = takeFlag("--missing-materials");
-    const result = listLifecycleTasks(targetArg(), { state, moduleKey, queue, preset, review, lesson, search, missingMaterials });
-    if (json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      for (const task of result.tasks) {
-        console.log(`${task.id}\t${task.state}\t${task.completion}%\t${task.title}`);
-      }
-    }
-    return;
-  }
-
-  if (command === "task-index") {
-    const json = takeFlag("--json");
-    const result = buildTaskIndex(targetArg());
-    if (json) console.log(JSON.stringify(result, null, 2));
-    else console.log(`${result.tasks.length} tasks indexed (${result.schemaVersion})`);
-    return;
-  }
-
-  if (command === "task-supersede") {
-    const by = takeOption("--by", "");
-    const reason = takeOption("--reason", "");
-    const taskId = args.shift();
-    if (!taskId) {
-      console.error("Missing task id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(supersedeTask(targetArg(), taskId, { by, reason }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (["task-delete", "task-archive", "task-reopen"].includes(command)) {
-    const soft = takeFlag("--soft");
-    const reason = takeOption("--reason", "");
-    const taskId = args.shift();
-    if (!taskId) {
-      console.error("Missing task id");
-      process.exit(2);
-    }
-    try {
-      if (command === "task-delete" && !soft) throw new Error("task-delete only supports --soft; hard delete is intentionally disabled.");
-      const result =
-        command === "task-delete"
-          ? softDeleteTask(targetArg(), taskId, { reason })
-          : command === "task-archive"
-            ? archiveTask(targetArg(), taskId, { reason })
-            : reopenTask(targetArg(), taskId, { reason });
-      console.log(JSON.stringify(result, null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "module-step") {
-    const state = takeOption("--state", "done");
-    const moduleKey = args.shift();
-    const stepId = args.shift();
-    if (!moduleKey || !stepId) {
-      console.error("Missing module key or step id");
-      process.exit(2);
-    }
-    try {
-      console.log(JSON.stringify(updateModuleStep(targetArg(), moduleKey, stepId, { state }), null, 2));
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  throw new Error(`Unsupported task command: ${command}`);
-}
-
-function parseNewTaskArgs(args, { preset = "", fromSession = "" } = {}) {
-  const values = [...args];
-  let taskId = "";
-  if (!fromSession) {
-    taskId = values.shift() || "";
-  } else if (values.length > 0 && !values[0].startsWith("-") && !(values.length === 1 && fs.existsSync(values[0]))) {
-    taskId = values.shift();
-  }
-  const presetPackage = preset ? readPresetPackageForNewTask(preset, values) : null;
-  if (!taskId && fromSession) taskId = presetPackage?.task?.defaultTaskId || "harness-v1-migration";
-  const parsed = splitPresetArgsAndTarget(values, presetPackage);
-  return {
-    taskId,
-    target: parsed.target || ".",
-    presetArgs: parsed.presetArgs,
-  };
-}
-
-function readPresetPackageForNewTask(preset, values) {
-  const candidates = presetDiscoveryTargetCandidates(values);
-  let fallbackPackage = null;
-  let lastError = null;
-  for (const targetInput of candidates) {
-    try {
-      const presetPackage = readPresetPackage(preset, { targetInput });
-      if (presetPackage.source === "project") return presetPackage;
-      if (!fallbackPackage) fallbackPackage = presetPackage;
-    } catch (error) {
-      lastError = error;
-    }
-  }
-  if (fallbackPackage) return fallbackPackage;
-  throw lastError;
-}
-
-function presetDiscoveryTargetCandidates(values) {
-  const candidates = [];
-  for (let index = values.length - 1; index >= 0; index -= 1) {
-    const value = values[index];
-    if (!value || value.startsWith("-")) continue;
-    if (!candidates.includes(value)) candidates.push(value);
-  }
-  if (!candidates.includes(".")) candidates.push(".");
-  return candidates;
-}
-
-function splitPresetArgsAndTarget(values, presetPackage) {
-  const presetArgs = [];
-  const targetCandidates = [];
-  const declaredFlags = new Map(Object.values(presetPackage?.inputs || {}).filter((input) => input.flag).map((input) => [input.flag, input]));
-  for (let index = 0; index < values.length; index += 1) {
-    const value = values[index];
-    const declared = declaredFlags.get(value);
-    if (declared) {
-      presetArgs.push(value);
-      if (declared.type !== "flag" && index + 1 < values.length) {
-        presetArgs.push(values[index + 1]);
-        index += 1;
-      }
-    } else if (value.startsWith("-")) {
-      presetArgs.push(value);
-      if (index + 1 < values.length && !values[index + 1].startsWith("-")) {
-        presetArgs.push(values[index + 1]);
-        index += 1;
-      }
-    } else {
-      targetCandidates.push(value);
-    }
-  }
-  if (targetCandidates.length > 1) {
-    throw new Error(`Too many positional arguments for new-task: ${targetCandidates.join(", ")}`);
-  }
-  return {
-    target: targetCandidates[0] || "",
-    presetArgs,
-  };
-}
-
-function formatTaskCommandError(error) {
-  const lines = [error.message];
-  if (Array.isArray(error.recovery) && error.recovery.length > 0) {
-    lines.push("", "Recovery:");
-    for (const item of error.recovery) lines.push(`- ${item}`);
-  }
-  if (error.details?.entries?.length) {
-    lines.push("", "Blocking Git status:");
-    for (const entry of error.details.entries) lines.push(`- ${entry.raw || entry.path}`);
-  }
-  if (error.details?.disallowed?.length) {
-    lines.push("", "Disallowed paths:");
-    for (const item of error.details.disallowed) lines.push(`- ${item}`);
-  }
-  if (error.details?.stderr) lines.push("", error.details.stderr);
-  if (error.details?.stdout) lines.push("", error.details.stdout);
-  return lines.join("\n");
-}

package/scripts/harness.mjs

@@ -1,287 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { createInterface } from "node:readline/promises";
-import {
-  addCapability,
-  buildStatus,
-  doctorUserSkill,
-  installUserSkill,
-  normalizeLocale,
-  rebuildGovernanceIndexes,
-  serveDashboardWorkbench,
-  validateSourcePackageBoundary,
-  writeInitFiles,
-} from "./lib/harness-core.mjs";
-import { runDashboardCommand } from "./commands/dashboard-command.mjs";
-import { runMigrationCommand } from "./commands/migration-command.mjs";
-import { runPresetCommand } from "./commands/preset-command.mjs";
-import { runTaskCommand } from "./commands/task-command.mjs";
-
-const args = process.argv.slice(2);
-const command = args.shift() || "help";
-
-function takeFlag(name, fallback = false) {
-  const index = args.indexOf(name);
-  if (index < 0) return fallback;
-  args.splice(index, 1);
-  return true;
-}
-
-function takeOption(name, fallback = "") {
-  const index = args.indexOf(name);
-  if (index < 0) return fallback;
-  const value = args[index + 1] || fallback;
-  args.splice(index, 2);
-  return value;
-}
-
-async function resolveInitLocale(requestedLocale) {
-  if (requestedLocale) return normalizeLocale(requestedLocale);
-  if (!process.stdin.isTTY || !process.stdout.isTTY) return "en-US";
-
-  const prompt = [
-    "Select harness language / 选择初始化语言:",
-    "  1. 中文 (zh-CN)",
-    "  2. English (en-US)",
-    "Language [1/2, default 2]: ",
-  ].join("\n");
-  const reader = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = (await reader.question(prompt)).trim().toLowerCase();
-    if (["1", "zh", "zh-cn", "cn", "中文"].includes(answer)) return "zh-CN";
-    if (["2", "en", "en-us", "english", "英文", ""].includes(answer)) return "en-US";
-    console.error(`Unknown language selection: ${answer}. Falling back to en-US.`);
-    return "en-US";
-  } finally {
-    reader.close();
-  }
-}
-
-async function confirmUserInstall({ yes = false, dryRun = false, agent = "codex" } = {}) {
-  if (yes || dryRun) return true;
-  if (!process.stdin.isTTY || !process.stdout.isTTY) return false;
-  const reader = createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const answer = (await reader.question(`Install Coding Agent Harness into user skill directory for ${agent}? [y/N] `)).trim().toLowerCase();
-    return ["y", "yes"].includes(answer);
-  } finally {
-    reader.close();
-  }
-}
-
-function targetArg() {
-  return args[args.length - 1] && !args[args.length - 1].startsWith("-") ? args[args.length - 1] : ".";
-}
-
-function printHelp() {
-  console.log(`Coding Agent Harness
-
-Usage:
-  harness check [--profile source-package|private-harness|target-project] [target]
-  harness status [--json] [--strict] [target]
-  harness dev [--no-open] [--out-dir folder] [--host 127.0.0.1] [--port n] [target]
-  harness dashboard [--out file.html] [--out-dir folder] [--workbench] [--host 127.0.0.1] [--port n] [target]
-  harness init [--dry-run] [--locale zh-CN|en-US] [--capabilities core,dashboard] [--add-npm-scripts] [target]
-  harness add-capability <name> [--dry-run] [--locale zh-CN|en-US] [target]
-  harness migrate-plan [--json] [--limit n] [target]
-  harness migrate-run [--locale zh-CN|en-US] [--assume-locale] [--allow-dirty] [--plan-only] [--out-dir folder] [--session-dir folder] [target]
-  harness migrate-verify [--json] [--full-cutover] <session.json>
-  harness governance rebuild [--dry-run] [--archive] [--apply] [target]
-  harness preset list [--json] [target]
-  harness preset inspect <id> [--json] [target]
-  harness preset check <id> [--json] [target]
-  harness preset install <path-or-builtin-id> [--project] [--force] [--json] [target]
-  harness preset seed [--project] [--force] [--dry-run] [--json] [target]
-  harness preset uninstall <id> [--project] [--json] [target]
-  harness new-task <task-id> [--module key] [--budget simple|standard|complex] [--preset id] [--from-session session.json] [--long-running] [--title title] [--locale zh-CN|en-US] [--dry-run] [target]
-  harness task-start <task-id> [--message text] [target]
-  harness task-phase <task-id> <phase-id> [--state done] [--completion 100] [--evidence present] [target]
-  harness task-log <task-id> --message text [--evidence type:PATH:summary] [target]
-  harness task-block <task-id> [--message text] [target]
-  harness task-review <task-id> [--message text] [target]
-  harness review-confirm <task-id> --confirm task-id [--reviewer name] [--message text] [target]
-  harness lesson-promote <task-id> <candidate-id> [--dry-run|--apply] [target]
-  harness lesson-sediment <task-id> <candidate-id> [--dry-run] [--title title] [target]
-  harness task-complete <task-id> [--message text] [target]
-  harness task-list [--json] [--state state] [--module key] [--queue queue] [--preset id] [--review status] [--lesson status] [--missing-materials] [--search text] [target]
-  harness task-index [--json] [target]
-  harness task-supersede <old-task-id> --by <new-task-id> [--reason text] [target]
-  harness task-delete <task-id> --soft [--reason text] [target]
-  harness task-archive <task-id> [--reason text] [target]
-  harness task-reopen <task-id> [--reason text] [target]
-  harness module-step <module-key> <step-id> [--state done|in-progress|blocked] [target]
-  harness install-user [--agent codex|claude|gemini|openclaw|agents|all] [--home dir] [--dry-run] [--force] [--skip-presets] [--yes]
-  harness doctor-user [--agent codex|claude|gemini|openclaw|agents|all] [--home dir]
-
-If init runs in an interactive terminal and --locale is omitted, it asks for a
-language. Non-interactive init defaults to en-US.
-
-Preset discovery:
-  Project presets live in <target>/.coding-agent-harness/presets/<preset-id>/.
-  User presets live in ~/.coding-agent-harness/presets/<preset-id>/.
-  Harness discovers project presets first when a target is supplied, then user
-  presets, then bundled package presets under presets/<preset-id>/.
-  "harness init" seeds bundled presets into the target project. "harness
-  install-user" and npm postinstall seed bundled presets into the user root.
-  Use "harness preset seed" to repair or re-run preset seeding.
-  Use "harness preset list --json" to see available presets, their source,
-  purpose, compatible budgets, and manifest path. Use "harness preset inspect
-  <id> --json" for the full preset manifest summary.
-`);
-}
-
-function exitWithReport(report) {
-  for (const warning of report.warnings || []) console.log(`Warning: ${warning}`);
-  for (const failure of report.failures || []) console.error(`Failure: ${failure}`);
-  process.exit((report.failures || []).length > 0 ? 1 : 0);
-}
-
-if (command === "help" || command === "--help" || command === "-h") {
-  printHelp();
-} else if (args[0] === "help" || args.includes("--help") || args.includes("-h")) {
-  printHelp();
-} else if (command === "check") {
-  const profile = takeOption("--profile", "target-project");
-  const strict = takeFlag("--strict");
-  const target = targetArg();
-  const failures = [];
-  const warnings = [];
-
-  if (profile === "source-package") {
-    for (const required of ["package.json", "scripts/harness.mjs", "scripts/check-harness.mjs", "templates/planning/task_plan.md"]) {
-      if (!fs.existsSync(path.resolve(target, required))) failures.push(`missing source package file: ${required}`);
-    }
-    const boundary = validateSourcePackageBoundary(target);
-    failures.push(...boundary.failures);
-    warnings.push(...boundary.warnings);
-  }
-
-  const status = buildStatus(target, { skipLegacyCheck: profile === "source-package", strictLegacy: strict, strict });
-  failures.push(...status.checkState.details.failures);
-  warnings.push(...status.checkState.details.warnings);
-
-  if (!["source-package", "private-harness", "target-project"].includes(profile)) failures.push(`unknown profile: ${profile}`);
-  if (failures.length === 0) console.log(`Harness check passed (${profile}): ${path.resolve(target)}`);
-  exitWithReport({ failures: [...new Set(failures)], warnings: [...new Set(warnings)] });
-} else if (command === "status") {
-  const json = takeFlag("--json");
-  const strict = takeFlag("--strict");
-  const status = buildStatus(targetArg(), { strictLegacy: strict, strict });
-  if (json) {
-    console.log(JSON.stringify(status, null, 2));
-  } else {
-    console.log(`${status.project.name}: ${status.checkState.status} (${status.checkState.failures} failures, ${status.checkState.warnings} warnings)`);
-    console.log(`mode: ${status.mode}`);
-    console.log(`capabilities: ${status.capabilities.map((capability) => `${capability.name}:${capability.state}`).join(", ")}`);
-    console.log(`tasks: ${status.tasks.length}`);
-  }
-  process.exitCode = status.checkState.status === "fail" ? 1 : 0;
-} else if (command === "dev") {
-  const open = !takeFlag("--no-open");
-  const outDir = takeOption("--out-dir", "");
-  const host = takeOption("--host", "127.0.0.1");
-  const port = takeOption("--port", "0");
-  const localeOverride = takeOption("--locale", "");
-  const target = targetArg();
-  const usesDefaultOutDir = !outDir;
-  const dashboardOutDir = outDir || defaultDevOutDir(target);
-  const opts = { ...(localeOverride ? { localeOverride } : {}), recoverGeneratedDashboard: usesDefaultOutDir };
-  try {
-    await serveDashboardWorkbench(dashboardOutDir, target, { ...opts, host, port, autoRefresh: true, open, label: "harness dev" });
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else if (command === "dashboard") {
-  await runDashboardCommand({ takeFlag, takeOption, targetArg });
-} else if (command === "init") {
-  const dryRun = takeFlag("--dry-run");
-  const addNpmScripts = takeFlag("--add-npm-scripts");
-  const locale = await resolveInitLocale(takeOption("--locale", ""));
-  const capabilities = takeOption("--capabilities", "core").split(",").map((item) => item.trim()).filter(Boolean);
-  try {
-    const result = writeInitFiles(targetArg(), capabilities, { dryRun, locale, addNpmScripts });
-    console.log(JSON.stringify({ dryRun, locale: result.locale, capabilities: result.capabilities, changes: result.changes, presetSeed: result.presetSeed, nextCommands: result.nextCommands, report: result.report }, null, 2));
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else if (command === "add-capability") {
-  const dryRun = takeFlag("--dry-run");
-  const locale = normalizeLocale(takeOption("--locale", ""));
-  const capability = args.shift();
-  if (!capability) {
-    console.error("Missing capability name");
-    process.exit(2);
-  }
-  try {
-    const result = addCapability(targetArg(), capability, { dryRun, locale });
-    console.log(JSON.stringify({ dryRun, registry: result.registry, changes: result.changes, report: result.report }, null, 2));
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else if (["migrate-plan", "migrate-run", "migrate-verify"].includes(command)) {
-  runMigrationCommand(command, { args, takeFlag, takeOption, targetArg });
-} else if (command === "governance") {
-  const subcommand = args.shift() || "";
-  if (subcommand !== "rebuild") {
-    console.error(`Unknown governance subcommand: ${subcommand || "(missing)"}`);
-    process.exit(2);
-  }
-  const dryRun = takeFlag("--dry-run");
-  const archive = takeFlag("--archive");
-  const apply = takeFlag("--apply");
-  try {
-    console.log(JSON.stringify(rebuildGovernanceIndexes(targetArg(), { dryRun, archive, apply }), null, 2));
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else if (command === "preset") {
-  runPresetCommand({ args, takeFlag, targetArg });
-} else if (["new-task", "task-phase", "task-start", "task-log", "task-block", "task-review", "task-complete", "review-confirm", "lesson-promote", "lesson-sediment", "task-list", "task-index", "task-supersede", "task-delete", "task-archive", "task-reopen", "module-step"].includes(command)) {
-  runTaskCommand(command, { args, takeFlag, takeOption, targetArg });
-} else if (command === "install-user") {
-  const dryRun = takeFlag("--dry-run");
-  const force = takeFlag("--force");
-  const yes = takeFlag("--yes") || takeFlag("-y");
-  const skipPresets = takeFlag("--skip-presets");
-  takeFlag("--global");
-  const agent = takeOption("--agent", "codex");
-  const home = takeOption("--home", "");
-  if (!(await confirmUserInstall({ yes, dryRun, agent }))) {
-    console.error("Refusing to write user skill files without confirmation. Re-run with --yes or --dry-run.");
-    process.exit(2);
-  }
-  try {
-    console.log(JSON.stringify(installUserSkill({ agent, home, dryRun, force, seedPresets: !skipPresets }), null, 2));
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else if (command === "doctor-user") {
-  const agent = takeOption("--agent", "codex");
-  const home = takeOption("--home", "");
-  try {
-    const report = doctorUserSkill({ agent, home });
-    console.log(JSON.stringify(report, null, 2));
-    process.exit(report.status === "pass" ? 0 : 1);
-  } catch (error) {
-    console.error(error.message);
-    process.exit(1);
-  }
-} else {
-  printHelp();
-  process.exit(2);
-}
-
-function defaultDevOutDir(targetInput) {
-  const target = path.resolve(targetInput || ".");
-  const name = path.basename(target) || "project";
-  const hash = Buffer.from(target).toString("hex").slice(0, 16);
-  return path.join(os.tmpdir(), "coding-agent-harness-dev", `${name}-${hash}`);
-}