metaharness 0.4.0 → 0.4.2

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

package/templates/vertical_crm/manifest.json

@@ -1,101 +1,101 @@
-{
-  "id": "vertical:crm",
-  "description": "A CRM pod — lead-qualifier, account-manager, and churn-watcher over the customer lifecycle.",
-  "domain": "crm/lifecycle",
-  "category": "Customer",
-  "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/lead-qualifier.ts.tmpl",
-      "dst": "src/agents/lead-qualifier.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/account-manager.ts.tmpl",
-      "dst": "src/agents/account-manager.ts",
-      "render": true
-    },
-    {
-      "src": "src/agents/churn-watcher.ts.tmpl",
-      "dst": "src/agents/churn-watcher.ts",
-      "render": true
-    },
-    {
-      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
-      "dst": ".claude/skills/memory-inspect/SKILL.md",
-      "render": true
-    },
-    {
-      "src": ".claude/commands/doctor.md.tmpl",
-      "dst": ".claude/commands/doctor.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": "Qualify leads, manage accounts, watch for churn"
-    },
-    {
-      "name": "host",
-      "prompt": "Host adapter",
-      "default": "claude-code",
-      "choices": [
-        "claude-code",
-        "codex",
-        "pi-dev",
-        "hermes"
-      ]
-    }
-  ]
-}
+{
+  "id": "vertical:crm",
+  "description": "A CRM pod — lead-qualifier, account-manager, and churn-watcher over the customer lifecycle.",
+  "domain": "crm/lifecycle",
+  "category": "Customer",
+  "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/lead-qualifier.ts.tmpl",
+      "dst": "src/agents/lead-qualifier.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/account-manager.ts.tmpl",
+      "dst": "src/agents/account-manager.ts",
+      "render": true
+    },
+    {
+      "src": "src/agents/churn-watcher.ts.tmpl",
+      "dst": "src/agents/churn-watcher.ts",
+      "render": true
+    },
+    {
+      "src": ".claude/skills/memory-inspect/SKILL.md.tmpl",
+      "dst": ".claude/skills/memory-inspect/SKILL.md",
+      "render": true
+    },
+    {
+      "src": ".claude/commands/doctor.md.tmpl",
+      "dst": ".claude/commands/doctor.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": "Qualify leads, manage accounts, watch for churn"
+    },
+    {
+      "name": "host",
+      "prompt": "Host adapter",
+      "default": "claude-code",
+      "choices": [
+        "claude-code",
+        "codex",
+        "pi-dev",
+        "hermes"
+      ]
+    }
+  ]
+}

package/templates/vertical_crm/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_crm/src/agents/account-manager.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Account Manager agent — Owns the relationship and the next play.
-
-export const SYSTEM_PROMPT = `You own active accounts. From the CRM history and usage, surface the next best action: an upsell that fits real usage, a check-in before a renewal, or a risk to defuse. Ground every play in the account's actual data, not a generic playbook. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'account-manager';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Account Manager agent — Owns the relationship and the next play.
+
+export const SYSTEM_PROMPT = `You own active accounts. From the CRM history and usage, surface the next best action: an upsell that fits real usage, a check-in before a renewal, or a risk to defuse. Ground every play in the account's actual data, not a generic playbook. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'account-manager';
+export const TIER = 'sonnet' as const;

package/templates/vertical_crm/src/agents/churn-watcher.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Churn Watcher agent — Detects and explains churn risk early.
-
-export const SYSTEM_PROMPT = `You watch for churn. Combine usage decay, support sentiment, and renewal proximity into a churn-risk score with the specific signal that drove it. Recommend the cheapest intervention that addresses that signal. Flag early — a save is only possible before the renewal conversation. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'churn-watcher';
-export const TIER = 'sonnet' as const;
+// SPDX-License-Identifier: MIT
+// Churn Watcher agent — Detects and explains churn risk early.
+
+export const SYSTEM_PROMPT = `You watch for churn. Combine usage decay, support sentiment, and renewal proximity into a churn-risk score with the specific signal that drove it. Recommend the cheapest intervention that addresses that signal. Flag early — a save is only possible before the renewal conversation. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'churn-watcher';
+export const TIER = 'sonnet' as const;

package/templates/vertical_crm/src/agents/lead-qualifier.ts.tmpl

@@ -1,7 +1,7 @@
-// SPDX-License-Identifier: MIT
-// Lead Qualifier agent — Scores and routes inbound leads.
-
-export const SYSTEM_PROMPT = `You qualify inbound leads against the ICP: fit, intent signals, and budget cues. Score each lead, route the hot ones, and nurture the warm ones with a suggested next touch. Be honest when a lead is not a fit — a clean disqualify saves the team hours. You operate inside the {{name}} harness; defer destructive actions to the user.`;
-
-export const NAME = 'lead-qualifier';
-export const TIER = 'haiku' as const;
+// SPDX-License-Identifier: MIT
+// Lead Qualifier agent — Scores and routes inbound leads.
+
+export const SYSTEM_PROMPT = `You qualify inbound leads against the ICP: fit, intent signals, and budget cues. Score each lead, route the hot ones, and nurture the warm ones with a suggested next touch. Be honest when a lead is not a fit — a clean disqualify saves the team hours. You operate inside the {{name}} harness; defer destructive actions to the user.`;
+
+export const NAME = 'lead-qualifier';
+export const TIER = 'haiku' as const;

package/templates/vertical_crm/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_crm/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_crm/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;
+      },
+    },
+  ],
+});