@cardor/agent-harness-kit 1.10.3 → 1.10.5

package/dist/cli.js

@@ -1,15 +1,18 @@
 import {
   findConfigFile,
   loadConfig
-} from "./chunk-ADV7OPU2.js";
+} from "./chunk-D64KK6UU.js";
 import {
+  DEFAULT_MARKDOWN_PATH,
+  DEFAULT_SQLITE_PATH,
   getRowCounts,
   isEmptyDatabase,
   openDB,
   readStorageStateFile,
   resolveGlobalStorageDir,
+  resolveSqlitePath,
   resolveSqlitePathForScope
-} from "./chunk-DNFFWQWR.js";
+} from "./chunk-6PEIJ2D5.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -532,6 +535,8 @@ function modelField(model) {
 }
 function configObjectBody(params) {
   const models = params.models ?? {};
+  const isGlobal = params.scope === "global";
+  const markdownFallbackLine = isGlobal ? `markdownFallback: { enabled: true },` : `markdownFallback: { enabled: true, path: '.harness/current.md' },`;
   return `  project: {
     name: ${JSON.stringify(params.name)},
     description: ${JSON.stringify(params.description)},
@@ -552,7 +557,7 @@ function configObjectBody(params) {
   // SQLite (default). Switch to postgres/mysql by changing database.type.
   // database: { type: 'postgres', connectionString: process.env.DATABASE_URL },
   // database: { type: 'mysql',    connectionString: process.env.DATABASE_URL },
-  database: { type: 'sqlite', path: '.harness/harness.db' },
+  database: { type: 'sqlite' },
 
   storage: {
     dir:    '.harness',
@@ -564,7 +569,7 @@ function configObjectBody(params) {
       blockers:      true,
       nextSteps:     false,
     },
-    markdownFallback: { enabled: true, path: '.harness/current.md' },
+    ${markdownFallbackLine}
     // 'local' \u2014 DB lives in .harness/ (project-relative). 'global' \u2014 DB lives
     // under ~/.harness/dbs/<projectId>/, outside the project tree.
     scope:     '${params.scope}',
@@ -763,7 +768,7 @@ var ClaudeCodeMaterializer = class {
     }
     const tasks = opts.firstTask ? [{ slug: slugify(opts.firstTask.title), ...opts.firstTask }] : [];
     write(cwd2, "feature_list.json", featureListJson(tasks));
-    if (!existsSync4(join5(cwd2, config.storage.markdownFallback.path))) {
+    if (config.storage.scope === "local" && !existsSync4(join5(cwd2, config.storage.markdownFallback.path))) {
       write(
         cwd2,
         config.storage.markdownFallback.path,
@@ -875,7 +880,7 @@ var CodexCliMaterializer = class {
     }
     const tasks = opts.firstTask ? [{ slug: slugify(opts.firstTask.title), ...opts.firstTask }] : [];
     write2(join6(config.storage.dir, "feature_list.json"), featureListJson(tasks));
-    if (!existsSync5(join6(cwd2, config.storage.markdownFallback.path))) {
+    if (config.storage.scope === "local" && !existsSync5(join6(cwd2, config.storage.markdownFallback.path))) {
       write2(
         config.storage.markdownFallback.path,
         `<!-- AUTO-GENERATED by agent-harness-kit \u2014 DO NOT EDIT MANUALLY -->
@@ -954,7 +959,7 @@ var OpenCodeMaterializer = class {
     }
     const tasks = opts.firstTask ? [{ slug: slugify(opts.firstTask.title), ...opts.firstTask }] : [];
     write2(join7(config.storage.dir, "feature_list.json"), featureListJson(tasks));
-    if (!existsSync6(join7(cwd2, config.storage.markdownFallback.path))) {
+    if (config.storage.scope === "local" && !existsSync6(join7(cwd2, config.storage.markdownFallback.path))) {
       write2(
         config.storage.markdownFallback.path,
         `<!-- AUTO-GENERATED by agent-harness-kit \u2014 DO NOT EDIT MANUALLY -->
@@ -1059,7 +1064,8 @@ async function buildOnce(cwd2) {
 }
 
 // src/commands/dashboard.ts
-import { dirname as dirname4, join as join9, resolve as resolve6 } from "path";
+import { homedir } from "os";
+import { dirname as dirname4, join as join9 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import pc2 from "picocolors";
 
@@ -1074,11 +1080,11 @@ import { WebSocketServer } from "ws";
 // src/core/port-utils.ts
 import { createServer } from "net";
 function isPortFree(port) {
-  return new Promise((resolve13) => {
+  return new Promise((resolve12) => {
     const server = createServer();
-    server.once("error", () => resolve13(false));
+    server.once("error", () => resolve12(false));
     server.once("listening", () => {
-      server.close(() => resolve13(true));
+      server.close(() => resolve12(true));
     });
     server.listen(port, "127.0.0.1");
   });
@@ -1272,7 +1278,7 @@ var __dirname3 = dirname4(fileURLToPath3(import.meta.url));
 async function runDashboard(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const db = await openDB(config, cwd2);
-  const dbPath = config.database.type === "sqlite" ? resolve6(cwd2, config.database.path) : null;
+  const dbPath = config.database.type === "sqlite" ? resolveSqlitePath(config, cwd2, homedir()) : null;
   const staticPath = join9(__dirname3, "dashboard-dist");
   const { url } = await startDashboardServer(db, dbPath, staticPath, opts.port);
   console.log(pc2.green(`\u2713`) + ` Dashboard running at ${pc2.bold(pc2.cyan(url))}`);
@@ -1601,7 +1607,8 @@ async function runExport(cwd2, opts) {
 // src/commands/health.ts
 import { spawnSync } from "child_process";
 import { existsSync as existsSync10 } from "fs";
-import { join as join12, resolve as resolve7 } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join12, resolve as resolve6 } from "path";
 import pc5 from "picocolors";
 function checkLine(label, ok3, message, indent = 0) {
   const prefix = label ? pc5.cyan(`[${label}] `) : " ".repeat(indent);
@@ -1619,9 +1626,9 @@ async function runHealth(cwd2) {
   let allOk = true;
   let dbOk;
   if (config.database.type === "sqlite") {
-    const dbPath = resolve7(cwd2, config.database.path);
+    const dbPath = resolveSqlitePath(config, cwd2, homedir2());
     dbOk = existsSync10(dbPath);
-    checkLine("checking DB", dbOk, `${config.database.path} reachable`);
+    checkLine("checking DB", dbOk, `${dbPath} reachable`);
   } else {
     dbOk = true;
     checkLine("checking DB", true, `${config.database.type}://${config.database.connectionString.replace(/:[^:@]*@/, ":***@")} configured`);
@@ -1645,7 +1652,7 @@ async function runHealth(cwd2) {
   }
   if (config.tools.mcp.enabled) {
     const mcpFile = providerFiles.mcpFile;
-    const mcpPath = resolve7(cwd2, mcpFile);
+    const mcpPath = resolve6(cwd2, mcpFile);
     const mcpOk = existsSync10(mcpPath);
     checkLine("checking MCP", mcpOk, `${mcpFile} valid`);
     if (!mcpOk) allOk = false;
@@ -1655,7 +1662,7 @@ async function runHealth(cwd2) {
     console.error(pc5.red("\u2717 Harness checks failed \u2014 fix the above before running health.sh"));
     process.exit(1);
   }
-  const scriptPath = resolve7(cwd2, config.health.scriptPath);
+  const scriptPath = resolve6(cwd2, config.health.scriptPath);
   if (!existsSync10(scriptPath)) {
     console.error(pc5.red(`\u2717 health.sh not found: ${scriptPath}`));
     console.error("  Run ahk init first.");
@@ -1729,8 +1736,7 @@ var taskTitleSchema = v2.pipe(
 );
 var taskDescriptionSchema = v2.pipe(
   v2.string(),
-  v2.nonEmpty("Description is required"),
-  v2.maxLength(1e3, "Description must be at most 1000 characters")
+  v2.nonEmpty("Description is required")
 );
 
 // src/utils/form.ts
@@ -1778,6 +1784,20 @@ function detectConfigExtension(cwd2) {
 }
 function applyConfigDefaults(params) {
   const models = params.models ?? {};
+  const scope = params.scope ?? "local";
+  const projectId = params.projectId ?? randomUUID();
+  const baseStorage = {
+    dir: ".harness",
+    tasks: { adapter: params.tasksAdapter },
+    sections: {
+      toolsUsed: true,
+      filesModified: true,
+      result: true,
+      blockers: true,
+      nextSteps: false
+    }
+  };
+  const storage = scope === "global" ? { ...baseStorage, markdownFallback: { enabled: true }, scope: "global", projectId } : { ...baseStorage, markdownFallback: { enabled: true, path: ".harness/current.md" }, scope: "local", projectId };
   return {
     provider: params.provider,
     project: {
@@ -1802,21 +1822,8 @@ function applyConfigDefaults(params) {
       ...models.consultant && { consultant: { instructionsPath: null, model: models.consultant } },
       custom: []
     },
-    database: { type: "sqlite", path: ".harness/harness.db" },
-    storage: {
-      dir: ".harness",
-      tasks: { adapter: params.tasksAdapter },
-      sections: {
-        toolsUsed: true,
-        filesModified: true,
-        result: true,
-        blockers: true,
-        nextSteps: false
-      },
-      markdownFallback: { enabled: true, path: ".harness/current.md" },
-      scope: params.scope ?? "local",
-      projectId: params.projectId ?? randomUUID()
-    },
+    database: { type: "sqlite" },
+    storage,
     health: {
       scriptPath: "./health.sh",
       required: true
@@ -2205,8 +2212,8 @@ async function runMigrate(cwd2, opts) {
 
 // src/commands/migrate-storage.ts
 import { copyFileSync, existsSync as existsSync12, mkdirSync as mkdirSync8, rmSync, writeFileSync as writeFileSync9 } from "fs";
-import { homedir } from "os";
-import { dirname as dirname7, join as join15, resolve as resolve8 } from "path";
+import { homedir as homedir3 } from "os";
+import { dirname as dirname7, join as join15, resolve as resolve7 } from "path";
 import pc9 from "picocolors";
 function log5(msg) {
   console.log(msg);
@@ -2214,11 +2221,17 @@ function log5(msg) {
 function fail(msg) {
   throw new Error(msg);
 }
+function defaultMarkdownPathForConfig(config) {
+  return config.storage.scope === "local" ? config.storage.markdownFallback.path : DEFAULT_MARKDOWN_PATH;
+}
 function currentMdPathForScope(scope, config, cwd2, homeDir) {
-  return scope === "global" ? join15(resolveGlobalStorageDir(config, homeDir), "current.md") : resolve8(cwd2, config.storage.markdownFallback.path);
+  return scope === "global" ? join15(resolveGlobalStorageDir(config, homeDir), "current.md") : resolve7(cwd2, defaultMarkdownPathForConfig(config));
+}
+function defaultSqlitePathForConfig(config) {
+  return config.storage.scope === "local" && config.database.type === "sqlite" ? config.storage.sqlitePath ?? DEFAULT_SQLITE_PATH : DEFAULT_SQLITE_PATH;
 }
 async function backupDestination(cwd2, storageDir, data) {
-  const backupsDir = resolve8(cwd2, storageDir, "backups");
+  const backupsDir = resolve7(cwd2, storageDir, "backups");
   const path = join15(backupsDir, `pre-migrate-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.json`);
   try {
     mkdirSync8(backupsDir, { recursive: true });
@@ -2242,14 +2255,14 @@ function copySqliteFile(srcPath, destPath) {
     throw new Error(`Copy verification failed: ${destPath} does not exist after copy.`);
   }
 }
-async function runMigrateStorage(cwd2, opts, homeDir = homedir()) {
+async function runMigrateStorage(cwd2, opts, homeDir = homedir3()) {
   const config = await loadConfig(cwd2);
   const storageDir = config.storage.dir;
   const state = readStorageStateFile(cwd2, storageDir);
   let realScope;
   let realDbType;
   if (!state) {
-    const defaultSqlitePath = config.database.type === "sqlite" ? config.database.path : ".harness/harness.db";
+    const defaultSqlitePath = defaultSqlitePathForConfig(config);
     const localPath = resolveSqlitePathForScope("local", defaultSqlitePath, cwd2, config, homeDir);
     const globalPath = resolveSqlitePathForScope("global", defaultSqlitePath, cwd2, config, homeDir);
     const localCount = await probeTaskCount(localPath);
@@ -2309,7 +2322,7 @@ async function probeTaskCount(dbPath) {
   }
 }
 async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts) {
-  const sqlitePath = config.database.type === "sqlite" ? config.database.path : ".harness/harness.db";
+  const sqlitePath = defaultSqlitePathForConfig(config);
   const srcDb = resolveSqlitePathForScope(fromScope, sqlitePath, cwd2, config, homeDir);
   const destDb = resolveSqlitePathForScope(toScope, sqlitePath, cwd2, config, homeDir);
   const srcMd = currentMdPathForScope(fromScope, config, cwd2, homeDir);
@@ -2339,8 +2352,8 @@ async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts)
       let data;
       try {
         await backupDriver.ensureSchema();
-        const { HarnessDB } = await import("./db-QQ7BR5K7.js");
-        const tmpDb = new HarnessDB(backupDriver, { ...config, storage: { ...config.storage, scope: toScope } }, homeDir);
+        const { HarnessDB } = await import("./db-3OXHRFAR.js");
+        const tmpDb = new HarnessDB(backupDriver, config, homeDir);
         data = await tmpDb.exportJson();
       } finally {
         await backupDriver.close();
@@ -2373,7 +2386,7 @@ async function migrateScopeOnly(cwd2, config, homeDir, fromScope, toScope, opts)
   log5(pc9.green(`\u2713 Storage migrated: scope ${fromScope} \u2192 ${toScope}`));
 }
 async function migrateAcrossDbType(cwd2, config, homeDir, sourceScope, opts) {
-  const sqlitePath = config.database.type === "sqlite" ? config.database.path : ".harness/harness.db";
+  const sqlitePath = defaultSqlitePathForConfig(config);
   const srcPath = resolveSqlitePathForScope(sourceScope, sqlitePath, cwd2, config, homeDir);
   if (!existsSync12(srcPath)) {
     fail(`Source sqlite database not found at ${srcPath} (expected ${sourceScope} scope) \u2014 nothing to migrate.`);
@@ -2385,8 +2398,8 @@ async function migrateAcrossDbType(cwd2, config, homeDir, sourceScope, opts) {
   try {
     await srcDriver.ensureSchema();
     sourceCounts = await getRowCounts(srcDriver);
-    const { HarnessDB } = await import("./db-QQ7BR5K7.js");
-    const srcDb = new HarnessDB(srcDriver, { ...config, storage: { ...config.storage, scope: sourceScope }, database: { type: "sqlite", path: sqlitePath } }, homeDir);
+    const { HarnessDB } = await import("./db-3OXHRFAR.js");
+    const srcDb = new HarnessDB(srcDriver, config, homeDir);
     sourceData = await srcDb.exportJson();
   } finally {
     await srcDriver.close();
@@ -2439,13 +2452,14 @@ async function migrateAcrossDbType(cwd2, config, homeDir, sourceScope, opts) {
 
 // src/commands/reset.ts
 import { existsSync as existsSync13, readdirSync, rmSync as rmSync2 } from "fs";
-import { join as join16, resolve as resolve9 } from "path";
+import { homedir as homedir4 } from "os";
+import { join as join16, resolve as resolve8 } from "path";
 import * as p5 from "@clack/prompts";
 import pc10 from "picocolors";
 var AGENT_MD_FILES = ["lead", "explorer", "consultant", "builder", "reviewer"];
 async function resetAgentMds(cwd2, provider) {
   const agentDir = provider === "claude-code" ? ".claude/agents" : ".opencode/agents";
-  const agentDirPath = resolve9(cwd2, agentDir);
+  const agentDirPath = resolve8(cwd2, agentDir);
   if (!existsSync13(agentDirPath)) {
     console.log(pc10.yellow(`  Skipping agent files \u2014 directory not found: ${agentDirPath}`));
     return;
@@ -2497,8 +2511,8 @@ async function runReset(cwd2, opts) {
     process.exit(1);
   }
   const storageDir = config.storage.dir || ".harness";
-  const dbPath = config.database.type === "sqlite" ? resolve9(cwd2, config.database.path) : null;
-  const featureListPath = resolve9(cwd2, storageDir, "feature_list.json");
+  const dbPath = config.database.type === "sqlite" ? resolveSqlitePath(config, cwd2, homedir4()) : null;
+  const featureListPath = resolve8(cwd2, storageDir, "feature_list.json");
   let resetDb = false;
   let resetFeatureList = false;
   let resetAgentMdsFlag = false;
@@ -2511,7 +2525,7 @@ async function runReset(cwd2, opts) {
         resetDb = false;
       } else {
         const confirm3 = await p5.confirm({
-          message: `Delete database (${config.database.path})?`,
+          message: `Delete database (${dbPath})?`,
           initialValue: true
         });
         if (p5.isCancel(confirm3)) {
@@ -2574,7 +2588,7 @@ async function runReset(cwd2, opts) {
 
 // src/core/mcp-server.ts
 import { existsSync as existsSync15, mkdirSync as mkdirSync9, readdirSync as readdirSync2, readFileSync as readFileSync10, statSync, writeFileSync as writeFileSync10 } from "fs";
-import { join as join18, resolve as resolve10 } from "path";
+import { join as join18, resolve as resolve9 } from "path";
 import { Server } from "@modelcontextprotocol/sdk/server";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -2655,7 +2669,10 @@ var TOOLS = [
           type: "string",
           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" }
+        content: {
+          type: "string",
+          description: "Content for this section. No length limit \u2014 include all information that's relevant and necessary, but avoid unnecessary padding to prevent context bottlenecks between agents."
+        }
       },
       required: ["actionId", "sectionType", "content"]
     }
@@ -2793,11 +2810,14 @@ var TOOLS = [
           type: "string",
           description: "URL-safe identifier (lowercase, hyphens). Auto-derived from title if omitted."
         },
-        description: { type: "string", description: "Longer description of the task goal" },
+        description: {
+          type: "string",
+          description: "Longer description of the task goal. No length limit \u2014 include all information that's relevant and necessary, but avoid unnecessary padding to prevent context bottlenecks between agents."
+        },
         acceptance: {
           type: "array",
           items: { type: "string" },
-          description: "List of acceptance criteria (plain sentences)"
+          description: "List of acceptance criteria (plain sentences). No length limit \u2014 include all information that's relevant and necessary, but avoid unnecessary padding to prevent context bottlenecks between agents."
         }
       },
       required: ["title"]
@@ -2886,7 +2906,7 @@ var TOOLS = [
 ];
 async function startMcpServer(config, cwd2) {
   const db = await openDB(config, cwd2);
-  const docsPath = resolve10(cwd2, config.project.docsPath);
+  const docsPath = resolve9(cwd2, config.project.docsPath);
   const server = new Server(
     { name: "agent-harness-kit", version: VERSION },
     { capabilities: { tools: {} } }
@@ -3286,12 +3306,12 @@ async function runStatus(cwd2, opts) {
 
 // src/commands/sync.ts
 import { existsSync as existsSync16, readFileSync as readFileSync11 } from "fs";
-import { join as join19, resolve as resolve11 } from "path";
+import { join as join19, resolve as resolve10 } from "path";
 import pc12 from "picocolors";
 async function runSync(cwd2, opts) {
   const config = await loadConfig(cwd2);
   const direction = opts.direction ?? "both";
-  const featureListPath = resolve11(join19(cwd2, config.storage.dir, "feature_list.json"));
+  const featureListPath = resolve10(join19(cwd2, config.storage.dir, "feature_list.json"));
   const db = await openDB(config, cwd2);
   try {
     if (direction === "in" || direction === "both") {
@@ -3397,12 +3417,12 @@ async function runTaskAdd(cwd2) {
 // src/commands/task/done.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import { existsSync as existsSync17 } from "fs";
-import { resolve as resolve12 } from "path";
+import { resolve as resolve11 } from "path";
 import pc14 from "picocolors";
 async function runTaskDone(cwd2, idOrSlug) {
   const config = await loadConfig(cwd2);
   if (config.health.required) {
-    const scriptPath = resolve12(cwd2, config.health.scriptPath);
+    const scriptPath = resolve11(cwd2, config.health.scriptPath);
     if (existsSync17(scriptPath)) {
       const result = spawnSync2("bash", [scriptPath], { cwd: cwd2, stdio: "pipe", encoding: "utf8" });
       if (result.status !== 0) {
@@ -3616,15 +3636,15 @@ import pc18 from "picocolors";
 var REGISTRY_URL2 = `https://registry.npmjs.org/${pkg.name}/latest`;
 var TIMEOUT_MS2 = 2500;
 function checkForUpdate(currentVersion) {
-  return new Promise((resolve13) => {
-    const timer = setTimeout(() => resolve13(null), TIMEOUT_MS2);
+  return new Promise((resolve12) => {
+    const timer = setTimeout(() => resolve12(null), TIMEOUT_MS2);
     fetch(REGISTRY_URL2).then((res) => res.json()).then((data) => {
       clearTimeout(timer);
       const latest = data.version;
-      resolve13(isNewer2(latest, currentVersion) ? { current: currentVersion, latest } : null);
+      resolve12(isNewer2(latest, currentVersion) ? { current: currentVersion, latest } : null);
     }).catch(() => {
       clearTimeout(timer);
-      resolve13(null);
+      resolve12(null);
     });
   });
 }