@openrig/cli 0.6.5 → 0.6.7

package/dist/commands/bootstrap.js

@@ -3,6 +3,7 @@ import { Command } from "commander";
 import { DaemonClient } from "../client.js";
 import { getDaemonStatus, getDaemonUrl, daemonStatusGuard } from "../daemon-lifecycle.js";
 import { realDeps } from "./daemon.js";
+import { bundleRoutingSummary, getCliVersion } from "./bundle.js";
 const LONG_RUNNING_BOOTSTRAP_TIMEOUT_MS = 120_000;
 function logStageDetailErrors(data) {
     const stages = data["stages"] ?? [];
@@ -22,7 +23,7 @@ function logStageDetailErrors(data) {
     }
 }
 export function bootstrapCommand(depsOverride) {
-    const cmd = new Command("bootstrap").description("Bootstrap a rig from a spec file");
+    const cmd = new Command("bootstrap").description("Bootstrap a rig from a spec file or bundle");
     const getDeps = () => depsOverride ?? { lifecycleDeps: realDeps(), clientFactory: (url) => new DaemonClient(url) };
     async function getClient(deps) {
         const status = await getDaemonStatus(deps.lifecycleDeps);
@@ -31,10 +32,13 @@ export function bootstrapCommand(depsOverride) {
         return deps.clientFactory(getDaemonUrl(status));
     }
     cmd
-        .argument("<spec>", "Path to rig spec YAML file")
+        .argument("<spec>", "Path to rig spec YAML file or .rigbundle archive")
         .option("--plan", "Plan mode — show reviewed plan without executing")
         .option("--yes", "Auto-approve trusted deterministic actions")
         .option("--cwd <path>", "Override launch working directory for all members for this run only")
+        .option("--target <path>", "Bundle install directory (defaults to current directory)")
+        .option("--skip-version-check", "Override the archive install compatibility check")
+        .option("--force", "Override archive install conflicts (may produce partial install state)")
         .option("--json", "Output as parseable JSON")
         .action(async (spec, opts) => {
         const deps = getDeps();
@@ -61,12 +65,24 @@ export function bootstrapCommand(depsOverride) {
                 // Not found — fall through to use spec as-is (existing behavior)
             }
         }
+        // Reuse bundle install's source-kind, compatibility checks, audit and
+        // stable materialization. The archive's extraction directory is temporary.
+        const bundleRequest = /\.rigbundle$/i.test(sourceRef) ? {
+            bundlePath: nodePath.resolve(sourceRef),
+            plan: opts.plan ?? false,
+            autoApprove: opts.yes ?? false,
+            targetRoot: nodePath.resolve(opts.target ?? process.cwd()),
+            cwdOverride: opts.cwd ? nodePath.resolve(opts.cwd) : undefined,
+            cliVersion: getCliVersion(),
+            skipVersionCheck: opts.skipVersionCheck ?? false,
+            force: opts.force ?? false,
+        } : undefined;
         if (opts.plan) {
             // Plan mode
-            const res = await client.post("/api/bootstrap/plan", {
+            const res = await client.post(bundleRequest ? "/api/bundles/install" : "/api/bootstrap/plan", bundleRequest ?? {
                 sourceRef,
                 cwdOverride: opts.cwd ? nodePath.resolve(opts.cwd) : undefined,
-            });
+            }, bundleRequest ? { timeoutMs: LONG_RUNNING_BOOTSTRAP_TIMEOUT_MS } : undefined);
             if (opts.json) {
                 console.log(JSON.stringify(res.data));
             }
@@ -104,7 +120,7 @@ export function bootstrapCommand(depsOverride) {
             return;
         }
         // Apply mode
-        const res = await client.post("/api/bootstrap/apply", {
+        const res = await client.post(bundleRequest ? "/api/bundles/install" : "/api/bootstrap/apply", bundleRequest ?? {
             sourceRef,
             cwdOverride: opts.cwd ? nodePath.resolve(opts.cwd) : undefined,
             autoApprove: opts.yes ?? false,
@@ -128,7 +144,16 @@ export function bootstrapCommand(depsOverride) {
                     console.error(`  ERROR: ${e}`);
                 }
             }
+            else if (typeof res.data["error"] === "string") {
+                console.error(`  ERROR: ${res.data["error"]}`);
+            }
             logStageDetailErrors(res.data);
+            if (bundleRequest) {
+                for (const line of bundleRoutingSummary(res.data))
+                    console.log(line);
+            }
+            for (const warning of res.data["warnings"] ?? [])
+                console.log(`Warning: ${warning}`);
         }
         const resultStatus = res.data["status"] ?? "";
         if (res.status === 409) {

package/dist/commands/bootstrap.js.map

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

package/dist/commands/bundle.d.ts

@@ -1,4 +1,16 @@
 import { Command } from "commander";
 import type { StatusDeps } from "./status.js";
+/**
+ * Read the CLI's own package.json version at call time (Item 1 / slice-05).
+ * Function-level read on purpose: module-level constants would mask test
+ * isolation per the audit-every-layer discipline.
+ */
+export declare function getCliVersion(): string;
+/** Keep the daemon's messages readable in human output; JSON retains the original body. */
+export declare function bundleInstallError(data: Record<string, unknown>, includeWarnings?: boolean): string;
 export declare function bundleCommand(depsOverride?: StatusDeps): Command;
+/** Render the daemon's reason verbatim, including continuation guidance when available. */
+export declare function startupAttentionSummary(data: Record<string, unknown>): string[];
+/** One line per routed kind: what landed, and each declared entry that did not. */
+export declare function bundleRoutingSummary(data: Record<string, unknown>): string[];
 //# sourceMappingURL=bundle.d.ts.map

package/dist/commands/bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/commands/bundle.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAmC9C,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG,OAAO,CAuMhE"}
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../src/commands/bundle.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAI9C;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAStC;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,UAAO,GAAG,MAAM,CAchG;AAmBD,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,UAAU,GAAG,OAAO,CA4VhE;AAUD,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAa/E;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,CAiB5E"}

package/dist/commands/bundle.js

@@ -6,12 +6,16 @@ import { Command } from "commander";
 import { DaemonClient } from "../client.js";
 import { getDaemonStatus, getDaemonUrl, daemonStatusGuard } from "../daemon-lifecycle.js";
 import { realDeps } from "./daemon.js";
+import { isGitHubBundleLink, importGitHubBundle, bundleIdentityLines, printBundleLinkError, rigSpecName } from "../lib/bundle-source.js";
+import { checkBundleFolder } from "../lib/bundle-check.js";
+import { showBundleBehaviourBeforeAction } from "../bundle-behaviour.js";
+import { readDeclaredConfigurations, authoredMapping, resolveConfiguration, listConfigurations, checkDeclaredConfigurations, stageConfiguration, ConfigurationError } from "../lib/bundle-configuration.js";
 /**
  * Read the CLI's own package.json version at call time (Item 1 / slice-05).
  * Function-level read on purpose: module-level constants would mask test
  * isolation per the audit-every-layer discipline.
  */
-function getCliVersion() {
+export function getCliVersion() {
     try {
         const here = fileURLToPath(import.meta.url);
         const pkgPath = nodePath.join(nodePath.dirname(here), "..", "..", "package.json");
@@ -22,6 +26,26 @@ function getCliVersion() {
         return "unknown";
     }
 }
+/** Keep the daemon's messages readable in human output; JSON retains the original body. */
+export function bundleInstallError(data, includeWarnings = true) {
+    const error = data.error ?? data.errors ?? "Install failed";
+    const lines = (Array.isArray(error) ? error : [error]).map(String);
+    if (typeof data.detail === "string")
+        lines.push(data.detail);
+    for (const conflict of Array.isArray(data.conflicts) ? data.conflicts : []) {
+        if (typeof conflict?.description === "string")
+            lines.push(conflict.description);
+    }
+    for (const resolution of Array.isArray(data.resolutions) ? data.resolutions : []) {
+        if (typeof resolution === "string")
+            lines.push(resolution);
+    }
+    for (const warning of includeWarnings && Array.isArray(data.warnings) ? data.warnings : []) {
+        if (typeof warning === "string")
+            lines.push(`Warning: ${warning}`);
+    }
+    return [...new Set(lines)].join("\n");
+}
 /**
  * Build the provenance block the CLI sends to /api/bundles/create. Reads
  * hostname, session name (from canonical OPENRIG_SESSION_NAME env), and
@@ -51,12 +75,16 @@ export function bundleCommand(depsOverride) {
     }
     // rig bundle create <spec> -o <path>
     cmd.command("create <spec>")
-        .description("Create a .rigbundle from a rig spec")
+        .description("Create a .rigbundle from a rig spec or GitHub folder link")
         .requiredOption("-o, --output <path>", "Output path for .rigbundle")
-        .option("--name <name>", "Bundle name", "my-bundle")
+        .option("--name <name>", "Bundle name (default: the rig's name in rig.yaml)")
         .option("--bundle-version <ver>", "Bundle version", "0.1.0")
         .option("--include-packages <refs...>", "Package refs to include (default: all from spec)")
         .option("--rig-root <root>", "Root directory for pod-aware resolution")
+        .option("--context-pack <dir>", "Carry the context pack in <dir> (its manifest.yaml and declared files), which may sit outside the rig folder; repeatable", (dir, dirs) => [...dirs, dir], [])
+        .option("--project-dir <dir>", "Carry the project this rig works in: the folder holding its project.yaml (with an id) and files such as SPEC.md. Install registers it in the workspace catalog and associates the rig with it")
+        .option("--preset <name>", "Build one of the configurations the bundle declares in configurations.yaml (for example all-claude)")
+        .option("--seat <member=runtime>", "Use this runtime for one seat, within what configurations.yaml allows (pod.member=runtime); repeatable", (v, all) => [...all, v], [])
         .option("--notes <text>", "Operator notes captured in bundle provenance metadata")
         .option("--min-daemon-version <ver>", "Minimum daemon version required to install this bundle (Item 2 compatibility)")
         .option("--min-cli-version <ver>", "Minimum CLI version required to install this bundle (Item 2 compatibility)")
@@ -64,6 +92,28 @@ export function bundleCommand(depsOverride) {
         .option("--json", "JSON output")
         .action(async (spec, opts) => {
         const deps = getDepsF();
+        if (isGitHubBundleLink(spec)) {
+            try {
+                const { res } = await importGitHubBundle(spec, deps, { ...opts, provenance: buildClientProvenance(opts.notes) });
+                if (opts.json)
+                    console.log(JSON.stringify(res.data));
+                else if (res.status >= 400)
+                    console.error(res.data.error ?? "Create failed");
+                else {
+                    console.log(`Bundle created: ${opts.output}`);
+                    for (const line of bundleIdentityLines(res.data))
+                        console.log(line);
+                    if (res.data.warning)
+                        console.warn(res.data.warning);
+                }
+                if (res.status >= 400)
+                    process.exitCode = 2;
+            }
+            catch (err) {
+                printBundleLinkError(err, opts.json);
+            }
+            return;
+        }
         const client = await getClient(deps);
         if (!client) {
             process.exitCode = 1;
@@ -88,14 +138,46 @@ export function bundleCommand(depsOverride) {
         // surface (not in slice-05 scope).
         // Paths are resolved here, against the operator's cwd: the daemon would otherwise resolve
         // them against ITS cwd. Nothing is uploaded — the files must exist on the daemon's host.
+        // A chosen configuration is applied to an owned copy of the rig folder; the author's folder is never changed.
+        let specPath = nodePath.resolve(spec);
+        const bundleName = opts.name ?? rigSpecName(specPath) ?? "my-bundle";
+        let rigRoot = opts.rigRoot ? nodePath.resolve(opts.rigRoot) : undefined;
+        let chosen;
+        let stagingDir;
+        if (opts.preset !== undefined || (opts.seat?.length ?? 0) > 0) {
+            try {
+                const rigDir = rigRoot ?? nodePath.dirname(specPath);
+                const declared = readDeclaredConfigurations(nodePath.dirname(specPath));
+                if (!declared)
+                    throw new ConfigurationError(`${nodePath.join(nodePath.dirname(specPath), "configurations.yaml")} doesn't exist, so this bundle offers no other configurations`);
+                chosen = resolveConfiguration(declared, authoredMapping(specPath), { preset: opts.preset, seats: opts.seat });
+                const staged = stageConfiguration(rigDir, specPath, declared, chosen);
+                stagingDir = staged.stagingDir;
+                specPath = staged.rigSpecPath;
+                if (rigRoot)
+                    rigRoot = staged.stagingDir;
+            }
+            catch (err) {
+                if (!(err instanceof ConfigurationError))
+                    throw err;
+                console.error(err.message);
+                process.exitCode = 2;
+                return;
+            }
+        }
         const res = await client.post("/api/bundles/create", {
-            specPath: nodePath.resolve(spec), bundleName: opts.name, bundleVersion: opts.bundleVersion, outputPath: nodePath.resolve(opts.output),
+            specPath, bundleName, bundleVersion: opts.bundleVersion, outputPath: nodePath.resolve(opts.output),
             includePackages: opts.includePackages,
-            rigRoot: opts.rigRoot ? nodePath.resolve(opts.rigRoot) : undefined,
+            rigRoot,
+            ...(opts.contextPack?.length ? { contextPackDirs: opts.contextPack.map((dir) => nodePath.resolve(dir)) } : {}),
+            ...(opts.projectDir ? { projectDir: nodePath.resolve(opts.projectDir) } : {}),
+            ...(chosen ? { configuration: { id: chosen.configurationId, ...(chosen.preset ? { preset: chosen.preset } : {}) } } : {}),
             provenance: buildClientProvenance(opts.notes),
             ...(hasCompatibility ? { compatibility } : {}),
             ...(opts.allowDrift ? { allowDrift: true } : {}),
         }, { timeoutMs: 120_000 });
+        if (stagingDir)
+            fs.rmSync(stagingDir, { recursive: true, force: true });
         if (opts.json) {
             console.log(JSON.stringify(res.data));
             if (res.status >= 400)
@@ -108,6 +190,8 @@ export function bundleCommand(depsOverride) {
             return;
         }
         console.log(`Bundle created: ${opts.output}`);
+        if (chosen)
+            console.log(`  Configuration: ${chosen.configurationId}${chosen.preset ? ` (${chosen.preset})` : ""}`);
         console.log(`  Name: ${res.data["bundleName"]} v${res.data["bundleVersion"]}`);
         console.log(`  Hash: ${res.data["archiveHash"]}`);
         // The daemon has returned this on every drifted export since Build B and the human path
@@ -115,13 +199,73 @@ export function bundleCommand(depsOverride) {
         if (typeof res.data["warning"] === "string")
             console.warn(`\n${res.data["warning"]}`);
     });
+    // rig bundle configurations <spec>
+    cmd.command("configurations <spec>")
+        .description("List the configurations a rig spec's configurations.yaml declares, with their configuration IDs")
+        .option("--json", "JSON output")
+        .action((spec, opts) => {
+        const specPath = nodePath.resolve(spec);
+        let declared;
+        let configurations = [];
+        try {
+            declared = readDeclaredConfigurations(nodePath.dirname(specPath));
+            const authored = authoredMapping(specPath);
+            if (declared) {
+                checkDeclaredConfigurations(declared, authored);
+                configurations = listConfigurations(declared, authored);
+            }
+        }
+        catch (err) {
+            if (!(err instanceof ConfigurationError))
+                throw err;
+            if (opts.json)
+                console.log(JSON.stringify({ declared: true, error: err.message }));
+            else
+                console.error(err.message);
+            process.exitCode = 2;
+            return;
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ declared: Boolean(declared), configurations }));
+            return;
+        }
+        if (!declared) {
+            console.log("No configurations.yaml: the bundle builds only as rig.yaml is written.");
+            return;
+        }
+        for (const c of configurations) {
+            const notes = [c.recommended ? "recommended" : "", c.authored ? "as rig.yaml is written" : ""].filter(Boolean).join(", ");
+            console.log(`${c.preset}: ${c.configurationId}${notes ? `  (${notes})` : ""}`);
+        }
+    });
     // rig bundle inspect <path>
     cmd.command("inspect <path>")
-        .description("Inspect a .rigbundle")
+        .description("Inspect a .rigbundle or build and inspect a GitHub folder link")
+        .option("--preset <name>", "For a GitHub link, choose a declared configuration")
+        .option("--seat <member=runtime>", "For a GitHub link, choose a declared seat runtime; repeatable", (v, all) => [...all, v], [])
         .option("--json", "JSON output")
         .action(async (bundlePath, opts) => {
         const deps = getDepsF();
-        const client = await getClient(deps);
+        let imported;
+        if (isGitHubBundleLink(bundlePath)) {
+            try {
+                imported = await importGitHubBundle(bundlePath, deps, opts);
+            }
+            catch (err) {
+                printBundleLinkError(err, opts.json);
+                return;
+            }
+            if (imported.res.status >= 400) {
+                if (opts.json)
+                    console.log(JSON.stringify(imported.res.data));
+                else
+                    console.error(imported.res.data.error ?? "Create failed");
+                process.exitCode = 2;
+                return;
+            }
+            bundlePath = imported.bundlePath;
+        }
+        const client = imported?.client ?? await getClient(deps);
         if (!client) {
             process.exitCode = 1;
             return;
@@ -150,46 +294,99 @@ export function bundleCommand(depsOverride) {
             return;
         }
         console.log(`Bundle: ${m["name"]} v${m["version"]}`);
+        for (const line of bundleIdentityLines(res.data))
+            console.log(line);
         console.log(`Digest valid: ${res.data["digestValid"]}`);
         const ir = res.data["integrityResult"];
         console.log(`Integrity: ${ir["passed"] ? "PASS" : "FAIL"}`);
+        // What install will add before any seat launches
+        const packs = m["contextPacks"];
+        if (packs?.length)
+            console.log(`Context packs: ${packs.join(", ")}`);
+        const project = m["project"];
+        if (project?.id)
+            console.log(`Project: ${project.id} (registered in the workspace catalog on install, with this rig associated)`);
+        await showBundleBehaviourBeforeAction(async () => res, console.log);
         if (!digestValid || !integrityPassed)
             process.exitCode = 2;
     });
     // rig bundle install <path>
     cmd.command("install <path>")
-        .description("Install a .rigbundle (bootstrap from bundle)")
+        .description("Install a .rigbundle or GitHub folder link (bootstrap from bundle)")
+        .option("--preset <name>", "For a GitHub link, choose a declared configuration")
+        .option("--seat <member=runtime>", "For a GitHub link, choose a declared seat runtime; repeatable", (v, all) => [...all, v], [])
+        .option("--non-interruptive", "Accept harness first-launch warnings for this rig at full bypass; saved for later launches")
+        .option("--no-non-interruptive", "Turn off this rig's saved warning-acceptance choice (stop an existing rig with rig down first)")
         .option("--plan", "Plan mode")
         .option("--yes", "Auto-approve")
         .option("--target <root>", "Target root directory")
+        .option("--cwd <path>", "Launch working directory for every member, for this install (for example, the repository the rig works on)")
         .option("--skip-version-check", "Operator-explicit override of the Item-2 install-time compatibility check (NOT recommended for routine use)")
         .option("--force", "Operator-explicit override of the Item-3 install-time conflict check (NOT recommended; conflicts may produce partial install state)")
         .option("--json", "JSON output")
         .action(async (bundlePath, opts) => {
         const deps = getDepsF();
-        const client = await getClient(deps);
+        let imported;
+        if (isGitHubBundleLink(bundlePath)) {
+            try {
+                imported = await importGitHubBundle(bundlePath, deps, opts);
+            }
+            catch (err) {
+                printBundleLinkError(err, opts.json);
+                return;
+            }
+            if (imported.res.status >= 400) {
+                if (opts.json)
+                    console.log(JSON.stringify(imported.res.data));
+                else
+                    console.error(imported.res.data.error ?? "Create failed");
+                process.exitCode = 2;
+                return;
+            }
+            bundlePath = imported.bundlePath;
+        }
+        const client = imported?.client ?? await getClient(deps);
         if (!client) {
             process.exitCode = 1;
             return;
         }
+        const behaviour = await showBundleBehaviourBeforeAction(() => client.post("/api/bundles/inspect", { bundlePath: nodePath.resolve(bundlePath) }));
         // QA-20260601 A1 repair: /install completes a full bootstrap run
         // (resolve → vendor sibling primitives → boot rig sessions) which
         // can take many seconds for real bundles. Default 5000ms CLI
         // timeout (client.ts:31) caused CLI to report failure while
         // daemon completed the mutating install — operator-unsafe retry
         // path (rig_name_collision on second attempt). Bumped to 120s.
-        const res = await client.post("/api/bundles/install", {
-            bundlePath: nodePath.resolve(bundlePath), plan: opts.plan ?? false, autoApprove: opts.yes ?? false,
-            targetRoot: opts.target ? nodePath.resolve(opts.target) : undefined,
-            // Item 2 / slice-05 Checkpoint 3.3: send CLI version + skip flag for the
-            // daemon-side install-time compatibility check. CLI version read at call
-            // time (no module-level constant) via the existing getCliVersion helper.
-            cliVersion: getCliVersion(),
-            skipVersionCheck: opts.skipVersionCheck ?? false,
-            // Item 3 / slice-05 Checkpoint 4.2: send force flag for the daemon-side
-            // install-time conflict check. Operator-explicit override only.
-            force: opts.force ?? false,
-        }, { timeoutMs: 120_000 });
+        let res;
+        try {
+            res = await client.post("/api/bundles/install", {
+                bundlePath: nodePath.resolve(bundlePath), plan: opts.plan ?? false, autoApprove: opts.yes ?? false, nonInterruptive: opts.nonInterruptive,
+                targetRoot: opts.target ? nodePath.resolve(opts.target) : (imported ? process.cwd() : undefined),
+                cwdOverride: opts.cwd ? nodePath.resolve(opts.cwd) : undefined,
+                // Item 2 / slice-05 Checkpoint 3.3: send CLI version + skip flag for the
+                // daemon-side install-time compatibility check. CLI version read at call
+                // time (no module-level constant) via the existing getCliVersion helper.
+                cliVersion: getCliVersion(),
+                skipVersionCheck: opts.skipVersionCheck ?? false,
+                // Item 3 / slice-05 Checkpoint 4.2: send force flag for the daemon-side
+                // install-time conflict check. Operator-explicit override only.
+                force: opts.force ?? false,
+            }, { timeoutMs: 120_000 });
+        }
+        catch (err) {
+            if (!imported)
+                throw err;
+            printBundleLinkError(new Error(`Bundle install outcome is unknown. Archive retained at ${bundlePath}; check rig ps and rig bundle history before retrying.`), opts.json);
+            return;
+        }
+        if (imported) {
+            const { source, configurationId, packageDigest, archiveHash, assembler } = imported.res.data;
+            res.data = { ...res.data, source, configurationId, packageDigest, archiveHash, assembler };
+        }
+        if (imported && ["failed", "partial", "partially_restored", "not_attempted"].includes(String(res.data.status ?? res.data.rigResult)))
+            process.exitCode = 2;
+        if (behaviour)
+            res.data = { ...res.data, behaviour };
         if (opts.json) {
             console.log(JSON.stringify(res.data));
             if (res.status >= 400)
@@ -197,14 +394,38 @@ export function bundleCommand(depsOverride) {
             return;
         }
         if (res.status >= 400) {
-            console.error(res.data["error"] ?? res.data["errors"] ?? "Install failed");
+            console.error(bundleInstallError(res.data));
             process.exitCode = res.status === 409 ? 1 : 2;
             return;
         }
         const status = res.data["status"];
         console.log(`Status: ${status}`);
+        for (const line of startupAttentionSummary(res.data))
+            console.log(line);
+        if (imported)
+            for (const line of bundleIdentityLines(res.data))
+                console.log(line);
         if (res.data["rigId"])
             console.log(`Rig: ${res.data["rigId"]}`);
+        for (const line of bundleRoutingSummary(res.data))
+            console.log(line);
+        for (const w of res.data["warnings"] ?? [])
+            console.log(`Warning: ${w}`);
+    });
+    cmd.command("check <folder>")
+        .description("Check the shareable bundle standard locally; advisory, no daemon or launch")
+        .option("--json", "JSON output")
+        .action(async (folder, opts) => {
+        const result = await checkBundleFolder(nodePath.resolve(folder));
+        if (opts.json)
+            console.log(JSON.stringify(result));
+        else {
+            console.log(`Bundle standard: ${result.standardVersion} (advisory)`);
+            for (const check of result.checks)
+                console.log(`${check.status}: ${check.ruleId}: ${check.reason}${check.path ? ` (${check.path})` : ""}`);
+        }
+        if (result.checks.some(check => check.status === "finding"))
+            process.exitCode = 1;
     });
     // rig bundle history — Item 4 / slice-05 Checkpoint 5.2
     cmd.command("history")
@@ -254,4 +475,49 @@ export function bundleCommand(depsOverride) {
     });
     return cmd;
 }
+const ROUTING_LABELS = [
+    ["contextPacksRouting", "Context packs"],
+    ["skillsRouting", "Skills"],
+    ["pluginsRouting", "Plugins"],
+    ["workflowSpecsRouting", "Workflow specs"],
+    ["agentImagesRouting", "Agent images"],
+];
+/** Render the daemon's reason verbatim, including continuation guidance when available. */
+export function startupAttentionSummary(data) {
+    const stages = data["stages"];
+    const lines = [];
+    for (const stage of Array.isArray(stages) ? stages : []) {
+        const nodes = stage?.detail?.attentionNodes;
+        for (const node of Array.isArray(nodes) ? nodes : []) {
+            const seat = node?.sessionName || node?.logicalId;
+            if (typeof seat === "string" && typeof node?.reason === "string") {
+                lines.push(`Startup attention (${seat}): ${node.reason}`);
+            }
+        }
+    }
+    return lines;
+}
+/** One line per routed kind: what landed, and each declared entry that did not. */
+export function bundleRoutingSummary(data) {
+    const lines = [];
+    for (const [key, label] of ROUTING_LABELS) {
+        const routing = data[key];
+        if (!routing || typeof routing.routedCount !== "number")
+            continue;
+        const rejected = (routing.records ?? []).filter((r) => r.status !== "routed");
+        const detail = rejected.length > 0 ? `; not routed: ${rejected.map((r) => `${r.declaredPath ?? r.id ?? "?"} (${r.status ?? "?"})`).join(", ")}` : "";
+        lines.push(`${label}: ${routing.routedCount} routed${detail}`);
+        // Each entry's own explanation, which can carry the command that resolves it
+        for (const r of rejected)
+            if (r.detail)
+                lines.push(`  ${r.declaredPath ?? r.id ?? "?"}: ${r.detail}`);
+    }
+    const project = data["projectRegistration"];
+    if (project && project.status !== "conflict") {
+        lines.push(`Project: ${project.projectId} (${project.status}) at ${project.projectRoot}; rig ${project.rigName} is associated with it in ${project.catalogPath}`);
+        if (project.projectFolderKept)
+            lines.push(`Project: kept the existing folder at ${project.projectRoot}, which differs from the bundle's copy`);
+    }
+    return lines;
+}
 //# sourceMappingURL=bundle.js.map