metaharness 0.1.0

package/dist/diag.d.ts

@@ -0,0 +1,76 @@
+/** Mirror of subcommands.ts's exported shape — kept local to avoid a
+ *  cyclic import (subcommands.ts imports from diag.ts via diagCmd). */
+export type SubcommandResult = {
+    code: number;
+    lines: string[];
+};
+/** Compute the skew verdict between two semvers. */
+export type SkewVerdict = 'match' | 'patch-diff' | 'minor-diff' | 'major-diff' | 'unparseable';
+export declare function skewVerdict(manifestVer: string | undefined, localVer: string | undefined): SkewVerdict;
+export interface DiagReport {
+    dir: string;
+    surface: string | undefined;
+    manifestKernelVersion: string | undefined;
+    localKernelVersion: string | undefined;
+    verdict: SkewVerdict;
+    actionable: string | undefined;
+    manifestGeneratorVersion: string | undefined;
+    localGeneratorVersion: string | undefined;
+    generatorVerdict: SkewVerdict;
+}
+export declare function buildDiagReport(harnessDir: string): Promise<DiagReport>;
+/**
+ * Format a diag report for human reading. Returns the lines + an exit
+ * code suitable for the CLI: 0 on match/patch, 1 on minor/major, 2 if
+ * the manifest is missing entirely.
+ */
+export declare function formatDiagReport(report: DiagReport): SubcommandResult;
+/**
+ * Format a report as JSON for programmatic consumers. Includes the full
+ * report shape + the resolved exit code (delegated to formatDiagReport
+ * so the verdict-to-exit-code mapping has exactly ONE definition) so
+ * callers can gate on either the structured data or the exit code.
+ */
+export declare function formatDiagReportJson(report: DiagReport): SubcommandResult;
+/**
+ * iter 90 — support-bundle JSON. Single-command snapshot of every
+ * diagnostic surface a maintainer would need to triage an issue:
+ *
+ *   - The diag report (skew verdict + versions)
+ *   - The manifest contents (sanitised — vars stay since they're chosen
+ *     by the user, but anything starting with `secret_`/`token_`/`key_`
+ *     is replaced with "<redacted>" so users can paste this without
+ *     leaking credentials they typed into prompts)
+ *   - The harness's package.json name + version + @ruflo/* deps
+ *   - Node version, platform, arch (for cross-OS bug repro)
+ *   - Last 3 .harness/* file paths (presence/absence proves which
+ *     lifecycle steps the user has run)
+ *
+ * Users run `harness diag --bundle` and paste the output into a GitHub
+ * issue. Maintainers get every load-bearing fact in one block.
+ */
+export interface SupportBundle {
+    schema: 1;
+    generatedAt: string;
+    diag: DiagReport & {
+        exitCode: number;
+    };
+    harness: {
+        packageName: string | undefined;
+        packageVersion: string | undefined;
+        rufloDeps: Record<string, string>;
+    };
+    manifest: {
+        present: boolean;
+        content: unknown | undefined;
+    };
+    harnessFiles: string[];
+    env: {
+        nodeVersion: string;
+        platform: string;
+        arch: string;
+    };
+}
+export declare function buildSupportBundle(harnessDir: string): Promise<SupportBundle>;
+export declare function diagCmd(args: string[]): Promise<SubcommandResult>;
+//# sourceMappingURL=diag.d.ts.map

package/dist/diag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag.d.ts","sourceRoot":"","sources":["../src/diag.ts"],"names":[],"mappings":"AAuBA;uEACuE;AACvE,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAejE,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAE/F,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,CAStG;AA8DD,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,kBAAkB,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAO/B,wBAAwB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,qBAAqB,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,gBAAgB,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2C7E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAgErE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,gBAAgB,CAQzE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,CAAC,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;QACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnC,CAAC;IACF,QAAQ,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAA;KAAE,CAAC;IAC7D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,EAAE;QACH,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH;AAgBD,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA8DnF;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuBvE"}

package/dist/diag.js

@@ -0,0 +1,349 @@
+// SPDX-License-Identifier: MIT
+//
+// `harness diag` — single-question diagnostic: is the LOCAL @ruflo/kernel
+// compatible with the version this harness was scaffolded against?
+//
+// Surfaces:
+//   - manifest.meta.surface     (iter 56) — which surface produced it (cli/web-ui)
+//   - manifest.meta.kernel_version (iter 58) — the version the scaffold was built against
+//   - the locally-installed @ruflo/kernel version (resolved at runtime)
+//   - drift verdict and actionable next step
+//
+// Why split this out of `harness doctor`?
+//   doctor is the generic smoke check (does .harness/ exist? is the
+//   manifest hash intact?). diag is the ONE cross-machine question
+//   that almost every "support ticket" turns out to be — and the
+//   answer needs to be loud, single-line, and copy-pasteable so users
+//   can act on it without reading every doctor line.
+import { createRequire } from 'node:module';
+import { readFile } from 'node:fs/promises';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * Parse "X.Y.Z[-pre]" into a tuple. Returns null on unrecognised input
+ * (e.g. "git+ssh://..." or "*"). We only need the major/minor/patch ints
+ * for the skew verdict; pre-release suffixes are ignored.
+ */
+function parseSemver(v) {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
+    if (!m)
+        return null;
+    return { major: +m[1], minor: +m[2], patch: +m[3] };
+}
+export function skewVerdict(manifestVer, localVer) {
+    if (!manifestVer || !localVer)
+        return 'unparseable';
+    const m = parseSemver(manifestVer);
+    const l = parseSemver(localVer);
+    if (!m || !l)
+        return 'unparseable';
+    if (m.major !== l.major)
+        return 'major-diff';
+    if (m.minor !== l.minor)
+        return 'minor-diff';
+    if (m.patch !== l.patch)
+        return 'patch-diff';
+    return 'match';
+}
+/**
+ * Resolve the locally-installed @ruflo/kernel version. Uses createRequire
+ * so it follows real Node resolution from the harness's package.json. We
+ * never throw — a missing kernel is the WHOLE POINT of this diagnostic
+ * (it gets reported as such).
+ */
+function resolveLocalKernelVersion(harnessDir) {
+    try {
+        const require = createRequire(join(harnessDir, 'package.json'));
+        const pkgPath = require.resolve('@ruflo/kernel/package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        return typeof pkg.version === 'string' ? pkg.version : undefined;
+    }
+    catch {
+        // Fall back to the workspace's kernel package if running uninstalled
+        // (e.g. dev work inside the monorepo before publish).
+        const wsPath = resolve(__dirname, '..', '..', 'kernel-js', 'package.json');
+        if (existsSync(wsPath)) {
+            try {
+                const pkg = JSON.parse(readFileSync(wsPath, 'utf-8'));
+                return typeof pkg.version === 'string' ? pkg.version : undefined;
+            }
+            catch {
+                return undefined;
+            }
+        }
+        return undefined;
+    }
+}
+/**
+ * iter 71: resolve the version of create-agent-harness this process is
+ * running from. Used to compare against `manifest.generator`. Falls
+ * through the same 3-path lookup as the kernel resolver: workspace
+ * checkout, installed sibling, top-level node_modules.
+ */
+function resolveLocalGeneratorVersion() {
+    const candidates = [
+        // Workspace: packages/create-agent-harness/dist/ → ../package.json
+        resolve(__dirname, '..', 'package.json'),
+        // Installed: node_modules/openharness/package.json (post iter 108 rename)
+        resolve(__dirname, '..', '..', 'openharness', 'package.json'),
+        // Legacy: node_modules/create-agent-harness/package.json (pre-rename installs)
+        resolve(__dirname, '..', '..', 'create-agent-harness', 'package.json'),
+    ];
+    for (const p of candidates) {
+        try {
+            if (existsSync(p)) {
+                const pkg = JSON.parse(readFileSync(p, 'utf-8'));
+                // Accept either name — `create-agent-harness` is the legacy resolved-from-sibling
+                // case, `openharness` is the current publishable name (iter 108).
+                if ((pkg.name === 'openharness' || pkg.name === 'create-agent-harness') && typeof pkg.version === 'string') {
+                    return pkg.version;
+                }
+            }
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return undefined;
+}
+export async function buildDiagReport(harnessDir) {
+    const manifestPath = join(harnessDir, '.harness', 'manifest.json');
+    let surface;
+    let manifestKernelVersion;
+    let manifestGeneratorVersion;
+    if (existsSync(manifestPath)) {
+        try {
+            const m = JSON.parse(await readFile(manifestPath, 'utf-8'));
+            surface = m.meta?.surface;
+            manifestKernelVersion = m.meta?.kernel_version;
+            // iter 71: manifest.generator is the top-level field stamped by
+            // emptyManifest() — predates the meta block, present in every
+            // scaffold from iter 4 onward.
+            manifestGeneratorVersion = typeof m.generator === 'string' ? m.generator : undefined;
+        }
+        catch {
+            /* leave both undefined */
+        }
+    }
+    const localKernelVersion = resolveLocalKernelVersion(harnessDir);
+    const verdict = skewVerdict(manifestKernelVersion, localKernelVersion);
+    const localGeneratorVersion = resolveLocalGeneratorVersion();
+    const generatorVerdict = skewVerdict(manifestGeneratorVersion, localGeneratorVersion);
+    let actionable;
+    if (verdict === 'major-diff') {
+        actionable = `Run: npm install @ruflo/kernel@${manifestKernelVersion} (major skew — APIs may break)`;
+    }
+    else if (verdict === 'minor-diff') {
+        actionable = `Run: npm install @ruflo/kernel@${manifestKernelVersion} (minor skew — new features may be missing)`;
+    }
+    else if (verdict === 'patch-diff') {
+        actionable = `Optional: npm install @ruflo/kernel@${manifestKernelVersion} (patch skew — usually safe)`;
+    }
+    else if (verdict === 'unparseable' && manifestKernelVersion && !localKernelVersion) {
+        actionable = `Run: npm install @ruflo/kernel@${manifestKernelVersion} (kernel not installed locally)`;
+    }
+    return {
+        dir: harnessDir,
+        surface,
+        manifestKernelVersion,
+        localKernelVersion,
+        verdict,
+        actionable,
+        manifestGeneratorVersion,
+        localGeneratorVersion,
+        generatorVerdict,
+    };
+}
+/**
+ * Format a diag report for human reading. Returns the lines + an exit
+ * code suitable for the CLI: 0 on match/patch, 1 on minor/major, 2 if
+ * the manifest is missing entirely.
+ */
+export function formatDiagReport(report) {
+    const lines = [];
+    lines.push(`harness diag — checking ${report.dir}`);
+    lines.push('');
+    if (!report.manifestKernelVersion && !existsSync(join(report.dir, '.harness', 'manifest.json'))) {
+        lines.push('  FAIL no .harness/manifest.json found at this path');
+        lines.push('       (this directory is not a scaffolded harness — run harness diag from a harness root)');
+        return { code: 2, lines };
+    }
+    lines.push(`  surface:              ${report.surface ?? '(unknown — pre-iter-56 manifest)'}`);
+    lines.push(`  manifest kernel:      ${report.manifestKernelVersion ?? '(unset — pre-iter-58 manifest)'}`);
+    lines.push(`  installed kernel:     ${report.localKernelVersion ?? '(not installed)'}`);
+    lines.push(`  manifest generator:   ${report.manifestGeneratorVersion ?? '(unset)'}`);
+    lines.push(`  installed generator:  ${report.localGeneratorVersion ?? '(not installed)'}`);
+    lines.push('');
+    const tag = {
+        'match': 'PASS',
+        'patch-diff': 'WARN',
+        'minor-diff': 'WARN',
+        'major-diff': 'FAIL',
+        'unparseable': 'WARN',
+    };
+    const blurb = {
+        'match': 'kernel versions match exactly',
+        'patch-diff': 'patch-level skew (usually safe; may include bugfixes)',
+        'minor-diff': 'minor-level skew (new kernel features may be missing)',
+        'major-diff': 'MAJOR skew — APIs may have changed; expect breakage',
+        'unparseable': 'could not parse one or both kernel versions',
+    };
+    lines.push(`  ${tag[report.verdict]} ${blurb[report.verdict]}`);
+    // iter 71: generator-skew is informational — never fails. The
+    // generator can change without the harness becoming incompatible
+    // (templates evolve, but the *generated* harness is self-contained).
+    // Surfacing it just lets `harness upgrade` users predict whether
+    // they'll see new template files after re-run.
+    const genBlurb = {
+        'match': 'generator versions match exactly',
+        'patch-diff': 'patch-level generator skew (template fixes since this scaffold)',
+        'minor-diff': 'minor-level generator skew (new template features available)',
+        'major-diff': 'MAJOR generator skew (template may have moved — re-run `harness upgrade` to preview drift)',
+        'unparseable': 'generator version unknown',
+    };
+    const genTag = {
+        'match': 'PASS',
+        'patch-diff': 'INFO',
+        'minor-diff': 'INFO',
+        'major-diff': 'WARN',
+        'unparseable': 'INFO',
+    };
+    lines.push(`  ${genTag[report.generatorVerdict]} ${genBlurb[report.generatorVerdict]}`);
+    if (report.actionable) {
+        lines.push('');
+        lines.push(`  → ${report.actionable}`);
+    }
+    // Exit codes:
+    //   0 — match (always)
+    //   0 — patch-diff (informational)
+    //   1 — minor-diff or major-diff (action needed)
+    //   1 — unparseable when manifest version is set but local isn't
+    // generatorVerdict NEVER fails — it's informational only.
+    let code = 0;
+    if (report.verdict === 'minor-diff' || report.verdict === 'major-diff')
+        code = 1;
+    if (report.verdict === 'unparseable' && report.manifestKernelVersion && !report.localKernelVersion)
+        code = 1;
+    return { code, lines };
+}
+/**
+ * Format a report as JSON for programmatic consumers. Includes the full
+ * report shape + the resolved exit code (delegated to formatDiagReport
+ * so the verdict-to-exit-code mapping has exactly ONE definition) so
+ * callers can gate on either the structured data or the exit code.
+ */
+export function formatDiagReportJson(report) {
+    const human = formatDiagReport(report);
+    return {
+        code: human.code,
+        lines: [
+            JSON.stringify({ ...report, exitCode: human.code }, null, 2),
+        ],
+    };
+}
+const REDACT_KEY_RE = /^(secret|token|key|password|api[-_]?key)/i;
+function sanitiseManifest(m) {
+    if (m === null || typeof m !== 'object')
+        return m;
+    if (Array.isArray(m))
+        return m.map(sanitiseManifest);
+    const out = {};
+    for (const [k, v] of Object.entries(m)) {
+        if (REDACT_KEY_RE.test(k))
+            out[k] = '<redacted>';
+        else if (typeof v === 'string' && REDACT_KEY_RE.test(k))
+            out[k] = '<redacted>';
+        else
+            out[k] = sanitiseManifest(v);
+    }
+    return out;
+}
+export async function buildSupportBundle(harnessDir) {
+    const report = await buildDiagReport(harnessDir);
+    const human = formatDiagReport(report);
+    const exitCode = human.code;
+    let packageName;
+    let packageVersion;
+    const rufloDeps = {};
+    const pkgPath = join(harnessDir, 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            packageName = typeof pkg.name === 'string' ? pkg.name : undefined;
+            packageVersion = typeof pkg.version === 'string' ? pkg.version : undefined;
+            for (const block of [pkg.dependencies, pkg.devDependencies, pkg.peerDependencies]) {
+                if (block && typeof block === 'object') {
+                    for (const [name, version] of Object.entries(block)) {
+                        if (name.startsWith('@ruflo/') || name === 'create-agent-harness' || name === 'openharness') {
+                            rufloDeps[name] = version;
+                        }
+                    }
+                }
+            }
+        }
+        catch {
+            /* unreadable package.json — harnessDir not a real harness */
+        }
+    }
+    const manifestPath = join(harnessDir, '.harness', 'manifest.json');
+    let manifestContent = undefined;
+    if (existsSync(manifestPath)) {
+        try {
+            manifestContent = sanitiseManifest(JSON.parse(readFileSync(manifestPath, 'utf-8')));
+        }
+        catch {
+            manifestContent = '<unreadable>';
+        }
+    }
+    const harnessFiles = [];
+    if (existsSync(join(harnessDir, '.harness'))) {
+        try {
+            for (const ent of readdirSync(join(harnessDir, '.harness'))) {
+                harnessFiles.push(`.harness/${ent}`);
+            }
+        }
+        catch {
+            /* swallow — read failure isn't fatal for the bundle */
+        }
+    }
+    return {
+        schema: 1,
+        generatedAt: new Date().toISOString(),
+        diag: { ...report, exitCode },
+        harness: { packageName, packageVersion, rufloDeps },
+        manifest: { present: !!manifestContent, content: manifestContent },
+        harnessFiles,
+        env: {
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+        },
+    };
+}
+export async function diagCmd(args) {
+    // iter 73: --json emits machine-readable output. Useful for CI
+    // scripts that want to gate on the structured verdict rather than
+    // parsing the human text.
+    // iter 90: --bundle emits a complete support-bundle JSON with
+    // diag + manifest + ruflo deps + env. For "paste this into the
+    // issue" workflows.
+    const json = args.includes('--json');
+    const bundle = args.includes('--bundle');
+    const positional = args.filter(a => !a.startsWith('--'));
+    const dir = resolve(positional[0] ?? process.cwd());
+    if (bundle) {
+        const b = await buildSupportBundle(dir);
+        return {
+            // Exit code follows the diag verdict so CI scripts can still
+            // gate on the bundle output (you can `harness diag --bundle > b.json`
+            // and use `$?` to know whether to alert).
+            code: b.diag.exitCode,
+            lines: [JSON.stringify(b, null, 2)],
+        };
+    }
+    const report = await buildDiagReport(dir);
+    return json ? formatDiagReportJson(report) : formatDiagReport(report);
+}
+//# sourceMappingURL=diag.js.map

package/dist/diag.js.map

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

package/dist/eject.d.ts

@@ -0,0 +1,33 @@
+export interface EjectPlan {
+    /** Source ruflo project root. */
+    source: string;
+    /** New harness name (kebab-case). */
+    newName: string;
+    /** Files we'd copy + rewrite, relative to source. */
+    files: string[];
+    /** Files we'd skip on purpose (with reason). */
+    skipped: Array<{
+        path: string;
+        reason: string;
+    }>;
+}
+/**
+ * Plan an eject without performing the copy. Useful for previewing what
+ * would happen.
+ */
+export declare function planEject(source: string, newName: string): Promise<EjectPlan>;
+/**
+ * Rewrite content: every ruflo/claude-flow name reference becomes the new
+ * harness name. Skips ATTRIBUTION blocks (marked with HTML comments) so
+ * the user can keep "Powered by ruflo" if they want.
+ */
+export declare function rewriteContent(content: string, newName: string): string;
+/**
+ * Apply an eject plan. Copies each file with rewrite, then writes a
+ * .harness/manifest.json marking the harness as ejected from <source>.
+ */
+export declare function applyEject(plan: EjectPlan, targetDir: string, generatorVersion: string): Promise<{
+    written: string[];
+    manifestPath: string;
+}>;
+//# sourceMappingURL=eject.d.ts.map

package/dist/eject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eject.d.ts","sourceRoot":"","sources":["../src/eject.ts"],"names":[],"mappings":"AAkCA,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAqBD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAyBnF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,SAAS,EACf,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAsCtD"}

package/dist/eject.js

@@ -0,0 +1,147 @@
+// SPDX-License-Identifier: MIT
+//
+// `--from-existing` ruflo-eject pipeline.
+//
+// Lift an existing ruflo install (agents/skills/commands/CLAUDE.md/.claude/)
+// into a new, renamed harness so the user owns the future without losing
+// the customisations they've made.
+//
+// Eject rules (load-bearing — these define what "eject" MEANS):
+//   1. agents/  — copied verbatim, every `claude-flow` / `ruflo` reference
+//      in YAML frontmatter and prose rewritten to <new-name>
+//   2. skills/  — same treatment as agents/
+//   3. commands/ — same treatment, plus the binary name in code fences
+//      (`npx claude-flow` -> `npx <new-name>`)
+//   4. CLAUDE.md — the project's CLAUDE.md is copied. References to
+//      "ruflo" / "claude-flow" in prose are rewritten unless they appear
+//      inside ruflo-attribution sections the user explicitly marked
+//      (the "<!-- ruflo-attribution-block -->" comment markers).
+//   5. .claude/settings.json — copied, but the `mcpServers.claude-flow`
+//      key is renamed to the harness's name; permissions are merged.
+//   6. .claude-flow/ — NOT copied. This is ruflo's local state (memory,
+//      session logs). It's per-install; the user starts fresh.
+//   7. .mcp.json — copied with rewrite.
+//
+// Per ADR-016 (Migration for ruflo users), the eject is one-way: the
+// resulting harness is independent of ruflo and gets kernel updates via
+// @ruflo/kernel npm peer, not via re-init.
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join, posix, relative, sep } from 'node:path';
+const RUFLO_NAMES = ['ruflo', 'claude-flow', '@claude-flow/cli', '@claude-flow'];
+const COPY_DIRS = ['agents', 'skills', 'commands', '.claude'];
+const COPY_FILES = ['CLAUDE.md', '.mcp.json'];
+const SKIP_DIRS = ['.claude-flow', 'node_modules', '.git', 'dist', 'target', '.cache'];
+function toPosix(p) {
+    return p.split(sep).join(posix.sep);
+}
+async function walkDir(root, current, into) {
+    if (SKIP_DIRS.some(s => current.endsWith(sep + s) || current === root + sep + s))
+        return;
+    const entries = await readdir(current, { withFileTypes: true });
+    for (const e of entries) {
+        if (SKIP_DIRS.includes(e.name))
+            continue;
+        const full = join(current, e.name);
+        if (e.isDirectory())
+            await walkDir(root, full, into);
+        else if (e.isFile())
+            into.push(toPosix(relative(root, full)));
+    }
+}
+/**
+ * Plan an eject without performing the copy. Useful for previewing what
+ * would happen.
+ */
+export async function planEject(source, newName) {
+    if (!existsSync(source)) {
+        throw new Error(`source does not exist: ${source}`);
+    }
+    const files = [];
+    const skipped = [];
+    for (const d of COPY_DIRS) {
+        const dir = join(source, d);
+        if (existsSync(dir)) {
+            await walkDir(source, dir, files);
+        }
+    }
+    for (const f of COPY_FILES) {
+        if (existsSync(join(source, f)))
+            files.push(f);
+    }
+    // Honest reporting of what we left behind on purpose.
+    if (existsSync(join(source, '.claude-flow'))) {
+        skipped.push({ path: '.claude-flow/', reason: 'ruflo local state — eject starts fresh' });
+    }
+    if (existsSync(join(source, 'node_modules'))) {
+        skipped.push({ path: 'node_modules/', reason: 'will be reinstalled by the harness' });
+    }
+    return { source, newName, files, skipped };
+}
+/**
+ * Rewrite content: every ruflo/claude-flow name reference becomes the new
+ * harness name. Skips ATTRIBUTION blocks (marked with HTML comments) so
+ * the user can keep "Powered by ruflo" if they want.
+ */
+export function rewriteContent(content, newName) {
+    // Skip content between attribution markers entirely.
+    const attributionRe = /<!--\s*ruflo-attribution-block\s*-->[\s\S]*?<!--\s*\/ruflo-attribution-block\s*-->/gi;
+    const placeholder = '\x00ATTR\x00';
+    const blocks = [];
+    const stashed = content.replace(attributionRe, m => {
+        blocks.push(m);
+        return placeholder;
+    });
+    let out = stashed;
+    for (const ruflo of RUFLO_NAMES) {
+        // Word-boundary-aware replace. \b doesn't recognise @, so we anchor with
+        // lookbehind on a non-word boundary or string start.
+        const escaped = ruflo.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const re = new RegExp(`(?<![\\w@/-])${escaped}(?![\\w/-])`, 'g');
+        out = out.replace(re, newName);
+    }
+    // Restore attribution blocks unchanged.
+    let i = 0;
+    out = out.replace(new RegExp(placeholder, 'g'), () => blocks[i++] ?? '');
+    return out;
+}
+/**
+ * Apply an eject plan. Copies each file with rewrite, then writes a
+ * .harness/manifest.json marking the harness as ejected from <source>.
+ */
+export async function applyEject(plan, targetDir, generatorVersion) {
+    if (existsSync(targetDir)) {
+        throw new Error(`target exists: ${targetDir} (pass --force or pick a new dir)`);
+    }
+    await mkdir(targetDir, { recursive: true });
+    const written = [];
+    for (const rel of plan.files) {
+        const src = join(plan.source, ...rel.split('/'));
+        const dst = join(targetDir, ...rel.split('/'));
+        await mkdir(dirname(dst), { recursive: true });
+        const raw = await readFile(src, 'utf-8');
+        const out = rewriteContent(raw, plan.newName);
+        await writeFile(dst, out, 'utf-8');
+        written.push(rel);
+    }
+    // Manifest marks the eject so future `harness upgrade` knows this is a
+    // one-way independent harness, not a generated-from-template install.
+    const manifest = {
+        schema: 1,
+        generator: generatorVersion,
+        template: 'eject-from-ruflo',
+        template_version: '0.0.0',
+        vars: { name: plan.newName },
+        hosts: ['claude-code'],
+        ejected_from: plan.source,
+        generated_at: new Date().toISOString(),
+        files: {},
+        skipped_on_eject: plan.skipped,
+    };
+    const manifestPath = join(targetDir, '.harness', 'manifest.json');
+    await mkdir(dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    written.push('.harness/manifest.json');
+    return { written, manifestPath };
+}
+//# sourceMappingURL=eject.js.map

package/dist/eject.js.map

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