coding-agent-harness 1.0.1 → 1.0.4

package/scripts/harness.mjs

@@ -1,6 +1,7 @@
 #!/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 {
@@ -8,11 +9,16 @@ import {
   buildStatus,
   doctorUserSkill,
   installUserSkill,
-  renderDashboard,
   normalizeLocale,
-  writeDashboardFolder,
+  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";
@@ -76,14 +82,54 @@ function printHelp() {
 Usage:
   harness check [--profile source-package|private-harness|target-project] [target]
   harness status [--json] [--strict] [target]
-  harness dashboard [--out file.html] [--out-dir folder] [target]
-  harness init [--dry-run] [--locale zh-CN|en-US] [--capabilities core,dashboard] [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 install-user [--agent codex|claude|gemini|openclaw|agents|all] [--home dir] [--dry-run] [--force] [--yes]
+  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.
 `);
 }
 
@@ -95,6 +141,8 @@ function exitWithReport(report) {
 
 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");
@@ -106,6 +154,9 @@ if (command === "help" || command === "--help" || command === "-h") {
     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 });
@@ -127,27 +178,33 @@ if (command === "help" || command === "--help" || command === "-h") {
     console.log(`capabilities: ${status.capabilities.map((capability) => `${capability.name}:${capability.state}`).join(", ")}`);
     console.log(`tasks: ${status.tasks.length}`);
   }
-  process.exit(status.checkState.status === "fail" ? 1 : 0);
-} else if (command === "dashboard") {
-  const out = takeOption("--out", "harness-dashboard.html");
+  process.exitCode = status.checkState.status === "fail" ? 1 : 0;
+} else if (command === "dev") {
+  const open = !takeFlag("--no-open");
   const outDir = takeOption("--out-dir", "");
-  if (outDir) {
-    console.log(writeDashboardFolder(outDir, targetArg()));
-  } else {
-    const status = buildStatus(targetArg());
-    const html = renderDashboard(status);
-    fs.mkdirSync(path.dirname(path.resolve(out)), { recursive: true });
-    fs.writeFileSync(path.resolve(out), html);
-    console.log(path.resolve(out));
+  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);
   }
-  process.exit(0);
+} 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 });
-    console.log(JSON.stringify({ dryRun, locale: result.locale, capabilities: result.capabilities, changes: result.changes, report: result.report }, null, 2));
+    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);
@@ -167,10 +224,32 @@ if (command === "help" || command === "--help" || command === "-h") {
     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", "");
@@ -179,7 +258,7 @@ if (command === "help" || command === "--help" || command === "-h") {
     process.exit(2);
   }
   try {
-    console.log(JSON.stringify(installUserSkill({ agent, home, dryRun, force }), null, 2));
+    console.log(JSON.stringify(installUserSkill({ agent, home, dryRun, force, seedPresets: !skipPresets }), null, 2));
   } catch (error) {
     console.error(error.message);
     process.exit(1);
@@ -199,3 +278,10 @@ if (command === "help" || command === "--help" || command === "-h") {
   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}`);
+}