metaharness 0.4.0 → 0.4.2

package/templates/vertical_support/package.json.tmpl

@@ -1,25 +1,25 @@
-{
-  "name": "{{name}}",
-  "version": "0.1.0",
-  "description": "{{description}}",
-  "type": "module",
-  "bin": { "{{name}}": "bin/cli.js" },
-  "files": ["bin/**", "dist/**", "src/**", "tsconfig.json", "kb/**", ".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": ["customer-support", "kb-rag", "ticket-triage", "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", "kb/**", ".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": ["customer-support", "kb-rag", "ticket-triage", "agent-harness"],
+  "publishConfig": { "access": "public" },
+  "engines": { "node": ">=20.0.0" }
+}

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

@@ -1,6 +1,6 @@
-// SPDX-License-Identifier: MIT
-export const SYSTEM_PROMPT = `You are the escalator for {{name}}.
-Triggered when severity >= HIGH or when the responder can't compose a reply with KB confidence > 0.6.
-Draft a handoff note: what the customer needs, what we know, what's unresolved, who should pick it up.`;
-export const NAME = 'escalator';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+export const SYSTEM_PROMPT = `You are the escalator for {{name}}.
+Triggered when severity >= HIGH or when the responder can't compose a reply with KB confidence > 0.6.
+Draft a handoff note: what the customer needs, what we know, what's unresolved, who should pick it up.`;
+export const NAME = 'escalator';
+export const TIER = 'sonnet' as const;

package/templates/vertical_support/src/agents/kb-searcher.ts.tmpl

@@ -1,6 +1,6 @@
-// SPDX-License-Identifier: MIT
-export const SYSTEM_PROMPT = `You are the KB retriever for {{name}}.
-Take the triaged ticket and return the top 3 KB articles via semantic search.
-Use the kernel memory bridge — never invent article ids. If no good match, return an empty array.`;
-export const NAME = 'kb-searcher';
-export const TIER = 'codemod' as const;
+// SPDX-License-Identifier: MIT
+export const SYSTEM_PROMPT = `You are the KB retriever for {{name}}.
+Take the triaged ticket and return the top 3 KB articles via semantic search.
+Use the kernel memory bridge — never invent article ids. If no good match, return an empty array.`;
+export const NAME = 'kb-searcher';
+export const TIER = 'codemod' as const;

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

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-export const SYSTEM_PROMPT = `You are the customer responder for {{name}}.
-Draft a customer-facing reply that cites the KB articles the searcher found.
-Match the customer's tone. Always end with "Let me know if this helps."
-NEVER promise refunds or credits — that's the billing team's call.`;
-export const NAME = 'responder';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+export const SYSTEM_PROMPT = `You are the customer responder for {{name}}.
+Draft a customer-facing reply that cites the KB articles the searcher found.
+Match the customer's tone. Always end with "Let me know if this helps."
+NEVER promise refunds or credits — that's the billing team's call.`;
+export const NAME = 'responder';
+export const TIER = 'sonnet' as const;

package/templates/vertical_support/src/agents/triager.ts.tmpl

@@ -1,6 +1,6 @@
-// SPDX-License-Identifier: MIT
-export const SYSTEM_PROMPT = `You are the support triager for {{name}}.
-Classify each ticket: category (billing|technical|general|urgent), severity (low|medium|high|urgent).
-Output JSON: {category, severity, summary}. Be terse. Never apologise.`;
-export const NAME = 'triager';
-export const TIER = 'haiku' as const;
+// SPDX-License-Identifier: MIT
+export const SYSTEM_PROMPT = `You are the support triager for {{name}}.
+Classify each ticket: category (billing|technical|general|urgent), severity (low|medium|high|urgent).
+Output JSON: {category, severity, summary}. Be terse. Never apologise.`;
+export const NAME = 'triager';
+export const TIER = 'haiku' as const;

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

@@ -1,16 +1,16 @@
-// SPDX-License-Identifier: MIT
-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} — customer support harness`);
-  console.log(`Kernel ${info.version} (${kernel.backend}), host: ${adapter.name}`);
-  console.log('Drop KB articles in kb/ and they will be indexed automatically.');
-  return 0;
-}
-
-main().then(c => process.exit(c)).catch(err => { console.error(err); process.exit(1); });
+// SPDX-License-Identifier: MIT
+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} — customer support harness`);
+  console.log(`Kernel ${info.version} (${kernel.backend}), host: ${adapter.name}`);
+  console.log('Drop KB articles in kb/ and they will be indexed automatically.');
+  return 0;
+}
+
+main().then(c => process.exit(c)).catch(err => { console.error(err); process.exit(1); });

package/templates/vertical_support/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_support/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_trading/.claude/settings.json.tmpl

@@ -1,20 +1,20 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npx {{name}}*)",
-      "mcp__{{name}}__*",
-      "mcp__market_data__read*"
-    ],
-    "deny": [
-      "Bash(rm *)",
-      "mcp__broker__live_order*",
-      "Read(./.env)",
-      "Read(./.env.*)",
-      "Read(./.creds*)"
-    ]
-  },
-  "mcpServers": {
-    "{{name}}": { "command": "npx", "args": ["-y", "{{name}}@latest", "mcp", "start"] },
-    "market_data": { "command": "npx", "args": ["-y", "{{name}}@latest", "mcp", "market-data"] }
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(npx {{name}}*)",
+      "mcp__{{name}}__*",
+      "mcp__market_data__read*"
+    ],
+    "deny": [
+      "Bash(rm *)",
+      "mcp__broker__live_order*",
+      "Read(./.env)",
+      "Read(./.env.*)",
+      "Read(./.creds*)"
+    ]
+  },
+  "mcpServers": {
+    "{{name}}": { "command": "npx", "args": ["-y", "{{name}}@latest", "mcp", "start"] },
+    "market_data": { "command": "npx", "args": ["-y", "{{name}}@latest", "mcp", "market-data"] }
+  }
+}

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

package/templates/vertical_trading/CLAUDE.md.tmpl

@@ -1,24 +1,24 @@
-# {{name}}
-
-{{description}}
-
-## Safety defaults
-
-- **Paper mode is the default.** Live trading requires explicit `--live` AND a non-empty `RUFLO_TRADE_CONFIRM` env var.
-- **Circuit breakers**: trade halts when daily P&L drops below `-2%` of equity OR when more than 5 consecutive losses occur OR when latency > 500ms.
-- **Position sizing** uses fractional-Kelly with a 0.25 multiplier — never bet full Kelly.
-
-## Agents
-
-| Agent | Role | Tier |
-|---|---|---|
-| `market-watcher` | Polls market data, detects regime shifts | Haiku |
-| `signal-gen` | Generates entry/exit signals from indicators | Sonnet |
-| `risk-checker` | Vets every signal against position-sizing rules + circuit-breaker state | Codemod (deterministic) |
-| `executor` | Submits orders (or simulates in paper mode) | Codemod (deterministic) |
-| `postmortem` | Daily P&L review + lessons learned | Sonnet |
-
-## Routing rules
-
-- `signal-gen` MUST always go through `risk-checker` before `executor`
-- Circuit-breaker state is checked on EVERY tick — not periodically
+# {{name}}
+
+{{description}}
+
+## Safety defaults
+
+- **Paper mode is the default.** Live trading requires explicit `--live` AND a non-empty `RUFLO_TRADE_CONFIRM` env var.
+- **Circuit breakers**: trade halts when daily P&L drops below `-2%` of equity OR when more than 5 consecutive losses occur OR when latency > 500ms.
+- **Position sizing** uses fractional-Kelly with a 0.25 multiplier — never bet full Kelly.
+
+## Agents
+
+| Agent | Role | Tier |
+|---|---|---|
+| `market-watcher` | Polls market data, detects regime shifts | Haiku |
+| `signal-gen` | Generates entry/exit signals from indicators | Sonnet |
+| `risk-checker` | Vets every signal against position-sizing rules + circuit-breaker state | Codemod (deterministic) |
+| `executor` | Submits orders (or simulates in paper mode) | Codemod (deterministic) |
+| `postmortem` | Daily P&L review + lessons learned | Sonnet |
+
+## Routing rules
+
+- `signal-gen` MUST always go through `risk-checker` before `executor`
+- Circuit-breaker state is checked on EVERY tick — not periodically

package/templates/vertical_trading/README.md.tmpl

@@ -1,17 +1,17 @@
-# {{name}}
-
-{{description}}
-
-> Generated with [`create-agent-harness`](https://github.com/ruvnet/agent-harness-generator) — `vertical:trading` template. **Paper mode by default.** Run `{{name}} backtest` to evaluate before going live.
-
-## Install
-
-```bash
-npm install -g {{name}}
-{{name}} init
-{{name}} backtest --strategy default --period 2025-01-01:2025-12-31
-```
-
-## License
-
-MIT — but **trading carries risk**. Past backtest performance does not predict future results. You're responsible for any losses.
+# {{name}}
+
+{{description}}
+
+> Generated with [`create-agent-harness`](https://github.com/ruvnet/agent-harness-generator) — `vertical:trading` template. **Paper mode by default.** Run `{{name}} backtest` to evaluate before going live.
+
+## Install
+
+```bash
+npm install -g {{name}}
+{{name}} init
+{{name}} backtest --strategy default --period 2025-01-01:2025-12-31
+```
+
+## License
+
+MIT — but **trading carries risk**. Past backtest performance does not predict future results. You're responsible for any losses.

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