@cardor/agent-harness-kit 1.6.8 → 1.7.0

package/README.md

@@ -161,7 +161,9 @@ ahk init --name "my-app" --provider claude-code --docs ./docs --tasks local
 ahk init --name "my-app" --provider codex-cli   --docs ./docs --tasks local
 ```
 
-Run this once per project. Safe to re-run — it will not overwrite files you've customized.
+Run this once per project. If the project is already initialized, the command prints an 'already initialized' message with suggested next-step commands (`ahk build`, `ahk build --sync`, `ahk reset`, `ahk serve`) and exits without overwriting anything.
+
+The config file extension is chosen automatically: `.ts` if a `tsconfig.json` is present, `.mjs` for ESM-only projects (`"type": "module"` in `package.json`), or `.cjs` otherwise.
 
 ---
 
@@ -339,7 +341,7 @@ ahk export --sql --output dump.sql       # SQL dump to file
 
 ```
 your-project/
-├── agent-harness-kit.config.ts
+├── agent-harness-kit.config.{ts|mjs|cjs}
 ├── AGENTS.md
 ├── CLAUDE.md
 ├── health.sh
@@ -361,7 +363,7 @@ your-project/
 
 ```
 your-project/
-├── agent-harness-kit.config.ts
+├── agent-harness-kit.config.{ts|mjs|cjs}
 ├── AGENTS.md
 ├── health.sh
 ├── opencode.json                  ← MCP server + default_agent + compaction config
@@ -378,7 +380,7 @@ your-project/
 
 ```
 your-project/
-├── agent-harness-kit.config.ts
+├── agent-harness-kit.config.{ts|mjs|cjs}
 ├── AGENTS.md
 ├── health.sh
 ├── .harness/

package/dist/{chunk-X7FOJOZB.js → chunk-OEPZRC7J.js}

@@ -5,7 +5,8 @@ import { createJiti } from "jiti";
 var CONFIG_NAMES = [
   "agent-harness-kit.config.ts",
   "agent-harness-kit.config",
-  "agent-harness-kit.config.mjs"
+  "agent-harness-kit.config.mjs",
+  "agent-harness-kit.config.cjs"
 ];
 function findConfigFile(cwd) {
   for (const name of CONFIG_NAMES) {
@@ -76,7 +77,8 @@ function applyDefaults(config) {
 }
 
 export {
+  findConfigFile,
   loadConfig,
   defineHarness
 };
-//# sourceMappingURL=chunk-X7FOJOZB.js.map
+//# sourceMappingURL=chunk-OEPZRC7J.js.map

package/dist/chunk-OEPZRC7J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/config.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { join } from 'node:path'\nimport { createJiti } from 'jiti'\n\nimport type { HarnessConfig } from '@/types'\n\nconst CONFIG_NAMES = [\n  'agent-harness-kit.config.ts',\n  'agent-harness-kit.config',\n  'agent-harness-kit.config.mjs',\n  'agent-harness-kit.config.cjs',\n]\n\nexport function findConfigFile(cwd: string): string | null {\n  for (const name of CONFIG_NAMES) {\n    const candidate = join(cwd, name)\n    if (existsSync(candidate)) return candidate\n  }\n  return null\n}\n\nexport async function loadConfig(cwd: string): Promise<HarnessConfig> {\n  const configPath = findConfigFile(cwd)\n  if (!configPath) {\n    throw new Error('No agent-harness-kit.config found. Run: ahk init')\n  }\n\n  const jiti = createJiti(import.meta.url)\n  const mod = await jiti.import(configPath) as { default?: HarnessConfig } | HarnessConfig\n  const config = (mod as { default?: HarnessConfig }).default ?? (mod as HarnessConfig)\n\n  if (!config || typeof config !== 'object') {\n    throw new Error(`agent-harness-kit.config must export a default HarnessConfig object.`)\n  }\n\n  return applyDefaults(config as HarnessConfig)\n}\n\nexport function defineHarness(config: HarnessConfig): HarnessConfig {\n  return config\n}\n\nfunction applyDefaults(config: HarnessConfig): HarnessConfig {\n  const c = config as Partial<HarnessConfig>\n  return {\n    ...config,\n    provider: c.provider ?? 'claude-code',\n    project: {\n      docsPath: './docs',\n      agentsMd: './AGENTS.md',\n      ...c.project,\n    } as HarnessConfig['project'],\n    agents: {\n      lead: { instructionsPath: null },\n      explorer: { instructionsPath: null },\n      builder: { instructionsPath: null },\n      reviewer: { instructionsPath: null },\n      custom: [],\n      ...c.agents,\n    } as HarnessConfig['agents'],\n    database: c.database ?? { type: 'sqlite' as const, path: '.harness/harness.db' },\n    storage: {\n      dir: '.harness',\n      tasks: { adapter: 'local' as const },\n      sections: {\n        toolsUsed: true,\n        filesModified: true,\n        result: true,\n        blockers: true,\n        nextSteps: false,\n      },\n      markdownFallback: { enabled: true, path: '.harness/current.md' },\n      ...c.storage,\n    } as HarnessConfig['storage'],\n    health: {\n      scriptPath: './health.sh',\n      required: true,\n      ...c.health,\n    },\n    tools: {\n      mcp: { enabled: true, port: 3742 },\n      scripts: { enabled: true, outputDir: './.harness/scripts' },\n      ...c.tools,\n    } as HarnessConfig['tools'],\n  }\n}\n"],"mappings":";AAAA,SAAS,kBAAkB;AAC3B,SAAS,YAAY;AACrB,SAAS,kBAAkB;AAI3B,IAAM,eAAe;AAAA,EACnB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,SAAS,eAAe,KAA4B;AACzD,aAAW,QAAQ,cAAc;AAC/B,UAAM,YAAY,KAAK,KAAK,IAAI;AAChC,QAAI,WAAW,SAAS,EAAG,QAAO;AAAA,EACpC;AACA,SAAO;AACT;AAEA,eAAsB,WAAW,KAAqC;AACpE,QAAM,aAAa,eAAe,GAAG;AACrC,MAAI,CAAC,YAAY;AACf,UAAM,IAAI,MAAM,kDAAkD;AAAA,EACpE;AAEA,QAAM,OAAO,WAAW,YAAY,GAAG;AACvC,QAAM,MAAM,MAAM,KAAK,OAAO,UAAU;AACxC,QAAM,SAAU,IAAoC,WAAY;AAEhE,MAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,UAAM,IAAI,MAAM,sEAAsE;AAAA,EACxF;AAEA,SAAO,cAAc,MAAuB;AAC9C;AAEO,SAAS,cAAc,QAAsC;AAClE,SAAO;AACT;AAEA,SAAS,cAAc,QAAsC;AAC3D,QAAM,IAAI;AACV,SAAO;AAAA,IACL,GAAG;AAAA,IACH,UAAU,EAAE,YAAY;AAAA,IACxB,SAAS;AAAA,MACP,UAAU;AAAA,MACV,UAAU;AAAA,MACV,GAAG,EAAE;AAAA,IACP;AAAA,IACA,QAAQ;AAAA,MACN,MAAM,EAAE,kBAAkB,KAAK;AAAA,MAC/B,UAAU,EAAE,kBAAkB,KAAK;AAAA,MACnC,SAAS,EAAE,kBAAkB,KAAK;AAAA,MAClC,UAAU,EAAE,kBAAkB,KAAK;AAAA,MACnC,QAAQ,CAAC;AAAA,MACT,GAAG,EAAE;AAAA,IACP;AAAA,IACA,UAAU,EAAE,YAAY,EAAE,MAAM,UAAmB,MAAM,sBAAsB;AAAA,IAC/E,SAAS;AAAA,MACP,KAAK;AAAA,MACL,OAAO,EAAE,SAAS,QAAiB;AAAA,MACnC,UAAU;AAAA,QACR,WAAW;AAAA,QACX,eAAe;AAAA,QACf,QAAQ;AAAA,QACR,UAAU;AAAA,QACV,WAAW;AAAA,MACb;AAAA,MACA,kBAAkB,EAAE,SAAS,MAAM,MAAM,sBAAsB;AAAA,MAC/D,GAAG,EAAE;AAAA,IACP;AAAA,IACA,QAAQ;AAAA,MACN,YAAY;AAAA,MACZ,UAAU;AAAA,MACV,GAAG,EAAE;AAAA,IACP;AAAA,IACA,OAAO;AAAA,MACL,KAAK,EAAE,SAAS,MAAM,MAAM,KAAK;AAAA,MACjC,SAAS,EAAE,SAAS,MAAM,WAAW,qBAAqB;AAAA,MAC1D,GAAG,EAAE;AAAA,IACP;AAAA,EACF;AACF;","names":[]}

package/dist/cli.js

@@ -1,6 +1,7 @@
 import {
+  findConfigFile,
   loadConfig
-} from "./chunk-X7FOJOZB.js";
+} from "./chunk-OEPZRC7J.js";
 
 // src/cli.ts
 import { Command } from "commander";
@@ -499,6 +500,57 @@ export default defineHarness({
 })
 `;
 }
+var configMjs = configTs;
+function configCjs(params) {
+  return `const { defineHarness } = require('@cardor/agent-harness-kit')
+
+module.exports = defineHarness({
+  project: {
+    name: '${params.name}',
+    description: '${params.description}',
+    docsPath: '${params.docsPath}',
+  },
+
+  provider: '${params.provider}',
+
+  agents: {
+    lead:     { instructionsPath: null },
+    explorer: { instructionsPath: null, allowedPaths: ['${params.docsPath}', './src'] },
+    builder:  { instructionsPath: null, writablePaths: ['./src', './tests'] },
+    reviewer: { instructionsPath: null },
+    custom:   [],
+  },
+
+  // 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' },
+
+  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' },
+  },
+
+  health: {
+    scriptPath: './health.sh',
+    required:   true,
+  },
+
+  tools: {
+    mcp:     { enabled: true, port: ${params.port} },
+    scripts: { enabled: true, outputDir: './.harness/scripts' },
+  },
+})
+`;
+}
 function agentLead(vars) {
   return loadAgentTemplate("lead", vars);
 }
@@ -1942,6 +1994,17 @@ function readProjectNameFromPackageJson(cwd2) {
     return null;
   }
 }
+function detectConfigExtension(cwd2) {
+  try {
+    if (existsSync8(join11(cwd2, "tsconfig.json"))) return "ts";
+    const pkgPath2 = join11(cwd2, "package.json");
+    if (!existsSync8(pkgPath2)) return "cjs";
+    const pkg2 = JSON.parse(readFileSync5(pkgPath2, "utf8"));
+    if (pkg2?.type === "module") return "mjs";
+  } catch {
+  }
+  return "cjs";
+}
 function applyConfigDefaults(params) {
   return {
     provider: params.provider,
@@ -2016,6 +2079,23 @@ function printWelcomeMessage(projectName) {
 
 // src/commands/init.ts
 async function runInit(cwd2, flags) {
+  const existingConfig = findConfigFile(cwd2);
+  if (existingConfig) {
+    console.log(
+      pc6.yellow("\u26A0") + " " + pc6.bold("Project already initialized.") + pc6.dim(` (${existingConfig})`)
+    );
+    console.log();
+    console.log(pc6.dim("Suggested next steps:"));
+    console.log(
+      "  " + pc6.cyan("ahk build") + pc6.dim("         \u2014 re-sync agent files after updating the library")
+    );
+    console.log("  " + pc6.cyan("ahk build --sync") + pc6.dim("  \u2014 also sync agent permissions"));
+    console.log(
+      "  " + pc6.cyan("ahk reset") + pc6.dim("         \u2014 wipe and re-initialize from scratch")
+    );
+    console.log("  " + pc6.cyan("ahk dashboard") + pc6.dim("         \u2014 open the harness dashboard"));
+    process.exit(0);
+  }
   const detectedName = flags.name ?? readProjectNameFromPackageJson(cwd2);
   const projectName = detectedName || "my-project";
   printWelcomeMessage(projectName);
@@ -2134,13 +2214,17 @@ async function runInit(cwd2, flags) {
     }
     firstTask = { title: taskTitle, description: taskDesc, acceptance };
   }
+  let configExt = "ts";
   const spinner6 = p3.spinner();
   spinner6.start("Scaffolding...");
   try {
     const config = applyConfigDefaults({ name, description, provider, docsPath, tasksAdapter });
     const materializer = getMaterializer(provider);
     const installDir = cwd2;
-    const configContent = configTs({
+    configExt = detectConfigExtension(cwd2);
+    const configFileName = `agent-harness-kit.config.${configExt}`;
+    const templateFn = configExt === "ts" ? configTs : configExt === "mjs" ? configMjs : configCjs;
+    const configContent = templateFn({
       name,
       description,
       provider,
@@ -2148,7 +2232,7 @@ async function runInit(cwd2, flags) {
       tasksAdapter,
       port: config.tools.mcp.port
     });
-    writeFileSync9(join12(installDir, "agent-harness-kit.config.ts"), configContent, "utf8");
+    writeFileSync9(join12(installDir, configFileName), configContent, "utf8");
     mkdirSync8(join12(installDir, config.storage.dir), { recursive: true });
     const db = await openDB(config, installDir);
     await materializer.scaffold(config, { cwd: installDir, firstTask });
@@ -2172,7 +2256,7 @@ async function runInit(cwd2, flags) {
   const agentsDir = provider === "claude-code" ? ".claude/agents/" : ".opencode/agents/";
   const mcpFile = provider === "claude-code" ? ".claude/mcp.json" : "./opencode.json";
   console.log("");
-  console.log(pc6.green("\u2713 agent-harness-kit.config.ts"));
+  console.log(pc6.green(`\u2713 agent-harness-kit.config.${configExt}`));
   console.log(pc6.green("\u2713 AGENTS.md"));
   console.log(pc6.green("\u2713 health.sh"));
   console.log(pc6.green("\u2713 .harness/harness.db"));