coding-agent-harness 1.0.5 → 1.0.7

package/scripts/commands/dashboard-command.mjs

@@ -1,67 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import {
-  serveDashboardWorkbench,
-  writeDashboardFolder,
-  writeDashboardSingleFile,
-} from "../lib/harness-core.mjs";
-
-export async function runDashboardCommand({ takeFlag, takeOption, targetArg }) {
-  const watch = takeFlag("--watch");
-  const workbench = takeFlag("--workbench");
-  const out = takeOption("--out", path.join("tmp", "harness-dashboard.html"));
-  const outDir = takeOption("--out-dir", "");
-  const host = takeOption("--host", "127.0.0.1");
-  const port = takeOption("--port", "0");
-  const localeOverride = takeOption("--locale", "");
-  const opts = localeOverride ? { localeOverride } : {};
-  if (workbench) {
-    if (!outDir) {
-      console.error("dashboard --workbench requires --out-dir so regenerated data has a stable folder");
-      process.exit(2);
-    }
-    try {
-      await serveDashboardWorkbench(outDir, targetArg(), { ...opts, host, port });
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-  }
-  if (watch) {
-    if (!outDir) {
-      console.error("dashboard --watch requires --out-dir so updates are written to a stable folder");
-      process.exit(2);
-    }
-    const target = targetArg();
-    const docsRoot = path.basename(path.resolve(target)) === "docs" ? path.resolve(target) : path.join(path.resolve(target), "docs");
-    const regenerate = () => {
-      try {
-        console.log(writeDashboardFolder(outDir, target, opts));
-        console.log(`dashboard regenerated: ${new Date().toISOString()}`);
-      } catch (error) {
-        console.error(`dashboard regeneration failed: ${error.message}`);
-      }
-    };
-    regenerate();
-    let timer = null;
-    const watcher = fs.watch(docsRoot, { recursive: true }, () => {
-      clearTimeout(timer);
-      timer = setTimeout(regenerate, 300);
-    });
-    const close = () => {
-      watcher.close();
-      clearTimeout(timer);
-      process.exit(0);
-    };
-    process.on("SIGINT", close);
-    process.on("SIGTERM", close);
-    console.log(`watching ${docsRoot}`);
-    await new Promise(() => {});
-  }
-  if (outDir) {
-    console.log(writeDashboardFolder(outDir, targetArg(), opts));
-  } else {
-    console.log(writeDashboardSingleFile(out, targetArg(), opts));
-  }
-  process.exit(0);
-}

package/scripts/commands/migration-command.mjs

@@ -1,126 +0,0 @@
-import {
-  buildMigrationPlan,
-  runMigration,
-  verifyMigrationSession,
-} from "../lib/harness-core.mjs";
-import {
-  applyTaskAuditIndexMigration,
-  planTaskAuditIndexMigration,
-} from "../lib/task-audit-migration.mjs";
-
-export function runMigrationCommand(command, { args, takeFlag, takeOption, targetArg }) {
-  if (command === "migrate-task-audit-index") {
-    const json = takeFlag("--json");
-    const apply = takeFlag("--apply");
-    const planOnly = takeFlag("--plan");
-    try {
-      const result = apply && !planOnly
-        ? applyTaskAuditIndexMigration(targetArg())
-        : planTaskAuditIndexMigration(targetArg());
-      if (json) {
-        console.log(JSON.stringify(result, null, 2));
-      } else {
-        console.log(`Task audit INDEX migration ${result.result}: ${result.target}`);
-        console.log(`actions: ${result.summary.actions}`);
-        console.log(`legacy audit blocks: ${result.summary.legacyAuditBlocks}`);
-        console.log(`failures: ${result.summary.failures}`);
-        for (const action of result.actions || []) console.log(`- ${action.taskId}: ${action.legacyBlocks.join(", ")}`);
-        for (const failure of result.failures || []) console.error(`Failure: ${failure.taskId}: ${failure.failure}`);
-      }
-      process.exit(result.failures?.length ? 1 : 0);
-    } catch (error) {
-      if (json && error.plan) console.error(JSON.stringify(error.plan, null, 2));
-      else console.error(error.message);
-      process.exit(1);
-    }
-  }
-
-  if (command === "migrate-plan") {
-    const json = takeFlag("--json");
-    const limit = Number.parseInt(takeOption("--limit", "20"), 10) || 20;
-    try {
-      const plan = buildMigrationPlan(targetArg(), { limit });
-      if (json) {
-        console.log(JSON.stringify(plan, null, 2));
-      } else {
-        console.log(`Migration Plan: ${plan.target}`);
-        console.log(`mode: ${plan.mode}`);
-        console.log(`warnings: ${plan.summary.warnings}`);
-        console.log(`task actions: ${plan.summary.taskActions}`);
-        console.log(`visual map actions: ${plan.summary.visualMapActions}`);
-        console.log(`legacy visual-only tasks: ${plan.summary.legacyVisualOnly}`);
-        console.log(`weak briefs: ${plan.summary.weakBrief}`);
-        console.log(`unknown classifications: ${plan.summary.unknownClassification}`);
-        console.log(`full cutover eligible: ${plan.summary.fullCutoverEligible ? "yes" : "no"}`);
-        console.log(`review actions: ${plan.summary.reviewSchemaGaps}`);
-        console.log(`legacy actions: ${plan.summary.legacyReferenceGaps}`);
-        console.log(`legacy residuals: ${plan.summary.legacyResiduals}`);
-        console.log(`recommended capabilities: ${plan.summary.recommendedCapabilities.join(", ") || "none"}`);
-        console.log("\nPhases:");
-        for (const phase of plan.phases) console.log(`- ${phase.id}: ${phase.title}`);
-        console.log("\nTop task actions:");
-        for (const action of plan.taskActions) console.log(`- ${action.taskId}: add ${action.files.join(", ")}`);
-        console.log("\nTop review actions:");
-        for (const action of plan.reviewActions) console.log(`- ${action.path}: add ${action.missing.join(", ")}`);
-        console.log("\nTop legacy residuals:");
-        for (const action of plan.legacyResiduals) console.log(`- ${action.taskId}: ${action.missing} (${action.reason})`);
-        console.log("\nNext commands:");
-        for (const next of plan.nextCommands) console.log(`- ${next}`);
-      }
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "migrate-run") {
-    const locale = takeOption("--locale", "");
-    const assumeLocale = takeFlag("--assume-locale");
-    const allowDirty = takeFlag("--allow-dirty");
-    const planOnly = takeFlag("--plan-only");
-    const outDir = takeOption("--out-dir", "");
-    const sessionDir = takeOption("--session-dir", "");
-    try {
-      console.log(
-        JSON.stringify(
-          runMigration(targetArg(), {
-            locale,
-            assumeLocale,
-            allowDirty,
-            planOnly,
-            outDir,
-            sessionDir,
-          }),
-          null,
-          2,
-        ),
-      );
-    } catch (error) {
-      console.error(error.message);
-      process.exit(1);
-    }
-    return;
-  }
-
-  if (command === "migrate-verify") {
-    const json = takeFlag("--json");
-    const fullCutover = takeFlag("--full-cutover");
-    const sessionPath = args.shift();
-    if (!sessionPath) {
-      console.error("Missing session.json path");
-      process.exit(2);
-    }
-    const result = verifyMigrationSession(sessionPath, { fullCutover });
-    if (json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      for (const failure of result.failures) console.error(`Failure: ${failure}`);
-      for (const warning of result.warnings) console.log(`Warning: ${warning}`);
-      console.log(`Migration verify ${result.status}: ${result.sessionPath}`);
-    }
-    process.exit(result.status === "pass" ? 0 : 1);
-  }
-
-  throw new Error(`Unsupported migration command: ${command}`);
-}

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,328 +0,0 @@
-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 });
-      console.log(JSON.stringify(createTask(parsed.target, parsed.taskId, { title, locale, dryRun, moduleKey, budget, longRunning, preset, fromSession, presetArgs: parsed.presetArgs, automaticTaskId: parsed.automaticTaskId }), 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 = "" } = {}) {
-  const values = [...args];
-  const presetPackage = preset ? readPresetPackageForNewTask(preset, values) : null;
-  const parsed = splitPresetArgsAndPositionals(values, presetPackage);
-  const resolved = resolveNewTaskPositionals(parsed.positionals);
-  return {
-    taskId: resolved.taskId,
-    target: resolved.target || ".",
-    automaticTaskId: !resolved.taskId,
-    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 splitPresetArgsAndPositionals(values, presetPackage) {
-  const presetArgs = [];
-  const positionals = [];
-  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 {
-      positionals.push(value);
-    }
-  }
-  return {
-    positionals,
-    presetArgs,
-  };
-}
-
-function isPathLikePositional(value) {
-  return value === "." || value === ".." || value.startsWith("/") || value.startsWith("~/") || value.includes("/") || value.includes("\\");
-}
-
-function resolveNewTaskPositionals(positionals) {
-  if (positionals.length === 0) return { taskId: "", target: "" };
-  if (positionals.length === 1) {
-    const [value] = positionals;
-    if (isPathLikePositional(value)) return { taskId: "", target: value };
-    return { taskId: value, target: "" };
-  }
-  if (positionals.length === 2) return { taskId: positionals[0], target: positionals[1] };
-  throw new Error(`Too many positional arguments for new-task: ${positionals.join(", ")}`);
-}
-
-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");
-}