metaharness 0.3.0 → 0.3.2

package/templates/vertical_education/.claude/commands/mastery-report.md.tmpl

@@ -1,12 +1,12 @@
----
-description: "Summarise the learner's current mastery map and recommend the next session's focus."
----
-
-Generate the mastery report.
-
-1. Read the full mastery map from memory.
-2. Group concepts as: mastered (>0.85), in-progress (0.5-0.85), shaky (<0.5), and locked (prereq not mastered).
-3. Recommend 1-3 concepts for the next session, with the rationale ("X is in-progress and unlocks 4 downstream concepts").
-4. Flag any concepts where the miss-pattern suggests a deeper conceptual gap rather than rehearsal noise.
-
-Write the report; do not start teaching in this command.
+---
+description: "Summarise the learner's current mastery map and recommend the next session's focus."
+---
+
+Generate the mastery report.
+
+1. Read the full mastery map from memory.
+2. Group concepts as: mastered (>0.85), in-progress (0.5-0.85), shaky (<0.5), and locked (prereq not mastered).
+3. Recommend 1-3 concepts for the next session, with the rationale ("X is in-progress and unlocks 4 downstream concepts").
+4. Flag any concepts where the miss-pattern suggests a deeper conceptual gap rather than rehearsal noise.
+
+Write the report; do not start teaching in this command.

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

@@ -1,45 +1,45 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx {{name}}*)",
-      "mcp__{{name}}__*",
-      "mcp__mastery_log__*",
-      "mcp__curriculum__*"
-    ],
-    "deny": [
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Bash(rm -rf*)",
-      "Bash(git push*)"
-    ]
-  },
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "start"
-      ]
-    },
-    "mastery_log": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "mastery"
-      ]
-    },
-    "curriculum": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "curriculum"
-      ]
-    }
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx {{name}}*)",
+      "mcp__{{name}}__*",
+      "mcp__mastery_log__*",
+      "mcp__curriculum__*"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Bash(rm -rf*)",
+      "Bash(git push*)"
+    ]
+  },
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "start"
+      ]
+    },
+    "mastery_log": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "mastery"
+      ]
+    },
+    "curriculum": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "curriculum"
+      ]
+    }
+  }
+}

package/templates/vertical_education/.claude/skills/memory-inspect/SKILL.md.tmpl

@@ -1,14 +1,14 @@
----
-name: memory-inspect
-description: Search and inspect the harness memory namespace (HNSW + emergent-time decay).
----
-
-# memory-inspect
-
-Inspect what the harness has learned.
-
-- `search <query>` — semantic nearest-neighbour over the namespace
-- `list` — recent patterns with decay weight
-- `forget <id>` — evict a pattern
-
-Use this before planning so the harness reuses prior trajectories instead of starting cold.
+---
+name: memory-inspect
+description: Search and inspect the harness memory namespace (HNSW + emergent-time decay).
+---
+
+# memory-inspect
+
+Inspect what the harness has learned.
+
+- `search <query>` — semantic nearest-neighbour over the namespace
+- `list` — recent patterns with decay weight
+- `forget <id>` — evict a pattern
+
+Use this before planning so the harness reuses prior trajectories instead of starting cold.

package/templates/vertical_education/.claude/skills/teach-next/SKILL.md.tmpl

@@ -1,16 +1,16 @@
----
-name: teach-next
-description: "Run one teaching cycle: pick next concept → explain → quiz → grade → update mastery."
----
-
-# teach-next
-
-Run one complete teaching cycle.
-
-1. Tutor reads the mastery map and picks the next concept whose prereqs are mastered.
-2. Explainer teaches it in 3 layers, pausing for "ready to go deeper?" between layers.
-3. Quiz-master generates 3-5 calibrated items mixing recall/apply/transfer.
-4. Grader scores the responses against the hidden rubric and writes mastery memory.
-5. Surface the smallest re-explanation needed for any item the learner missed.
-
-Always respect the abstain floor — never invent supporting facts to fill in for a concept the harness doesn't actually know.
+---
+name: teach-next
+description: "Run one teaching cycle: pick next concept → explain → quiz → grade → update mastery."
+---
+
+# teach-next
+
+Run one complete teaching cycle.
+
+1. Tutor reads the mastery map and picks the next concept whose prereqs are mastered.
+2. Explainer teaches it in 3 layers, pausing for "ready to go deeper?" between layers.
+3. Quiz-master generates 3-5 calibrated items mixing recall/apply/transfer.
+4. Grader scores the responses against the hidden rubric and writes mastery memory.
+5. Surface the smallest re-explanation needed for any item the learner missed.
+
+Always respect the abstain floor — never invent supporting facts to fill in for a concept the harness doesn't actually know.

package/templates/vertical_education/.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",
-    "Knowledge",
-    "learning"
-  ],
-  "tags": [
-    "metaharness",
-    "agent-harness",
-    "vertical:education",
-    "learning"
-  ],
-  "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",
+    "Knowledge",
+    "learning"
+  ],
+  "tags": [
+    "metaharness",
+    "agent-harness",
+    "vertical:education",
+    "learning"
+  ],
+  "homepage": "https://github.com/ruvnet/agent-harness-generator"
+}

package/templates/vertical_education/CLAUDE.md.tmpl

@@ -1,33 +1,33 @@
-# {{name}}
-
-{{description}}
-
-> Education / Tutoring harness · domain: `learning`. 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 |
-|---|---|---|
-| `tutor` | sonnet | Picks the next concept to teach from the learner's mastery map. |
-| `explainer` | sonnet | Explains the picked concept at the right depth. |
-| `quiz-master` | haiku | Generates calibrated quiz items. |
-| `grader` | sonnet | Grades open-ended responses against the hidden rubric. |
-## Skills
-
-- `/memory-inspect` — Search and inspect the harness memory namespace (HNSW + emergent-time decay).
-- `/teach-next` — Run one teaching cycle: pick next concept → explain → quiz → grade → update mastery.
-
-## Commands
-
-- `doctor` — Health-check the harness: kernel load, MCP wiring, memory backend, host adapter.
-- `mastery-report` — Summarise the learner's current mastery map and recommend the next session's focus.
-
-## 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}}
+
+> Education / Tutoring harness · domain: `learning`. 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 |
+|---|---|---|
+| `tutor` | sonnet | Picks the next concept to teach from the learner's mastery map. |
+| `explainer` | sonnet | Explains the picked concept at the right depth. |
+| `quiz-master` | haiku | Generates calibrated quiz items. |
+| `grader` | sonnet | Grades open-ended responses against the hidden rubric. |
+## Skills
+
+- `/memory-inspect` — Search and inspect the harness memory namespace (HNSW + emergent-time decay).
+- `/teach-next` — Run one teaching cycle: pick next concept → explain → quiz → grade → update mastery.
+
+## Commands
+
+- `doctor` — Health-check the harness: kernel load, MCP wiring, memory backend, host adapter.
+- `mastery-report` — Summarise the learner's current mastery map and recommend the next session's focus.
+
+## 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_education/README.md.tmpl

@@ -1,30 +1,30 @@
-# {{name}}
-
-{{description}}
-
-> **Education / Tutoring** — Tutor → explain → quiz → grade, over per-learner mastery memory with an abstain-not-hallucinate policy.
->
-> 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 |
-|---|---|
-| `tutor` | Picks the next concept to teach from the learner's mastery map. |
-| `explainer` | Explains the picked concept at the right depth. |
-| `quiz-master` | Generates calibrated quiz items. |
-| `grader` | Grades open-ended responses against the hidden rubric. |
-
-This harness ships with the **{{host}}** adapter.
-
-## License
-
-MIT
+# {{name}}
+
+{{description}}
+
+> **Education / Tutoring** — Tutor → explain → quiz → grade, over per-learner mastery memory with an abstain-not-hallucinate policy.
+>
+> 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 |
+|---|---|
+| `tutor` | Picks the next concept to teach from the learner's mastery map. |
+| `explainer` | Explains the picked concept at the right depth. |
+| `quiz-master` | Generates calibrated quiz items. |
+| `grader` | Grades open-ended responses against the hidden rubric. |
+
+This harness ships with the **{{host}}** adapter.
+
+## License
+
+MIT

package/templates/vertical_education/__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);
+  });
+});

package/templates/vertical_education/bin/cli.js.tmpl

@@ -1,100 +1,100 @@
-#!/usr/bin/env node
-// SPDX-License-Identifier: MIT
-// Generated by metaharness — the `{{name}}` CLI entry point.
-//
-// This is plain ESM JavaScript on purpose: it runs as-is via `npx {{name}}`
-// with NO build step. `npm run build` (tsc) is only needed if you extend the
-// TypeScript in src/. The published package ships this file directly (see the
-// "bin" + "files" fields in package.json), so `npx {{name}}` works the moment
-// `npm install` has resolved @metaharness/kernel + @metaharness/host-{{host}}.
-
-import { loadKernel } from '@metaharness/kernel';
-import adapter from '@metaharness/host-{{host}}';
-
-const HARNESS_NAME = '{{name}}';
-
-/** `{{name}} init` — boot the kernel + host adapter and report status. */
-async function init() {
-  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;
-}
-
-/** `{{name}} doctor` — verify the install end-to-end (kernel + host resolve). */
-async function doctor() {
-  const kernel = await loadKernel();
-  const info = kernel.kernelInfo();
-  const checks = [
-    ['kernel loads', !!kernel],
-    ['kernel reports a version', typeof info.version === 'string' && info.version.length > 0],
-    ['kernel backend is native|wasm|js', ['native', 'wasm', 'js'].includes(kernel.backend)],
-    ['host adapter has a name', typeof adapter?.name === 'string' && adapter.name.length > 0],
-  ];
-  let ok = true;
-  for (const [label, pass] of checks) {
-    console.log(`${pass ? 'PASS' : 'FAIL'} ${label}`);
-    if (!pass) ok = false;
-  }
-  console.log(
-    ok
-      ? `\n${HARNESS_NAME}: all checks passed (kernel ${info.version}, ${kernel.backend} backend, host ${adapter.name})`
-      : `\n${HARNESS_NAME}: doctor found problems`,
-  );
-  return ok ? 0 : 1;
-}
-
-/**
- * Dispatch one CLI invocation. Exported (not just run on import) so a test can
- * drive it without spawning a subprocess. Returns the intended exit code.
- */
-export async function run(argv) {
-  const cmd = argv[0] ?? 'init';
-  switch (cmd) {
-    case 'init':
-      return init();
-    case 'doctor':
-      return doctor();
-    case '--version':
-    case '-v': {
-      const kernel = await loadKernel();
-      console.log(kernel.version());
-      return 0;
-    }
-    case '--help':
-    case '-h':
-      console.log(`Usage: ${HARNESS_NAME} <command>\n\n  init     boot the kernel + host adapter (default)\n  doctor   verify the install end-to-end\n  --version  print the kernel version`);
-      return 0;
-    default:
-      console.error(`Unknown command: ${cmd}. Try \`${HARNESS_NAME} --help\`.`);
-      return 2;
-  }
-}
-
-// CLI guard: execute only when invoked directly (not when imported by a test).
-// npm's bin shims pass a NON-normalized argv[1] (e.g. ".../.bin/../<pkg>/bin/cli.js"
-// on Windows) and may differ in case, so realpath BOTH sides before comparing —
-// a naive string === misses the npx/shim path and the CLI silently no-ops.
-import { fileURLToPath } from 'node:url';
-import { realpathSync } from 'node:fs';
-import { argv } from 'node:process';
-const invokedDirectly = (() => {
-  if (!argv[1]) return false;
-  try {
-    const a = realpathSync(argv[1]);
-    const b = realpathSync(fileURLToPath(import.meta.url));
-    return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b;
-  } catch {
-    return false;
-  }
-})();
-if (invokedDirectly) {
-  run(argv.slice(2))
-    .then((code) => process.exit(code))
-    .catch((err) => {
-      console.error(err);
-      process.exit(1);
-    });
-}
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+// Generated by metaharness — the `{{name}}` CLI entry point.
+//
+// This is plain ESM JavaScript on purpose: it runs as-is via `npx {{name}}`
+// with NO build step. `npm run build` (tsc) is only needed if you extend the
+// TypeScript in src/. The published package ships this file directly (see the
+// "bin" + "files" fields in package.json), so `npx {{name}}` works the moment
+// `npm install` has resolved @metaharness/kernel + @metaharness/host-{{host}}.
+
+import { loadKernel } from '@metaharness/kernel';
+import adapter from '@metaharness/host-{{host}}';
+
+const HARNESS_NAME = '{{name}}';
+
+/** `{{name}} init` — boot the kernel + host adapter and report status. */
+async function init() {
+  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;
+}
+
+/** `{{name}} doctor` — verify the install end-to-end (kernel + host resolve). */
+async function doctor() {
+  const kernel = await loadKernel();
+  const info = kernel.kernelInfo();
+  const checks = [
+    ['kernel loads', !!kernel],
+    ['kernel reports a version', typeof info.version === 'string' && info.version.length > 0],
+    ['kernel backend is native|wasm|js', ['native', 'wasm', 'js'].includes(kernel.backend)],
+    ['host adapter has a name', typeof adapter?.name === 'string' && adapter.name.length > 0],
+  ];
+  let ok = true;
+  for (const [label, pass] of checks) {
+    console.log(`${pass ? 'PASS' : 'FAIL'} ${label}`);
+    if (!pass) ok = false;
+  }
+  console.log(
+    ok
+      ? `\n${HARNESS_NAME}: all checks passed (kernel ${info.version}, ${kernel.backend} backend, host ${adapter.name})`
+      : `\n${HARNESS_NAME}: doctor found problems`,
+  );
+  return ok ? 0 : 1;
+}
+
+/**
+ * Dispatch one CLI invocation. Exported (not just run on import) so a test can
+ * drive it without spawning a subprocess. Returns the intended exit code.
+ */
+export async function run(argv) {
+  const cmd = argv[0] ?? 'init';
+  switch (cmd) {
+    case 'init':
+      return init();
+    case 'doctor':
+      return doctor();
+    case '--version':
+    case '-v': {
+      const kernel = await loadKernel();
+      console.log(kernel.version());
+      return 0;
+    }
+    case '--help':
+    case '-h':
+      console.log(`Usage: ${HARNESS_NAME} <command>\n\n  init     boot the kernel + host adapter (default)\n  doctor   verify the install end-to-end\n  --version  print the kernel version`);
+      return 0;
+    default:
+      console.error(`Unknown command: ${cmd}. Try \`${HARNESS_NAME} --help\`.`);
+      return 2;
+  }
+}
+
+// CLI guard: execute only when invoked directly (not when imported by a test).
+// npm's bin shims pass a NON-normalized argv[1] (e.g. ".../.bin/../<pkg>/bin/cli.js"
+// on Windows) and may differ in case, so realpath BOTH sides before comparing —
+// a naive string === misses the npx/shim path and the CLI silently no-ops.
+import { fileURLToPath } from 'node:url';
+import { realpathSync } from 'node:fs';
+import { argv } from 'node:process';
+const invokedDirectly = (() => {
+  if (!argv[1]) return false;
+  try {
+    const a = realpathSync(argv[1]);
+    const b = realpathSync(fileURLToPath(import.meta.url));
+    return process.platform === 'win32' ? a.toLowerCase() === b.toLowerCase() : a === b;
+  } catch {
+    return false;
+  }
+})();
+if (invokedDirectly) {
+  run(argv.slice(2))
+    .then((code) => process.exit(code))
+    .catch((err) => {
+      console.error(err);
+      process.exit(1);
+    });
+}