metaharness 0.1.0

package/dist/index.js

@@ -0,0 +1,409 @@
+// SPDX-License-Identifier: MIT
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { existsSync, readFileSync } from 'node:fs';
+import { walkTemplate, asFileMap } from './walker.js';
+import { writeAtomic } from './writer.js';
+import { emptyManifest, fingerprintFiles, sha256 } from './manifest.js';
+import { validateHarnessName } from './renderer.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Templates live at packages/create-agent-harness/templates/, one level above dist/.
+const TEMPLATES_ROOT = resolve(__dirname, '..', 'templates');
+/**
+ * Resolve `@ruflo/kernel`'s version at scaffold time so we can stamp it into
+ * `manifest.meta.kernel_version` (ADR-027 diagnostic). Falls through three
+ * lookup paths because the create-agent-harness package can run:
+ *   - from a workspace checkout (`packages/kernel-js/package.json`)
+ *   - from an installed npm tree (resolve `@ruflo/kernel/package.json`)
+ *   - from the prebuilt dist with neither sibling (fall back to 'unknown')
+ *
+ * We never throw — a missing kernel version downgrades the meta block to
+ * `kernel_version: undefined`, which `harness doctor` already handles as
+ * a WARN line. The CLI must keep generating harnesses even if the local
+ * kernel install is broken.
+ */
+function resolveKernelVersion() {
+    const candidates = [
+        // Workspace layout: packages/create-agent-harness/dist/ → ../../kernel-js/package.json
+        resolve(__dirname, '..', '..', 'kernel-js', 'package.json'),
+        // Installed layout: sibling node_modules/@ruflo/kernel/package.json
+        resolve(__dirname, '..', '..', '@ruflo', 'kernel', 'package.json'),
+        // Fallback: top-level node_modules
+        resolve(__dirname, '..', '..', '..', '@ruflo', 'kernel', 'package.json'),
+    ];
+    for (const p of candidates) {
+        try {
+            if (existsSync(p)) {
+                const pkg = JSON.parse(readFileSync(p, 'utf-8'));
+                if (typeof pkg.version === 'string' && pkg.version.length > 0) {
+                    return pkg.version;
+                }
+            }
+        }
+        catch {
+            // Try next candidate
+        }
+    }
+    return undefined;
+}
+const KERNEL_VERSION = resolveKernelVersion();
+export const HOSTS = ['claude-code', 'codex', 'pi-dev', 'hermes', 'openclaw', 'rvm'];
+export const TEMPLATES = [
+    'minimal',
+    'vertical:devops',
+    'vertical:support',
+    'vertical:trading',
+    'vertical:legal',
+    'vertical:research',
+    'vertical:coding',
+    'vertical:business',
+    'vertical:crm',
+    'vertical:marketing',
+    'vertical:advertising',
+    'vertical:ai',
+    'vertical:agentics',
+    'vertical:ruview',
+    'vertical:health',
+    'vertical:education', // iter 80 (milestone)
+    'vertical:sales', // iter 87
+    'vertical:gaming', // iter 96
+    'vertical:repo-maintainer', // iter 113 — best viral demo (user roadmap)
+    'vertical:exotic',
+];
+/** Read the canonical template catalog shipped at templates/catalog.json. */
+export function loadCatalog() {
+    const p = join(TEMPLATES_ROOT, 'catalog.json');
+    if (!existsSync(p))
+        return [];
+    try {
+        const parsed = JSON.parse(readFileSync(p, 'utf-8'));
+        return parsed.templates ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Render the catalog as a human-readable table for `--list`. */
+export function formatCatalog(entries) {
+    const lines = ['Available templates:', ''];
+    let category = '';
+    for (const e of entries) {
+        if (e.category !== category) {
+            category = e.category;
+            lines.push(`  ${category}`);
+        }
+        const counts = `${e.agentCount}a/${e.skillCount}s/${e.commandCount}c`;
+        lines.push(`    ${e.id.padEnd(22)} ${counts.padEnd(10)} ${e.quickStart}`);
+    }
+    lines.push('', `Scaffold with: openharness <name> --template <id>`);
+    return lines;
+}
+export function parseArgs(argv) {
+    const out = {};
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!a)
+            continue;
+        if (a === '--template' || a === '-t') {
+            out.template = argv[++i];
+        }
+        else if (a === '--template-package') {
+            out.templatePackage = argv[++i];
+        }
+        else if (a === '--host' || a === '-h') {
+            const v = argv[++i];
+            if (v)
+                (out.hosts ??= []).push(v);
+        }
+        else if (a === '--yes' || a === '-y') {
+            out.yes = true;
+        }
+        else if (a === '--force' || a === '-f') {
+            out.force = true;
+        }
+        else if (a === '--description' || a === '-d') {
+            out.description = argv[++i];
+        }
+        else if (a === '--from-existing') {
+            out.fromExisting = argv[++i] ?? process.cwd();
+        }
+        else if (a === '--list' || a === '--templates') {
+            out.list = true;
+        }
+        else if (a === '--wizard' || a === '-w') {
+            // iter 100: opt-in interactive flow. Off by default so CI scripts
+            // calling no-args keep getting the usage message instead of hanging.
+            out.wizard = true;
+        }
+        else if (!a.startsWith('-') && !out.name) {
+            out.name = a;
+        }
+    }
+    return out;
+}
+/**
+ * Resolve a template id to its on-disk directory. The "minimal" template
+ * lives at templates/minimal; vertical templates use ":" as the separator
+ * in their id and "_" as the on-disk separator (e.g. vertical:devops ->
+ * templates/vertical_devops).
+ */
+export function templateDir(id) {
+    return join(TEMPLATES_ROOT, id.replace(':', '_'));
+}
+/**
+ * Run the full scaffold pipeline:
+ *   1. Validate the name
+ *   2. Walk the template dir + render
+ *   3. Compute fingerprints
+ *   4. Build .harness/manifest.json
+ *   5. Atomically write everything to targetDir
+ *
+ * Returns the list of paths written + the manifest path + any unresolved
+ * template variables (should be empty for a clean run).
+ */
+export async function scaffold(opts) {
+    const nameCheck = validateHarnessName(opts.name);
+    if (!nameCheck.valid) {
+        throw new Error(`invalid harness name: ${nameCheck.reason}`);
+    }
+    const dir = templateDir(opts.template);
+    if (!existsSync(dir)) {
+        throw new Error(`unknown template: ${opts.template} (expected at ${dir})`);
+    }
+    const vars = {
+        name: opts.name,
+        description: opts.description ?? 'My AI agent harness',
+        host: opts.host,
+    };
+    const rendered = await walkTemplate(dir, vars, { strict: false });
+    const fileMap = asFileMap(rendered);
+    // iter 58: stamp kernel_version at scaffold time (ADR-027 diagnostic).
+    // surface defaults to 'cli' inside emptyManifest; we override only
+    // kernel_version here so the web-UI port can still set surface='web-ui'.
+    const manifest = emptyManifest(opts.template, opts.generatorVersion, {
+        meta: KERNEL_VERSION ? { kernel_version: KERNEL_VERSION } : {},
+    });
+    manifest.vars = vars;
+    manifest.hosts = [opts.host];
+    manifest.files = fingerprintFiles(fileMap);
+    // Self-hash the manifest itself so `harness upgrade` can detect a hand-
+    // edited manifest.
+    const manifestJson = JSON.stringify(manifest, null, 2);
+    rendered.push({
+        path: '.harness/manifest.json',
+        content: manifestJson,
+        rendered: false,
+        unresolved: [],
+    });
+    // Also record the manifest's own hash inside the manifest file's directory
+    // sibling (`.harness/manifest.sha256`) so a corrupt download is obvious.
+    rendered.push({
+        path: '.harness/manifest.sha256',
+        content: sha256(manifestJson) + '\n',
+        rendered: false,
+        unresolved: [],
+    });
+    const paths = await writeAtomic(opts.targetDir, rendered, { force: opts.force });
+    return {
+        paths,
+        manifestPath: join(opts.targetDir, '.harness', 'manifest.json'),
+        unresolved: rendered.flatMap(f => f.unresolved),
+    };
+}
+/** Try to detect an existing ruflo project at the given path. */
+export function detectRufloProject(dir) {
+    const signals = [];
+    if (existsSync(join(dir, 'CLAUDE.md')))
+        signals.push('CLAUDE.md');
+    if (existsSync(join(dir, '.claude')))
+        signals.push('.claude/');
+    if (existsSync(join(dir, '.claude-flow')))
+        signals.push('.claude-flow/');
+    if (existsSync(join(dir, '.mcp.json')))
+        signals.push('.mcp.json');
+    return { found: signals.length >= 2, signals };
+}
+/**
+ * iter 117 — subcommand router. Per the user's directive:
+ *
+ *   Before generation: `openharness`
+ *   Inside generated harness: `harness`
+ *
+ * The factory side gains 4 explicit verbs (new / from-repo / analyze / genome)
+ * so the surface reads as a tool, not as "the thing that takes a name". The
+ * legacy bare-name form (`openharness my-bot`) still works as a back-compat
+ * shortcut for `openharness new my-bot`.
+ */
+async function runOpenHarnessSubcommand(sub, rest) {
+    switch (sub) {
+        case 'new': {
+            // `openharness new <name> [--template <id>] [--host <id>]`
+            // Just an explicit alias for the bare-name form. Falls through to the
+            // legacy scaffold pipeline so semantics stay byte-identical.
+            return null; // signal "not handled — fall through to main()"
+        }
+        case 'from-repo': {
+            // `openharness from-repo <url> <name> [--template <id>] [--host <id>]`
+            // Clones a public GitHub repo to a tempdir, runs analyze-repo on it,
+            // and scaffolds the recommended harness as <name>. NO repository code
+            // is executed during analysis — same invariant as `analyze`.
+            const url = rest[0];
+            const name = rest[1];
+            if (!url || !name) {
+                console.error('Usage: npx openharness from-repo <repo-url> <harness-name> [--template <id>] [--host <id>]');
+                return 2;
+            }
+            const { spawnSync } = await import('node:child_process');
+            const { mkdtempSync } = await import('node:fs');
+            const { tmpdir } = await import('node:os');
+            const { join: pathJoin } = await import('node:path');
+            const tmp = mkdtempSync(pathJoin(tmpdir(), 'openharness-fromrepo-'));
+            console.log(`Cloning ${url} → ${tmp} (depth=1, code never executed)`);
+            const clone = spawnSync('git', ['clone', '--depth=1', '--quiet', url, tmp], { stdio: 'inherit' });
+            if (clone.status !== 0) {
+                console.error(`git clone failed (exit ${clone.status}). Is the URL public, is git installed?`);
+                return 2;
+            }
+            // Delegate to analyze-repo with --scaffold.
+            const { analyzeRepoCmd } = await import('./analyze-repo.js');
+            const remaining = rest.slice(2);
+            const analyzeArgs = [tmp, '--scaffold', name, ...remaining];
+            const r = await analyzeRepoCmd(analyzeArgs);
+            for (const line of r.lines)
+                console.log(line);
+            return r.code;
+        }
+        case 'analyze': {
+            // `openharness analyze <path> [--scaffold <name>] [--embed]`
+            // Alias for `harness analyze-repo`. Surface unification per the
+            // user's command-model directive.
+            const { analyzeRepoCmd } = await import('./analyze-repo.js');
+            const r = await analyzeRepoCmd(rest);
+            for (const line of r.lines)
+                console.log(line);
+            return r.code;
+        }
+        case 'genome': {
+            // `openharness genome <path>` — flagship feature per the user.
+            // Same code path as `harness genome`.
+            const { genomeCmd } = await import('./genome.js');
+            const r = await genomeCmd(rest);
+            for (const line of r.lines)
+                console.log(line);
+            return r.code;
+        }
+        default:
+            return null; // not a known subcommand
+    }
+}
+export async function main(argv) {
+    // iter 117 — subcommand router runs BEFORE flag parsing so positional
+    // verbs win over the legacy bare-name form. The router returns null when
+    // the first arg isn't a recognised subcommand, letting us fall through.
+    const first = argv[0];
+    if (first && !first.startsWith('-')) {
+        const subResult = await runOpenHarnessSubcommand(first, argv.slice(1));
+        if (subResult !== null)
+            return subResult;
+        // `new <name>` — strip the verb and fall through to the legacy scaffold.
+        if (first === 'new') {
+            argv = argv.slice(1);
+        }
+    }
+    const args = parseArgs(argv);
+    if (args.list) {
+        for (const line of formatCatalog(loadCatalog()))
+            console.log(line);
+        return 0;
+    }
+    if (args.wizard) {
+        // iter 100 (MILESTONE) — interactive wizard. Errors immediately
+        // on non-TTY environments (no point running the wizard in CI;
+        // arg-driven scaffold is what CI should use).
+        if (!process.stdin.isTTY) {
+            console.error('--wizard requires an interactive TTY. Use the arg-driven form in CI:');
+            console.error('  npx openharness <name> --template <id> --host <id>');
+            return 2;
+        }
+        const { runWizard, makeReadlineAsker, answersToInvocation } = await import('./wizard.js');
+        const catalogEntries = loadCatalog().map(t => ({ id: t.id, name: t.name, description: t.description }));
+        const wizardCatalog = { templates: catalogEntries, hosts: HOSTS };
+        const { ask, close } = makeReadlineAsker();
+        try {
+            const answers = await runWizard(wizardCatalog, ask);
+            // Fall through to the same scaffold path the arg-driven form
+            // uses — single source of truth for the scaffold semantics.
+            args.name = answers.name;
+            args.template = answers.template;
+            args.hosts = [answers.host];
+            args.description = answers.description;
+            // Print the equivalent CLI invocation so the user can re-run
+            // without the wizard next time.
+            process.stdout.write('\nNext time, you can skip the wizard with:\n');
+            process.stdout.write(`  ${answersToInvocation(answers)}\n\n`);
+        }
+        finally {
+            close();
+        }
+    }
+    if (args.fromExisting !== undefined) {
+        const root = args.fromExisting || process.cwd();
+        const d = detectRufloProject(root);
+        if (d.found) {
+            console.log(`Detected ruflo project at ${root}`);
+            console.log(`Signals: ${d.signals.join(', ')}`);
+            console.log('Eject mode will lift agents/skills/commands into a renamed harness.');
+            console.log('(Full eject pipeline lands in iter 5.)');
+            return 0;
+        }
+        else {
+            console.log(`No ruflo project detected at ${root}`);
+            console.log(`Signals seen: ${d.signals.length === 0 ? 'none' : d.signals.join(', ')}`);
+            return 1;
+        }
+    }
+    if (!args.name) {
+        console.log('Usage: npx openharness <name> [--template <id>] [--host claude-code|codex|pi-dev|hermes] [--description "..."] [--force]');
+        console.log('       npx openharness --from-existing [./path]');
+        console.log('       npx openharness --wizard          (iter 100 — interactive picker)');
+        console.log('       npx openharness --list            (browse all templates)');
+        console.log('');
+        console.log(`Templates: ${TEMPLATES.join(', ')}`);
+        console.log(`Hosts: ${HOSTS.join(', ')}`);
+        return 2;
+    }
+    const host = (args.hosts?.[0] ?? 'claude-code');
+    if (!HOSTS.includes(host)) {
+        console.error(`Unknown host: ${host}. Choose from: ${HOSTS.join(', ')}`);
+        return 2;
+    }
+    const template = args.template ?? 'minimal';
+    const targetDir = resolve(process.cwd(), args.name);
+    try {
+        const result = await scaffold({
+            name: args.name,
+            template,
+            host,
+            description: args.description,
+            targetDir,
+            force: args.force,
+            generatorVersion: '0.1.0',
+        });
+        console.log(`Scaffolded ${args.name} into ${targetDir}`);
+        console.log(`Files: ${result.paths.length}`);
+        console.log(`Manifest: ${result.manifestPath}`);
+        if (result.unresolved.length > 0) {
+            console.log(`Warning: unresolved vars in template: ${result.unresolved.join(', ')}`);
+        }
+        return 0;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return 1;
+    }
+}
+export { render, extractVarReferences, validateHarnessName } from './renderer.js';
+export { walkTemplate, asFileMap } from './walker.js';
+export { writeAtomic } from './writer.js';
+export { emptyManifest, sha256, fingerprintFiles, diffFingerprints } from './manifest.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/manifest.d.ts

@@ -0,0 +1,55 @@
+import type { TemplateVars } from './renderer.js';
+/** Diagnostic metadata per ADR-022 (CLI ↔ Web-UI integration). */
+export interface HarnessMeta {
+    /** Which surface produced this harness — 'cli' or 'web-ui'. Lets the
+     *  validate umbrella decide which parity test bucket the harness should
+     *  pass, and tells operators which surface to debug when drift surfaces. */
+    surface?: 'cli' | 'web-ui';
+    /** `@ruflo/kernel` version the harness was scaffolded against. ADR-022
+     *  identifies kernel version skew as the most common root cause of
+     *  manifest-shape disagreement between CLI + Pages deployments. Recording
+     *  it here turns "drift" into "v0.1.5 vs v0.1.6 mismatch". */
+    kernel_version?: string;
+}
+export interface HarnessManifest {
+    /** Manifest schema version. Bump only on breaking shape changes. */
+    schema: 1;
+    /** Generator package version that produced this harness. */
+    generator: string;
+    /** Template id (e.g. "minimal", "vertical:trading"). */
+    template: string;
+    /** Template package version (resolved at generation time). */
+    template_version: string;
+    /** Variables the user supplied. */
+    vars: TemplateVars;
+    /** Host adapters bundled. */
+    hosts: string[];
+    /** Per-rendered-file sha256, so `harness upgrade` can detect divergence. */
+    files: Record<string, string>;
+    /** ISO-8601 generation timestamp. */
+    generated_at: string;
+    /** ADR-022 diagnostic block. Optional for backwards-compat with pre-iter-56
+     *  manifests; `harness validate doctor` warns (does NOT fail) when absent. */
+    meta?: HarnessMeta;
+}
+export declare function emptyManifest(template: string, generator: string, opts?: {
+    meta?: HarnessMeta;
+}): HarnessManifest;
+/** sha256-hex of a string. Used to fingerprint each rendered file. */
+export declare function sha256(content: string): string;
+/**
+ * Compute the per-file hash table for a rendered file map.
+ * Keys are file paths relative to the harness root.
+ */
+export declare function fingerprintFiles(rendered: Record<string, string>): Record<string, string>;
+/**
+ * Compare two manifests' file fingerprints, returning the set of paths
+ * that differ. Drives the `harness upgrade` regenerate-diff-merge flow
+ * per copier's update model (cited in ADR-008).
+ */
+export declare function diffFingerprints(a: Record<string, string>, b: Record<string, string>): {
+    added: string[];
+    removed: string[];
+    changed: string[];
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B;;gFAE4E;IAC5E,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B;;;kEAG8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,MAAM,EAAE,CAAC,CAAC;IACV,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,IAAI,EAAE,YAAY,CAAC;IACnB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,qCAAqC;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB;kFAC8E;IAC9E,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,WAAW,CAAA;CAAO,GAChC,eAAe,CAkBjB;AAED,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMzF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAW3D"}

package/dist/manifest.js

@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: MIT
+//
+// .harness/manifest.json — the load-bearing artefact for drift detection
+// (ADR-008) and eject/upgrade (ADR-012). Mirrors copier's `.copier-answers.yml`
+// model: a single source of truth for what the user chose at generation
+// time, used to re-apply template updates on `harness upgrade`.
+import { createHash } from 'node:crypto';
+export function emptyManifest(template, generator, opts = {}) {
+    return {
+        schema: 1,
+        generator,
+        template,
+        template_version: '0.0.0',
+        vars: {},
+        hosts: [],
+        files: {},
+        generated_at: new Date().toISOString(),
+        // ADR-022: surface is always 'cli' from this code path. The web-UI
+        // (PR #1) will populate 'web-ui' from its own emit path. opts.meta
+        // wins so callers can override (tests, future channels).
+        meta: {
+            surface: 'cli',
+            ...(opts.meta ?? {}),
+        },
+    };
+}
+/** sha256-hex of a string. Used to fingerprint each rendered file. */
+export function sha256(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+/**
+ * Compute the per-file hash table for a rendered file map.
+ * Keys are file paths relative to the harness root.
+ */
+export function fingerprintFiles(rendered) {
+    const out = {};
+    for (const [path, content] of Object.entries(rendered)) {
+        out[path] = sha256(content);
+    }
+    return out;
+}
+/**
+ * Compare two manifests' file fingerprints, returning the set of paths
+ * that differ. Drives the `harness upgrade` regenerate-diff-merge flow
+ * per copier's update model (cited in ADR-008).
+ */
+export function diffFingerprints(a, b) {
+    const added = [];
+    const removed = [];
+    const changed = [];
+    const allPaths = new Set([...Object.keys(a), ...Object.keys(b)]);
+    for (const p of Array.from(allPaths).sort()) {
+        if (!(p in a))
+            added.push(p);
+        else if (!(p in b))
+            removed.push(p);
+        else if (a[p] !== b[p])
+            changed.push(p);
+    }
+    return { added, removed, changed };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,yEAAyE;AACzE,gFAAgF;AAChF,wEAAwE;AACxE,gEAAgE;AAEhE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAsCzC,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,SAAiB,EACjB,OAA+B,EAAE;IAEjC,OAAO;QACL,MAAM,EAAE,CAAC;QACT,SAAS;QACT,QAAQ;QACR,gBAAgB,EAAE,OAAO;QACzB,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,mEAAmE;QACnE,mEAAmE;QACnE,yDAAyD;QACzD,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;SACrB;KACF,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgC;IAC/D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,CAAyB,EACzB,CAAyB;IAEzB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aACxB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;aAC/B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/mcp-cmd.d.ts

@@ -0,0 +1,19 @@
+export type SubcommandResult = {
+    code: number;
+    lines: string[];
+};
+/** `harness mcp ls [path]` — list MCP servers + tools declared. */
+export declare function mcpLs(args: string[]): Promise<SubcommandResult>;
+/**
+ * `harness mcp invoke <server> <tool> --args=<json> [path]` — dispatch
+ * a tool through the kernel-style claim check and print the outcome.
+ *
+ * We re-use the TS ToolDispatcher here. For a real-world harness this
+ * would talk to the actual MCP server over stdio/HTTP; the CLI command
+ * is the same shape so users learn the dispatch model without bringing
+ * up infrastructure.
+ */
+export declare function mcpInvoke(args: string[]): Promise<SubcommandResult>;
+/** Top-level dispatcher for `harness mcp <subsub> ...`. */
+export declare function mcpDispatch(args: string[]): Promise<SubcommandResult>;
+//# sourceMappingURL=mcp-cmd.d.ts.map

package/dist/mcp-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-cmd.d.ts","sourceRoot":"","sources":["../src/mcp-cmd.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAmCjE,mEAAmE;AACnE,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6BrE;AAED;;;;;;;;GAQG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6DzE;AAED,2DAA2D;AAC3D,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B3E"}