@cairn-tool/cairn 2.0.0

package/dist/commands/agent-package.js

@@ -0,0 +1,159 @@
+import fs from "node:fs";
+import path from "node:path";
+import { diagnostic } from "../agent/types.js";
+import { loadBundle } from "../agent/parser.js";
+import { renderBundle } from "../agent/render.js";
+import { diffOutput, outputMatches } from "../agent/output.js";
+import { PACKAGE_REPORT, buildArchives, buildCatalogs, buildChecksums, buildSbom, checkAssets, checkCaseCollisions, checkExecutables, checkPinning, } from "../agent/package/index.js";
+import { TarPathTooLongError } from "../agent/package/tar.js";
+import { packageName, packageVersion } from "../version.js";
+import { writeArtifactsAtomically } from "../agent/writer.js";
+import { outputDecidedResult, profiles, resolveTargets } from "./agent.js";
+const MODES = ["repo", "local", "none"];
+function isInside(parent, child) {
+    const relative = path.relative(parent, child);
+    return relative === "" || (!relative.startsWith("..") && !path.isAbsolute(relative));
+}
+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));
+}
+/**
+ * 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 function packageHasFindings(diagnostics, strict) {
+    return diagnostics.some((item) => item.severity === "error" || (strict && item.severity === "warning"));
+}
+export async function agentPackageAction(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 targets = resolveTargets(opts.target, true);
+    const selectedProfiles = profiles(opts.profile);
+    const mode = (opts.marketplace ?? "repo");
+    if (!MODES.includes(mode))
+        throw new Error(`Unknown --marketplace '${mode}'. Use one of: ${MODES.join(", ")}.`);
+    const bundle = loadBundle(source);
+    const output = path.resolve(opts.output);
+    if (isInside(fs.realpathSync(bundle.root), resolveThroughExistingAncestors(output)))
+        throw new Error("Output directory must not be inside the bundle");
+    // Rendering here rather than trusting an existing tree means the catalog and
+    // checksums are provably derived from the source of truth. `convert` stays a
+    // pure compiler; packaging adds no rendering logic of its own.
+    const rendered = renderBundle(bundle, targets, selectedProfiles);
+    const diagnostics = [...rendered.diagnostics];
+    if (opts.fromDist) {
+        // Verifying an existing tree is a separate question from building one: it
+        // asks whether CI packaged what this bundle actually produces.
+        const dist = path.resolve(opts.fromDist);
+        if (!fs.existsSync(dist))
+            throw new Error(`--from-dist directory does not exist: ${dist}`);
+        if (!outputMatches(diffOutput(dist, rendered.artifacts, targets, selectedProfiles)))
+            diagnostics.push({
+                ...diagnostic("AB508", `The tree at ${dist} is not what this bundle produces`, "unsupported", { remediation: "Re-run agent convert, or package without --from-dist." }),
+                severity: "error",
+            });
+    }
+    const catalogs = buildCatalogs(bundle, targets, selectedProfiles, mode);
+    diagnostics.push(...catalogs.diagnostics);
+    const payload = [...rendered.artifacts, ...catalogs.artifacts].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+    diagnostics.push(...checkAssets(bundle, targets, payload), ...checkExecutables(payload), ...checkCaseCollisions(payload), ...checkPinning(bundle));
+    let archives = [];
+    const extra = [];
+    if (opts.archive) {
+        try {
+            const built = buildArchives(bundle, payload, targets, selectedProfiles);
+            extra.push(...built.artifacts);
+            archives = built.archives;
+        }
+        catch (cause) {
+            if (!(cause instanceof TarPathTooLongError))
+                throw cause;
+            diagnostics.push({
+                ...diagnostic("AB509", cause.message, "unsupported", {
+                    path: cause.path,
+                    remediation: "Shorten the path; ustar headers cannot express it.",
+                }),
+                severity: "error",
+            });
+        }
+    }
+    const withArchives = [...payload, ...extra];
+    const checksums = buildChecksums(withArchives);
+    const sbom = buildSbom(bundle, withArchives);
+    const report = {
+        catalogs: catalogs.entries,
+        archives,
+        checksums: checksums.path,
+        sbom: sbom.path,
+        checks: {
+            failed: diagnostics.filter((item) => item.severity === "error").length,
+            passed: diagnostics.filter((item) => item.severity !== "error").length,
+        },
+    };
+    const all = [
+        ...withArchives,
+        checksums,
+        sbom,
+        {
+            path: PACKAGE_REPORT,
+            content: Buffer.from(JSON.stringify({ generator: { name: packageName, version: packageVersion }, ...report }, null, 2) + "\n"),
+            mode: 0o644,
+        },
+    ];
+    const blocked = packageHasFindings(diagnostics, Boolean(opts.strict));
+    const stale = opts.check ? !matchesPackage(output, all) : false;
+    const readOnly = Boolean(opts.dryRun) || Boolean(opts.check);
+    if (!readOnly && !blocked)
+        writeArtifactsAtomically(output, all, {
+            managedRoots: targets.flatMap((target) => selectedProfiles.map((profile) => path.join(target, profile))),
+            looseFiles: all
+                .filter((artifact) => !/^[^/]+\/(plugin|project)\//.test(artifact.path))
+                .map((artifact) => artifact.path),
+            force: Boolean(opts.force),
+        });
+    outputDecidedResult({
+        command: "package",
+        ok: !blocked && !stale,
+        source: bundle.root,
+        targets,
+        profiles: selectedProfiles,
+        artifacts: all.map((artifact) => ({
+            path: artifact.path,
+            bytes: artifact.content.length,
+            mode: `0${artifact.mode.toString(8)}`,
+            ...(artifact.origin === "native" ? { origin: artifact.origin } : {}),
+        })),
+        diagnostics,
+        package: report,
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    }, opts);
+}
+/**
+ * Compares a package 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 package stale after a CLI upgrade.
+ * Same rule `diffOutput` applies to `conversion-report.json`.
+ */
+function matchesPackage(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 === PACKAGE_REPORT)
+            continue;
+        if (!fs.readFileSync(file).equals(artifact.content))
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=agent-package.js.map

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

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

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

@@ -0,0 +1,17 @@
+import type { AgentOptions } from "./agent.js";
+export interface AgentInitOptions extends AgentOptions {
+    description?: string;
+    bundleVersion?: string;
+    license?: string;
+    component?: string[];
+    overlays?: boolean;
+}
+export interface AgentAddOptions extends AgentOptions {
+    description?: string;
+    path?: string;
+    activation?: string;
+    glob?: string[];
+    command?: string;
+}
+export declare function agentInitAction(name: string, opts: AgentInitOptions): Promise<void>;
+export declare function agentAddAction(kind: string, name: string, source: string | undefined, opts: AgentAddOptions): Promise<void>;

package/dist/commands/agent-scaffold.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+import { TARGETS, diagnostic } from "../agent/types.js";
+import { COMPONENT_KINDS, DEFAULT_ROOTS, applyManifestEdits, scaffoldBundle, scaffoldComponent, sortArtifacts, } from "../agent/scaffold.js";
+import { PORTABLE_HOOK_EVENTS } from "../agent/targets/schema.js";
+import { writeArtifactsAtomically } from "../agent/writer.js";
+import { outputDecidedResult, profiles, resolveTargets } from "./agent.js";
+const NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+function error(code, message, remediation) {
+    return {
+        ...diagnostic(code, message, "unsupported", remediation ? { remediation } : {}),
+        severity: "error",
+    };
+}
+function requireName(value, label) {
+    if (!NAME.test(value))
+        throw new Error(`Invalid ${label} '${value}': use lowercase kebab-case, e.g. my-${label}`);
+}
+/**
+ * Compares planned artifacts against what is already on disk.
+ *
+ * `create` and `update` are both writes; the distinction exists so `--check`
+ * and a JSON plan can say which files already matched.
+ */
+function planFor(root, artifacts, kind) {
+    const operations = artifacts.map((artifact) => {
+        const destination = path.join(root, artifact.path);
+        const exists = fs.existsSync(destination) && fs.statSync(destination).isFile();
+        const identical = exists && fs.readFileSync(destination).equals(artifact.content);
+        return {
+            action: identical ? "skip" : exists ? "update" : "create",
+            path: artifact.path,
+            kind: kind(artifact.path),
+            bytes: artifact.content.length,
+            mode: `0${artifact.mode.toString(8)}`,
+            ...(identical ? { reason: "already matches the scaffold" } : {}),
+        };
+    });
+    return { root, operations };
+}
+function willChange(plan) {
+    return plan.operations.some((operation) => operation.action !== "skip");
+}
+function kindOf(relative) {
+    if (relative === "agent-bundle.yaml")
+        return "manifest";
+    const root = relative.split("/")[0];
+    const match = COMPONENT_KINDS.find((kind) => DEFAULT_ROOTS[kind] === root);
+    return match ?? "asset";
+}
+/** Shared tail: emit the plan, write unless read-only, and decide the exit status. */
+function finish(command, root, artifacts, plan, diagnostics, opts, managed) {
+    const readOnly = Boolean(opts.dryRun) || Boolean(opts.check);
+    const stale = willChange(plan);
+    const blocked = diagnostics.some((item) => item.severity === "error");
+    if (!readOnly && !blocked)
+        writeArtifactsAtomically(root, artifacts, { ...managed, force: true });
+    const result = {
+        command,
+        // `--check` reports drift, so a plan that would change something fails it.
+        // Without `--check` a pending change is the normal case, not a finding.
+        ok: !blocked && !(opts.check && stale),
+        source: root,
+        targets: [],
+        artifacts: artifacts.map((artifact) => ({
+            path: artifact.path,
+            bytes: artifact.content.length,
+            mode: `0${artifact.mode.toString(8)}`,
+        })),
+        diagnostics,
+        plan,
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    };
+    outputDecidedResult(result, opts);
+}
+export async function agentInitAction(name, opts) {
+    requireName(name, "bundle name");
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    const output = path.resolve(opts.output ?? `./${name}`);
+    const components = parseComponents(opts.component);
+    const selected = resolveTargets(opts.target);
+    const targets = selected.length ? selected : [...TARGETS];
+    // `--profile` is accepted for symmetry with the other agent commands and is
+    // validated here even though a scaffold has no per-profile content yet.
+    profiles(opts.profile);
+    const diagnostics = [];
+    if (!opts.dryRun && !opts.check && nonempty(output) && !opts.force)
+        diagnostics.push(error("AB200", `Destination is nonempty: ${output}`, "Pass --force to scaffold into it anyway."));
+    const { artifacts } = scaffoldBundle({
+        name,
+        version: opts.bundleVersion ?? "0.1.0",
+        description: opts.description ?? `${name} agent bundle`,
+        license: opts.license ?? "MIT",
+        components,
+        targets,
+        overlays: Boolean(opts.overlays),
+    });
+    const plan = planFor(output, artifacts, kindOf);
+    // `init` creates the bundle, so it owns the whole root — with --force that
+    // means replacing whatever was there, the same meaning --force has elsewhere.
+    finish("init", output, artifacts, plan, diagnostics, opts, { managedRoots: ["."] });
+}
+function parseComponents(values) {
+    const raw = values ?? [];
+    if (!raw.length)
+        return ["skill"];
+    if (raw.includes("none"))
+        return [];
+    const unknown = raw.filter((value) => !COMPONENT_KINDS.includes(value));
+    if (unknown.length)
+        throw new Error(`Unknown component kind(s): ${unknown.join(", ")}. Use one of: ${COMPONENT_KINDS.join(", ")}, none.`);
+    return [...new Set(raw)];
+}
+function nonempty(directory) {
+    if (!fs.existsSync(directory))
+        return false;
+    return !fs.statSync(directory).isDirectory() || fs.readdirSync(directory).length > 0;
+}
+export async function agentAddAction(kind, name, source, opts) {
+    if (!COMPONENT_KINDS.includes(kind))
+        throw new Error(`Unknown component kind '${kind}'. Use one of: ${COMPONENT_KINDS.join(", ")}.`);
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    const componentKind = kind;
+    const root = path.resolve(source ?? ".");
+    const manifestPath = path.join(root, "agent-bundle.yaml");
+    if (!fs.existsSync(manifestPath))
+        throw new Error(`No agent-bundle.yaml found in ${root}. Run 'cairn agent init' first.`);
+    const diagnostics = [];
+    // A hook is named by its event, not freely, so it is validated against the
+    // portable event list rather than the kebab-case component rule.
+    if (componentKind === "hook") {
+        if (!PORTABLE_HOOK_EVENTS.includes(name))
+            diagnostics.push(error("AB202", `'${name}' is not a portable hook event`, `Use one of: ${PORTABLE_HOOK_EVENTS.join(", ")}.`));
+    }
+    else
+        requireName(name, "component name");
+    const overlayTarget = resolveTargets(opts.target);
+    if (componentKind === "overlay" && overlayTarget.length !== 1)
+        throw new Error("agent add overlay requires exactly one --target");
+    const spec = {
+        kind: componentKind,
+        name,
+        description: opts.description ?? `${name} ${componentKind}`,
+        root: opts.path,
+        activation: opts.activation ?? "always",
+        globs: opts.glob ?? [],
+        command: opts.command,
+        target: overlayTarget[0],
+        profile: opts.profile === "project" ? "project" : "plugin",
+    };
+    const { artifacts, edits } = scaffoldComponent(spec);
+    for (const artifact of artifacts) {
+        const destination = path.join(root, artifact.path);
+        if (fs.existsSync(destination) && !opts.force && !opts.dryRun && !opts.check)
+            diagnostics.push(error("AB201", `Component already exists: ${artifact.path}`, "Pass --force to replace it, or choose another name."));
+    }
+    const planned = [...artifacts];
+    if (edits.length) {
+        const applied = applyManifestEdits(fs.readFileSync(manifestPath, "utf8"), edits);
+        if (applied.changed) {
+            planned.push({ path: "agent-bundle.yaml", content: applied.content, mode: 0o644 });
+            if (applied.reformatted)
+                diagnostics.push(diagnostic("AB203", "agent-bundle.yaml will be reformatted by the manifest edit", "exact", {
+                    path: manifestPath,
+                    remediation: "Incidental whitespace is normalized; comments and key order are kept.",
+                }));
+        }
+    }
+    const sorted = sortArtifacts(planned);
+    const plan = planFor(root, sorted, kindOf);
+    // `agent add` writes into an existing bundle, so it owns individual files
+    // rather than any directory — a managed root would delete their siblings.
+    finish("add", root, sorted, plan, diagnostics, opts, {
+        managedRoots: [],
+        looseFiles: sorted.map((artifact) => artifact.path),
+    });
+}
+//# sourceMappingURL=agent-scaffold.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { AgentOptions } from "./agent.js";
+export type AgentSpecsOptions = Pick<AgentOptions, "target" | "format">;
+/**
+ * Publishes the versioned target conformance profiles. This is the machine
+ * readable form of the compatibility information `agent compat` summarizes.
+ */
+export declare function agentSpecsAction(opts: AgentSpecsOptions): Promise<void>;

package/dist/commands/agent-specs.js

@@ -0,0 +1,20 @@
+import { TARGETS } from "../agent/types.js";
+import { specsPayload } from "../agent/targets/index.js";
+import { outputResult, resolveTargets } from "./agent.js";
+/**
+ * Publishes the versioned target conformance profiles. This is the machine
+ * readable form of the compatibility information `agent compat` summarizes.
+ */
+export async function agentSpecsAction(opts) {
+    const selected = resolveTargets(opts.target);
+    const targets = selected.length ? selected : [...TARGETS];
+    outputResult({
+        command: "specs",
+        ok: true,
+        targets,
+        artifacts: [],
+        diagnostics: [],
+        specs: specsPayload(targets),
+    }, opts);
+}
+//# sourceMappingURL=agent-specs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-specs.js","sourceRoot":"","sources":["../../src/commands/agent-specs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAI1D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB;IAC5D,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,YAAY,CACV;QACE,OAAO,EAAE,OAAO;QAChB,EAAE,EAAE,IAAI;QACR,OAAO;QACP,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC;KAC7B,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { AgentDiagnostic } from "../agent/types.js";
+import type { AgentOptions } from "./agent.js";
+export interface AgentTestOptions extends AgentOptions {
+    tests?: string;
+    case?: string[];
+}
+/**
+ * Test's own pass/fail rule.
+ *
+ * Like doctor, audit, import, upgrade, and package, this cannot use the shared
+ * `hasFindings`, which fails on any approximate mapping — every Codex bundle
+ * carries those, and they say nothing about whether an expectation held.
+ *
+ * Unlike audit it needs no per-code split: an unmet expectation is already an
+ * error, so severity alone separates "a test failed" from "the render was
+ * lossy". The one warning this command mints itself, `AB701`, is deliberately
+ * non-blocking by default and blocking under `--strict`, which is how CI asks
+ * "and there were tests, right?".
+ */
+export declare function testHasFindings(diagnostics: AgentDiagnostic[], strict: boolean): boolean;
+export declare function agentTestAction(source: string, opts: AgentTestOptions): Promise<void>;

package/dist/commands/agent-test.js

@@ -0,0 +1,50 @@
+import { loadBundle } from "../agent/parser.js";
+import { runTests } from "../agent/test/index.js";
+import { outputDecidedResult, profiles, resolveTargets } from "./agent.js";
+/**
+ * Test's own pass/fail rule.
+ *
+ * Like doctor, audit, import, upgrade, and package, this cannot use the shared
+ * `hasFindings`, which fails on any approximate mapping — every Codex bundle
+ * carries those, and they say nothing about whether an expectation held.
+ *
+ * Unlike audit it needs no per-code split: an unmet expectation is already an
+ * error, so severity alone separates "a test failed" from "the render was
+ * lossy". The one warning this command mints itself, `AB701`, is deliberately
+ * non-blocking by default and blocking under `--strict`, which is how CI asks
+ * "and there were tests, right?".
+ */
+export function testHasFindings(diagnostics, strict) {
+    return diagnostics.some((item) => item.severity === "error" || (strict && item.severity === "warning"));
+}
+export async function agentTestAction(source, opts) {
+    const targets = resolveTargets(opts.target);
+    const selectedProfiles = profiles(opts.profile);
+    const bundle = loadBundle(source);
+    const { report, diagnostics, forwarded } = runTests(bundle, {
+        tests: opts.tests,
+        targets,
+        profiles: selectedProfiles,
+        cases: opts.case ?? [],
+    });
+    // Bundle diagnostics lead, as in audit; `forwarded` already repeats them for
+    // every tree that rendered, and the same rule `renderBundle` applies decides
+    // the rest: an identical finding reached from two directions is one finding.
+    const unique = [
+        ...new Map([...bundle.diagnostics, ...forwarded, ...diagnostics].map((item) => [
+            JSON.stringify(item),
+            item,
+        ])).values(),
+    ];
+    outputDecidedResult({
+        command: "test",
+        ok: !testHasFindings(unique, Boolean(opts.strict)),
+        source: bundle.root,
+        targets,
+        profiles: selectedProfiles,
+        artifacts: [],
+        diagnostics: unique,
+        test: report,
+    }, opts);
+}
+//# sourceMappingURL=agent-test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-test.js","sourceRoot":"","sources":["../../src/commands/agent-test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAO3E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,WAA8B,EAAE,MAAe;IAC7E,OAAO,WAAW,CAAC,IAAI,CACrB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAC/E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAc,EAAE,IAAsB;IAC1E,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE;QAC1D,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO;QACP,QAAQ,EAAE,gBAAgB;QAC1B,KAAK,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;KACvB,CAAC,CAAC;IAEH,6EAA6E;IAC7E,6EAA6E;IAC7E,6EAA6E;IAC7E,MAAM,MAAM,GAAG;QACb,GAAG,IAAI,GAAG,CACR,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAClE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YACpB,IAAI;SACL,CAAC,CACH,CAAC,MAAM,EAAE;KACX,CAAC;IAEF,mBAAmB,CACjB;QACE,OAAO,EAAE,MAAM;QACf,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,OAAO;QACP,QAAQ,EAAE,gBAAgB;QAC1B,SAAS,EAAE,EAAE;QACb,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,MAAM;KACS,EACvB,IAAI,CACL,CAAC;AACJ,CAAC"}

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

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

package/dist/commands/agent-uninstall.js

@@ -0,0 +1,45 @@
+import { commitUninstall, missingInstallDiagnostic, planUninstall, } from "../agent/install/index.js";
+import { outputDecidedResult } from "./agent.js";
+import { installHasFindings, requireInstallTarget } from "./agent-install.js";
+export async function agentUninstallAction(name, opts) {
+    if (opts.check && opts.dryRun)
+        throw new Error("--check and --dry-run cannot be used together");
+    const target = requireInstallTarget(opts.target);
+    const plan = planUninstall(name, target, { scope: opts.scope, into: opts.into });
+    if (plan.missing && !opts.check)
+        plan.diagnostics.push(missingInstallDiagnostic(name, target, plan.destination));
+    const blocked = installHasFindings(plan.diagnostics, Boolean(opts.strict));
+    const stale = Boolean(opts.check && plan.manifest);
+    if (!opts.dryRun && !opts.check && !blocked)
+        commitUninstall(plan);
+    const entry = plan.manifest
+        ? {
+            name: plan.manifest.bundle.name,
+            version: plan.manifest.bundle.version,
+            target: plan.manifest.target,
+            profile: plan.manifest.profile,
+            scope: plan.manifest.scope,
+            layout: plan.manifest.layout,
+            mode: plan.manifest.mode,
+            destination: plan.destination,
+            registered: Boolean(plan.manifest.registration),
+            files: plan.manifest.files.length,
+        }
+        : null;
+    outputDecidedResult({
+        command: "uninstall",
+        ok: !blocked && !stale,
+        targets: [target],
+        ...(plan.manifest ? { profiles: [plan.manifest.profile] } : {}),
+        artifacts: (plan.manifest?.files ?? []).map((file) => ({
+            path: file.path,
+            bytes: 0,
+            mode: file.mode,
+        })),
+        diagnostics: plan.diagnostics,
+        install: { installs: entry ? [entry] : [] },
+        ...(opts.dryRun ? { dryRun: true } : {}),
+        ...(opts.check ? { check: true, stale } : {}),
+    }, opts);
+}
+//# sourceMappingURL=agent-uninstall.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { AgentOptions } from "./agent.js";
+export interface AgentUpgradeOptions extends AgentOptions {
+    toSchema?: string;
+}
+export declare function agentUpgradeAction(source: string, opts: AgentUpgradeOptions): Promise<void>;