@cardor/agent-harness-kit 1.6.7 → 1.7.0

package/README.md

@@ -151,7 +151,7 @@ ahk init
 
 ### `ahk init`
 
-Interactive scaffold. Asks for your project name, description, AI provider, whether to install globally, docs path, task adapter, and an optional first task. Creates all harness files in the current directory (or home directory if global).
+Interactive scaffold. Asks for your project name, description, AI provider, docs path, task adapter, and an optional first task. Creates all harness files in the current directory.
 
 ```bash
 ahk init
@@ -161,9 +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.
 
-**Global installation** — if you answer yes to "Install globally?", files go to `~/.claude` (Claude Code), `~/.config/opencode` (OpenCode), or `~/.codex` (Codex CLI). This lets you share one harness config across all your projects.
+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.
 
 ---
 
@@ -341,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
@@ -363,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
@@ -380,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);
 }
@@ -1871,7 +1923,6 @@ function getProviderHealthFiles(provider) {
 
 // src/commands/init.ts
 import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync9 } from "fs";
-import { homedir } from "os";
 import { join as join12 } from "path";
 import * as p3 from "@clack/prompts";
 import pc6 from "picocolors";
@@ -1943,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,
@@ -2017,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);
@@ -2066,18 +2145,6 @@ async function runInit(cwd2, flags) {
     }
     provider = val;
   }
-  let globalInstallation = false;
-  const globalVal = await p3.confirm({
-    message: "Install globally (to home directory)?",
-    initialValue: false
-  });
-  if (p3.isCancel(globalVal)) {
-    p3.cancel("Cancelled.");
-    process.exit(0);
-  }
-  if (globalVal) {
-    globalInstallation = true;
-  }
   let docsPath;
   if (flags.docs) {
     docsPath = flags.docs;
@@ -2147,20 +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);
-    let installDir = cwd2;
-    if (globalInstallation) {
-      if (provider === "claude-code") {
-        installDir = join12(homedir(), ".claude");
-      } else {
-        installDir = join12(homedir(), ".config", "opencode");
-      }
-    }
-    const configContent = configTs({
+    const installDir = cwd2;
+    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,
@@ -2168,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 });
@@ -2188,12 +2252,11 @@ async function runInit(cwd2, flags) {
     p3.log.error(err instanceof Error ? err.message : String(err));
     throw err;
   }
-  const agentHarnessKitDir = globalInstallation ? "home directory" : "current directory";
-  console.log(pc6.green(`\u2713 Scaffolded harness in ${agentHarnessKitDir}`));
+  console.log(pc6.green("\u2713 Scaffolded harness in current directory"));
   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"));