metaharness 0.4.0 → 0.4.2

package/templates/vertical_agentics/package.json.tmpl

@@ -1,30 +1,30 @@
-{
-  "name": "{{name}}",
-  "version": "0.1.0",
-  "description": "{{description}}",
-  "type": "module",
-  "bin": {
-    "{{name}}": "bin/cli.js"
-  },
-  "files": ["bin/**", "dist/**", "src/**", "tsconfig.json", ".claude/**", "CLAUDE.md", "README.md", "LICENSE"],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "init": "node ./bin/cli.js init", "doctor": "node ./bin/cli.js doctor"
-  },
-  "dependencies": {
-    "@metaharness/kernel": "^0.1.0",
-    "@metaharness/host-{{host}}": "^0.1.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0",
-    "vitest": "^3.0.0"
-  },
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "type": "module",
+  "bin": {
+    "{{name}}": "bin/cli.js"
+  },
+  "files": ["bin/**", "dist/**", "src/**", "tsconfig.json", ".claude/**", "CLAUDE.md", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "init": "node ./bin/cli.js init", "doctor": "node ./bin/cli.js doctor"
+  },
+  "dependencies": {
+    "@metaharness/kernel": "^0.1.0",
+    "@metaharness/host-{{host}}": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/templates/vertical_agentics/src/agents/critic.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Critic agent — Reviews outputs before they land.
-
-export const SYSTEM_PROMPT = `You review worker outputs against the task's success criteria before they are accepted into shared state. Reject work that is plausible but wrong, and say exactly why. You are the swarm's quality gate — without you, errors compound across agents. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'critic';
-export const TIER = 'opus' as const;
+// SPDX-License-Identifier: MIT
+// Critic agent — Reviews outputs before they land.
+
+export const SYSTEM_PROMPT = `You review worker outputs against the task's success criteria before they are accepted into shared state. Reject work that is plausible but wrong, and say exactly why. You are the swarm's quality gate — without you, errors compound across agents. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'critic';
+export const TIER = 'opus' as const;

package/templates/vertical_agentics/src/agents/orchestrator.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Orchestrator agent — Routes work and owns the goal state.
-
-export const SYSTEM_PROMPT = `You own the goal. Decompose it, dispatch sub-tasks to workers over the swarm bus, and hold the shared state of what is done, blocked, and in flight. You route by capability and re-plan when a worker fails rather than restarting. You do the work of coordination, not the tasks themselves. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'orchestrator';
-export const TIER = 'opus' as const;
+// SPDX-License-Identifier: MIT
+// Orchestrator agent — Routes work and owns the goal state.
+
+export const SYSTEM_PROMPT = `You own the goal. Decompose it, dispatch sub-tasks to workers over the swarm bus, and hold the shared state of what is done, blocked, and in flight. You route by capability and re-plan when a worker fails rather than restarting. You do the work of coordination, not the tasks themselves. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'orchestrator';
+export const TIER = 'opus' as const;

package/templates/vertical_agentics/src/agents/planner.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Planner agent — Builds the dependency-aware plan.
-
-export const SYSTEM_PROMPT = `You turn the goal into a dependency-aware plan: tasks, their preconditions and effects, and the order that respects dependencies. You expose the critical path and the tasks that can run in parallel. You replan from the current state on failure — never from scratch. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'planner';
-export const TIER = 'opus' as const;
+// SPDX-License-Identifier: MIT
+// Planner agent — Builds the dependency-aware plan.
+
+export const SYSTEM_PROMPT = `You turn the goal into a dependency-aware plan: tasks, their preconditions and effects, and the order that respects dependencies. You expose the critical path and the tasks that can run in parallel. You replan from the current state on failure — never from scratch. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'planner';
+export const TIER = 'opus' as const;

package/templates/vertical_agentics/src/agents/worker.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Worker agent — Executes one task and reports.
-
-export const SYSTEM_PROMPT = `You execute exactly one assigned task, write the result and any new facts to shared memory, and report success or a precise failure to the orchestrator. You stay in your lane: you do not re-plan or grab another task. A crisp failure report is more useful than a heroic overreach. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'worker';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Worker agent — Executes one task and reports.
+
+export const SYSTEM_PROMPT = `You execute exactly one assigned task, write the result and any new facts to shared memory, and report success or a precise failure to the orchestrator. You stay in your lane: you do not re-plan or grab another task. A crisp failure report is more useful than a heroic overreach. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'worker';
+export const TIER = 'sonnet' as const;

package/templates/vertical_agentics/src/init.ts.tmpl

@@ -1,21 +1,21 @@
-// SPDX-License-Identifier: MIT
-// Generated by create-agent-harness — your harness's `{{name}} init` entry.
-
-import { loadKernel } from '@metaharness/kernel';
-import adapter from '@metaharness/host-{{host}}';
-
-const HARNESS_NAME = '{{name}}';
-
-async function main(): Promise<number> {
-  const kernel = await loadKernel();
-  const info = kernel.kernelInfo();
-  console.log(`${HARNESS_NAME} — kernel ${info.version} (${kernel.backend})`);
-  console.log(`Host adapter: ${adapter.name}`);
-  console.log(`Run \`${HARNESS_NAME} doctor\` to verify the install.`);
-  return 0;
-}
-
-main().then(c => process.exit(c)).catch(err => {
-  console.error(err);
-  process.exit(1);
-});
+// SPDX-License-Identifier: MIT
+// Generated by create-agent-harness — your harness's `{{name}} init` entry.
+
+import { loadKernel } from '@metaharness/kernel';
+import adapter from '@metaharness/host-{{host}}';
+
+const HARNESS_NAME = '{{name}}';
+
+async function main(): Promise<number> {
+  const kernel = await loadKernel();
+  const info = kernel.kernelInfo();
+  console.log(`${HARNESS_NAME} — kernel ${info.version} (${kernel.backend})`);
+  console.log(`Host adapter: ${adapter.name}`);
+  console.log(`Run \`${HARNESS_NAME} doctor\` to verify the install.`);
+  return 0;
+}
+
+main().then(c => process.exit(c)).catch(err => {
+  console.error(err);
+  process.exit(1);
+});

package/templates/vertical_agentics/tsconfig.json.tmpl

@@ -1,19 +1,19 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules", "dist", "__tests__"]
-}
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "__tests__"]
+}

package/templates/vertical_agentics/vitest.config.ts.tmpl

@@ -1,23 +1,23 @@
-// SPDX-License-Identifier: MIT
-// Generated by metaharness. Strips the `#!/usr/bin/env node` shebang from
-// importable entrypoints (e.g. bin/cli.js) before Vite parses them — Vite/esbuild
-// (used internally by Vitest) does NOT strip shebangs, so importing a shebanged
-// module throws `SyntaxError: Invalid or unexpected token`. See issue #44.
-// Has no effect on direct CLI execution or `npm run doctor` (those bypass Vite).
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  plugins: [
-    {
-      name: 'strip-shebang',
-      enforce: 'pre',
-      transform(code: string) {
-        if (code.startsWith('#!')) {
-          // Replace with a blank line so source line numbers stay aligned.
-          return { code: code.replace(/^#![^\n]*/, ''), map: null };
-        }
-        return null;
-      },
-    },
-  ],
-});
+// SPDX-License-Identifier: MIT
+// Generated by metaharness. Strips the `#!/usr/bin/env node` shebang from
+// importable entrypoints (e.g. bin/cli.js) before Vite parses them — Vite/esbuild
+// (used internally by Vitest) does NOT strip shebangs, so importing a shebanged
+// module throws `SyntaxError: Invalid or unexpected token`. See issue #44.
+// Has no effect on direct CLI execution or `npm run doctor` (those bypass Vite).
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  plugins: [
+    {
+      name: 'strip-shebang',
+      enforce: 'pre',
+      transform(code: string) {
+        if (code.startsWith('#!')) {
+          // Replace with a blank line so source line numbers stay aligned.
+          return { code: code.replace(/^#![^\n]*/, ''), map: null };
+        }
+        return null;
+      },
+    },
+  ],
+});

package/templates/vertical_ai/.claude/commands/doctor.md.tmpl

@@ -1,12 +1,12 @@
----
-description: "Health-check the harness: kernel load, MCP wiring, memory backend, host adapter."
----
-
-Run a full health check and print a PASS/FAIL table.
-
-1. Kernel loads and `kernelInfo().version` matches package.json.
-2. The MCP server starts and lists its tools.
-3. The memory backend is reachable.
-4. The configured host adapter is present.
-
-Exit non-zero if any check fails.
+---
+description: "Health-check the harness: kernel load, MCP wiring, memory backend, host adapter."
+---
+
+Run a full health check and print a PASS/FAIL table.
+
+1. Kernel loads and `kernelInfo().version` matches package.json.
+2. The MCP server starts and lists its tools.
+3. The memory backend is reachable.
+4. The configured host adapter is present.
+
+Exit non-zero if any check fails.

package/templates/vertical_ai/.claude/settings.json.tmpl

@@ -1,35 +1,35 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx {{name}}*)",
-      "mcp__{{name}}__*",
-      "mcp__experiments__*",
-      "Bash(python *)"
-    ],
-    "deny": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Bash(rm -rf*)"
-    ]
-  },
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "start"
-      ]
-    },
-    "experiments": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "experiments"
-      ]
-    }
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx {{name}}*)",
+      "mcp__{{name}}__*",
+      "mcp__experiments__*",
+      "Bash(python *)"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Bash(rm -rf*)"
+    ]
+  },
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "start"
+      ]
+    },
+    "experiments": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "experiments"
+      ]
+    }
+  }
+}

package/templates/vertical_ai/.claude/skills/eval-report/SKILL.md.tmpl

@@ -1,13 +1,13 @@
----
-name: eval-report
-description: "Produce an honest eval report: metrics, subgroup slices, baseline delta, ship/no-ship."
----
-
-# eval-report
-
-Produce an evaluation report.
-
-1. Evaluate on the held-out set with objective-aligned metrics.
-2. Slice by subgroup and report the worst slice.
-3. Compare against the baseline; show the delta.
-4. End with SHIP or NO-SHIP and the number behind it.
+---
+name: eval-report
+description: "Produce an honest eval report: metrics, subgroup slices, baseline delta, ship/no-ship."
+---
+
+# eval-report
+
+Produce an evaluation report.
+
+1. Evaluate on the held-out set with objective-aligned metrics.
+2. Slice by subgroup and report the worst slice.
+3. Compare against the baseline; show the delta.
+4. End with SHIP or NO-SHIP and the number behind it.

package/templates/vertical_ai/.claude-plugin/plugin.json.tmpl

@@ -1,23 +1,23 @@
-{
-  "name": "{{name}}",
-  "version": "0.1.0",
-  "description": "{{description}}",
-  "author": {
-    "displayName": "Generated by metaharness",
-    "url": "https://www.npmjs.com/package/metaharness"
-  },
-  "license": "MIT",
-  "categories": [
-    "agent-harness",
-    "metaharness-scaffold",
-    "Engineering",
-    "ai/ml-lifecycle"
-  ],
-  "tags": [
-    "metaharness",
-    "agent-harness",
-    "vertical:ai",
-    "ai/ml-lifecycle"
-  ],
-  "homepage": "https://github.com/ruvnet/agent-harness-generator"
-}
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "author": {
+    "displayName": "Generated by metaharness",
+    "url": "https://www.npmjs.com/package/metaharness"
+  },
+  "license": "MIT",
+  "categories": [
+    "agent-harness",
+    "metaharness-scaffold",
+    "Engineering",
+    "ai/ml-lifecycle"
+  ],
+  "tags": [
+    "metaharness",
+    "agent-harness",
+    "vertical:ai",
+    "ai/ml-lifecycle"
+  ],
+  "homepage": "https://github.com/ruvnet/agent-harness-generator"
+}

package/templates/vertical_ai/CLAUDE.md.tmpl

@@ -1,31 +1,31 @@
-# {{name}}
-
-{{description}}
-
-> AI / ML Engineering harness · domain: `ai/ml-lifecycle`. Generated with [create-agent-harness](https://github.com/ruvnet/agent-harness-generator).
-
-## Behavioral rules
-
-- Use the harness's MCP tools (`mcp__{{name}}__*`) for orchestration
-- Memory and routing are handled by the kernel — you don't need to learn them
-- Defer destructive operations to the user
-
-## Agents
-
-| Agent | Tier | Role |
-|---|---|---|
-| `data-curator` | sonnet | Builds and documents the dataset. |
-| `trainer` | sonnet | Runs reproducible training jobs. |
-| `evaluator` | opus | The honest eval gate. |
-| `deployer` | sonnet | Ships behind a guardrail. |
-## Skills
-
-- `/eval-report` — Produce an honest eval report: metrics, subgroup slices, baseline delta, ship/no-ship.
-
-## Commands
-
-- `doctor` — Health-check the harness: kernel load, MCP wiring, memory backend, host adapter.
-
-## Architecture
-
-This harness uses [@metaharness/kernel](https://www.npmjs.com/package/@metaharness/kernel) — a Rust-compiled WASM module with a NAPI-RS native fallback — so the same code runs identically on every platform.
+# {{name}}
+
+{{description}}
+
+> AI / ML Engineering harness · domain: `ai/ml-lifecycle`. Generated with [create-agent-harness](https://github.com/ruvnet/agent-harness-generator).
+
+## Behavioral rules
+
+- Use the harness's MCP tools (`mcp__{{name}}__*`) for orchestration
+- Memory and routing are handled by the kernel — you don't need to learn them
+- Defer destructive operations to the user
+
+## Agents
+
+| Agent | Tier | Role |
+|---|---|---|
+| `data-curator` | sonnet | Builds and documents the dataset. |
+| `trainer` | sonnet | Runs reproducible training jobs. |
+| `evaluator` | opus | The honest eval gate. |
+| `deployer` | sonnet | Ships behind a guardrail. |
+## Skills
+
+- `/eval-report` — Produce an honest eval report: metrics, subgroup slices, baseline delta, ship/no-ship.
+
+## Commands
+
+- `doctor` — Health-check the harness: kernel load, MCP wiring, memory backend, host adapter.
+
+## Architecture
+
+This harness uses [@metaharness/kernel](https://www.npmjs.com/package/@metaharness/kernel) — a Rust-compiled WASM module with a NAPI-RS native fallback — so the same code runs identically on every platform.

package/templates/vertical_ai/README.md.tmpl

@@ -1,30 +1,30 @@
-# {{name}}
-
-{{description}}
-
-> **AI / ML Engineering** — Curate → train → evaluate → deploy, with an experiment-tracking MCP and eval gates.
->
-> Generated with [`create-agent-harness`](https://github.com/ruvnet/agent-harness-generator). Multi-host scaffolding with a kernel that resolves native → wasm → js (js backend in the published beta; see `harness doctor`).
-
-## Install
-
-```bash
-npm install -g {{name}}
-{{name}} init
-{{name}} doctor
-```
-
-## Agents
-
-| Agent | Role |
-|---|---|
-| `data-curator` | Builds and documents the dataset. |
-| `trainer` | Runs reproducible training jobs. |
-| `evaluator` | The honest eval gate. |
-| `deployer` | Ships behind a guardrail. |
-
-This harness ships with the **{{host}}** adapter.
-
-## License
-
-MIT
+# {{name}}
+
+{{description}}
+
+> **AI / ML Engineering** — Curate → train → evaluate → deploy, with an experiment-tracking MCP and eval gates.
+>
+> Generated with [`create-agent-harness`](https://github.com/ruvnet/agent-harness-generator). Multi-host scaffolding with a kernel that resolves native → wasm → js (js backend in the published beta; see `harness doctor`).
+
+## Install
+
+```bash
+npm install -g {{name}}
+{{name}} init
+{{name}} doctor
+```
+
+## Agents
+
+| Agent | Role |
+|---|---|
+| `data-curator` | Builds and documents the dataset. |
+| `trainer` | Runs reproducible training jobs. |
+| `evaluator` | The honest eval gate. |
+| `deployer` | Ships behind a guardrail. |
+
+This harness ships with the **{{host}}** adapter.
+
+## License
+
+MIT

package/templates/vertical_ai/__tests__/smoke.test.ts.tmpl

@@ -1,37 +1,37 @@
-// SPDX-License-Identifier: MIT
-// Generated by metaharness — a real smoke test for {{name}}.
-//
-// This is NOT a placeholder: it boots the actual kernel + host adapter the
-// harness depends on, so `npm test` fails loudly if @metaharness/kernel or
-// @metaharness/host-{{host}} is missing, broken, or version-skewed. It is the
-// fastest signal that `npm install` produced a runnable harness.
-
-import { describe, it, expect } from 'vitest';
-import { loadKernel } from '@metaharness/kernel';
-import adapter from '@metaharness/host-{{host}}';
-import { run } from '../bin/cli.js';
-
-describe('{{name}} — install smoke test', () => {
-  it('loads the kernel and reports a version + a known backend', async () => {
-    const kernel = await loadKernel();
-    const info = kernel.kernelInfo();
-    expect(typeof info.version).toBe('string');
-    expect(info.version.length).toBeGreaterThan(0);
-    expect(['native', 'wasm', 'js']).toContain(kernel.backend);
-  });
-
-  it('resolves the host adapter with a name', () => {
-    expect(typeof adapter.name).toBe('string');
-    expect(adapter.name.length).toBeGreaterThan(0);
-  });
-
-  it('the CLI doctor command succeeds (exit 0)', async () => {
-    const code = await run(['doctor']);
-    expect(code).toBe(0);
-  });
-
-  it('an unknown CLI command exits non-zero', async () => {
-    const code = await run(['definitely-not-a-command']);
-    expect(code).not.toBe(0);
-  });
-});
+// SPDX-License-Identifier: MIT
+// Generated by metaharness — a real smoke test for {{name}}.
+//
+// This is NOT a placeholder: it boots the actual kernel + host adapter the
+// harness depends on, so `npm test` fails loudly if @metaharness/kernel or
+// @metaharness/host-{{host}} is missing, broken, or version-skewed. It is the
+// fastest signal that `npm install` produced a runnable harness.
+
+import { describe, it, expect } from 'vitest';
+import { loadKernel } from '@metaharness/kernel';
+import adapter from '@metaharness/host-{{host}}';
+import { run } from '../bin/cli.js';
+
+describe('{{name}} — install smoke test', () => {
+  it('loads the kernel and reports a version + a known backend', async () => {
+    const kernel = await loadKernel();
+    const info = kernel.kernelInfo();
+    expect(typeof info.version).toBe('string');
+    expect(info.version.length).toBeGreaterThan(0);
+    expect(['native', 'wasm', 'js']).toContain(kernel.backend);
+  });
+
+  it('resolves the host adapter with a name', () => {
+    expect(typeof adapter.name).toBe('string');
+    expect(adapter.name.length).toBeGreaterThan(0);
+  });
+
+  it('the CLI doctor command succeeds (exit 0)', async () => {
+    const code = await run(['doctor']);
+    expect(code).toBe(0);
+  });
+
+  it('an unknown CLI command exits non-zero', async () => {
+    const code = await run(['definitely-not-a-command']);
+    expect(code).not.toBe(0);
+  });
+});