@cairn-tool/cairn 2.0.0

package/dist/commands/agent-import.js

@@ -0,0 +1,212 @@
+import fs from "node:fs";
+import path from "node:path";
+import { diagnostic } from "../agent/types.js";
+import { resolveLayout } from "../agent/import/detect.js";
+import { normalizeTree } from "../agent/import/normalize.js";
+import { packageName, packageVersion } from "../version.js";
+import { writeArtifactsAtomically } from "../agent/writer.js";
+import { outputDecidedResult } from "./agent.js";
+/** File name of the migration report written at the bundle root. */
+export const IMPORT_REPORT = "import-report.json";
+const MERGE_STRATEGIES = ["refuse", "skip-existing", "overwrite", "native-only"];
+function walk(root) {
+    const files = [];
+    const visit = (current) => {
+        for (const entry of fs
+            .readdirSync(current, { withFileTypes: true })
+            .sort((a, b) => (a.name < b.name ? -1 : 1))) {
+            const full = path.join(current, entry.name);
+            if (entry.isSymbolicLink()) {
+                const real = fs.realpathSync(full);
+                const relative = path.relative(fs.realpathSync(root), real);
+                if (relative.startsWith("..") || path.isAbsolute(relative))
+                    throw new Error(`Symlink escapes the import source: ${full}`);
+            }
+            if (entry.isDirectory() || (entry.isSymbolicLink() && fs.statSync(full).isDirectory()))
+                visit(full);
+            else
+                files.push({
+                    path: path.relative(root, full),
+                    content: fs.readFileSync(full),
+                    mode: fs.statSync(full).mode & 0o777,
+                });
+        }
+    };
+    visit(root);
+    return files;
+}
+function isInside(parent, child) {
+    const relative = path.relative(parent, child);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+/**
+ * Real-paths a destination that does not exist yet.
+ *
+ * Comparing an unresolved path against a resolved source root would miss the
+ * containment violation entirely wherever a parent is a symlink — `/var` on
+ * macOS, for one.
+ */
+function resolveThroughExistingAncestors(candidate) {
+    let existing = candidate;
+    while (!fs.existsSync(existing) && existing !== path.dirname(existing))
+        existing = path.dirname(existing);
+    return path.resolve(fs.realpathSync(existing), path.relative(existing, candidate));
+}
+function nonempty(directory) {
+    if (!fs.existsSync(directory))
+        return false;
+    return !fs.statSync(directory).isDirectory() || fs.readdirSync(directory).length > 0;
+}
+function error(code, message, remediation) {
+    return {
+        ...diagnostic(code, message, "unsupported", remediation ? { remediation } : {}),
+        severity: "error",
+    };
+}
+/**
+ * Import's own pass/fail rule.
+ *
+ * The shared `hasFindings` treats any approximate mapping as blocking, which
+ * would make nearly every import exit 2 — approximations are the expected
+ * outcome of crossing from a native format back to a portable one. Only errors,
+ * and warnings under `--strict`, fail here. Same reasoning as `agent doctor`.
+ */
+export function importHasFindings(diagnostics, strict) {
+    return diagnostics.some((item) => item.severity === "error" || (strict && item.severity === "warning"));
+}
+function counts(provenance) {
+    const totals = {
+        portable: 0,
+        native: 0,
+        manifest: 0,
+        dropped: 0,
+    };
+    for (const entry of provenance)
+        totals[entry.layer] += 1;
+    return totals;
+}
+export async function agentImportAction(source, opts) {
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    if (!opts.output)
+        throw new Error("--output is required");
+    const merge = (opts.merge ?? "refuse");
+    if (!MERGE_STRATEGIES.includes(merge))
+        throw new Error(`Unknown --merge '${merge}'. Use one of: ${MERGE_STRATEGIES.join(", ")}.`);
+    const root = path.resolve(source);
+    if (!fs.existsSync(root) || !fs.statSync(root).isDirectory())
+        throw new Error(`Source is not a directory: ${source}`);
+    const output = path.resolve(opts.output);
+    if (isInside(fs.realpathSync(root), resolveThroughExistingAncestors(output)))
+        throw new Error("Output directory must not be inside the import source");
+    const files = walk(root);
+    const layout = resolveLayout(root, files, opts.from, opts.scope);
+    const bundleName = opts.bundleName ?? path.basename(root);
+    const result = normalizeTree(files, layout.target, layout.profile, bundleName, Boolean(opts.nativeOnly) || merge === "native-only");
+    const diagnostics = [...result.diagnostics];
+    // Every input file must appear in the report exactly once. Anything else
+    // means the importer silently lost a file.
+    const accounted = new Set(result.provenance.map((entry) => entry.source));
+    for (const file of files) {
+        const relative = file.path.split(path.sep).join("/");
+        if (!accounted.has(relative))
+            result.provenance.push({
+                source: relative,
+                destination: null,
+                layer: "dropped",
+                fidelity: "unsupported",
+                note: "not claimed by any importer",
+            });
+    }
+    result.provenance.sort((a, b) => (a.source < b.source ? -1 : 1));
+    let artifacts = result.artifacts;
+    if (merge === "native-only")
+        artifacts = artifacts.filter((artifact) => artifact.path.startsWith("native/"));
+    if (nonempty(output)) {
+        if (merge === "refuse")
+            diagnostics.push(error("AB236", `Destination is nonempty: ${output}`, `Choose a merge strategy: --merge ${MERGE_STRATEGIES.filter((s) => s !== "refuse").join(", ")}.`));
+        if (merge === "skip-existing") {
+            const kept = [];
+            for (const artifact of artifacts) {
+                if (fs.existsSync(path.join(output, artifact.path))) {
+                    const entry = result.provenance.find((item) => item.destination === artifact.path);
+                    if (entry)
+                        entry.note = "skipped; already present in the destination";
+                    continue;
+                }
+                kept.push(artifact);
+            }
+            artifacts = kept;
+        }
+        if (merge === "overwrite")
+            for (const artifact of artifacts)
+                if (fs.existsSync(path.join(output, artifact.path)))
+                    diagnostics.push(diagnostic("AB237", `Replaced existing file '${artifact.path}'`, "approximate", {
+                        path: artifact.path,
+                    }));
+    }
+    const report = {
+        from: {
+            target: layout.target,
+            profile: layout.profile,
+            requested: opts.from ?? "auto",
+            confidence: layout.confidence,
+        },
+        merge,
+        files: result.provenance,
+        counts: counts(result.provenance),
+    };
+    // No timestamp: the report must change only when the input or the generator
+    // does, so importing the same source twice stays byte-identical.
+    const reportArtifact = {
+        path: IMPORT_REPORT,
+        content: Buffer.from(JSON.stringify({ generator: { name: packageName, version: packageVersion }, ...report }, null, 2) + "\n"),
+        mode: 0o644,
+    };
+    const all = [...artifacts, reportArtifact];
+    const blocked = importHasFindings(diagnostics, Boolean(opts.strict));
+    const stale = opts.check ? !matchesOutput(output, all) : false;
+    const readOnly = Boolean(opts.dryRun) || Boolean(opts.check);
+    if (!readOnly && !blocked)
+        writeArtifactsAtomically(output, all, {
+            managedRoots: [],
+            looseFiles: all.map((artifact) => artifact.path),
+            force: true,
+        });
+    outputDecidedResult({
+        command: "import",
+        ok: !blocked && !stale,
+        source: root,
+        targets: [layout.target],
+        profiles: [layout.profile],
+        artifacts: all.map((artifact) => ({
+            path: artifact.path,
+            bytes: artifact.content.length,
+            mode: `0${artifact.mode.toString(8)}`,
+        })),
+        diagnostics,
+        import: report,
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    }, opts);
+}
+/**
+ * Compares a previously imported tree against what this run would produce.
+ *
+ * The report is compared by existence only, exactly as `diffOutput` treats
+ * `conversion-report.json`: it embeds the generator version, so byte-comparing
+ * it would report every tree as stale after any CLI upgrade.
+ */
+function matchesOutput(output, artifacts) {
+    for (const artifact of artifacts) {
+        const file = path.join(output, artifact.path);
+        if (!fs.existsSync(file) || !fs.statSync(file).isFile())
+            return false;
+        if (artifact.path === IMPORT_REPORT)
+            continue;
+        if (!fs.readFileSync(file).equals(artifact.content))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=agent-import.js.map

package/dist/commands/agent-import.js.map

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

package/dist/commands/agent-install.d.ts

@@ -0,0 +1,18 @@
+import type { AgentDiagnostic, AgentTarget } from "../agent/types.js";
+import type { AgentOptions } from "./agent.js";
+export interface AgentInstallOptions extends AgentOptions {
+    scope?: string;
+    into?: string;
+    link?: boolean;
+    register?: boolean;
+}
+/**
+ * Install's own pass/fail rule.
+ *
+ * Like package and doctor, this cannot use the shared `hasFindings`: a Codex
+ * bundle inherently carries approximate render diagnostics, which say nothing
+ * about whether the install landed. Notices (AB802, AB807) never fail.
+ */
+export declare function installHasFindings(diagnostics: AgentDiagnostic[], strict: boolean): boolean;
+export declare function requireInstallTarget(values: string[] | undefined): AgentTarget;
+export declare function agentInstallAction(source: string, opts: AgentInstallOptions): Promise<void>;

package/dist/commands/agent-install.js

@@ -0,0 +1,59 @@
+import { loadBundle } from "../agent/parser.js";
+import { commitInstall, installIsCurrent, planInstall, planToEntry, } from "../agent/install/index.js";
+import { outputDecidedResult, resolveTargets } from "./agent.js";
+/**
+ * Install's own pass/fail rule.
+ *
+ * Like package and doctor, this cannot use the shared `hasFindings`: a Codex
+ * bundle inherently carries approximate render diagnostics, which say nothing
+ * about whether the install landed. Notices (AB802, AB807) never fail.
+ */
+export function installHasFindings(diagnostics, strict) {
+    return diagnostics.some((item) => item.severity === "error" || (strict && item.severity === "warning"));
+}
+export function requireInstallTarget(values) {
+    const targets = resolveTargets(values, true);
+    if (targets.length !== 1)
+        throw new Error("Specify one target; install destinations differ per host.");
+    return targets[0];
+}
+function artifactInfo(plan) {
+    return plan.artifacts.map((artifact) => ({
+        path: artifact.path,
+        bytes: artifact.content.length,
+        mode: `0${(artifact.mode & 0o777).toString(8)}`,
+        ...(artifact.origin === "native" ? { origin: artifact.origin } : {}),
+    }));
+}
+export async function agentInstallAction(source, opts) {
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    const target = requireInstallTarget(opts.target);
+    const bundle = loadBundle(source);
+    const plan = planInstall(bundle, target, {
+        scope: opts.scope,
+        into: opts.into,
+        profile: opts.profile,
+        link: opts.link,
+        register: opts.register,
+        force: opts.force,
+    });
+    const blocked = installHasFindings(plan.diagnostics, Boolean(opts.strict));
+    const stale = Boolean(opts.check && plan.destination && !installIsCurrent(plan));
+    if (!opts.dryRun && !opts.check && !blocked && plan.destination)
+        commitInstall(plan);
+    const report = { installs: plan.destination ? [planToEntry(plan)] : [] };
+    outputDecidedResult({
+        command: "install",
+        ok: !blocked && !stale,
+        source: bundle.root,
+        targets: [target],
+        ...(plan.destination ? { profiles: [plan.profile] } : {}),
+        artifacts: artifactInfo(plan),
+        diagnostics: plan.diagnostics,
+        install: report,
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    }, opts);
+}
+//# sourceMappingURL=agent-install.js.map

package/dist/commands/agent-install.js.map

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

package/dist/commands/agent-installed.d.ts

@@ -0,0 +1,6 @@
+import type { AgentOptions } from "./agent.js";
+export interface AgentInstalledOptions extends AgentOptions {
+    scope?: string;
+    into?: string;
+}
+export declare function agentInstalledAction(opts: AgentInstalledOptions): Promise<void>;

package/dist/commands/agent-installed.js

@@ -0,0 +1,17 @@
+import { TARGETS } from "../agent/types.js";
+import { listInstalled } from "../agent/install/index.js";
+import { outputDecidedResult, resolveTargets } from "./agent.js";
+export async function agentInstalledAction(opts) {
+    const selected = resolveTargets(opts.target);
+    const targets = selected.length ? selected : [...TARGETS];
+    const installs = listInstalled(targets, { scope: opts.scope, into: opts.into });
+    outputDecidedResult({
+        command: "installed",
+        ok: true,
+        targets,
+        artifacts: [],
+        diagnostics: [],
+        install: { installs },
+    }, opts);
+}
+//# sourceMappingURL=agent-installed.js.map

package/dist/commands/agent-installed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-installed.js","sourceRoot":"","sources":["../../src/commands/agent-installed.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAOjE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAA2B;IACpE,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,mBAAmB,CACjB;QACE,OAAO,EAAE,WAAW;QACpB,EAAE,EAAE,IAAI;QACR,OAAO;QACP,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE,QAAQ,EAAE;KACA,EACvB,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/commands/agent-marketplace.d.ts

@@ -0,0 +1,11 @@
+import type { AgentOptions } from "./agent.js";
+export interface AgentMarketplaceOptions extends AgentOptions {
+    marketplace?: string;
+    archive?: boolean;
+    install?: boolean;
+    scope?: string;
+    into?: string;
+    link?: boolean;
+    register?: boolean;
+}
+export declare function agentMarketplaceAction(source: string, opts: AgentMarketplaceOptions): Promise<void>;

package/dist/commands/agent-marketplace.js

@@ -0,0 +1,178 @@
+import fs from "node:fs";
+import path from "node:path";
+import { loadSpec } from "../agent/marketplace/spec.js";
+import { COLLECTION_MODES, MARKETPLACE_REPORT, buildCollection, collectionHasFindings, } from "../agent/marketplace/index.js";
+import { INSTALL_CACHE, commitInstall, installIsCurrent, planCollectionInstall, planToEntry, resolveScope, } from "../agent/install/index.js";
+import { writeArtifactsAtomically } from "../agent/writer.js";
+import { packageName, packageVersion } from "../version.js";
+import { isInside } from "../config-schema.js";
+import { outputDecidedResult, resolveTargets } from "./agent.js";
+function resolveThroughExistingAncestors(candidate) {
+    let existing = candidate;
+    while (!fs.existsSync(existing) && existing !== path.dirname(existing))
+        existing = path.dirname(existing);
+    return path.resolve(fs.realpathSync(existing), path.relative(existing, candidate));
+}
+/**
+ * Compares a collection tree against what this run would produce.
+ *
+ * The report is compared by existence only — it embeds the generator version,
+ * so byte-comparing it would call every collection stale after a CLI upgrade.
+ * Same rule `agent package` applies to `package-report.json`.
+ */
+function matchesCollection(output, artifacts) {
+    for (const artifact of artifacts) {
+        const file = path.join(output, artifact.path);
+        if (!fs.existsSync(file) || !fs.statSync(file).isFile())
+            return false;
+        if (artifact.path === MARKETPLACE_REPORT)
+            continue;
+        if (!fs.readFileSync(file).equals(artifact.content))
+            return false;
+    }
+    return true;
+}
+/**
+ * One target's slice of a built collection, with the `<target>/` prefix
+ * stripped: a host marketplace directory holds the catalog and the plugin
+ * directories directly, not a target-named level above them.
+ */
+function forTarget(artifacts, target) {
+    const prefix = `${target}/`;
+    return artifacts
+        .filter((artifact) => artifact.path.startsWith(prefix))
+        .map((artifact) => ({ ...artifact, path: artifact.path.slice(prefix.length) }));
+}
+export async function agentMarketplaceAction(source, opts) {
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    if (!opts.output && !opts.install)
+        throw new Error("--output is required unless --install is given");
+    for (const [flag, given] of [
+        ["--scope", opts.scope !== undefined],
+        ["--into", opts.into !== undefined],
+        ["--link", Boolean(opts.link)],
+        ["--register", Boolean(opts.register)],
+    ])
+        if (given && !opts.install)
+            throw new Error(`${flag} applies only with --install`);
+    const mode = (opts.marketplace ?? "repo");
+    if (!COLLECTION_MODES.includes(mode))
+        throw new Error(`Unknown --marketplace '${mode}'. Use one of: ${COLLECTION_MODES.join(", ")}.`);
+    const { spec, diagnostics: specDiagnostics } = loadSpec(source);
+    // With --install and no --output the collection is never written as a tree;
+    // the install plan carries the artifacts straight to the host destination.
+    const output = opts.output ? path.resolve(opts.output) : undefined;
+    // Not the spec directory, which is normally the repository root and is exactly
+    // where a build output belongs. What must not be written into is a bundle,
+    // whose tree is a source the renderer reads.
+    if (output) {
+        const resolvedOutput = resolveThroughExistingAncestors(output);
+        const inside = spec.bundles.find((entry) => isInside(entry.root, resolvedOutput));
+        if (inside)
+            throw new Error(`Output directory must not be inside a bundle: ${inside.path}`);
+    }
+    // A spec that does not parse cannot be built from, so report and stop rather
+    // than rendering against half-validated data.
+    if (specDiagnostics.some((item) => item.severity === "error")) {
+        outputDecidedResult({
+            command: "marketplace",
+            ok: false,
+            source: spec.file,
+            targets: spec.targets,
+            artifacts: [],
+            diagnostics: specDiagnostics,
+        }, opts);
+        return;
+    }
+    // --target narrows the spec rather than replacing it: the spec is the record
+    // of what this collection is for, and a flag that could add to it would let
+    // CI publish a target the spec never declared.
+    const requested = opts.target?.length ? resolveTargets(opts.target, true) : spec.targets;
+    const unknown = requested.filter((target) => !spec.targets.includes(target));
+    if (unknown.length)
+        throw new Error(`--target ${unknown.join(", ")} is not declared by ${path.basename(spec.file)}`);
+    const targets = spec.targets.filter((target) => requested.includes(target));
+    const built = buildCollection(spec, targets, mode, { archive: opts.archive });
+    const diagnostics = [...specDiagnostics, ...built.diagnostics];
+    const all = [
+        ...built.artifacts,
+        {
+            path: MARKETPLACE_REPORT,
+            content: Buffer.from(JSON.stringify({ generator: { name: packageName, version: packageVersion }, ...built.report }, null, 2) + "\n"),
+            mode: 0o644,
+        },
+    ];
+    // Install plans are built before the pass/fail decision so their own findings
+    // — an occupied destination, a missing activation edit — can block the write
+    // rather than being discovered after it.
+    const plans = [];
+    if (opts.install) {
+        const scope = resolveScope(opts.scope, "user");
+        for (const target of targets) {
+            const entry = built.report.targets.find((item) => item.target === target);
+            if (!entry?.plugins.length)
+                continue;
+            const plan = planCollectionInstall({
+                name: spec.name,
+                version: spec.version,
+                target,
+                artifacts: forTarget(built.artifacts, target),
+                plugins: entry.plugins.map((plugin) => ({
+                    name: plugin.name,
+                    version: plugin.version,
+                })),
+            }, {
+                scope,
+                into: opts.into,
+                link: opts.link,
+                force: opts.force,
+                register: opts.register,
+                materializeInto: opts.link
+                    ? path.join(spec.root, INSTALL_CACHE, target, "plugin")
+                    : undefined,
+            });
+            plans.push(plan);
+            diagnostics.push(...plan.diagnostics);
+        }
+    }
+    const blocked = collectionHasFindings(diagnostics, Boolean(opts.strict));
+    const stale = opts.check
+        ? plans.length
+            ? !plans.every((plan) => installIsCurrent(plan))
+            : !matchesCollection(output, all)
+        : false;
+    const readOnly = Boolean(opts.dryRun) || Boolean(opts.check);
+    if (!readOnly && !blocked) {
+        if (output)
+            writeArtifactsAtomically(output, all, {
+                managedRoots: targets,
+                looseFiles: all
+                    .filter((artifact) => !targets.some((target) => artifact.path.startsWith(`${target}/`)))
+                    .map((artifact) => artifact.path),
+                force: Boolean(opts.force),
+            });
+        for (const plan of plans)
+            commitInstall(plan);
+    }
+    const installs = plans.map(planToEntry);
+    outputDecidedResult({
+        command: "marketplace",
+        ok: !blocked && !stale,
+        source: spec.file,
+        targets,
+        profiles: ["plugin"],
+        artifacts: all.map((artifact) => ({
+            path: artifact.path,
+            bytes: artifact.content.length,
+            mode: `0${artifact.mode.toString(8)}`,
+            ...(artifact.origin === "native" ? { origin: artifact.origin } : {}),
+        })),
+        diagnostics,
+        marketplace: built.report,
+        ...(opts.install ? { install: { installs } } : {}),
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    }, opts);
+}
+//# sourceMappingURL=agent-marketplace.js.map

package/dist/commands/agent-marketplace.js.map

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

package/dist/commands/agent-package.d.ts

@@ -0,0 +1,16 @@
+import type { AgentDiagnostic } from "../agent/types.js";
+import type { AgentOptions } from "./agent.js";
+export interface AgentPackageOptions extends AgentOptions {
+    marketplace?: string;
+    archive?: boolean;
+    fromDist?: string;
+}
+/**
+ * Package's own pass/fail rule.
+ *
+ * Like import and doctor, this cannot use the shared `hasFindings`: a codex
+ * bundle inherently carries approximate render diagnostics, which would fail
+ * every codex package regardless of its publish readiness.
+ */
+export declare function packageHasFindings(diagnostics: AgentDiagnostic[], strict: boolean): boolean;
+export declare function agentPackageAction(source: string, opts: AgentPackageOptions): Promise<void>;