metaharness 0.4.0 → 0.4.2

package/templates/vertical_education/manifest.json

@@ -1,116 +1,116 @@
-{
-  "id": "vertical:education",
-  "description": "A tutoring pod — tutor, explainer, quiz-master, grader over a per-learner mastery memory.",
-  "domain": "learning",
-  "category": "Knowledge",
-  "files": [
-    {
-      "src": "package.json.tmpl",
-      "dst": "package.json",
-      "render": true
-    },
-    {
-      "src": "CLAUDE.md.tmpl",
-      "dst": "CLAUDE.md",
-      "render": true
-    },
-    {
-      "src": "README.md.tmpl",
-      "dst": "README.md",
-      "render": true
-    },
-    {
-      "src": ".claude/settings.json.tmpl",
-      "dst": ".claude/settings.json",
-      "render": true
-    },
-    {
-      "src": ".claude-plugin/plugin.json.tmpl",
-      "dst": ".claude-plugin/plugin.json",
-      "render": true
-    },
-    {
-      "src": "src/init.ts.tmpl",
-      "dst": "src/init.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/tutor.ts.tmpl",
-      "dst": "src/agents/tutor.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/explainer.ts.tmpl",
-      "dst": "src/agents/explainer.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/quiz-master.ts.tmpl",
-      "dst": "src/agents/quiz-master.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/grader.ts.tmpl",
-      "dst": "src/agents/grader.ts",
-      "render": true
-    },
-    {
-      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
-      "dst": ".claude/skills/memory-inspect/SKILL.md",
-      "render": true
-    },
-    {
-      "src": ".claude/skills/teach-next/SKILL.md.tmpl",
-      "dst": ".claude/skills/teach-next/SKILL.md",
-      "render": true
-    },
-    {
-      "src": ".claude/commands/doctor.md.tmpl",
-      "dst": ".claude/commands/doctor.md",
-      "render": true
-    },
-    {
-      "src": ".claude/commands/mastery-report.md.tmpl",
-      "dst": ".claude/commands/mastery-report.md",
-      "render": true
-    },
-    {
-      "src": "tsconfig.json.tmpl",
-      "dst": "tsconfig.json",
-      "render": true
-    },
-    {
-      "src": "bin/cli.js.tmpl",
-      "dst": "bin/cli.js",
-      "render": true
-    },
-    {
-      "src": "__tests__/smoke.test.ts.tmpl",
-      "dst": "__tests__/smoke.test.ts",
-      "render": true
-    }
-  ],
-  "vars": [
-    {
-      "name": "name",
-      "prompt": "Harness name (kebab-case)",
-      "validate": "^[a-z0-9-]+$"
-    },
-    {
-      "name": "description",
-      "prompt": "One-line description",
-      "default": "Tutor → explain → quiz → grade with adaptive depth and a \"say I do not know\" floor"
-    },
-    {
-      "name": "host",
-      "prompt": "Host adapter",
-      "default": "claude-code",
-      "choices": [
-        "claude-code",
-        "codex",
-        "pi-dev",
-        "hermes"
-      ]
-    }
-  ]
-}
+{
+  "id": "vertical:education",
+  "description": "A tutoring pod — tutor, explainer, quiz-master, grader over a per-learner mastery memory.",
+  "domain": "learning",
+  "category": "Knowledge",
+  "files": [
+    {
+      "src": "package.json.tmpl",
+      "dst": "package.json",
+      "render": true
+    },
+    {
+      "src": "CLAUDE.md.tmpl",
+      "dst": "CLAUDE.md",
+      "render": true
+    },
+    {
+      "src": "README.md.tmpl",
+      "dst": "README.md",
+      "render": true
+    },
+    {
+      "src": ".claude/settings.json.tmpl",
+      "dst": ".claude/settings.json",
+      "render": true
+    },
+    {
+      "src": ".claude-plugin/plugin.json.tmpl",
+      "dst": ".claude-plugin/plugin.json",
+      "render": true
+    },
+    {
+      "src": "src/init.ts.tmpl",
+      "dst": "src/init.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/tutor.ts.tmpl",
+      "dst": "src/agents/tutor.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/explainer.ts.tmpl",
+      "dst": "src/agents/explainer.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/quiz-master.ts.tmpl",
+      "dst": "src/agents/quiz-master.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/grader.ts.tmpl",
+      "dst": "src/agents/grader.ts",
+      "render": true
+    },
+    {
+      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
+      "dst": ".claude/skills/memory-inspect/SKILL.md",
+      "render": true
+    },
+    {
+      "src": ".claude/skills/teach-next/SKILL.md.tmpl",
+      "dst": ".claude/skills/teach-next/SKILL.md",
+      "render": true
+    },
+    {
+      "src": ".claude/commands/doctor.md.tmpl",
+      "dst": ".claude/commands/doctor.md",
+      "render": true
+    },
+    {
+      "src": ".claude/commands/mastery-report.md.tmpl",
+      "dst": ".claude/commands/mastery-report.md",
+      "render": true
+    },
+    {
+      "src": "tsconfig.json.tmpl",
+      "dst": "tsconfig.json",
+      "render": true
+    },
+    {
+      "src": "bin/cli.js.tmpl",
+      "dst": "bin/cli.js",
+      "render": true
+    },
+    {
+      "src": "__tests__/smoke.test.ts.tmpl",
+      "dst": "__tests__/smoke.test.ts",
+      "render": true
+    }
+  ],
+  "vars": [
+    {
+      "name": "name",
+      "prompt": "Harness name (kebab-case)",
+      "validate": "^[a-z0-9-]+$"
+    },
+    {
+      "name": "description",
+      "prompt": "One-line description",
+      "default": "Tutor → explain → quiz → grade with adaptive depth and a \"say I do not know\" floor"
+    },
+    {
+      "name": "host",
+      "prompt": "Host adapter",
+      "default": "claude-code",
+      "choices": [
+        "claude-code",
+        "codex",
+        "pi-dev",
+        "hermes"
+      ]
+    }
+  ]
+}

package/templates/vertical_education/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_education/src/agents/explainer.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Explainer agent — Explains the picked concept at the right depth.
-
-export const SYSTEM_PROMPT = `You explain the concept the tutor picked. Start from the analogy or example most likely to land given the learner's prior masteries. Build the new concept in three layers: the one-line intuition, the worked example, then the formal statement. Stop after each layer and ask if the learner is ready to go deeper — never dump all three at once. If you do not know, say so; do not invent supporting "facts". You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'explainer';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Explainer agent — Explains the picked concept at the right depth.
+
+export const SYSTEM_PROMPT = `You explain the concept the tutor picked. Start from the analogy or example most likely to land given the learner's prior masteries. Build the new concept in three layers: the one-line intuition, the worked example, then the formal statement. Stop after each layer and ask if the learner is ready to go deeper — never dump all three at once. If you do not know, say so; do not invent supporting "facts". You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'explainer';
+export const TIER = 'sonnet' as const;

package/templates/vertical_education/src/agents/grader.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Grader agent — Grades open-ended responses against the hidden rubric.
-
-export const SYSTEM_PROMPT = `You grade the learner's response against the rubric the quiz-master attached. Award partial credit for correct reasoning that misses the bottom line; deduct for the answer-by-pattern-match without the reasoning. Write to mastery memory: concept, item id, score, miss pattern, and the smallest re-explanation the explainer would give to close the gap. Be the encouraging-but-honest voice. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'grader';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Grader agent — Grades open-ended responses against the hidden rubric.
+
+export const SYSTEM_PROMPT = `You grade the learner's response against the rubric the quiz-master attached. Award partial credit for correct reasoning that misses the bottom line; deduct for the answer-by-pattern-match without the reasoning. Write to mastery memory: concept, item id, score, miss pattern, and the smallest re-explanation the explainer would give to close the gap. Be the encouraging-but-honest voice. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'grader';
+export const TIER = 'sonnet' as const;

package/templates/vertical_education/src/agents/quiz-master.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Quiz Master agent — Generates calibrated quiz items.
-
-export const SYSTEM_PROMPT = `You generate quiz items targeted at the concept just taught. One concept per item; mix recall, application, and transfer in 1:2:1 ratio. Calibrate difficulty using the learner's previous miss rate in memory — too easy is noise, too hard is demoralising. Every item carries a hidden rubric the grader will use; never reveal the rubric to the learner. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'quiz-master';
-export const TIER = 'haiku' as const;
+// SPDX-License-Identifier: MIT
+// Quiz Master agent — Generates calibrated quiz items.
+
+export const SYSTEM_PROMPT = `You generate quiz items targeted at the concept just taught. One concept per item; mix recall, application, and transfer in 1:2:1 ratio. Calibrate difficulty using the learner's previous miss rate in memory — too easy is noise, too hard is demoralising. Every item carries a hidden rubric the grader will use; never reveal the rubric to the learner. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'quiz-master';
+export const TIER = 'haiku' as const;

package/templates/vertical_education/src/agents/tutor.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Tutor agent — Picks the next concept to teach from the learner's mastery map.
-
-export const SYSTEM_PROMPT = `You are the tutor. Read the learner's mastery map from memory and pick the next concept whose prerequisites are mastered but the concept itself is not. State the goal in one sentence the learner can hold in their head. Never teach something whose prerequisite is unmastered — fix the prerequisite first. Adapt depth to the learner's grade level and stated style preferences in memory. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'tutor';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Tutor agent — Picks the next concept to teach from the learner's mastery map.
+
+export const SYSTEM_PROMPT = `You are the tutor. Read the learner's mastery map from memory and pick the next concept whose prerequisites are mastered but the concept itself is not. State the goal in one sentence the learner can hold in their head. Never teach something whose prerequisite is unmastered — fix the prerequisite first. Adapt depth to the learner's grade level and stated style preferences in memory. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'tutor';
+export const TIER = 'sonnet' as const;

package/templates/vertical_education/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_education/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_education/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_exotic/.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_exotic/.claude/settings.json.tmpl

@@ -1,44 +1,44 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx {{name}}*)",
-      "mcp__{{name}}__*",
-      "mcp__evolution_log__*",
-      "mcp__federation__*"
-    ],
-    "deny": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Bash(rm -rf*)"
-    ]
-  },
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "start"
-      ]
-    },
-    "evolution_log": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "evolution"
-      ]
-    },
-    "federation": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "federate"
-      ]
-    }
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx {{name}}*)",
+      "mcp__{{name}}__*",
+      "mcp__evolution_log__*",
+      "mcp__federation__*"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Bash(rm -rf*)"
+    ]
+  },
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "start"
+      ]
+    },
+    "evolution_log": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "evolution"
+      ]
+    },
+    "federation": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "federate"
+      ]
+    }
+  }
+}

package/templates/vertical_exotic/.claude/skills/evolve/SKILL.md.tmpl

@@ -1,14 +1,14 @@
----
-name: evolve
-description: "Run one safe self-improvement cycle: hypothesize → experiment → record → (maybe) federate."
----
-
-# evolve
-
-Run one evolution cycle.
-
-1. Hypothesizer reads the evolution log and proposes a falsifiable change with a metric.
-2. Experimenter tests it in a sandbox and records a signed kept/killed result.
-3. Federator shares it to peers only if witness-signed and reproduced.
-
-Guard against Goodharting the metric. See ADR-014 (self-evolution + federation).
+---
+name: evolve
+description: "Run one safe self-improvement cycle: hypothesize → experiment → record → (maybe) federate."
+---
+
+# evolve
+
+Run one evolution cycle.
+
+1. Hypothesizer reads the evolution log and proposes a falsifiable change with a metric.
+2. Experimenter tests it in a sandbox and records a signed kept/killed result.
+3. Federator shares it to peers only if witness-signed and reproduced.
+
+Guard against Goodharting the metric. See ADR-014 (self-evolution + federation).