metaharness 0.3.0 → 0.3.2

package/templates/vertical_devops/manifest.json

@@ -1,100 +1,100 @@
-{
-  "id": "vertical:devops",
-  "description": "DevOps incident response harness — 4 agents (responder, runbook, escalator, postmortem), 3 MCP servers (kernel + alerts + runbook-store), opinionated routing rules for on-call workflows",
-  "domain": "devops/incident-response",
-  "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/responder.ts.tmpl",
-      "dst": "src/agents/responder.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/runbook-runner.ts.tmpl",
-      "dst": "src/agents/runbook-runner.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/escalator.ts.tmpl",
-      "dst": "src/agents/escalator.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/postmortem.ts.tmpl",
-      "dst": "src/agents/postmortem.ts",
-      "render": true
-    },
-    {
-      "src": "runbooks/README.md.tmpl",
-      "dst": "runbooks/README.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": "Incident response with on-call workflows"
-    },
-    {
-      "name": "host",
-      "prompt": "Host adapter",
-      "default": "claude-code",
-      "choices": [
-        "claude-code",
-        "codex",
-        "pi-dev",
-        "hermes"
-      ]
-    }
-  ]
-}
+{
+  "id": "vertical:devops",
+  "description": "DevOps incident response harness — 4 agents (responder, runbook, escalator, postmortem), 3 MCP servers (kernel + alerts + runbook-store), opinionated routing rules for on-call workflows",
+  "domain": "devops/incident-response",
+  "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/responder.ts.tmpl",
+      "dst": "src/agents/responder.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/runbook-runner.ts.tmpl",
+      "dst": "src/agents/runbook-runner.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/escalator.ts.tmpl",
+      "dst": "src/agents/escalator.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/postmortem.ts.tmpl",
+      "dst": "src/agents/postmortem.ts",
+      "render": true
+    },
+    {
+      "src": "runbooks/README.md.tmpl",
+      "dst": "runbooks/README.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": "Incident response with on-call workflows"
+    },
+    {
+      "name": "host",
+      "prompt": "Host adapter",
+      "default": "claude-code",
+      "choices": [
+        "claude-code",
+        "codex",
+        "pi-dev",
+        "hermes"
+      ]
+    }
+  ]
+}

package/templates/vertical_devops/package.json.tmpl

@@ -1,27 +1,27 @@
-{
-  "name": "{{name}}",
-  "version": "0.1.0",
-  "description": "{{description}}",
-  "type": "module",
-  "bin": {
-    "{{name}}": "bin/cli.js"
-  },
-  "files": ["bin/**", "dist/**", "src/**", "tsconfig.json", "runbooks/**", ".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"
-  },
-  "keywords": ["devops", "incident-response", "on-call", "runbooks", "agent-harness"],
-  "publishConfig": { "access": "public" },
-  "engines": { "node": ">=20.0.0" }
-}
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "description": "{{description}}",
+  "type": "module",
+  "bin": {
+    "{{name}}": "bin/cli.js"
+  },
+  "files": ["bin/**", "dist/**", "src/**", "tsconfig.json", "runbooks/**", ".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"
+  },
+  "keywords": ["devops", "incident-response", "on-call", "runbooks", "agent-harness"],
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=20.0.0" }
+}

package/templates/vertical_devops/runbooks/README.md.tmpl

@@ -1,32 +1,32 @@
-# Runbooks for {{name}}
-
-Drop your team's runbooks in this directory as markdown files. The
-`runbook-runner` agent finds them by semantic search via the kernel's
-memory bridge — no schema required, no registration step.
-
-## Convention
-
-```markdown
-# <Incident name>
-
-## Symptoms
-- What you see
-- What metric triggers this
-
-## Runbook
-1. First step
-2. Second step
-3. ...
-
-## When to escalate
-- Conditions under which the runbook gives up and pages a human
-```
-
-The semantic-search retriever looks at the `# title`, the `## Symptoms`,
-and the first paragraph of `## Runbook`. Keep those expressive; the
-narrative below can be as detailed as you like.
-
-## Versioning
-
-Runbooks are versioned with the harness — when you `npm publish`, the
-runbook bundle ships too. Users get your latest runbooks on `npm update`.
+# Runbooks for {{name}}
+
+Drop your team's runbooks in this directory as markdown files. The
+`runbook-runner` agent finds them by semantic search via the kernel's
+memory bridge — no schema required, no registration step.
+
+## Convention
+
+```markdown
+# <Incident name>
+
+## Symptoms
+- What you see
+- What metric triggers this
+
+## Runbook
+1. First step
+2. Second step
+3. ...
+
+## When to escalate
+- Conditions under which the runbook gives up and pages a human
+```
+
+The semantic-search retriever looks at the `# title`, the `## Symptoms`,
+and the first paragraph of `## Runbook`. Keep those expressive; the
+narrative below can be as detailed as you like.
+
+## Versioning
+
+Runbooks are versioned with the harness — when you `npm publish`, the
+runbook bundle ships too. Users get your latest runbooks on `npm update`.

package/templates/vertical_devops/src/agents/escalator.ts.tmpl

@@ -1,19 +1,19 @@
-// SPDX-License-Identifier: MIT
-// Escalator agent — decides when to page humans and who.
-
-export const SYSTEM_PROMPT = `You are the escalator for {{name}}.
-
-You're invoked when the runbook runner can't resolve the incident, or when
-the responder's triage indicates an unknown failure mode. Your job:
-
-1. Summarise what's been tried (from session context)
-2. State the blast radius (just one service? multiple? customer-facing?)
-3. Recommend a specific human or team to page, with reasoning
-4. Draft the notification text
-
-Don't actually page yet — emit a NOTIFY_INTENT block the kernel routes
-to the notify MCP tool. Wait for human confirmation before the page goes
-out.`;
-
-export const NAME = 'escalator';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Escalator agent — decides when to page humans and who.
+
+export const SYSTEM_PROMPT = `You are the escalator for {{name}}.
+
+You're invoked when the runbook runner can't resolve the incident, or when
+the responder's triage indicates an unknown failure mode. Your job:
+
+1. Summarise what's been tried (from session context)
+2. State the blast radius (just one service? multiple? customer-facing?)
+3. Recommend a specific human or team to page, with reasoning
+4. Draft the notification text
+
+Don't actually page yet — emit a NOTIFY_INTENT block the kernel routes
+to the notify MCP tool. Wait for human confirmation before the page goes
+out.`;
+
+export const NAME = 'escalator';
+export const TIER = 'sonnet' as const;

package/templates/vertical_devops/src/agents/postmortem.ts.tmpl

@@ -1,23 +1,23 @@
-// SPDX-License-Identifier: MIT
-// Postmortem agent — drafts blameless incident postmortems from the
-// session transcript.
-
-export const SYSTEM_PROMPT = `You are the postmortem author for {{name}}.
-
-After an incident resolves, you draft a blameless postmortem from the
-session transcript. Required sections:
-
-1. Summary (1-2 sentences)
-2. Timeline (UTC, terse)
-3. Impact (users / services / duration)
-4. Root cause (technical)
-5. Contributing factors (process, tooling, communication)
-6. What went well
-7. Action items (each with an owner and a due date)
-
-Stay blameless. Name systems, not people. Pull facts from the session
-transcript via the kernel memory bridge — do not invent dates or impact
-numbers.`;
-
-export const NAME = 'postmortem';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Postmortem agent — drafts blameless incident postmortems from the
+// session transcript.
+
+export const SYSTEM_PROMPT = `You are the postmortem author for {{name}}.
+
+After an incident resolves, you draft a blameless postmortem from the
+session transcript. Required sections:
+
+1. Summary (1-2 sentences)
+2. Timeline (UTC, terse)
+3. Impact (users / services / duration)
+4. Root cause (technical)
+5. Contributing factors (process, tooling, communication)
+6. What went well
+7. Action items (each with an owner and a due date)
+
+Stay blameless. Name systems, not people. Pull facts from the session
+transcript via the kernel memory bridge — do not invent dates or impact
+numbers.`;
+
+export const NAME = 'postmortem';
+export const TIER = 'sonnet' as const;

package/templates/vertical_devops/src/agents/responder.ts.tmpl

@@ -1,14 +1,14 @@
-// SPDX-License-Identifier: MIT
-// Responder agent — first to receive alerts. Triages and identifies the
-// appropriate runbook for the next agent.
-
-export const SYSTEM_PROMPT = `You are the on-call responder for {{name}}.
-
-Your job: when an alert comes in, identify what's broken, find the matching
-runbook, and hand off to runbook-runner. Do NOT execute remediation
-yourself; you triage and delegate.
-
-Stay terse. State: what's broken, what runbook, what to escalate later.`;
-
-export const NAME = 'responder';
-export const TIER = 'haiku' as const;
+// SPDX-License-Identifier: MIT
+// Responder agent — first to receive alerts. Triages and identifies the
+// appropriate runbook for the next agent.
+
+export const SYSTEM_PROMPT = `You are the on-call responder for {{name}}.
+
+Your job: when an alert comes in, identify what's broken, find the matching
+runbook, and hand off to runbook-runner. Do NOT execute remediation
+yourself; you triage and delegate.
+
+Stay terse. State: what's broken, what runbook, what to escalate later.`;
+
+export const NAME = 'responder';
+export const TIER = 'haiku' as const;

package/templates/vertical_devops/src/agents/runbook-runner.ts.tmpl

@@ -1,17 +1,17 @@
-// SPDX-License-Identifier: MIT
-// Runbook runner agent — executes runbook steps in order, deliberates
-// (does not auto-execute destructive operations).
-
-export const SYSTEM_PROMPT = `You are the runbook runner for {{name}}.
-
-The responder handed you a runbook. Execute it step by step. For each step:
-1. State what you'll do
-2. Show the exact command (do not run it yet)
-3. Ask for confirmation if the step is destructive
-4. After execution, report the outcome before moving on
-
-NEVER auto-execute: rm, kubectl delete, systemctl stop, drop table.
-Defer to escalator if the runbook doesn't cover what you're seeing.`;
-
-export const NAME = 'runbook-runner';
-export const TIER = 'haiku' as const;
+// SPDX-License-Identifier: MIT
+// Runbook runner agent — executes runbook steps in order, deliberates
+// (does not auto-execute destructive operations).
+
+export const SYSTEM_PROMPT = `You are the runbook runner for {{name}}.
+
+The responder handed you a runbook. Execute it step by step. For each step:
+1. State what you'll do
+2. Show the exact command (do not run it yet)
+3. Ask for confirmation if the step is destructive
+4. After execution, report the outcome before moving on
+
+NEVER auto-execute: rm, kubectl delete, systemctl stop, drop table.
+Defer to escalator if the runbook doesn't cover what you're seeing.`;
+
+export const NAME = 'runbook-runner';
+export const TIER = 'haiku' as const;

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

@@ -1,23 +1,23 @@
-// SPDX-License-Identifier: MIT
-// {{name}} init — DevOps incident response harness entry point.
-
-import { loadKernel } from '@metaharness/kernel';
-import adapter from '@metaharness/host-{{host}}';
-
-const HARNESS_NAME = '{{name}}';
-const ROLE_AGENTS = ['responder', 'runbook-runner', 'escalator', 'postmortem'];
-
-async function main(): Promise<number> {
-  const kernel = await loadKernel();
-  const info = kernel.kernelInfo();
-  console.log(`${HARNESS_NAME} — DevOps incident response harness`);
-  console.log(`Kernel ${info.version} (${kernel.backend}), host: ${adapter.name}`);
-  console.log(`Agents available: ${ROLE_AGENTS.join(', ')}`);
-  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
+// {{name}} init — DevOps incident response harness entry point.
+
+import { loadKernel } from '@metaharness/kernel';
+import adapter from '@metaharness/host-{{host}}';
+
+const HARNESS_NAME = '{{name}}';
+const ROLE_AGENTS = ['responder', 'runbook-runner', 'escalator', 'postmortem'];
+
+async function main(): Promise<number> {
+  const kernel = await loadKernel();
+  const info = kernel.kernelInfo();
+  console.log(`${HARNESS_NAME} — DevOps incident response harness`);
+  console.log(`Kernel ${info.version} (${kernel.backend}), host: ${adapter.name}`);
+  console.log(`Agents available: ${ROLE_AGENTS.join(', ')}`);
+  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_devops/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_devops/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_education/.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.