@cardor/agent-harness-kit 0.1.0

package/dist/core/materializer/claude-code.js

@@ -0,0 +1,83 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { HEALTH_SH, GITIGNORE_ENTRIES, agentsMd, mergeClaudeMcpJson, featureListJson, AGENT_LEAD, AGENT_EXPLORER, AGENT_BUILDER, AGENT_REVIEWER, } from './templates.js';
+export class ClaudeCodeMaterializer {
+    async scaffold(config, opts) {
+        const { cwd } = opts;
+        const write = (relPath, content, mode) => {
+            const abs = join(cwd, relPath);
+            mkdirSync(resolve(abs, '..'), { recursive: true });
+            writeFileSync(abs, content, { encoding: 'utf8', mode });
+        };
+        // AGENTS.md — always overwrite (generated from config)
+        write('AGENTS.md', agentsMd(config));
+        // health.sh — only create if it doesn't exist
+        if (!existsSync(join(cwd, 'health.sh'))) {
+            write('health.sh', HEALTH_SH, 0o755);
+        }
+        // .harness/feature_list.json
+        const tasks = opts.firstTask
+            ? [{ slug: slugify(opts.firstTask.title), ...opts.firstTask }]
+            : [];
+        write(join(config.storage.dir, 'feature_list.json'), featureListJson(tasks));
+        // .harness/current.md placeholder
+        if (!existsSync(join(cwd, config.storage.markdownFallback.path))) {
+            write(config.storage.markdownFallback.path, `<!-- AUTO-GENERATED by agent-harness-kit — DO NOT EDIT MANUALLY -->\n<!-- Run ahk status to refresh -->\n\n# Current Session\n\nNo tasks in progress.\n`);
+        }
+        // .claude/agents/ — skip files the dev may have customized
+        writeAgentFile(cwd, '.claude/agents/lead.md', AGENT_LEAD);
+        writeAgentFile(cwd, '.claude/agents/explorer.md', AGENT_EXPLORER);
+        writeAgentFile(cwd, '.claude/agents/builder.md', AGENT_BUILDER);
+        writeAgentFile(cwd, '.claude/agents/reviewer.md', AGENT_REVIEWER);
+        // .claude/mcp.json — MERGE, never overwrite whole file
+        mergeClaudeMcpJson(join(cwd, '.claude', 'mcp.json'), config.tools.mcp.port);
+        // .gitignore additions
+        appendGitignore(cwd);
+    }
+    async build(config, cwd) {
+        const write = (relPath, content) => {
+            const abs = join(cwd, relPath);
+            mkdirSync(resolve(abs, '..'), { recursive: true });
+            writeFileSync(abs, content, 'utf8');
+        };
+        // build always regenerates AGENTS.md (it's derived from config)
+        write('AGENTS.md', agentsMd(config));
+        // Agent files: skip if customized, write if missing
+        writeAgentFile(cwd, '.claude/agents/lead.md', AGENT_LEAD);
+        writeAgentFile(cwd, '.claude/agents/explorer.md', AGENT_EXPLORER);
+        writeAgentFile(cwd, '.claude/agents/builder.md', AGENT_BUILDER);
+        writeAgentFile(cwd, '.claude/agents/reviewer.md', AGENT_REVIEWER);
+        // MCP config: always merge
+        mergeClaudeMcpJson(join(cwd, '.claude', 'mcp.json'), config.tools.mcp.port);
+    }
+    async migrate(config, _to, _cwd) {
+        void config;
+        // Migration from claude-code is handled by the target materializer
+    }
+}
+// ─── Shared helpers ───────────────────────────────────────────────────────────
+function writeAgentFile(cwd, relPath, content) {
+    const abs = join(cwd, relPath);
+    if (existsSync(abs))
+        return; // preserve dev customizations
+    mkdirSync(resolve(abs, '..'), { recursive: true });
+    writeFileSync(abs, content, 'utf8');
+}
+function appendGitignore(cwd) {
+    const giPath = join(cwd, '.gitignore');
+    const existing = existsSync(giPath) ? readFileSync(giPath, 'utf8') : '';
+    const toAdd = GITIGNORE_ENTRIES.split('\n')
+        .filter((line) => line && !existing.includes(line))
+        .join('\n');
+    if (toAdd.trim()) {
+        writeFileSync(giPath, existing + (existing.endsWith('\n') ? '' : '\n') + toAdd + '\n', 'utf8');
+    }
+}
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64);
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/core/materializer/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/core/materializer/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/core/materializer/index.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessConfig, Provider, ScaffoldOptions } from '../../types.js';
+export interface Materializer {
+    scaffold(config: HarnessConfig, opts: ScaffoldOptions): Promise<void>;
+    build(config: HarnessConfig, cwd: string): Promise<void>;
+    migrate(config: HarnessConfig, to: Provider, cwd: string): Promise<void>;
+}
+export declare function getMaterializer(provider: Provider): Materializer;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/materializer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/materializer/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAI9E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACzE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAShE"}

package/dist/core/materializer/index.js

@@ -0,0 +1,13 @@
+import { ClaudeCodeMaterializer } from './claude-code.js';
+import { OpenCodeMaterializer } from './opencode.js';
+export function getMaterializer(provider) {
+    switch (provider) {
+        case 'claude-code':
+            return new ClaudeCodeMaterializer();
+        case 'opencode':
+            return new OpenCodeMaterializer();
+        default:
+            throw new Error(`Unknown provider: ${provider}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/core/materializer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/materializer/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAQpD,MAAM,UAAU,eAAe,CAAC,QAAkB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,IAAI,sBAAsB,EAAE,CAAA;QACrC,KAAK,UAAU;YACb,OAAO,IAAI,oBAAoB,EAAE,CAAA;QACnC;YACE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAkB,EAAE,CAAC,CAAA;IAC9D,CAAC;AACH,CAAC"}

package/dist/core/materializer/opencode.d.ts

@@ -0,0 +1,8 @@
+import type { HarnessConfig, Provider, ScaffoldOptions } from '../../types.js';
+import type { Materializer } from './index.js';
+export declare class OpenCodeMaterializer implements Materializer {
+    scaffold(config: HarnessConfig, opts: ScaffoldOptions): Promise<void>;
+    build(config: HarnessConfig, cwd: string): Promise<void>;
+    migrate(config: HarnessConfig, _to: Provider, _cwd: string): Promise<void>;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/core/materializer/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/core/materializer/opencode.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC9E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAa9C,qBAAa,oBAAqB,YAAW,YAAY;IACjD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCrE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjF"}

package/dist/core/materializer/opencode.js

@@ -0,0 +1,76 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { HEALTH_SH, GITIGNORE_ENTRIES, agentsMd, mergeOpencodeJson, featureListJson, AGENT_LEAD, AGENT_EXPLORER, AGENT_BUILDER, AGENT_REVIEWER, } from './templates.js';
+export class OpenCodeMaterializer {
+    async scaffold(config, opts) {
+        const { cwd } = opts;
+        const write = (relPath, content, mode) => {
+            const abs = join(cwd, relPath);
+            mkdirSync(resolve(abs, '..'), { recursive: true });
+            writeFileSync(abs, content, { encoding: 'utf8', mode });
+        };
+        // AGENTS.md — always overwrite (generated from config)
+        write('AGENTS.md', agentsMd(config));
+        // health.sh — only create if it doesn't exist
+        if (!existsSync(join(cwd, 'health.sh'))) {
+            write('health.sh', HEALTH_SH, 0o755);
+        }
+        const tasks = opts.firstTask
+            ? [{ slug: slugify(opts.firstTask.title), ...opts.firstTask }]
+            : [];
+        write(join(config.storage.dir, 'feature_list.json'), featureListJson(tasks));
+        if (!existsSync(join(cwd, config.storage.markdownFallback.path))) {
+            write(config.storage.markdownFallback.path, `<!-- AUTO-GENERATED by agent-harness-kit — DO NOT EDIT MANUALLY -->\n<!-- Run ahk status to refresh -->\n\n# Current Session\n\nNo tasks in progress.\n`);
+        }
+        // .opencode/agents/ — skip files the dev may have customized
+        writeAgentFile(cwd, '.opencode/agents/lead.md', AGENT_LEAD);
+        writeAgentFile(cwd, '.opencode/agents/explorer.md', AGENT_EXPLORER);
+        writeAgentFile(cwd, '.opencode/agents/builder.md', AGENT_BUILDER);
+        writeAgentFile(cwd, '.opencode/agents/reviewer.md', AGENT_REVIEWER);
+        // opencode.json — MERGE, never overwrite whole file
+        mergeOpencodeJson(join(cwd, 'opencode.json'), config.tools.mcp.port);
+        appendGitignore(cwd);
+    }
+    async build(config, cwd) {
+        const write = (relPath, content) => {
+            const abs = join(cwd, relPath);
+            mkdirSync(resolve(abs, '..'), { recursive: true });
+            writeFileSync(abs, content, 'utf8');
+        };
+        write('AGENTS.md', agentsMd(config));
+        writeAgentFile(cwd, '.opencode/agents/lead.md', AGENT_LEAD);
+        writeAgentFile(cwd, '.opencode/agents/explorer.md', AGENT_EXPLORER);
+        writeAgentFile(cwd, '.opencode/agents/builder.md', AGENT_BUILDER);
+        writeAgentFile(cwd, '.opencode/agents/reviewer.md', AGENT_REVIEWER);
+        mergeOpencodeJson(join(cwd, 'opencode.json'), config.tools.mcp.port);
+    }
+    async migrate(config, _to, _cwd) {
+        void config;
+    }
+}
+// ─── Shared helpers ───────────────────────────────────────────────────────────
+function writeAgentFile(cwd, relPath, content) {
+    const abs = join(cwd, relPath);
+    if (existsSync(abs))
+        return; // preserve dev customizations
+    mkdirSync(resolve(abs, '..'), { recursive: true });
+    writeFileSync(abs, content, 'utf8');
+}
+function appendGitignore(cwd) {
+    const giPath = join(cwd, '.gitignore');
+    const existing = existsSync(giPath) ? readFileSync(giPath, 'utf8') : '';
+    const toAdd = GITIGNORE_ENTRIES.split('\n')
+        .filter((line) => line && !existing.includes(line))
+        .join('\n');
+    if (toAdd.trim()) {
+        writeFileSync(giPath, existing + (existing.endsWith('\n') ? '' : '\n') + toAdd + '\n', 'utf8');
+    }
+}
+function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 64);
+}
+//# sourceMappingURL=opencode.js.map

package/dist/core/materializer/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../../src/core/materializer/opencode.ts"],"names":[],"mappings":"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"}

package/dist/core/materializer/templates.d.ts

@@ -0,0 +1,25 @@
+import type { HarnessConfig } from '../../types.js';
+export declare const HEALTH_SH = "#!/usr/bin/env bash\n# health.sh \u2014 project health check for agent-harness-kit\n#\n# This script must exit 0 when the project is healthy.\n# Agents will run this before starting work.\n#\n# TODO: implement your project's health checks below.\n# Examples:\n#   npm test\n#   docker compose ps | grep -q \"running\"\n#   psql -c \"SELECT 1\" > /dev/null 2>&1\n#\n# Until you implement it, this script intentionally exits 1\n# so agents know the environment is not verified.\n\necho \"health.sh not implemented yet.\"\necho \"Edit this file with your project's health checks.\"\necho \"It must exit 0 for agents to start working.\"\nexit 1\n";
+export declare function agentsMd(config: HarnessConfig): string;
+export declare function configTs(params: {
+    name: string;
+    description: string;
+    provider: string;
+    docsPath: string;
+    tasksAdapter: string;
+    port: number;
+}): string;
+export declare const AGENT_LEAD = "---\ndescription: Lead agent \u2014 orchestrates the harness workflow for a single task\n---\n\n# Lead Agent\n\nYou are the **lead agent** in the agent-harness-kit harness. Your job is to decompose a task into a plan and coordinate the other agents.\n\n## Your workflow\n\n1. Read `.harness/current.md` (or call `tasks.get('in_progress')`) to orient yourself.\n2. Call `actions.start(taskId, 'lead')` to register your action.\n3. Decompose the task:\n   - What needs to be explored first?\n   - What needs to be built?\n   - What are the acceptance criteria?\n4. Call `actions.write(actionId, 'result', plan)` with your decomposition.\n5. Call `actions.complete(actionId, 'Plan defined')`.\n6. Delegate to explorer, then builder, then reviewer \u2014 in that order.\n\n## Rules\n\n- Do NOT write code yourself. Delegate to builder.\n- Do NOT read source files yourself. Delegate to explorer.\n- One task at a time. Check `tasks.get('in_progress')` before picking a new one.\n- If the reviewer blocks, coordinate a fix with builder and re-review.\n";
+export declare const AGENT_EXPLORER = "---\ndescription: Explorer agent \u2014 reads and maps the codebase, never writes files\n---\n\n# Explorer Agent\n\nYou are the **explorer agent** in the agent-harness-kit harness. Your job is to read and understand the relevant parts of the codebase for the current task. You never write or modify files.\n\n## Your workflow\n\n1. Call `actions.start(taskId, 'explorer')` to register your action.\n2. Read only the files relevant to the current task. Use `docs.search(query)` first.\n3. Record what you find:\n   - `actions.write(actionId, 'tools_used', list_of_tools)`\n   - `actions.write(actionId, 'result', analysis)`\n4. Call `actions.complete(actionId, 'Analysis done')`.\n\n## Rules\n\n- Never modify files. You are read-only.\n- Use progressive disclosure \u2014 read AGENTS.md, then navigate to specific files.\n- Record every file you read via `actions.write(actionId, 'tools_used', ...)`.\n";
+export declare const AGENT_BUILDER = "---\ndescription: Builder agent \u2014 implements the plan produced by explorer and lead\n---\n\n# Builder Agent\n\nYou are the **builder agent** in the agent-harness-kit harness. Your job is to implement the plan from lead, using the analysis from explorer.\n\n## Your workflow\n\n1. Read the lead's plan from `actions.get(taskId)`.\n2. Call `actions.start(taskId, 'builder')` to register your action.\n3. Implement the task. Record every file you touch:\n   - `actions.write(actionId, 'files_modified', list)`\n4. Record the result:\n   - `actions.write(actionId, 'result', summary_of_changes)`\n5. If you hit a blocker: `actions.write(actionId, 'blockers', description)`\n6. Call `actions.complete(actionId, 'Implementation done')`.\n\n## Rules\n\n- Only write to the paths allowed by your config (writablePaths).\n- If something is unclear, record a blocker and surface it to lead \u2014 don't guess.\n- Run tests after implementing if the project has a test suite.\n";
+export declare const AGENT_REVIEWER = "---\ndescription: Reviewer agent \u2014 verifies acceptance criteria before marking a task done\n---\n\n# Reviewer Agent\n\nYou are the **reviewer agent** in the agent-harness-kit harness. Your job is to verify that the builder's work meets all acceptance criteria before the task is marked done.\n\n## Your workflow\n\n1. Call `actions.get(taskId)` to read the full history (lead plan + explorer analysis + builder changes).\n2. Call `actions.start(taskId, 'reviewer')` to register your action.\n3. Verify each acceptance criterion:\n   - `actions.write(actionId, 'result', 'APPROVED' or 'BLOCKED: reason')`\n4. If approved:\n   - `actions.complete(actionId, 'Task approved')`\n   - `tasks.update(taskId, 'done')`\n5. If blocked:\n   - `actions.write(actionId, 'blockers', what_is_missing)`\n   - `actions.complete(actionId, 'Task blocked: reason')`\n   - Notify lead to re-assign to builder.\n\n## Rules\n\n- Never approve unless ALL acceptance criteria are met.\n- Check that health.sh is green before approving.\n- Be specific about what is missing when blocking.\n";
+export declare function featureListJson(tasks: {
+    slug: string;
+    title: string;
+    description?: string;
+    acceptance?: string[];
+}[]): string;
+export declare function mergeClaudeMcpJson(filePath: string, port: number): void;
+export declare function mergeOpencodeJson(filePath: string, port: number): void;
+export declare const GITIGNORE_ENTRIES = "\n# agent-harness-kit\n.harness/harness.db\n.harness/harness.db-shm\n.harness/harness.db-wal\n";
+//# sourceMappingURL=templates.d.ts.map

package/dist/core/materializer/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/core/materializer/templates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAInD,eAAO,MAAM,SAAS,uoBAmBrB,CAAA;AAID,wBAAgB,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA8EtD;AAID,wBAAgB,QAAQ,CAAC,MAAM,EAAE;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,MAAM,CA6CT;AAID,eAAO,MAAM,UAAU,4hCA0BtB,CAAA;AAED,eAAO,MAAM,cAAc,24BAsB1B,CAAA;AAED,eAAO,MAAM,aAAa,g9BAwBzB,CAAA;AAED,eAAO,MAAM,cAAc,kjCA2B1B,CAAA;AAID,wBAAgB,eAAe,CAC7B,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,GACpF,MAAM,CAER;AAQD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAwBvE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CA6BtE;AAID,eAAO,MAAM,iBAAiB,mGAK7B,CAAA"}

package/dist/core/materializer/templates.js

@@ -0,0 +1,319 @@
+// ─── health.sh — exits 1 until the dev implements it ─────────────────────────
+export const HEALTH_SH = `#!/usr/bin/env bash
+# health.sh — project health check for agent-harness-kit
+#
+# This script must exit 0 when the project is healthy.
+# Agents will run this before starting work.
+#
+# TODO: implement your project's health checks below.
+# Examples:
+#   npm test
+#   docker compose ps | grep -q "running"
+#   psql -c "SELECT 1" > /dev/null 2>&1
+#
+# Until you implement it, this script intentionally exits 1
+# so agents know the environment is not verified.
+
+echo "health.sh not implemented yet."
+echo "Edit this file with your project's health checks."
+echo "It must exit 0 for agents to start working."
+exit 1
+`;
+// ─── AGENTS.md template ───────────────────────────────────────────────────────
+export function agentsMd(config) {
+    const { name, description, docsPath } = config.project;
+    const port = config.tools.mcp.port;
+    return `# AGENTS.md — ${name}
+
+> **Read this file first.** It is the navigation map for every AI agent working in this repository.
+
+## Project
+
+**${name}** — ${description}
+
+## Health check (run before starting)
+
+\`\`\`bash
+bash health.sh
+\`\`\`
+
+If it exits non-zero, stop and report the issue. Do not proceed with tasks until health is green.
+
+## Harness data (source of truth)
+
+| File | Purpose |
+|------|---------|
+| \`.harness/harness.db\` | SQLite: all tasks, actions, file changes, tool calls |
+| \`.harness/current.md\` | Markdown fallback — read this if MCP server is unavailable |
+| \`.harness/feature_list.json\` | Human-editable task seed list |
+
+## MCP tools (preferred)
+
+The harness exposes tools via MCP server on port ${port}. Use these instead of reading files directly.
+
+\`\`\`
+actions.start      taskId agent          → start an action, returns actionId
+actions.write      actionId section text → 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 (pending | in_progress | done | blocked)
+tasks.claim        id                   → atomically claim a pending task
+tasks.update       id status            → change task status
+docs.search        query                → search ${docsPath} for relevant content
+\`\`\`
+
+## Workflow
+
+\`\`\`
+1. INIT
+   - Run health.sh → exit 1 means stop
+   - tasks.get('in_progress') → resume if something is in progress
+   - tasks.get('pending') → pick lowest id
+
+2. WORK  (lead → explorer → builder → reviewer)
+   - Each agent calls actions.start(taskId, agentName) → actionId
+   - Records work with actions.write(actionId, section, content)
+   - Closes with actions.complete(actionId, summary)
+
+3. CLOSE
+   - tasks.update(taskId, 'done')
+   - Run health.sh → must be green before closing
+\`\`\`
+
+## Agent roles
+
+| Agent | Responsibility |
+|-------|---------------|
+| lead | Decomposes the task into a plan, assigns sub-agents |
+| explorer | Reads and maps relevant code, never writes |
+| builder | Implements the plan, writes files |
+| reviewer | Verifies acceptance criteria, approves or blocks |
+
+## What to read
+
+\`\`\`
+Always:         .harness/current.md (or MCP tasks.get)
+If implementing: ${docsPath}/
+If orchestrating: Agent definition files in your provider's agents directory
+\`\`\`
+`;
+}
+// ─── agent-harness-kit.config.ts template ───────────────────────────────────────────
+export function configTs(params) {
+    return `import { defineHarness } from 'agent-harness-kit'
+
+export default 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:   [],
+  },
+
+  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: ${params.port} },
+    scripts: { enabled: true, outputDir: './.harness/scripts' },
+  },
+})
+`;
+}
+// ─── Agent definition templates ───────────────────────────────────────────────
+export const AGENT_LEAD = `---
+description: Lead agent — orchestrates the harness workflow for a single task
+---
+
+# Lead Agent
+
+You are the **lead agent** in the agent-harness-kit harness. Your job is to decompose a task into a plan and coordinate the other agents.
+
+## Your workflow
+
+1. Read \`.harness/current.md\` (or call \`tasks.get('in_progress')\`) to orient yourself.
+2. Call \`actions.start(taskId, 'lead')\` to register your action.
+3. Decompose the task:
+   - What needs to be explored first?
+   - What needs to be built?
+   - What are the acceptance criteria?
+4. Call \`actions.write(actionId, 'result', plan)\` with your decomposition.
+5. Call \`actions.complete(actionId, 'Plan defined')\`.
+6. Delegate to explorer, then builder, then reviewer — in that order.
+
+## Rules
+
+- Do NOT write code yourself. Delegate to builder.
+- Do NOT read source files yourself. Delegate to explorer.
+- One task at a time. Check \`tasks.get('in_progress')\` before picking a new one.
+- If the reviewer blocks, coordinate a fix with builder and re-review.
+`;
+export const AGENT_EXPLORER = `---
+description: Explorer agent — reads and maps the codebase, never writes files
+---
+
+# Explorer Agent
+
+You are the **explorer agent** in the agent-harness-kit harness. Your job is to read and understand the relevant parts of the codebase for the current task. You never write or modify files.
+
+## Your workflow
+
+1. Call \`actions.start(taskId, 'explorer')\` to register your action.
+2. Read only the files relevant to the current task. Use \`docs.search(query)\` first.
+3. Record what you find:
+   - \`actions.write(actionId, 'tools_used', list_of_tools)\`
+   - \`actions.write(actionId, 'result', analysis)\`
+4. Call \`actions.complete(actionId, 'Analysis done')\`.
+
+## Rules
+
+- Never modify files. You are read-only.
+- Use progressive disclosure — read AGENTS.md, then navigate to specific files.
+- Record every file you read via \`actions.write(actionId, 'tools_used', ...)\`.
+`;
+export const AGENT_BUILDER = `---
+description: Builder agent — implements the plan produced by explorer and lead
+---
+
+# Builder Agent
+
+You are the **builder agent** in the agent-harness-kit harness. Your job is to implement the plan from lead, using the analysis from explorer.
+
+## Your workflow
+
+1. Read the lead's plan from \`actions.get(taskId)\`.
+2. Call \`actions.start(taskId, 'builder')\` to register your action.
+3. Implement the task. Record every file you touch:
+   - \`actions.write(actionId, 'files_modified', list)\`
+4. Record the result:
+   - \`actions.write(actionId, 'result', summary_of_changes)\`
+5. If you hit a blocker: \`actions.write(actionId, 'blockers', description)\`
+6. Call \`actions.complete(actionId, 'Implementation done')\`.
+
+## Rules
+
+- Only write to the paths allowed by your config (writablePaths).
+- If something is unclear, record a blocker and surface it to lead — don't guess.
+- Run tests after implementing if the project has a test suite.
+`;
+export const AGENT_REVIEWER = `---
+description: Reviewer agent — verifies acceptance criteria before marking a task done
+---
+
+# Reviewer Agent
+
+You are the **reviewer agent** in the agent-harness-kit harness. Your job is to verify that the builder's work meets all acceptance criteria before the task is marked done.
+
+## Your workflow
+
+1. Call \`actions.get(taskId)\` to read the full history (lead plan + explorer analysis + builder changes).
+2. Call \`actions.start(taskId, 'reviewer')\` to register your action.
+3. Verify each acceptance criterion:
+   - \`actions.write(actionId, 'result', 'APPROVED' or 'BLOCKED: reason')\`
+4. If approved:
+   - \`actions.complete(actionId, 'Task approved')\`
+   - \`tasks.update(taskId, 'done')\`
+5. If blocked:
+   - \`actions.write(actionId, 'blockers', what_is_missing)\`
+   - \`actions.complete(actionId, 'Task blocked: reason')\`
+   - Notify lead to re-assign to builder.
+
+## Rules
+
+- Never approve unless ALL acceptance criteria are met.
+- Check that health.sh is green before approving.
+- Be specific about what is missing when blocking.
+`;
+// ─── feature_list.json initial seed ──────────────────────────────────────────
+export function featureListJson(tasks) {
+    return JSON.stringify(tasks, null, 2) + '\n';
+}
+// ─── MCP JSON merge helpers ───────────────────────────────────────────────────
+// These do a deep merge so existing provider config is preserved.
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export function mergeClaudeMcpJson(filePath, port) {
+    let existing = {};
+    if (existsSync(filePath)) {
+        try {
+            existing = JSON.parse(readFileSync(filePath, 'utf8'));
+        }
+        catch {
+            // Unreadable JSON — start fresh to avoid corrupt state
+        }
+    }
+    const merged = {
+        ...existing,
+        mcpServers: {
+            ...(existing.mcpServers ?? {}),
+            'agent-harness-kit': {
+                command: 'npx',
+                args: ['ahk', 'serve', '--port', String(port)],
+                type: 'stdio',
+            },
+        },
+    };
+    mkdirSync(dirname(filePath), { recursive: true });
+    writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+}
+export function mergeOpencodeJson(filePath, port) {
+    let existing = {};
+    if (existsSync(filePath)) {
+        try {
+            existing = JSON.parse(readFileSync(filePath, 'utf8'));
+        }
+        catch {
+            // start fresh
+        }
+    }
+    const existingMcp = existing.mcp ?? {};
+    const existingServers = existingMcp.servers ?? {};
+    const merged = {
+        ...existing,
+        mcp: {
+            ...existingMcp,
+            servers: {
+                ...existingServers,
+                'agent-harness-kit': {
+                    command: 'npx',
+                    args: ['ahk', 'serve', '--port', String(port)],
+                    type: 'stdio',
+                },
+            },
+        },
+    };
+    writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+}
+// ─── .gitignore additions ─────────────────────────────────────────────────────
+export const GITIGNORE_ENTRIES = `
+# agent-harness-kit
+.harness/harness.db
+.harness/harness.db-shm
+.harness/harness.db-wal
+`;
+//# sourceMappingURL=templates.js.map

package/dist/core/materializer/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/core/materializer/templates.ts"],"names":[],"mappings":"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"}

package/dist/core/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import type { HarnessConfig } from '../types.js';
+export declare function startMcpServer(config: HarnessConfig, cwd: string): Promise<void>;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/core/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/core/mcp-server.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,aAAa,CAAA;AAwH3D,wBAAsB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtF"}