@cardor/agent-harness-kit 0.16.3 → 0.16.8

package/dist/cli.js

@@ -1007,6 +1007,9 @@ var HarnessDB = class {
     }
     return { added, skipped };
   }
+  markAcceptanceMet(criterionId) {
+    this.db.prepare(`UPDATE task_acceptance SET met = 1 WHERE id = ?`).run(criterionId);
+  }
   writeFeatureList(cwd2) {
     const tasks = this.getTasks();
     const list = tasks.map((t) => ({
@@ -1152,9 +1155,10 @@ import { mkdirSync as mkdirSync6, writeFileSync as writeFileSync7 } from "fs";
 import { homedir } from "os";
 import { join as join9 } from "path";
 import * as p2 from "@clack/prompts";
-import pc5 from "picocolors";
+import pc6 from "picocolors";
 
 // src/commands/init-helpers.ts
+import pc5 from "picocolors";
 function applyConfigDefaults(params) {
   return {
     provider: params.provider,
@@ -1194,10 +1198,43 @@ function applyConfigDefaults(params) {
     }
   };
 }
+function stripAnsi(str2) {
+  return str2.replace(/\x1B\[[0-9;]*m/g, "");
+}
+function drawBox(lines) {
+  const width = Math.max(...lines.map((l) => stripAnsi(l).length));
+  const border = "\u2500".repeat(width);
+  console.log(pc5.yellow(`\u250C${border}\u2510`));
+  for (const line of lines) {
+    const pad = width - stripAnsi(line).length;
+    const padStr = pad > 0 ? " ".repeat(pad) : "";
+    console.log(pc5.yellow("\u2502") + line + padStr + pc5.yellow("\u2502"));
+  }
+  console.log(pc5.yellow(`\u2514${border}\u2518`));
+}
+function printWelcomeMessage(projectName) {
+  const sep = "\u2500".repeat(38);
+  const lines = [
+    `  ${pc5.bold(pc5.white("agent-harness-kit"))}  `,
+    `  ${pc5.gray("\u2014")} harness scaffolding ${pc5.gray("\u2014")}  `,
+    `  ${pc5.gray(sep)}  `,
+    `  ${pc5.bold("Project:")}  ${projectName || "\u2014"}  `,
+    `  ${pc5.bold("Status:")}   ${pc5.green("ready to configure")}  `,
+    `  ${pc5.gray(sep)}  `,
+    `  ${pc5.gray("Next steps:")}  `,
+    `  ${pc5.gray("\u2192")} ${pc5.gray("Set up your AI provider config")}  `,
+    `  ${pc5.gray("\u2192")} ${pc5.gray("Run your health check to verify")}  `,
+    `  ${pc5.gray("\u2192")} ${pc5.gray("Start adding tasks for your agents")}  `
+  ];
+  console.log();
+  drawBox(lines);
+  console.log();
+}
 
 // src/commands/init.ts
 async function runInit(cwd2, flags) {
-  p2.intro(pc5.bold("agent-harness-kit \u2014 harness scaffolding"));
+  const projectName = flags.name || "my-project";
+  printWelcomeMessage(projectName);
   let name;
   if (flags.name) {
     name = flags.name;
@@ -1278,14 +1315,14 @@ async function runInit(cwd2, flags) {
       ]
     });
     if (p2.isCancel(val)) {
-      p2.cancel("Cancelled.");
+      p2.cancel("Cancelled");
       process.exit(0);
     }
     tasksAdapter = val;
   }
   const addFirstTask = await p2.confirm({ message: "Add your first task now?", initialValue: true });
   if (p2.isCancel(addFirstTask)) {
-    p2.cancel("Cancelled.");
+    p2.cancel("Cancelled");
     process.exit(0);
   }
   let firstTask;
@@ -1295,7 +1332,7 @@ async function runInit(cwd2, flags) {
       validate: (v) => v.trim() ? void 0 : "Title is required"
     });
     if (p2.isCancel(titleVal)) {
-      p2.cancel("Cancelled.");
+      p2.cancel("Cancelled");
       process.exit(0);
     }
     const taskTitle = titleVal.trim();
@@ -1304,7 +1341,7 @@ async function runInit(cwd2, flags) {
       placeholder: "What and why"
     });
     if (p2.isCancel(taskDescVal)) {
-      p2.cancel("Cancelled.");
+      p2.cancel("Cancelled");
       process.exit(0);
     }
     const taskDesc = taskDescVal.trim();
@@ -1362,29 +1399,29 @@ async function runInit(cwd2, flags) {
     process.exit(1);
   }
   const agentHarnessKitDir = globalInstallation ? "home directory" : "current directory";
-  console.log(pc5.green(`\u2713 Scaffolded harness in ${agentHarnessKitDir}`));
+  console.log(pc6.green(`\u2713 Scaffolded harness in ${agentHarnessKitDir}`));
   const agentsDir = provider === "claude-code" ? ".claude/agents/" : ".opencode/agents/";
   const mcpFile = provider === "claude-code" ? ".claude/mcp.json" : "./opencode.json";
   console.log("");
-  console.log(pc5.green("\u2713 agent-harness-kit.config.ts"));
-  console.log(pc5.green("\u2713 AGENTS.md"));
-  console.log(pc5.green("\u2713 health.sh"));
-  console.log(pc5.green("\u2713 .harness/harness.db"));
-  console.log(pc5.green("\u2713 .harness/current.md"));
-  console.log(pc5.green(`\u2713 ${agentsDir}lead.md`));
-  console.log(pc5.green(`\u2713 ${agentsDir}explorer.md`));
-  console.log(pc5.green(`\u2713 ${agentsDir}builder.md`));
-  console.log(pc5.green(`\u2713 ${agentsDir}reviewer.md`));
-  console.log(pc5.green(`\u2713 ${mcpFile}`));
-  console.log(pc5.green("\u2713 .gitignore entries added"));
+  console.log(pc6.green("\u2713 agent-harness-kit.config.ts"));
+  console.log(pc6.green("\u2713 AGENTS.md"));
+  console.log(pc6.green("\u2713 health.sh"));
+  console.log(pc6.green("\u2713 .harness/harness.db"));
+  console.log(pc6.green("\u2713 .harness/current.md"));
+  console.log(pc6.green(`\u2713 ${agentsDir}lead.md`));
+  console.log(pc6.green(`\u2713 ${agentsDir}explorer.md`));
+  console.log(pc6.green(`\u2713 ${agentsDir}builder.md`));
+  console.log(pc6.green(`\u2713 ${agentsDir}reviewer.md`));
+  console.log(pc6.green(`\u2713 ${mcpFile}`));
+  console.log(pc6.green("\u2713 .gitignore entries added"));
   console.log("");
-  console.log(pc5.cyan("\u2192") + ` Edit ${pc5.cyan("health.sh")} with your project checks`);
-  console.log(pc5.cyan("\u2192") + ` ${pc5.cyan("ahk task add")} to queue work for agents`);
+  console.log(pc6.cyan("\u2192") + ` Edit ${pc6.cyan("health.sh")} with your project checks`);
+  console.log(pc6.cyan("\u2192") + ` ${pc6.cyan("ahk task add")} to queue work for agents`);
 }
 
 // src/commands/migrate.ts
 import * as p3 from "@clack/prompts";
-import pc6 from "picocolors";
+import pc7 from "picocolors";
 async function runMigrate(cwd2, opts) {
   const config = await loadConfig(cwd2);
   let target;
@@ -1405,7 +1442,7 @@ async function runMigrate(cwd2, opts) {
     target = val;
   }
   if (target === config.provider) {
-    console.log(pc6.dim(`Already on ${target} \u2014 nothing to migrate.`));
+    console.log(pc7.dim(`Already on ${target} \u2014 nothing to migrate.`));
     return;
   }
   const spinner5 = p3.spinner();
@@ -1413,11 +1450,11 @@ async function runMigrate(cwd2, opts) {
   try {
     const targetMaterializer = getMaterializer(target);
     await targetMaterializer.build(config, cwd2);
-    spinner5.stop(pc6.green(`Migrated to ${target}`));
+    spinner5.stop(pc7.green(`Migrated to ${target}`));
     p3.log.warn(`Update agent-harness-kit.config.ts: set provider: '${target}'`);
     p3.log.warn(`Then run: ahk build`);
   } catch (err) {
-    spinner5.stop(pc6.red("Migration failed"));
+    spinner5.stop(pc7.red("Migration failed"));
     p3.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
@@ -1451,14 +1488,14 @@ var TOOLS = [
   },
   {
     name: "actions.write",
-    description: "Record a section in an action. Standard sections: result, tools_used, files_modified, blockers, next_steps.",
+    description: "Record a section in an action. Standard sections: result, tools_used, blockers, next_steps. Note: files_modified is a plain-text note only \u2014 it does NOT populate the files dashboard. Use actions.record_file to register files in the dashboard.",
     inputSchema: {
       type: "object",
       properties: {
         actionId: { type: "string", description: "UUID returned by actions.start" },
         sectionType: {
           type: "string",
-          description: "Section name: result | tools_used | files_modified | blockers | next_steps | <custom>"
+          description: "Section name: result | tools_used | blockers | next_steps | <custom>. Do NOT use files_modified to track files \u2014 it is stored as plain text only. Use actions.record_file instead."
         },
         content: { type: "string", description: "Content for this section" }
       },
@@ -1539,6 +1576,35 @@ var TOOLS = [
       },
       required: ["query"]
     }
+  },
+  {
+    name: "actions.record_file",
+    description: "Record a file touched during an action. This is the only way to populate the files-touched count shown in the dashboard. Call once per file.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        actionId: { type: "string", description: "UUID returned by actions.start" },
+        filePath: { type: "string", description: "Absolute or repo-relative path of the file" },
+        operation: {
+          type: "string",
+          enum: ["read", "created", "modified", "deleted"],
+          description: "What was done to the file"
+        },
+        notes: { type: "string", description: "Optional short note about the change" }
+      },
+      required: ["actionId", "filePath", "operation"]
+    }
+  },
+  {
+    name: "tasks.acceptance.update",
+    description: "Mark an acceptance criterion as met. Use the criterion id from tasks.get.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        criterionId: { type: "number", description: "The id of the acceptance criterion to mark as met" }
+      },
+      required: ["criterionId"]
+    }
   }
 ];
 async function startMcpServer(config, cwd2) {
@@ -1617,6 +1683,19 @@ async function dispatch(name, args, db, docsPath) {
       const results = searchDocs(docsPath, query);
       return ok(JSON.stringify(results, null, 2));
     }
+    case "actions.record_file": {
+      const actionId = str(args, "actionId");
+      const filePath = str(args, "filePath");
+      const operation = str(args, "operation");
+      const notes = args["notes"];
+      db.recordFile(actionId, filePath, operation, notes);
+      return ok(JSON.stringify({ actionId, filePath, operation, recorded: true }));
+    }
+    case "tasks.acceptance.update": {
+      const criterionId = num(args, "criterionId");
+      db.markAcceptanceMet(criterionId);
+      return ok(JSON.stringify({ criterionId, met: true }));
+    }
     default:
       return ok(`Unknown tool: ${name}`, true);
   }
@@ -1689,12 +1768,12 @@ async function runServe(cwd2, opts) {
 
 // src/commands/status.ts
 import Table from "cli-table3";
-import pc7 from "picocolors";
+import pc8 from "picocolors";
 var STATUS_COLOR = {
-  pending: (s) => pc7.dim(s),
-  in_progress: (s) => pc7.cyan(s),
-  done: (s) => pc7.green(s),
-  blocked: (s) => pc7.red(s)
+  pending: (s) => pc8.dim(s),
+  in_progress: (s) => pc8.cyan(s),
+  done: (s) => pc8.green(s),
+  blocked: (s) => pc8.red(s)
 };
 async function runStatus(cwd2, opts) {
   const config = await loadConfig(cwd2);
@@ -1712,11 +1791,11 @@ async function runStatus(cwd2, opts) {
       return;
     }
     if (tasks.length === 0) {
-      console.log(pc7.dim("No tasks yet. Run: ahk task add"));
+      console.log(pc8.dim("No tasks yet. Run: ahk task add"));
       return;
     }
     const table = new Table({
-      head: ["ID", "Slug", "Title", "Status", "Assigned", "Started"].map((h) => pc7.bold(h)),
+      head: ["ID", "Slug", "Title", "Status", "Assigned", "Started"].map((h) => pc8.bold(h)),
       style: { head: [], border: [] }
     });
     for (const t of tasks) {
@@ -1734,12 +1813,12 @@ async function runStatus(cwd2, opts) {
     const inProgress = tasks.filter((t) => t.status === "in_progress");
     if (inProgress.length > 0) {
       console.log("");
-      console.log(pc7.bold("Active actions:"));
+      console.log(pc8.bold("Active actions:"));
       for (const t of inProgress) {
         const actions = db.getActionsForTask(t.id);
         const active = actions.filter((a) => a.status === "in_progress");
         for (const a of active) {
-          console.log(`  ${pc7.cyan(a.agent.padEnd(10))} \u2192 task #${t.id} ${t.slug}`);
+          console.log(`  ${pc8.cyan(a.agent.padEnd(10))} \u2192 task #${t.id} ${t.slug}`);
         }
       }
     }
@@ -1748,7 +1827,7 @@ async function runStatus(cwd2, opts) {
       const fn = STATUS_COLOR[s.status] ?? ((x) => x);
       return `${fn(s.status)}: ${s.total}`;
     });
-    console.log(pc7.dim("Tasks \u2014 ") + parts.join(pc7.dim(" | ")));
+    console.log(pc8.dim("Tasks \u2014 ") + parts.join(pc8.dim(" | ")));
   } finally {
     db.close();
   }
@@ -1757,7 +1836,7 @@ async function runStatus(cwd2, opts) {
 // src/commands/sync.ts
 import { existsSync as existsSync7, readFileSync as readFileSync6 } from "fs";
 import { join as join11, resolve as resolve8 } from "path";
-import pc8 from "picocolors";
+import pc9 from "picocolors";
 async function runSync(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const direction = opts.direction ?? "both";
@@ -1776,43 +1855,43 @@ async function runSync(cwd2, opts) {
 }
 async function syncIn(featureListPath, db, dryRun) {
   if (!existsSync7(featureListPath)) {
-    console.log(pc8.dim(`feature_list.json not found at ${featureListPath} \u2014 skipping in-sync`));
+    console.log(pc9.dim(`feature_list.json not found at ${featureListPath} \u2014 skipping in-sync`));
     return;
   }
   let seeds;
   try {
     seeds = JSON.parse(readFileSync6(featureListPath, "utf8"));
   } catch (err) {
-    console.error(pc8.red(`Failed to parse feature_list.json: ${err}`));
+    console.error(pc9.red(`Failed to parse feature_list.json: ${err}`));
     process.exit(1);
   }
   if (dryRun) {
-    console.log(pc8.bold("Dry run \u2014 in-sync (feature_list.json \u2192 SQLite):"));
+    console.log(pc9.bold("Dry run \u2014 in-sync (feature_list.json \u2192 SQLite):"));
     for (const t of seeds) {
       const existing = db.getTaskBySlug(t.slug);
-      console.log(`  ${existing ? pc8.dim("skip") : pc8.green("add ")} ${t.slug}`);
+      console.log(`  ${existing ? pc9.dim("skip") : pc9.green("add ")} ${t.slug}`);
     }
     return;
   }
   const result = db.syncFromFeatureList(seeds);
-  console.log(pc8.green(`\u2713 In-sync: ${result.added} added, ${result.skipped} already existed`));
+  console.log(pc9.green(`\u2713 In-sync: ${result.added} added, ${result.skipped} already existed`));
 }
 function syncOut(db, cwd2, dryRun) {
   if (dryRun) {
     const tasks = db.getTasks();
-    console.log(pc8.bold("Dry run \u2014 out-sync (SQLite \u2192 feature_list.json):"));
+    console.log(pc9.bold("Dry run \u2014 out-sync (SQLite \u2192 feature_list.json):"));
     console.log(`  ${tasks.length} tasks would be written`);
     return;
   }
   db.writeFeatureList(cwd2);
-  console.log(pc8.green("\u2713 Out-sync: feature_list.json updated"));
+  console.log(pc9.green("\u2713 Out-sync: feature_list.json updated"));
 }
 
 // src/commands/task/add.ts
 import * as p4 from "@clack/prompts";
-import pc9 from "picocolors";
+import pc10 from "picocolors";
 async function runTaskAdd(cwd2) {
-  p4.intro(pc9.bold("agent-harness-kit \u2014 add task"));
+  p4.intro(pc10.bold("agent-harness-kit \u2014 add task"));
   const titleVal = await p4.text({
     message: "Task title",
     validate: (v) => v.trim() ? void 0 : "Title is required"
@@ -1848,10 +1927,10 @@ async function runTaskAdd(cwd2) {
     db.writeFeatureList(cwd2);
     db.close();
     spinner5.stop("");
-    console.log(pc9.green(`\u2713 Task #${task2.id} added \u2014 ${task2.slug} (pending)`));
-    console.log(pc9.cyan("\u2192") + " " + pc9.cyan("ahk status") + " to see all tasks");
+    console.log(pc10.green(`\u2713 Task #${task2.id} added \u2014 ${task2.slug} (pending)`));
+    console.log(pc10.cyan("\u2192") + " " + pc10.cyan("ahk status") + " to see all tasks");
   } catch (err) {
-    spinner5.stop(pc9.red("Failed"));
+    spinner5.stop(pc10.red("Failed"));
     p4.log.error(err instanceof Error ? err.message : String(err));
     process.exit(1);
   }
@@ -1861,7 +1940,7 @@ async function runTaskAdd(cwd2) {
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync8 } from "fs";
 import { resolve as resolve9 } from "path";
-import pc10 from "picocolors";
+import pc11 from "picocolors";
 async function runTaskDone(cwd2, idOrSlug) {
   const config = await loadConfig(cwd2);
   if (config.health.required) {
@@ -1869,7 +1948,7 @@ async function runTaskDone(cwd2, idOrSlug) {
     if (existsSync8(scriptPath)) {
       const result = spawnSync2("bash", [scriptPath], { cwd: cwd2, stdio: "pipe", encoding: "utf8" });
       if (result.status !== 0) {
-        console.error(pc10.red("\u2717 Health check failed \u2014 cannot mark task as done."));
+        console.error(pc11.red("\u2717 Health check failed \u2014 cannot mark task as done."));
         if (result.stdout) console.error(result.stdout);
         if (result.stderr) console.error(result.stderr);
         process.exit(1);
@@ -1882,16 +1961,16 @@ async function runTaskDone(cwd2, idOrSlug) {
     const isId = !isNaN(parsed);
     const task2 = isId ? db.getTaskById(parsed) : db.getTaskBySlug(idOrSlug);
     if (!task2) {
-      console.error(pc10.red(`Task not found: ${idOrSlug}`));
+      console.error(pc11.red(`Task not found: ${idOrSlug}`));
       process.exit(1);
     }
     if (task2.status === "done") {
-      console.log(pc10.dim(`Task #${task2.id} is already done.`));
+      console.log(pc11.dim(`Task #${task2.id} is already done.`));
       return;
     }
     db.updateTaskStatus(task2.id, "done");
     db.writeFeatureList(cwd2);
-    console.log(pc10.green(`\u2713 Task #${task2.id} \u2014 ${task2.slug} marked as done`));
+    console.log(pc11.green(`\u2713 Task #${task2.id} \u2014 ${task2.slug} marked as done`));
   } finally {
     db.close();
   }
@@ -1899,12 +1978,12 @@ async function runTaskDone(cwd2, idOrSlug) {
 
 // src/commands/task/list.ts
 import Table2 from "cli-table3";
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 var STATUS_COLOR2 = {
-  pending: (s) => pc11.dim(s),
-  in_progress: (s) => pc11.cyan(s),
-  done: (s) => pc11.green(s),
-  blocked: (s) => pc11.red(s)
+  pending: (s) => pc12.dim(s),
+  in_progress: (s) => pc12.cyan(s),
+  done: (s) => pc12.green(s),
+  blocked: (s) => pc12.red(s)
 };
 async function runTaskList(cwd2, opts) {
   const config = await loadConfig(cwd2);
@@ -1918,11 +1997,11 @@ async function runTaskList(cwd2, opts) {
       return;
     }
     if (tasks.length === 0) {
-      console.log(pc11.dim("No tasks" + (filterStatus ? ` with status: ${filterStatus}` : "") + "."));
+      console.log(pc12.dim("No tasks" + (filterStatus ? ` with status: ${filterStatus}` : "") + "."));
       return;
     }
     const table = new Table2({
-      head: ["ID", "Slug", "Title", "Status"].map((h) => pc11.bold(h)),
+      head: ["ID", "Slug", "Title", "Status"].map((h) => pc12.bold(h)),
       style: { head: [], border: [] }
     });
     for (const t of tasks) {
@@ -1944,7 +2023,7 @@ var pkgPath = join12(dirname5(fileURLToPath3(import.meta.url)), "..", "package.j
 var pkg = require2(pkgPath);
 
 // src/core/update-check.ts
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 var REGISTRY_URL = `https://registry.npmjs.org/${pkg.name}/latest`;
 var TIMEOUT_MS = 2500;
 function checkForUpdate(currentVersion) {
@@ -1962,18 +2041,18 @@ function checkForUpdate(currentVersion) {
 }
 function printUpdateMessage({ current, latest }) {
   const lines = [
-    `  Update available ${pc12.dim(current)} \u2192 ${pc12.green(latest)}  `,
-    `  Run: ${pc12.cyan(`npm i ${pkg.name}@${latest}`)}          `
+    `  Update available ${pc13.dim(current)} \u2192 ${pc13.green(latest)}  `,
+    `  Run: ${pc13.cyan(`npm i ${pkg.name}@${latest}`)}          `
   ];
-  const width = Math.max(...lines.map((l) => stripAnsi(l).length));
+  const width = Math.max(...lines.map((l) => stripAnsi2(l).length));
   const border = "\u2500".repeat(width);
   console.log();
-  console.log(pc12.yellow(`\u250C${border}\u2510`));
+  console.log(pc13.yellow(`\u250C${border}\u2510`));
   for (const line of lines) {
-    const pad = width - stripAnsi(line).length;
-    console.log(pc12.yellow("\u2502") + line + " ".repeat(pad) + pc12.yellow("\u2502"));
+    const pad = width - stripAnsi2(line).length;
+    console.log(pc13.yellow("\u2502") + line + " ".repeat(pad) + pc13.yellow("\u2502"));
   }
-  console.log(pc12.yellow(`\u2514${border}\u2518`));
+  console.log(pc13.yellow(`\u2514${border}\u2518`));
   console.log();
 }
 function isNewer(latest, current) {
@@ -1984,7 +2063,7 @@ function isNewer(latest, current) {
   if (lMin !== cMin) return lMin > cMin;
   return lPat > cPat;
 }
-function stripAnsi(str2) {
+function stripAnsi2(str2) {
   return str2.replace(/\x1B\[[0-9;]*m/g, "");
 }