metaharness 0.1.0

package/dist/genome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"genome.d.ts","sourceRoot":"","sources":["../src/genome.ts"],"names":[],"mappings":"AAuBA,OAAO,EAA0C,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EAML,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAGjE,MAAM,WAAW,MAAM;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,UAAU,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;IAC5C,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACrB;AASD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,GAAE,MAAiC,GAAG,YAAY,CA+B3G;AAmBD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CA4D5D;AAkCD,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA0DzE"}

package/dist/genome.js

@@ -0,0 +1,219 @@
+// SPDX-License-Identifier: MIT
+//
+// `harness genome <repo>` — 18th subcommand (iter 110). The "strongest next
+// commit" per the user's roadmap. Produces a 7-section readiness scorecard
+// for a LOCAL repo, ON TOP of analyze-repo's archetype scoring.
+//
+// LOCAL-only, deterministic, never executes repo code. Same invariant as
+// analyze-repo — we inherit the inventory/profile/plan pipeline so the
+// no-exec contract is enforced once, not twice.
+//
+// Modes:
+//   - default: human-readable 7-section text report
+//   - --json: emits ONLY the 6-field genome scorecard the user named
+//   - --out <path>: writes the scorecard JSON to a file (text still goes to stdout)
+//   - --bundle: ADR-031 schema-1 envelope of the full report (for support tickets)
+//
+// Verdict + exit code:
+//   - 'ready'      (0) — publish_readiness >= 0.75 && risk_score < 0.35
+//   - 'needs-work' (1) — somewhere in between
+//   - 'blocked'    (2) — risk_score >= 0.7
+import { existsSync, statSync, writeFileSync } from 'node:fs';
+import { basename, resolve } from 'node:path';
+import { inventory, analyzeFiles, recommendPlan } from './analyze-repo.js';
+import { resolveAgentTopology, scoreMcpRisk, scoreTestConfidence, scorePublishReadiness, classifyRepoType, } from './genome-scorers.js';
+function round2(x) {
+    return Math.round(x * 100) / 100;
+}
+function round3(x) {
+    return Math.round(x * 1000) / 1000;
+}
+export function buildGenomeReport(dir, generatedAt = new Date().toISOString()) {
+    const profile = analyzeFiles(basename(dir), inventory(dir));
+    const plan = recommendPlan(profile);
+    const topology = resolveAgentTopology(profile, plan);
+    const mcp = scoreMcpRisk(profile, plan);
+    const testConf = scoreTestConfidence(profile);
+    const publish = scorePublishReadiness(profile, plan);
+    // risk = weighted blend: most of the signal comes from publish-readiness
+    // (the inverse) and MCP surface; tests bend the curve a little.
+    const risk = round3(0.5 * (1 - publish) + 0.3 * mcp.numeric + 0.2 * (1 - testConf));
+    const genome = {
+        repo_type: classifyRepoType(profile),
+        agent_topology: topology,
+        risk_score: risk,
+        mcp_surface: mcp.surface,
+        test_confidence: round2(testConf),
+        publish_readiness: round2(publish),
+    };
+    let verdict;
+    let exitCode;
+    if (risk >= 0.7) {
+        verdict = 'blocked';
+        exitCode = 2;
+    }
+    else if (publish >= 0.75 && risk < 0.35) {
+        verdict = 'ready';
+        exitCode = 0;
+    }
+    else {
+        verdict = 'needs-work';
+        exitCode = 1;
+    }
+    return { schema: 1, generatedAt, dir, profile, plan, genome, verdict, exitCode };
+}
+// --- formatting ------------------------------------------------------------
+function pct(x) {
+    return `${Math.round(x * 100)}%`;
+}
+function verdictLine(v) {
+    switch (v) {
+        case 'ready':
+            return 'READY — this repo is in shape to scaffold a harness for';
+        case 'needs-work':
+            return 'NEEDS WORK — harness will scaffold; expect some manual cleanup';
+        case 'blocked':
+            return 'BLOCKED — fix the high-risk signals before scaffolding';
+    }
+}
+export function formatGenomeReport(r) {
+    const out = [];
+    out.push(`harness genome — ${r.dir}`);
+    out.push('');
+    // 1. Repo profile
+    out.push('1. Repo profile');
+    out.push(`   type:              ${r.genome.repo_type}`);
+    out.push(`   languages:         ${r.profile.languages.join(', ') || '(none detected)'}`);
+    out.push(`   build:             ${r.profile.buildCommands.join(', ') || '(none detected)'}`);
+    out.push(`   test:              ${r.profile.testCommands.join(', ') || '(none detected)'}`);
+    out.push(`   ci:                ${r.profile.hasCi ? 'present' : 'none'}`);
+    out.push(`   mcp signals:       ${r.profile.hasMcp ? 'present' : 'none'}`);
+    out.push('');
+    // 2. Agent topology
+    out.push('2. Agent topology');
+    out.push(`   recommended:       ${r.genome.agent_topology.join(', ')}`);
+    out.push('');
+    // 3. MCP risk model
+    out.push('3. MCP risk model');
+    out.push(`   surface:           ${r.genome.mcp_surface}`);
+    out.push(`   numeric risk:      ${pct(scoreMcpRisk(r.profile, r.plan).numeric)}`);
+    out.push(`   policy:            ${r.plan.riskProfile}`);
+    out.push('');
+    // 4. Test confidence
+    out.push('4. Test confidence');
+    out.push(`   score:             ${pct(r.genome.test_confidence)}`);
+    out.push(`   signals:           ${r.profile.testCommands.length} test command(s), ci ${r.profile.hasCi ? 'yes' : 'no'}`);
+    out.push('');
+    // 5. Release readiness
+    out.push('5. Release readiness');
+    out.push(`   score:             ${pct(r.genome.publish_readiness)}`);
+    out.push(`   buildable:         ${r.profile.buildCommands.length > 0 ? 'yes' : 'no'}`);
+    out.push(`   testable:          ${r.profile.testCommands.length > 0 ? 'yes' : 'no'}`);
+    out.push(`   ci wired:          ${r.profile.hasCi ? 'yes' : 'no'}`);
+    out.push('');
+    // 6. Recommended harness plan
+    out.push('6. Recommended harness plan');
+    out.push(`   template:          ${r.plan.template}`);
+    out.push(`   archetype:         ${r.plan.archetypeId} (confidence ${pct(r.plan.confidence)})`);
+    out.push(`   hosts:             ${r.plan.hosts.join(', ')}`);
+    out.push(`   agents:            ${r.plan.agents.join(', ') || '(none)'}`);
+    out.push(`   skills:            ${r.plan.skills.join(', ') || '(none)'}`);
+    out.push('');
+    // 7. Scorecard
+    out.push('7. Scorecard');
+    out.push(`   risk score:        ${pct(r.genome.risk_score)}`);
+    out.push(`   publish readiness: ${pct(r.genome.publish_readiness)}`);
+    out.push(`   test confidence:   ${pct(r.genome.test_confidence)}`);
+    out.push('');
+    out.push(`Verdict: ${verdictLine(r.verdict)} (exit ${r.exitCode})`);
+    out.push(`Scaffold it: npx openharness ${r.plan.name} --template ${r.plan.template}`);
+    return out;
+}
+// --- sanitisation (ADR-031) ------------------------------------------------
+const SECRET_RE = /(secret|token|key|password|passphrase)/i;
+function sanitiseValue(v) {
+    if (v == null)
+        return v;
+    if (Array.isArray(v))
+        return v.map(sanitiseValue);
+    if (typeof v === 'object') {
+        const out = {};
+        for (const [k, val] of Object.entries(v)) {
+            out[k] = SECRET_RE.test(k) ? '[REDACTED]' : sanitiseValue(val);
+        }
+        return out;
+    }
+    return v;
+}
+// --- dispatch --------------------------------------------------------------
+function usage() {
+    return [
+        'Usage: harness genome <path> [--out <file>] [--json] [--bundle]',
+        '',
+        '  Produces a 7-section readiness scorecard for a LOCAL repo.',
+        '  Defaults to human-readable text.',
+        '',
+        '  --out <file>   Write the 6-field genome JSON to <file>.',
+        '  --json         Emit the 6-field genome JSON to stdout (instead of text).',
+        '  --bundle       Emit the full report as an ADR-031 schema-1 envelope.',
+    ];
+}
+export async function genomeCmd(args) {
+    const bundle = args.includes('--bundle');
+    const json = args.includes('--json');
+    let outPath = null;
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (a === '--out') {
+            outPath = args[++i] ?? null;
+            if (!outPath) {
+                const err = { schema: 1, error: 'missing-out-path', exitCode: 2 };
+                return { code: 2, lines: [bundle || json ? JSON.stringify(err, null, 2) : '--out requires a file path'] };
+            }
+        }
+        else if (a === '--bundle' || a === '--json') {
+            /* handled */
+        }
+        else if (a === '--help' || a === '-h') {
+            return { code: 0, lines: usage() };
+        }
+        else if (a && !a.startsWith('--')) {
+            positional.push(a);
+        }
+        else if (a) {
+            const err = { schema: 1, error: `unknown-flag-${a.replace(/^--?/, '')}`, exitCode: 2 };
+            return { code: 2, lines: [bundle || json ? JSON.stringify(err, null, 2) : `Unknown flag: ${a}`] };
+        }
+    }
+    if (positional.length === 0) {
+        return { code: 2, lines: usage() };
+    }
+    const dir = resolve(positional[0]);
+    if (!existsSync(dir) || !statSync(dir).isDirectory()) {
+        const generatedAt = new Date().toISOString();
+        const err = { schema: 1, generatedAt, error: 'not-a-directory', dir, exitCode: 2 };
+        if (bundle || json)
+            return { code: 2, lines: [JSON.stringify(err, null, 2)] };
+        return { code: 2, lines: [`harness genome: not a directory: ${dir}`] };
+    }
+    const report = buildGenomeReport(dir);
+    if (outPath) {
+        try {
+            writeFileSync(resolve(outPath), JSON.stringify(report.genome, null, 2) + '\n', 'utf-8');
+        }
+        catch (e) {
+            const err = { schema: 1, error: 'out-write-failed', detail: String(e), exitCode: 2 };
+            return { code: 2, lines: [bundle || json ? JSON.stringify(err, null, 2) : `harness genome: failed to write --out: ${String(e)}`] };
+        }
+    }
+    if (bundle) {
+        const sanitised = sanitiseValue({ ...report, exitCode: report.exitCode });
+        return { code: report.exitCode, lines: [JSON.stringify(sanitised, null, 2)] };
+    }
+    if (json) {
+        return { code: report.exitCode, lines: [JSON.stringify(report.genome, null, 2)] };
+    }
+    return { code: report.exitCode, lines: formatGenomeReport(report) };
+}
+//# sourceMappingURL=genome.js.map

package/dist/genome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genome.js","sourceRoot":"","sources":["../src/genome.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,gDAAgD;AAChD,EAAE;AACF,SAAS;AACT,oDAAoD;AACpD,qEAAqE;AACrE,oFAAoF;AACpF,mFAAmF;AACnF,EAAE;AACF,uBAAuB;AACvB,wEAAwE;AACxE,8CAA8C;AAC9C,2CAA2C;AAE3C,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAsC,MAAM,mBAAmB,CAAC;AAC/G,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,GAEjB,MAAM,qBAAqB,CAAC;AAyB7B,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACnC,CAAC;AACD,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,cAAsB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAC3F,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,oBAAoB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrD,yEAAyE;IACzE,gEAAgE;IAChE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAW;QACrB,SAAS,EAAE,gBAAgB,CAAC,OAAO,CAAC;QACpC,cAAc,EAAE,QAAQ;QACxB,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,GAAG,CAAC,OAAO;QACxB,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC;QACjC,iBAAiB,EAAE,MAAM,CAAC,OAAO,CAAC;KACnC,CAAC;IACF,IAAI,OAA2C,CAAC;IAChD,IAAI,QAAmB,CAAC;IACxB,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,SAAS,CAAC;QACpB,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;QAC1C,OAAO,GAAG,OAAO,CAAC;QAClB,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,YAAY,CAAC;QACvB,QAAQ,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AACnF,CAAC;AAED,8EAA8E;AAE9E,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,CAA0B;IAC7C,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,OAAO;YACV,OAAO,yDAAyD,CAAC;QACnE,KAAK,YAAY;YACf,OAAO,gEAAgE,CAAC;QAC1E,KAAK,SAAS;YACZ,OAAO,wDAAwD,CAAC;IACpE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAe;IAChD,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;IACtC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,kBAAkB;IAClB,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;IACxD,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IACzF,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC7F,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC5F,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,oBAAoB;IACpB,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,oBAAoB;IACpB,GAAG,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC9B,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClF,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,qBAAqB;IACrB,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/B,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACnE,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,wBAAwB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACzH,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,uBAAuB;IACvB,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACjC,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACrE,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtF,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,8BAA8B;IAC9B,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IACxC,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACrD,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,WAAW,gBAAgB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/F,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC1E,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,eAAe;IACf,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzB,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACrE,GAAG,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IACnE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEb,GAAG,CAAC,IAAI,CAAC,YAAY,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpE,GAAG,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAE9E,MAAM,SAAS,GAAG,yCAAyC,CAAC;AAE5D,SAAS,aAAa,CAAC,CAAU;IAC/B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAA4B,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,8EAA8E;AAE9E,SAAS,KAAK;IACZ,OAAO;QACL,iEAAiE;QACjE,EAAE;QACF,8DAA8D;QAC9D,oCAAoC;QACpC,EAAE;QACF,2DAA2D;QAC3D,4EAA4E;QAC5E,wEAAwE;KACzE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;YAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,CAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;gBAC3E,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC,EAAE,CAAC;YAC5G,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,KAAK,UAAU,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC9C,aAAa;QACf,CAAC;aAAM,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACxC,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QACrC,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,CAAU,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAChG,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,CAAC;QACpG,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAE,CAAC,CAAC;IAEpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACrD,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,CAAU,EAAE,WAAW,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;QAC5F,IAAI,MAAM,IAAI,IAAI;YAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9E,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,oCAAoC,GAAG,EAAE,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,EAAE,MAAM,EAAE,CAAU,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;YAC9F,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,0CAA0C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACrI,CAAC;IACH,CAAC;IAED,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,SAAS,GAAG,aAAa,CAAC,EAAE,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/dist/harness-bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=harness-bin.d.ts.map

package/dist/harness-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-bin.d.ts","sourceRoot":"","sources":["../src/harness-bin.ts"],"names":[],"mappings":""}

package/dist/harness-bin.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+// SPDX-License-Identifier: MIT
+//
+// `harness` binary entry point.
+import { dispatch } from './subcommands.js';
+const [, , subcommand = 'help', ...rest] = process.argv;
+dispatch(subcommand, rest).then(({ code, lines }) => {
+    // eslint-disable-next-line no-console
+    for (const l of lines)
+        console.log(l);
+    process.exit(code);
+}).catch(err => {
+    // eslint-disable-next-line no-console
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=harness-bin.js.map

package/dist/harness-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness-bin.js","sourceRoot":"","sources":["../src/harness-bin.ts"],"names":[],"mappings":";AACA,+BAA+B;AAC/B,EAAE;AACF,gCAAgC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,EAAE,AAAD,EAAG,UAAU,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;AAExD,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE;IAClD,sCAAsC;IACtC,KAAK,MAAM,CAAC,IAAI,KAAK;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;IACb,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+export declare const HOSTS: readonly ["claude-code", "codex", "pi-dev", "hermes", "openclaw", "rvm"];
+export type Host = (typeof HOSTS)[number];
+export declare const TEMPLATES: readonly ["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", "vertical:sales", "vertical:gaming", "vertical:repo-maintainer", "vertical:exotic"];
+export type TemplateId = (typeof TEMPLATES)[number];
+export interface CatalogEntry {
+    id: string;
+    category: string;
+    name: string;
+    domain: string;
+    description: string;
+    quickStart: string;
+    tags: string[];
+    generate: boolean;
+    agentCount: number;
+    skillCount: number;
+    commandCount: number;
+}
+/** Read the canonical template catalog shipped at templates/catalog.json. */
+export declare function loadCatalog(): CatalogEntry[];
+/** Render the catalog as a human-readable table for `--list`. */
+export declare function formatCatalog(entries: CatalogEntry[]): string[];
+export interface CliArgs {
+    name?: string;
+    template?: string;
+    templatePackage?: string;
+    hosts?: string[];
+    yes?: boolean;
+    force?: boolean;
+    description?: string;
+    fromExisting?: string;
+    list?: boolean;
+    wizard?: boolean;
+}
+export declare function parseArgs(argv: string[]): CliArgs;
+/**
+ * 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 declare function templateDir(id: string): string;
+export interface ScaffoldOptions {
+    name: string;
+    template: string;
+    host: Host;
+    description?: string;
+    targetDir: string;
+    force?: boolean;
+    generatorVersion: string;
+}
+export interface ScaffoldResult {
+    paths: string[];
+    manifestPath: string;
+    unresolved: string[];
+}
+/**
+ * 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 declare function scaffold(opts: ScaffoldOptions): Promise<ScaffoldResult>;
+/** Try to detect an existing ruflo project at the given path. */
+export declare function detectRufloProject(dir: string): {
+    found: boolean;
+    signals: string[];
+};
+export declare function main(argv: string[]): Promise<number>;
+export type { TemplateVars } from './renderer.js';
+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.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAqDA,eAAO,MAAM,KAAK,0EAA2E,CAAC;AAC9F,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1C,eAAO,MAAM,SAAS,kZAqBZ,CAAC;AACX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAS5C;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAa/D;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA+BjD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAoD7E;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAOA;AAyED,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4G1D;AAED,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}