metaharness 0.4.0 → 0.4.2

package/templates/vertical_gaming/manifest.json

@@ -1,116 +1,116 @@
-{
-  "id": "vertical:gaming",
-  "description": "A game-design pod — playtest reader, balance critic, economy modeler, narrative thread keeper over per-build telemetry memory.",
-  "domain": "gaming",
-  "category": "Frontier",
-  "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/playtest-reader.ts.tmpl",
-      "dst": "src/agents/playtest-reader.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/balance-critic.ts.tmpl",
-      "dst": "src/agents/balance-critic.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/economy-modeler.ts.tmpl",
-      "dst": "src/agents/economy-modeler.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/narrative-keeper.ts.tmpl",
-      "dst": "src/agents/narrative-keeper.ts",
-      "render": true
-    },
-    {
-      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
-      "dst": ".claude/skills/memory-inspect/SKILL.md",
-      "render": true
-    },
-    {
-      "src": ".claude/skills/playtest-recap/SKILL.md.tmpl",
-      "dst": ".claude/skills/playtest-recap/SKILL.md",
-      "render": true
-    },
-    {
-      "src": ".claude/commands/doctor.md.tmpl",
-      "dst": ".claude/commands/doctor.md",
-      "render": true
-    },
-    {
-      "src": ".claude/commands/design-doc-diff.md.tmpl",
-      "dst": ".claude/commands/design-doc-diff.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": "Read playtests → critique balance → model economy → keep narrative consistent across builds"
-    },
-    {
-      "name": "host",
-      "prompt": "Host adapter",
-      "default": "claude-code",
-      "choices": [
-        "claude-code",
-        "codex",
-        "pi-dev",
-        "hermes"
-      ]
-    }
-  ]
-}
+{
+  "id": "vertical:gaming",
+  "description": "A game-design pod — playtest reader, balance critic, economy modeler, narrative thread keeper over per-build telemetry memory.",
+  "domain": "gaming",
+  "category": "Frontier",
+  "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/playtest-reader.ts.tmpl",
+      "dst": "src/agents/playtest-reader.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/balance-critic.ts.tmpl",
+      "dst": "src/agents/balance-critic.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/economy-modeler.ts.tmpl",
+      "dst": "src/agents/economy-modeler.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/narrative-keeper.ts.tmpl",
+      "dst": "src/agents/narrative-keeper.ts",
+      "render": true
+    },
+    {
+      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
+      "dst": ".claude/skills/memory-inspect/SKILL.md",
+      "render": true
+    },
+    {
+      "src": ".claude/skills/playtest-recap/SKILL.md.tmpl",
+      "dst": ".claude/skills/playtest-recap/SKILL.md",
+      "render": true
+    },
+    {
+      "src": ".claude/commands/doctor.md.tmpl",
+      "dst": ".claude/commands/doctor.md",
+      "render": true
+    },
+    {
+      "src": ".claude/commands/design-doc-diff.md.tmpl",
+      "dst": ".claude/commands/design-doc-diff.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": "Read playtests → critique balance → model economy → keep narrative consistent across builds"
+    },
+    {
+      "name": "host",
+      "prompt": "Host adapter",
+      "default": "claude-code",
+      "choices": [
+        "claude-code",
+        "codex",
+        "pi-dev",
+        "hermes"
+      ]
+    }
+  ]
+}

package/templates/vertical_gaming/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_gaming/src/agents/balance-critic.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Balance Critic agent — Critiques mechanic balance with concrete proposals.
-
-export const SYSTEM_PROMPT = `You critique mechanic balance. Read the playtest reader's observations + the current numeric design doc. For each imbalance you flag, propose ONE specific change (a number, a duration, a rule) and predict its second-order effect ("doubling reload time makes shotgun viable in close quarters but obsoletes the existing 8-second cooldown design — adjust that too"). Avoid vague "feels off" criticism. A balance change without a predicted side-effect is incomplete. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'balance-critic';
-export const TIER = 'opus' as const;
+// SPDX-License-Identifier: MIT
+// Balance Critic agent — Critiques mechanic balance with concrete proposals.
+
+export const SYSTEM_PROMPT = `You critique mechanic balance. Read the playtest reader's observations + the current numeric design doc. For each imbalance you flag, propose ONE specific change (a number, a duration, a rule) and predict its second-order effect ("doubling reload time makes shotgun viable in close quarters but obsoletes the existing 8-second cooldown design — adjust that too"). Avoid vague "feels off" criticism. A balance change without a predicted side-effect is incomplete. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'balance-critic';
+export const TIER = 'opus' as const;

package/templates/vertical_gaming/src/agents/economy-modeler.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Economy Modeler agent — Models in-game economy flows.
-
-export const SYSTEM_PROMPT = `You model the in-game economy: sources, sinks, conversion rates, time-to-acquire each tier. Flag inflation (more sources than sinks at endgame), deflation (sinks dominate, players hoard), or stratification (rich-get-richer with no catchup). For every imbalance, simulate the fix in the design doc memory and report what would change. Never just say "the economy is broken" — show the spreadsheet logic. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'economy-modeler';
-export const TIER = 'opus' as const;
+// SPDX-License-Identifier: MIT
+// Economy Modeler agent — Models in-game economy flows.
+
+export const SYSTEM_PROMPT = `You model the in-game economy: sources, sinks, conversion rates, time-to-acquire each tier. Flag inflation (more sources than sinks at endgame), deflation (sinks dominate, players hoard), or stratification (rich-get-richer with no catchup). For every imbalance, simulate the fix in the design doc memory and report what would change. Never just say "the economy is broken" — show the spreadsheet logic. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'economy-modeler';
+export const TIER = 'opus' as const;

package/templates/vertical_gaming/src/agents/narrative-keeper.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Narrative Keeper agent — Maintains narrative + lore consistency across builds.
-
-export const SYSTEM_PROMPT = `You maintain narrative consistency. Read the design doc + current build dialog + lore memory. Flag contradictions (character A says X in build 5 but Y in build 6), dropped threads (a quest seed planted in act 1 with no payoff), or tonal drift. Never invent new lore — your job is to keep what exists coherent, not to add. If a contradiction has both sides documented, surface BOTH and let the designer pick. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'narrative-keeper';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Narrative Keeper agent — Maintains narrative + lore consistency across builds.
+
+export const SYSTEM_PROMPT = `You maintain narrative consistency. Read the design doc + current build dialog + lore memory. Flag contradictions (character A says X in build 5 but Y in build 6), dropped threads (a quest seed planted in act 1 with no payoff), or tonal drift. Never invent new lore — your job is to keep what exists coherent, not to add. If a contradiction has both sides documented, surface BOTH and let the designer pick. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'narrative-keeper';
+export const TIER = 'sonnet' as const;

package/templates/vertical_gaming/src/agents/playtest-reader.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Playtest Reader agent — Reads playtest sessions and surfaces the signal.
-
-export const SYSTEM_PROMPT = `You read playtest sessions (videos, transcripts, telemetry) and surface the signal: where players got stuck, where they smiled, where they quit. You report observations, not interpretations — "player paused for 12s on the crafting menu before opening the help overlay", not "players find crafting confusing". Designers want the raw signal; interpretation is the next agent's job. Skip the highlight reel; the boring middle is where bugs live. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'playtest-reader';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Playtest Reader agent — Reads playtest sessions and surfaces the signal.
+
+export const SYSTEM_PROMPT = `You read playtest sessions (videos, transcripts, telemetry) and surface the signal: where players got stuck, where they smiled, where they quit. You report observations, not interpretations — "player paused for 12s on the crafting menu before opening the help overlay", not "players find crafting confusing". Designers want the raw signal; interpretation is the next agent's job. Skip the highlight reel; the boring middle is where bugs live. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'playtest-reader';
+export const TIER = 'sonnet' as const;

package/templates/vertical_gaming/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_gaming/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_gaming/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_health/.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_health/.claude/settings.json.tmpl

@@ -1,33 +1,33 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx {{name}}*)",
-      "mcp__{{name}}__*",
-      "mcp__health_kb__*"
-    ],
-    "deny": [
-      "Read(./.env)",
-      "Read(./.env.*)"
-    ]
-  },
-  "mcpServers": {
-    "{{name}}": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "start"
-      ]
-    },
-    "health_kb": {
-      "command": "npx",
-      "args": [
-        "-y",
-        "{{name}}@latest",
-        "mcp",
-        "health"
-      ]
-    }
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx {{name}}*)",
+      "mcp__{{name}}__*",
+      "mcp__health_kb__*"
+    ],
+    "deny": [
+      "Read(./.env)",
+      "Read(./.env.*)"
+    ]
+  },
+  "mcpServers": {
+    "{{name}}": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "start"
+      ]
+    },
+    "health_kb": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "{{name}}@latest",
+        "mcp",
+        "health"
+      ]
+    }
+  }
+}

package/templates/vertical_health/.claude/skills/wellness-intake/SKILL.md.tmpl

@@ -1,15 +1,15 @@
----
-name: wellness-intake
-description: "Run a safe, structured wellness intake that escalates red flags to professionals."
----
-
-# wellness-intake
-
-Run a wellness intake.
-
-1. Intake collects goals, volunteered history, and routine.
-2. On any red-flag symptom, STOP and direct to emergency/professional care.
-3. Triage routes to the right resource (clinician / dietitian / mental-health / info).
-4. Care-coordinator organises logistics and questions for a real clinician.
-
-This harness is informational only and is not a substitute for professional medical advice.
+---
+name: wellness-intake
+description: "Run a safe, structured wellness intake that escalates red flags to professionals."
+---
+
+# wellness-intake
+
+Run a wellness intake.
+
+1. Intake collects goals, volunteered history, and routine.
+2. On any red-flag symptom, STOP and direct to emergency/professional care.
+3. Triage routes to the right resource (clinician / dietitian / mental-health / info).
+4. Care-coordinator organises logistics and questions for a real clinician.
+
+This harness is informational only and is not a substitute for professional medical advice.