@cardor/agent-harness-kit 0.1.0

package/README.md

@@ -0,0 +1,218 @@
+# agent-harness-kit
+
+CLI scaffolding for multi-agent harness systems.  
+Binary: `ahk` · Works with Claude Code, OpenCode, and any MCP-compatible AI tool.
+
+---
+
+## Requirements
+
+- Node.js ≥ 22 **or** Bun (any recent version)
+- npm ≥ 9
+
+---
+
+## Local development setup
+
+### 1. Clone and install dependencies
+
+```bash
+git clone <repo-url>
+cd agent-harness-kit
+npm install
+```
+
+### 2. Build the TypeScript source
+
+```bash
+npm run build
+```
+
+This compiles `src/` → `dist/`. You must re-run this every time you change source files.
+
+> Tip: run `npm run dev` in a separate terminal to watch for changes and rebuild automatically.
+
+### 3. Link the binary globally
+
+```bash
+npm link
+```
+
+This registers `ahk` as a global command on your machine by symlinking `bin/ahk.js` into your global `node_modules/.bin/`.
+
+Verify it worked:
+
+```bash
+ahk --version
+# 0.1.0
+```
+
+---
+
+## Testing from an external project folder
+
+Once linked, you can use `ahk` from **any directory** — no need to be inside `agent-harness-kit/`.
+
+```bash
+# Create a test project folder anywhere
+mkdir ~/projects/my-test-app
+cd ~/projects/my-test-app
+
+# Run the interactive scaffold
+ahk init
+```
+
+Follow the prompts. After init, your folder will contain:
+
+```
+my-test-app/
+├── agent-harness-kit.config.ts       ← your harness config
+├── AGENTS.md                  ← navigation map for agents
+├── health.sh                  ← implement your health checks here
+├── .harness/
+│   ├── harness.db             ← SQLite source of truth
+│   ├── current.md             ← auto-generated session snapshot
+│   └── feature_list.json      ← human-editable task list
+└── .claude/
+    ├── agents/
+    │   ├── lead.md
+    │   ├── explorer.md
+    │   ├── builder.md
+    │   └── reviewer.md
+    └── mcp.json               ← Claude Code picks this up automatically
+```
+
+---
+
+## Development loop
+
+```
+# Terminal 1 — watch and rebuild on save
+cd agent-harness-kit
+npm run dev
+
+# Terminal 2 — test commands from your external project
+cd ~/projects/my-test-app
+ahk status
+ahk task add
+ahk health
+```
+
+Because `npm link` creates a symlink (not a copy), every rebuild in terminal 1 is immediately available in terminal 2 — no re-linking needed.
+
+---
+
+## Available commands
+
+```
+ahk init                    Interactive harness scaffold
+ahk build                   Regenerate AGENTS.md + provider files from config
+ahk build --watch           Rebuild on config file changes
+ahk health                  Run health.sh and report result
+ahk status                  Show task table and active actions
+ahk status --json           Same, as JSON
+ahk sync                    Sync feature_list.json ↔ SQLite
+ahk sync --dry-run          Preview changes without applying
+ahk serve                   Start MCP server on stdio (used by Claude Code)
+ahk task add                Add a task interactively
+ahk task list               List all tasks
+ahk task list --status pending|in_progress|done|blocked
+ahk task done <id|slug>     Mark a task as done (runs health check first)
+ahk migrate --to <provider> Move provider files to claude-code or opencode
+ahk export --json           Export tasks + actions as JSON
+```
+
+---
+
+## Remove the global link
+
+When you no longer need the local link:
+
+```bash
+npm unlink -g agent-harness-kit
+```
+
+---
+
+## MCP server
+
+`ahk serve` starts the MCP server on stdio. You never need to call it manually — after `ahk init`, the generated `.claude/mcp.json` (Claude Code) or `opencode.json` (OpenCode) tells the AI tool to spawn it automatically when you open the project.
+
+**Tools exposed to agents:**
+
+| Tool | Description |
+|------|-------------|
+| `actions.start(taskId, agent)` | Start an action, returns `actionId` |
+| `actions.write(actionId, section, content)` | Record a section (result, tools\_used, …) |
+| `actions.complete(actionId, summary)` | Close the action |
+| `actions.get(taskId)` | Full action history for a task |
+| `tasks.get([status])` | List tasks, optionally filtered |
+| `tasks.claim(id, agent)` | Atomically claim a pending task |
+| `tasks.update(id, status)` | Change task status |
+| `docs.search(query)` | Search the project docs folder |
+
+---
+
+## Runtime compatibility
+
+| Runtime | Support |
+|---------|---------|
+| Node.js ≥ 22 | ✅ uses `node:sqlite` built-in |
+| Bun (any) | ✅ uses `bun:sqlite` built-in |
+| Node.js < 22 | ❌ `node:sqlite` not available |
+
+---
+
+## Running tests
+
+Tests use the Node.js built-in test runner — no extra dependencies needed.
+
+```bash
+npm run build
+npm test
+```
+
+---
+
+## Publishing to npm
+
+The package is published under the `@cardor` scope as `@cardor/agent-harness-kit`.
+
+### Prerequisites
+
+1. Be a member of the `@cardor` npm organization (or have publish access).
+2. Be logged in to npm:
+
+```bash
+npm login
+```
+
+### Manual publish
+
+```bash
+# 1. Bump the version (patch | minor | major)
+npm version patch
+
+# 2. Build, run tests, and publish (prepublishOnly does build + test automatically)
+npm publish --access public
+```
+
+> `--access public` is required for scoped packages on the free npm plan.
+
+### Check what will be packed before publishing
+
+```bash
+npm pack --dry-run
+```
+
+This lists every file that would be included in the tarball without actually uploading anything. Make sure `dist/` and `bin/` are listed, and that `src/`, `node_modules/`, and `.harness/` are **not**.
+
+### Patch release checklist
+
+```
+[ ] git pull --rebase origin main
+[ ] npm run build && npm test         # must be green
+[ ] npm version patch                 # bumps package.json + creates git tag
+[ ] git push && git push --tags       # CI will publish automatically (see below)
+[ ] npm publish --access public       # only if publishing manually
+```

package/bin/ahk.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli.js'

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,113 @@
+import { Command } from 'commander';
+import { createRequire } from 'node:module';
+import { runInit } from './commands/init.js';
+import { runBuild } from './commands/build.js';
+import { runHealth } from './commands/health.js';
+import { runStatus } from './commands/status.js';
+import { runSync } from './commands/sync.js';
+import { runServe } from './commands/serve.js';
+import { runMigrate } from './commands/migrate.js';
+import { runExport } from './commands/export.js';
+import { runTaskAdd, runTaskList, runTaskDone } from './commands/task/index.js';
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+const pkg = require('../package.json');
+const cwd = process.cwd();
+const program = new Command();
+program
+    .name('ahk')
+    .description('agent-harness-kit — CLI scaffolding for multi-agent harness systems')
+    .version(pkg.version, '-v, --version');
+// ─── init ─────────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Scaffold a harness interactively in the current directory')
+    .option('--name <name>', 'Project name (skip prompt)')
+    .option('--provider <provider>', 'AI provider: claude-code | opencode (skip prompt)')
+    .option('--docs <path>', 'Docs folder path (skip prompt)')
+    .option('--tasks <adapter>', 'Task adapter: local | jira | linear (skip prompt)')
+    .action(async (opts) => {
+    await runInit(cwd, opts);
+});
+// ─── build ────────────────────────────────────────────────────────────────────
+program
+    .command('build')
+    .description('Regenerate AGENTS.md and provider files from agent-harness-kit.config.ts')
+    .option('--watch', 'Rebuild on config changes')
+    .action(async (opts) => {
+    await runBuild(cwd, opts);
+});
+// ─── health ───────────────────────────────────────────────────────────────────
+program
+    .command('health')
+    .description('Run health.sh and report result')
+    .action(async () => {
+    await runHealth(cwd);
+});
+// ─── status ───────────────────────────────────────────────────────────────────
+program
+    .command('status')
+    .description('Show task table and active actions')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    await runStatus(cwd, opts);
+});
+// ─── sync ─────────────────────────────────────────────────────────────────────
+program
+    .command('sync')
+    .description('Sync feature_list.json ↔ SQLite')
+    .option('--dry-run', 'Show what would change without applying')
+    .option('--direction <direction>', 'in | out | both (default: both)')
+    .action(async (opts) => {
+    await runSync(cwd, { dryRun: opts['dry-run'], direction: opts.direction });
+});
+// ─── serve ────────────────────────────────────────────────────────────────────
+program
+    .command('serve')
+    .description('Start the MCP server (stdio)')
+    .option('--port <port>', 'Port hint stored in config (default: 3742)', parseInt)
+    .action(async (opts) => {
+    await runServe(cwd, { port: opts.port });
+});
+// ─── task ─────────────────────────────────────────────────────────────────────
+const task = program.command('task').description('Manage tasks');
+task
+    .command('add')
+    .description('Add a task interactively')
+    .action(async () => {
+    await runTaskAdd(cwd);
+});
+task
+    .command('list')
+    .description('List tasks')
+    .option('--status <status>', 'Filter by status: pending | in_progress | done | blocked')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    await runTaskList(cwd, opts);
+});
+task
+    .command('done <id|slug>')
+    .description('Mark a task as done')
+    .action(async (idOrSlug) => {
+    await runTaskDone(cwd, idOrSlug);
+});
+// ─── migrate ──────────────────────────────────────────────────────────────────
+program
+    .command('migrate')
+    .description('Migrate provider-specific files to a different provider')
+    .option('--to <provider>', 'Target provider: claude-code | opencode')
+    .action(async (opts) => {
+    await runMigrate(cwd, opts);
+});
+// ─── export ───────────────────────────────────────────────────────────────────
+program
+    .command('export')
+    .description('Export the database')
+    .option('--sql', 'SQL dump')
+    .option('--json', 'JSON export of tasks and actions')
+    .option('--output <path>', 'Output file path (default: stdout)')
+    .action(async (opts) => {
+    await runExport(cwd, opts);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAE/E,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC9C,mEAAmE;AACnE,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAA;AAE7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;AAEzB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,qEAAqE,CAAC;KAClF,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAA;AAExC,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,2DAA2D,CAAC;KACxE,MAAM,CAAC,eAAe,EAAE,4BAA4B,CAAC;KACrD,MAAM,CAAC,uBAAuB,EAAE,mDAAmD,CAAC;KACpF,MAAM,CAAC,eAAe,EAAE,gCAAgC,CAAC;KACzD,MAAM,CAAC,mBAAmB,EAAE,mDAAmD,CAAC;KAChF,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC1B,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,0EAA0E,CAAC;KACvF,MAAM,CAAC,SAAS,EAAE,2BAA2B,CAAC;KAC9C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC3B,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,iCAAiC,CAAC;KAC9C,MAAM,CAAC,WAAW,EAAE,yCAAyC,CAAC;KAC9D,MAAM,CAAC,yBAAyB,EAAE,iCAAiC,CAAC;KACpE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;AAC5E,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,8BAA8B,CAAC;KAC3C,MAAM,CAAC,eAAe,EAAE,4CAA4C,EAAE,QAAQ,CAAC;KAC/E,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;AAC1C,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,cAAc,CAAC,CAAA;AAEhE,IAAI;KACD,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;AACvB,CAAC,CAAC,CAAA;AAEJ,IAAI;KACD,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,YAAY,CAAC;KACzB,MAAM,CAAC,mBAAmB,EAAE,0DAA0D,CAAC;KACvF,MAAM,CAAC,QAAQ,EAAE,gBAAgB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC9B,CAAC,CAAC,CAAA;AAEJ,IAAI;KACD,OAAO,CAAC,gBAAgB,CAAC;KACzB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,KAAK,EAAE,QAAgB,EAAE,EAAE;IACjC,MAAM,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;AAClC,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,yDAAyD,CAAC;KACtE,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,CAAC;KACpE,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC7B,CAAC,CAAC,CAAA;AAEJ,iFAAiF;AACjF,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,qBAAqB,CAAC;KAClC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC;KAC3B,MAAM,CAAC,QAAQ,EAAE,kCAAkC,CAAC;KACpD,MAAM,CAAC,iBAAiB,EAAE,oCAAoC,CAAC;KAC/D,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;AAC5B,CAAC,CAAC,CAAA;AAEJ,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/commands/build.d.ts

@@ -0,0 +1,6 @@
+interface BuildOptions {
+    watch?: boolean;
+}
+export declare function runBuild(cwd: string, opts: BuildOptions): Promise<void>;
+export {};
+//# sourceMappingURL=build.d.ts.map

package/dist/commands/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAMA,UAAU,YAAY;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAc7E"}

package/dist/commands/build.js

@@ -0,0 +1,39 @@
+import * as p from '@clack/prompts';
+import pc from 'picocolors';
+import { watch } from 'node:fs';
+import { loadConfig } from '../core/config.js';
+import { getMaterializer } from '../core/materializer/index.js';
+export async function runBuild(cwd, opts) {
+    await buildOnce(cwd);
+    if (opts.watch) {
+        p.log.info(`Watching agent-harness-kit.config.ts for changes...`);
+        watch(cwd, { recursive: false }, async (_, filename) => {
+            if (filename?.startsWith('agent-harness-kit.config')) {
+                p.log.step('Config changed — rebuilding...');
+                await buildOnce(cwd);
+            }
+        });
+        // Keep process alive
+        await new Promise(() => { });
+    }
+}
+async function buildOnce(cwd) {
+    const spinner = p.spinner();
+    spinner.start('Loading config...');
+    try {
+        const config = await loadConfig(cwd);
+        spinner.message('Rebuilding files...');
+        const materializer = getMaterializer(config.provider);
+        await materializer.build(config, cwd);
+        spinner.stop(pc.green('Build complete'));
+        p.log.success('AGENTS.md');
+        p.log.success(`Agent definitions (${config.provider})`);
+        p.log.success('MCP config');
+    }
+    catch (err) {
+        spinner.stop(pc.red('Build failed'));
+        p.log.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAA;AACnC,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAM/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAkB;IAC5D,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;IAEpB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAA;QACjE,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE;YACrD,IAAI,QAAQ,EAAE,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;gBACrD,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;gBAC5C,MAAM,SAAS,CAAC,GAAG,CAAC,CAAA;YACtB,CAAC;QACH,CAAC,CAAC,CAAA;QACF,qBAAqB;QACrB,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IAC7B,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IAC3B,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;IAElC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;QACpC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;QACtC,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;QACrD,MAAM,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;QACxC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QAC1B,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAA;QACvD,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAA;QACpC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;AACH,CAAC"}

package/dist/commands/export.d.ts

@@ -0,0 +1,8 @@
+interface ExportOptions {
+    sql?: boolean;
+    json?: boolean;
+    output?: string;
+}
+export declare function runExport(cwd: string, opts: ExportOptions): Promise<void>;
+export {};
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B/E"}

package/dist/commands/export.js

@@ -0,0 +1,33 @@
+import pc from 'picocolors';
+import { writeFileSync } from 'node:fs';
+import { loadConfig } from '../core/config.js';
+import { openDB } from '../core/db.js';
+export async function runExport(cwd, opts) {
+    if (!opts.sql && !opts.json) {
+        console.error(pc.red('Specify --sql or --json'));
+        process.exit(1);
+    }
+    const config = await loadConfig(cwd);
+    const db = openDB(config, cwd);
+    try {
+        if (opts.json) {
+            const data = db.exportJson();
+            const out = JSON.stringify(data, null, 2) + '\n';
+            if (opts.output) {
+                writeFileSync(opts.output, out, 'utf8');
+                console.log(pc.green(`✓ Exported JSON → ${opts.output}`));
+            }
+            else {
+                process.stdout.write(out);
+            }
+        }
+        if (opts.sql) {
+            console.error(pc.dim('SQL dump requires direct SQLite access — use: sqlite3 .harness/harness.db .dump'));
+            process.exit(1);
+        }
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAQtC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,IAAmB;IAC9D,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC,CAAA;QAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;IACpC,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE9B,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,IAAI,GAAG,EAAE,CAAC,UAAU,EAAE,CAAA;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAA;YAChD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,aAAa,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;gBACvC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;YAC3D,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,iFAAiF,CAAC,CAAC,CAAA;YACxG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAA;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/health.d.ts

@@ -0,0 +1,2 @@
+export declare function runHealth(cwd: string): Promise<void>;
+//# sourceMappingURL=health.d.ts.map

package/dist/commands/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAMA,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC1D"}

package/dist/commands/health.js

@@ -0,0 +1,38 @@
+import pc from 'picocolors';
+import { spawnSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../core/config.js';
+export async function runHealth(cwd) {
+    let scriptPath;
+    try {
+        const config = await loadConfig(cwd);
+        scriptPath = resolve(cwd, config.health.scriptPath);
+    }
+    catch {
+        scriptPath = join(cwd, 'health.sh');
+    }
+    if (!existsSync(scriptPath)) {
+        console.error(pc.red(`✗ health.sh not found: ${scriptPath}`));
+        console.error('  Run ahk init first.');
+        process.exit(1);
+    }
+    const result = spawnSync('bash', [scriptPath], {
+        cwd,
+        stdio: 'inherit',
+        encoding: 'utf8',
+    });
+    if (result.error) {
+        console.error(pc.red(`✗ Failed to run health.sh: ${result.error.message}`));
+        process.exit(1);
+    }
+    if (result.status === 0) {
+        console.log(pc.green('✓ Health check passed'));
+        process.exit(0);
+    }
+    else {
+        console.error(pc.red(`✗ Health check failed (exit ${result.status ?? 'unknown'})`));
+        process.exit(result.status ?? 1);
+    }
+}
+//# sourceMappingURL=health.js.map

package/dist/commands/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/commands/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,IAAI,UAAkB,CAAA;IAEtB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,CAAA;QACpC,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC,CAAA;QAC7D,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE;QAC7C,GAAG;QACH,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,MAAM;KACjB,CAAC,CAAA;IAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC,CAAA;QAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACjB,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,MAAM,IAAI,SAAS,GAAG,CAAC,CAAC,CAAA;QACnF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAA;IAClC,CAAC;AACH,CAAC"}

package/dist/commands/init-helpers.d.ts

@@ -0,0 +1,9 @@
+import type { HarnessConfig, Provider } from '../types.js';
+export declare function applyConfigDefaults(params: {
+    name: string;
+    description: string;
+    provider: Provider;
+    docsPath: string;
+    tasksAdapter: string;
+}): HarnessConfig;
+//# sourceMappingURL=init-helpers.d.ts.map

package/dist/commands/init-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/init-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE1D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;CACrB,GAAG,aAAa,CAsChB"}

package/dist/commands/init-helpers.js

@@ -0,0 +1,40 @@
+export function applyConfigDefaults(params) {
+    return {
+        provider: params.provider,
+        project: {
+            name: params.name,
+            description: params.description,
+            docsPath: params.docsPath,
+            agentsMd: './AGENTS.md',
+        },
+        agents: {
+            lead: { instructionsPath: null },
+            explorer: { instructionsPath: null, allowedPaths: [params.docsPath, './src'] },
+            builder: { instructionsPath: null, writablePaths: ['./src', './tests'] },
+            reviewer: { instructionsPath: null },
+            custom: [],
+        },
+        storage: {
+            dir: '.harness',
+            dbPath: '.harness/harness.db',
+            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: 3742 },
+            scripts: { enabled: true, outputDir: './.harness/scripts' },
+        },
+    };
+}
+//# sourceMappingURL=init-helpers.js.map

package/dist/commands/init-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-helpers.js","sourceRoot":"","sources":["../../src/commands/init-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAMnC;IACC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,aAAa;SACxB;QACD,MAAM,EAAE;YACN,IAAI,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;YAChC,QAAQ,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE;YAC9E,OAAO,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;YACxE,QAAQ,EAAE,EAAE,gBAAgB,EAAE,IAAI,EAAE;YACpC,MAAM,EAAE,EAAE;SACX;QACD,OAAO,EAAE;YACP,GAAG,EAAE,UAAU;YACf,MAAM,EAAE,qBAAqB;YAC7B,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,YAAuB,EAAE;YAClD,QAAQ,EAAE;gBACR,SAAS,EAAE,IAAI;gBACf,aAAa,EAAE,IAAI;gBACnB,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,KAAK;aACjB;YACD,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,qBAAqB,EAAE;SACjE;QACD,MAAM,EAAE;YACN,UAAU,EAAE,aAAa;YACzB,QAAQ,EAAE,IAAI;SACf;QACD,KAAK,EAAE;YACL,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE;YAClC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,oBAAoB,EAAE;SAC5D;KACF,CAAA;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,9 @@
+interface InitOptions {
+    name?: string;
+    provider?: string;
+    docs?: string;
+    tasks?: string;
+}
+export declare function runInit(cwd: string, flags: InitOptions): Promise<void>;
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAUA,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAoL5E"}