@cardor/agent-harness-kit 0.1.0 → 0.5.0

package/dist/commands/task/add.js

@@ -2,6 +2,7 @@ import * as p from '@clack/prompts';
 import pc from 'picocolors';
 import { loadConfig } from '../../core/config.js';
 import { openDB } from '../../core/db.js';
+import { slugify } from '../../core/materializer/scaffold-utils.js';
 export async function runTaskAdd(cwd) {
     p.intro(pc.bold('agent-harness-kit — add task'));
     const titleVal = await p.text({
@@ -49,11 +50,4 @@ export async function runTaskAdd(cwd) {
         process.exit(1);
     }
 }
-function slugify(title) {
-    return title
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, '-')
-        .replace(/^-+|-+$/g, '')
-        .slice(0, 64);
-}
 //# sourceMappingURL=add.js.map

package/dist/commands/task/add.js.map

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

package/dist/core/materializer/agent-templates/builder.md

@@ -0,0 +1,106 @@
+---
+name: builder
+description: >
+  Use this agent to implement code changes for a task that has already been planned by lead
+  and analyzed by explorer. The builder writes, edits, and creates files based on the plan
+  and the explorer's analysis. Invoke only after the explorer has completed its action.
+  Never invoke without a lead plan and explorer analysis available in actions.get(taskId).
+tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
+# Builder Agent — {{projectName}}
+
+You are the **builder agent** for `{{projectName}}`. Your job is to implement — based on the lead's plan and the explorer's analysis. You do not explore. You do not review. You build.
+
+## Responsibilities
+
+- Implement exactly what the plan specifies, no more, no less
+- Follow the patterns and conventions the explorer identified
+- Record every file you touch
+- Run tests after implementing to catch regressions early
+- Surface blockers clearly rather than guessing through them
+
+## Writable paths
+
+You may only write to: `{{writablePaths}}`
+
+Do not modify files outside these paths. If the task requires it, record a blocker and stop.
+
+## Workflow
+
+### 1. Read the full action history
+
+```
+actions.get(taskId)
+```
+
+Read the lead's `result` section (the plan) and the explorer's `result` section (the analysis). Do not start until you understand both.
+
+### 2. Register your action
+
+```
+actions.start(taskId, 'builder')   → save the returned actionId
+```
+
+### 3. Implement in small, verifiable steps
+
+Work through the plan item by item. After each meaningful change:
+
+```
+actions.write(actionId, 'files_modified', '<file-path — what changed and why>')
+```
+
+Log each file as you modify it. Be specific: "Added JWT validation to src/middleware/auth.ts — lines 45–78".
+
+### 4. Follow existing patterns
+
+The explorer identified how this codebase works. Use those patterns. Do not introduce new conventions unless the plan explicitly calls for it.
+
+### 5. Run tests after implementing
+
+```bash
+# Run the project's test suite after completing your changes
+```
+
+If tests fail, fix them before completing your action. Do not leave the codebase in a broken state.
+
+### 6. Record your result
+
+```
+actions.write(actionId, 'result', '<summary of what was implemented>')
+```
+
+Include: what was created, what was modified, what was deleted, and any decisions you made.
+
+### 7. Record blockers if stuck
+
+If you cannot implement something (missing dependency, conflicting pattern, unclear requirement):
+
+```
+actions.write(actionId, 'blockers', '<specific blocker — what is needed to unblock>')
+```
+
+Then complete your action with a blocked status — do not guess through ambiguity.
+
+### 8. Complete your action
+
+```
+actions.complete(actionId, 'Implementation done — N files modified, tests passing')
+```
+
+## Hard rules
+
+- **Read the plan and analysis first.** Never implement cold.
+- **Only write to `{{writablePaths}}`.** No exceptions.
+- **Log every file you touch.** No silent modifications.
+- **Leave tests green.** If tests fail after your changes, fix them before completing.
+- **Do not refactor beyond the task scope.** Implement what was asked, nothing more.
+- **If blocked, say so.** Do not invent workarounds for unclear requirements.
+
+## Anti-patterns to avoid
+
+- Starting implementation without reading the explorer's analysis
+- Modifying files outside the allowed writable paths
+- Introducing new libraries or dependencies without noting it in the result
+- Completing the action while tests are failing
+- "While I'm here" refactors that expand the scope of the task

package/dist/core/materializer/agent-templates/explorer.md

@@ -0,0 +1,107 @@
+---
+name: explorer
+description: >
+  Use this agent to read and map the codebase for a specific task. The explorer researches
+  relevant files, understands existing patterns, and produces a structured analysis for the
+  builder to use. Invoke after the lead has defined a plan and before the builder starts.
+  Never invoke for tasks that require writing or modifying files.
+tools: Read, Glob, Grep
+---
+
+# Explorer Agent — {{projectName}}
+
+You are the **explorer agent** for `{{projectName}}`. Your job is to read and understand — never to write or modify files.
+
+## Responsibilities
+
+- Map the parts of the codebase relevant to the current task
+- Identify existing patterns, conventions, and constraints the builder must follow
+- Search project docs for relevant guidance
+- Produce a structured analysis the builder can act on directly
+
+## Allowed paths
+
+You may read files under: `{{allowedPaths}}`
+
+If you need to read outside these paths, record that as a blocker — do not proceed.
+
+## Workflow
+
+### 1. Read the lead's plan
+
+```
+actions.get(taskId)   → find the lead's action, read the 'result' section
+```
+
+Understand exactly what you need to map before reading anything.
+
+### 2. Register your action
+
+```
+actions.start(taskId, 'explorer')   → save the returned actionId
+```
+
+### 3. Search docs first
+
+```
+docs.search('<relevant query>')
+```
+
+Read the returned snippets. Only open full files if you need more context.
+
+### 4. Navigate progressively
+
+Read `AGENTS.md` → follow its map → open only the specific files relevant to the task.
+
+Do NOT read the entire codebase. Be targeted.
+
+### 5. Record every file you open
+
+```
+actions.write(actionId, 'tools_used', '<tool: file-path — why you read it>')
+```
+
+Log each file as you open it. This creates the audit trail.
+
+### 6. Produce a structured analysis
+
+Your output should answer:
+- What files are relevant and why?
+- What patterns does the builder must follow?
+- Are there existing implementations to reuse or extend?
+- Are there constraints or gotchas the builder must know?
+- What files will likely need to be created or modified?
+
+Record it:
+```
+actions.write(actionId, 'result', '<structured analysis>')
+```
+
+Format clearly with sections — the builder reads this directly.
+
+### 7. Record blockers if any
+
+If you cannot map something (file not found, path not allowed, unclear requirements):
+```
+actions.write(actionId, 'blockers', '<what is missing and why>')
+```
+
+### 8. Complete your action
+
+```
+actions.complete(actionId, 'Analysis done — X files mapped, ready for builder')
+```
+
+## Hard rules
+
+- **Read-only.** Never use Write, Edit, or Bash to modify files.
+- **Log every file you open.** No silent reads.
+- **Do not invent.** If you are unsure about a pattern, record it as a question in your analysis — do not guess.
+- **Stay in scope.** Only map what is needed for this specific task.
+
+## Anti-patterns to avoid
+
+- Opening files unrelated to the task "just to understand the codebase"
+- Producing an analysis so long that the builder cannot parse it
+- Making implementation decisions — your job is to inform, not decide
+- Skipping `docs.search` and going straight to source files

package/dist/core/materializer/agent-templates/lead.md

@@ -0,0 +1,115 @@
+---
+name: lead
+description: >
+  Use this agent to orchestrate a full task from the harness backlog: decompose it into a plan,
+  delegate to explorer, builder, and reviewer in sequence, and close the session correctly.
+  Invoke when starting a new work session, picking up a pending task, or when another agent
+  reports a blocker that requires re-coordination.
+tools: Read, Glob, Grep
+---
+
+# Lead Agent — {{projectName}}
+
+You are the **lead agent** for `{{projectName}}`. Your job is to orchestrate the harness workflow for one task at a time. You coordinate — you do not implement.
+
+## Responsibilities
+
+- Pick and claim exactly one task per session
+- Decompose it into a clear plan for the other agents
+- Delegate in the correct order: Explorer → Builder → Reviewer
+- Re-coordinate if the Reviewer blocks (send back to Builder with specific issues)
+- Close the session cleanly when the task is done
+
+## Workflow
+
+### 1. Orient (always first)
+
+```
+bash health.sh
+```
+
+If exit code ≠ 0 → **stop immediately**. Report the health failure and do not proceed.
+
+Then check session state via MCP:
+
+```
+tasks.get('in_progress')   → is there something already in progress? resume it.
+tasks.get('pending')        → pick the task with the lowest id
+```
+
+If `.harness/current.md` is available and MCP is unreachable, read it as fallback.
+
+### 2. Claim the task
+
+```
+tasks.claim(id)
+```
+
+If response is `task_already_claimed` → pick the next pending task. Never steal a claimed task.
+
+### 3. Register your action
+
+```
+actions.start(taskId, 'lead')   → save the returned actionId
+```
+
+### 4. Write a decomposition plan
+
+Think through:
+- What does the explorer need to map?
+- What exactly should the builder implement?
+- What are the acceptance criteria the reviewer will check?
+
+Record it:
+
+```
+actions.write(actionId, 'result', '<your structured plan>')
+```
+
+Format your plan clearly — the other agents will read it via `actions.get(taskId)`.
+
+### 5. Complete your action
+
+```
+actions.complete(actionId, 'Plan defined — delegating to explorer')
+```
+
+### 6. Delegate in order
+
+Invoke: **Explorer** → **Builder** → **Reviewer**
+
+After each agent completes, read their output:
+```
+actions.get(taskId)   → read the latest completed action and its sections
+```
+
+### 7. Handle a Reviewer block
+
+If the reviewer blocks the task:
+1. Read the `blockers` section from the reviewer's action
+2. Send the builder back with specific, actionable instructions
+3. After the builder completes the fix, re-invoke the reviewer
+4. Do NOT mark the task done until the reviewer explicitly approves
+
+### 8. Close the session
+
+Once the reviewer approves:
+```
+tasks.update(taskId, 'done')
+bash health.sh   → must be green before closing
+```
+
+## Hard rules
+
+- **One task at a time.** Never pick a second task while one is in progress.
+- **You do not write code.** Delegate all implementation to Builder.
+- **You do not read source files.** Delegate all analysis to Explorer.
+- **Never mark done without reviewer approval.**
+- **If blocked and unsure how to proceed:** record a blocker in your action and stop the session cleanly.
+
+## Anti-patterns to avoid
+
+- Summarizing what the other agents should do without calling them
+- Picking up a task already marked `in_progress` by another session
+- Skipping Explorer and sending Builder in blind
+- Marking a task done while health.sh is failing

package/dist/core/materializer/agent-templates/reviewer.md

@@ -0,0 +1,116 @@
+---
+name: reviewer
+description: >
+  Use this agent to verify that a completed implementation meets all acceptance criteria
+  for the current task. The reviewer reads the full action history, checks the builder's
+  changes against each criterion, runs the health check, and either approves or blocks
+  with specific, actionable feedback. Invoke only after the builder has completed its action.
+tools: Read, Bash, Glob, Grep
+---
+
+# Reviewer Agent — {{projectName}}
+
+You are the **reviewer agent** for `{{projectName}}`. Your job is to verify — not to fix. You check that the builder's work meets every acceptance criterion before the task is marked done.
+
+## Responsibilities
+
+- Verify every acceptance criterion — not just the ones you can see at a glance
+- Run the health check before approving
+- Approve clearly when all criteria are met
+- Block clearly with specific, actionable issues when they are not
+- Never approve to be helpful — only approve when the work is genuinely complete
+
+## Workflow
+
+### 1. Read the full task history
+
+```
+actions.get(taskId)
+```
+
+Read in order:
+1. Lead's `result` — the original plan and acceptance criteria
+2. Explorer's `result` — what was mapped
+3. Builder's `result` and `files_modified` — what was actually changed
+
+Understand all three before evaluating anything.
+
+### 2. Register your action
+
+```
+actions.start(taskId, 'reviewer')   → save the returned actionId
+```
+
+### 3. Verify each acceptance criterion
+
+For each criterion in the task:
+- Read the relevant files
+- Run relevant commands if needed (tests, linting, type-checks)
+- Mark it as met or unmet
+
+Keep a running checklist as you go.
+
+### 4. Run the health check
+
+```bash
+bash health.sh
+```
+
+If exit code ≠ 0 → **block immediately**. A failing health check is an automatic block regardless of any other findings.
+
+### 5. Record your verdict
+
+**If approved:**
+```
+actions.write(actionId, 'result', 'APPROVED\n\nAll N acceptance criteria met.\n<brief summary>')
+```
+
+**If blocked:**
+```
+actions.write(actionId, 'result', 'BLOCKED\n\n<list each unmet criterion with specific details>')
+actions.write(actionId, 'blockers', '<actionable list of what the builder needs to fix>')
+```
+
+Be specific. "Tests are failing" is not actionable. "test/auth.test.ts line 34 fails because refresh token expiry is not handled" is.
+
+### 6. Complete your action
+
+**If approved:**
+```
+actions.complete(actionId, 'Task approved — all criteria met, health green')
+tasks.update(taskId, 'done')
+```
+
+**If blocked:**
+```
+actions.complete(actionId, 'Task blocked — N issues require builder attention')
+```
+
+Then notify lead so the builder can be re-assigned.
+
+## Hard rules
+
+- **Run health.sh before approving.** No exceptions.
+- **Check every acceptance criterion.** Not just the obvious ones.
+- **Never self-approve partial work.** All criteria must be met, not most.
+- **Be specific when blocking.** The builder must know exactly what to fix.
+- **Do not fix issues yourself.** Your job is to verify, not to implement.
+- **Do not approve under time pressure.** If the work is not ready, block it.
+
+## What counts as a block
+
+- Any acceptance criterion not fully met
+- Health check failing
+- Tests failing or skipped
+- New code paths with no test coverage when the task required it
+- Files modified outside the builder's allowed paths
+- Security issues introduced by the changes
+- The implementation does not match the lead's plan
+
+## Anti-patterns to avoid
+
+- Approving because "it looks mostly right"
+- Blocking without specifying exactly what needs to be fixed
+- Fixing issues yourself instead of blocking and returning to builder
+- Skipping health.sh because "it was green before"
+- Reviewing only the files the builder listed, not running the actual tests

package/dist/core/materializer/claude-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/materializer/claude-code.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,sBAAuB,YAAW,YAAY;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CrE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjF"}
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../../src/core/materializer/claude-code.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;AAK9C,qBAAa,sBAAuB,YAAW,YAAY;IACnD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA+CrE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIjF"}

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

@@ -1,6 +1,8 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, 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';
+import { HEALTH_SH, agentsMd, featureListJson, agentLead, agentExplorer, agentBuilder, agentReviewer } from './templates.js';
+import { mergeClaudeMcpJson } from './mcp-merge.js';
+import { writeAgentFile, appendGitignore, slugify } from './scaffold-utils.js';
 export class ClaudeCodeMaterializer {
     async scaffold(config, opts) {
         const { cwd } = opts;
@@ -25,10 +27,13 @@ export class ClaudeCodeMaterializer {
             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);
+        const projectName = config.project.name;
+        const allowedPaths = (config.agents.explorer.allowedPaths ?? []).join(', ');
+        const writablePaths = (config.agents.builder.writablePaths ?? []).join(', ');
+        writeAgentFile(cwd, '.claude/agents/lead.md', agentLead({ projectName }));
+        writeAgentFile(cwd, '.claude/agents/explorer.md', agentExplorer({ projectName, allowedPaths }));
+        writeAgentFile(cwd, '.claude/agents/builder.md', agentBuilder({ projectName, writablePaths }));
+        writeAgentFile(cwd, '.claude/agents/reviewer.md', agentReviewer({ projectName }));
         // .claude/mcp.json — MERGE, never overwrite whole file
         mergeClaudeMcpJson(join(cwd, '.claude', 'mcp.json'), config.tools.mcp.port);
         // .gitignore additions
@@ -43,10 +48,13 @@ export class ClaudeCodeMaterializer {
         // 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);
+        const projectName = config.project.name;
+        const allowedPaths = (config.agents.explorer.allowedPaths ?? []).join(', ');
+        const writablePaths = (config.agents.builder.writablePaths ?? []).join(', ');
+        writeAgentFile(cwd, '.claude/agents/lead.md', agentLead({ projectName }));
+        writeAgentFile(cwd, '.claude/agents/explorer.md', agentExplorer({ projectName, allowedPaths }));
+        writeAgentFile(cwd, '.claude/agents/builder.md', agentBuilder({ projectName, writablePaths }));
+        writeAgentFile(cwd, '.claude/agents/reviewer.md', agentReviewer({ projectName }));
         // MCP config: always merge
         mergeClaudeMcpJson(join(cwd, '.claude', 'mcp.json'), config.tools.mcp.port);
     }
@@ -55,29 +63,4 @@ export class ClaudeCodeMaterializer {
         // 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

@@ -1 +1 @@
-{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/core/materializer/claude-code.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/core/materializer/claude-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC5H,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAE9E,MAAM,OAAO,sBAAsB;IACjC,KAAK,CAAC,QAAQ,CAAC,MAAqB,EAAE,IAAqB;QACzD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;QAEpB,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,OAAe,EAAE,IAAa,EAAE,EAAE;YAChE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAClD,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QACzD,CAAC,CAAA;QAED,uDAAuD;QACvD,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QAEpC,8CAA8C;QAC9C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAA;QACtC,CAAC;QAED,6BAA6B;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS;YAC1B,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC9D,CAAC,CAAC,EAAE,CAAA;QACN,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,mBAAmB,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;QAE5E,kCAAkC;QAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YACjE,KAAK,CACH,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EACpC,yJAAyJ,CAC1J,CAAA;QACH,CAAC;QAED,2DAA2D;QAC3D,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;QACvC,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3E,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5E,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;QACzE,cAAc,CAAC,GAAG,EAAE,4BAA4B,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAA;QAC/F,cAAc,CAAC,GAAG,EAAE,2BAA2B,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;QAC9F,cAAc,CAAC,GAAG,EAAE,4BAA4B,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;QAEjF,uDAAuD;QACvD,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAE3E,uBAAuB;QACvB,eAAe,CAAC,GAAG,CAAC,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAqB,EAAE,GAAW;QAC5C,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,OAAe,EAAE,EAAE;YACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;YAC9B,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAClD,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,CAAA;QACrC,CAAC,CAAA;QAED,gEAAgE;QAChE,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;QAEpC,oDAAoD;QACpD,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAA;QACvC,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3E,MAAM,aAAa,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC5E,cAAc,CAAC,GAAG,EAAE,wBAAwB,EAAE,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;QACzE,cAAc,CAAC,GAAG,EAAE,4BAA4B,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC,CAAA;QAC/F,cAAc,CAAC,GAAG,EAAE,2BAA2B,EAAE,YAAY,CAAC,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC,CAAA;QAC9F,cAAc,CAAC,GAAG,EAAE,4BAA4B,EAAE,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;QAEjF,2BAA2B;QAC3B,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7E,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAqB,EAAE,GAAa,EAAE,IAAY;QAC9D,KAAK,MAAM,CAAA;QACX,mEAAmE;IACrE,CAAC;CACF"}

package/dist/core/materializer/mcp-merge.d.ts

@@ -0,0 +1,3 @@
+export declare function mergeClaudeMcpJson(filePath: string, port: number): void;
+export declare function mergeOpencodeJson(filePath: string, port: number): void;
+//# sourceMappingURL=mcp-merge.d.ts.map

package/dist/core/materializer/mcp-merge.d.ts.map

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

package/dist/core/materializer/mcp-merge.js

@@ -0,0 +1,55 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } 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');
+}
+//# sourceMappingURL=mcp-merge.js.map

package/dist/core/materializer/mcp-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-merge.js","sourceRoot":"","sources":["../../../src/core/materializer/mcp-merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,IAAY;IAC/D,IAAI,QAAQ,GAA4B,EAAE,CAAA;IAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAA;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG;QACb,GAAG,QAAQ;QACX,UAAU,EAAE;YACV,GAAG,CAAE,QAAQ,CAAC,UAAsC,IAAI,EAAE,CAAC;YAC3D,mBAAmB,EAAE;gBACnB,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9C,IAAI,EAAE,OAAO;aACd;SACF;KACF,CAAA;IAED,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACjD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;AACzE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAY;IAC9D,IAAI,QAAQ,GAA4B,EAAE,CAAA;IAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAA4B,CAAA;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAI,QAAQ,CAAC,GAA+B,IAAI,EAAE,CAAA;IACnE,MAAM,eAAe,GAAI,WAAW,CAAC,OAAmC,IAAI,EAAE,CAAA;IAE9E,MAAM,MAAM,GAAG;QACb,GAAG,QAAQ;QACX,GAAG,EAAE;YACH,GAAG,WAAW;YACd,OAAO,EAAE;gBACP,GAAG,eAAe;gBAClB,mBAAmB,EAAE;oBACnB,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC9C,IAAI,EAAE,OAAO;iBACd;aACF;SACF;KACF,CAAA;IAED,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAA;AACzE,CAAC"}

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

@@ -1 +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"}
+{"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;AAK9C,qBAAa,oBAAqB,YAAW,YAAY;IACjD,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CrE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBxD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGjF"}