@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/bootstrap.js

@@ -1,485 +0,0 @@
-/**
- * `olam bootstrap` — the SOLE on-ramp for olam's image stack.
- *
- * Phase C of the olam-fresh-install-self-bootstrap epic, implementing
- * the centerpiece of the user goal: `npm install -g @pleri/olam-cli &&
- * olam init && olam bootstrap` lands the operator at a working stack
- * with all three images pulled by digest, protocol-version handshake
- * verified, and services started + authenticated.
- *
- * Steps:
- *   1. docker info smoke (fail-fast with remedy if daemon missing).
- *   2. Parallel pull 3 images by digest from image-digests.json
- *      (shipped in the npm tarball by Phase B). Retry-throttle-coalesce
- *      pattern adopted from packages/auth-client (withCredential +
- *      coalesce.ts) per Decision #16: in-flight Map deduplicates
- *      concurrent identical-digest pulls; bounded retry.
- *   3. For each pulled image, run `docker inspect` + checkProtocolOverlap
- *      (Decision #14 handshake). Refuse on no-overlap.
- *   4. olam host-cp start (no-ops if already running).
- *   5. olam auth up (idempotent).
- *   6. olam auth login (interactive PKCE — 5-min timeout, "still
- *      waiting" reprint every 60s, Ctrl+C cancellation).
- *   7. Optional --with-smoke: olam create --workspace smoke
- *      --task "smoke test".
- *
- * Idempotent re-run: when all images present + matching digests +
- * services healthy, prints a brief status table and exits 0 in ≤30s.
- */
-import { spawnSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import ora, {} from 'ora';
-import pc from 'picocolors';
-import { pullImageWithRetry, realDocker, } from '@olam/adapters';
-import { installRoot } from '../install-root.js';
-import { EXIT_BOOTSTRAP_PULL_FAILED, EXIT_GENERIC_ERROR, EXIT_PROTOCOL_MISMATCH, } from '../exit-codes.js';
-import { checkProtocolOverlap, parseProtocolVersionsLabel } from '../protocol-version.js';
-import { printError, printSuccess, printInfo, printHeader } from '../output.js';
-import { readConfig } from '../lib/config.js';
-import { runBootstrapKubernetes, DEFAULT_K3S_CLUSTER } from '../lib/bootstrap-kubernetes.js';
-// Re-export so existing call sites (upgrade.ts, auth-upgrade.ts, tests)
-// keep importing from `./bootstrap.js` unchanged. The implementation
-// moved to @olam/adapters/docker/pull.ts so the adapter layer can
-// pull-before-createContainer without inverting the cli↔adapters dep
-// direction.
-export { pullImageWithRetry, realDocker, };
-/** Image-digests.json schema validation + load. */
-export function loadImageDigests(installRootDir = installRoot()) {
-    const digestsPath = join(installRootDir, 'dist', 'image-digests.json');
-    if (!existsSync(digestsPath)) {
-        throw new Error(`image-digests.json missing at ${digestsPath}. ` +
-            `Re-run \`npm install -g @pleri/olam-cli@<version>\` to refresh the tarball.`);
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(digestsPath, 'utf8'));
-    }
-    catch (err) {
-        throw new Error(`image-digests.json is not valid JSON: ${err.message}`);
-    }
-    if (typeof parsed !== 'object' || parsed === null) {
-        throw new Error('image-digests.json is not an object');
-    }
-    const obj = parsed;
-    const required = ['host-cp', 'auth', 'devbox'];
-    const missing = required.filter((k) => typeof obj[k] !== 'string' || !obj[k]);
-    if (missing.length > 0) {
-        throw new Error(`image-digests.json missing required key(s): ${missing.join(', ')}. ` +
-            `Tarball may be corrupted; reinstall the CLI.`);
-    }
-    return parsed;
-}
-const REAL_OLAM_SUBCOMMAND = (args) => {
-    const result = spawnSync(process.execPath, [
-        process.argv[1] ?? 'olam',
-        ...args,
-    ], {
-        encoding: 'utf8',
-        stdio: ['ignore', 'pipe', 'pipe'],
-    });
-    return {
-        exitCode: result.status ?? -1,
-        stdout: result.stdout ?? '',
-        stderr: result.stderr ?? '',
-    };
-};
-export async function runBootstrap(opts, deps = {}) {
-    // Substrate-aware dispatch. k3s is the default substrate as of
-    // feat/cli-bootstrap-k3s-default; compose remains supported for existing
-    // installs whose ~/.olam/config.json still declares substrate=compose.
-    const cfg = readConfig(deps.configPath ? { configPath: deps.configPath } : {});
-    if (cfg.host.substrate === 'kubernetes') {
-        const k8s = await runBootstrapKubernetes({
-            cluster: opts.k3sCluster ?? DEFAULT_K3S_CLUSTER,
-            autoInstall: opts.autoInstall ?? false,
-            skipObservability: opts.skipObservability ?? false,
-            skipClusterCreate: opts.skipClusterCreate ?? false,
-            skipPrepull: opts.skipPrepull ?? false,
-            verbose: opts.verbose ?? false,
-            hostCpDevPath: opts.hostCpDevPath,
-            // Honour the operator's Phase 0 substrate-picker choice. When unset,
-            // bootstrap-kubernetes auto-detects (prefers an installed Docker
-            // Desktop over imposing Colima).
-            preferredRuntime: cfg.host.preferred_runtime,
-        });
-        return { exitCode: k8s.exitCode, summary: k8s.summary };
-    }
-    // Compose substrate — existing flow.
-    const docker = deps.docker ?? realDocker;
-    const digests = deps.digests ?? loadImageDigests();
-    const registry = opts.registry ?? deps.registry ?? digests.$registry ?? 'ghcr.io/pleri';
-    printHeader('olam bootstrap');
-    // Step 1: docker daemon smoke.
-    const infoSpinner = ora('Checking docker daemon').start();
-    const info = await docker.info();
-    if (info.exitCode !== 0) {
-        infoSpinner.fail('docker daemon not reachable');
-        process.stderr.write(`${pc.red('error')} docker info exited with ${info.exitCode}.\n` +
-            '  Ensure Docker Desktop / Colima / Rancher is running, then retry.\n' +
-            `  stderr: ${info.stderr.split('\n')[0] ?? ''}\n`);
-        return { exitCode: EXIT_GENERIC_ERROR, summary: 'docker daemon not reachable' };
-    }
-    infoSpinner.succeed('docker daemon reachable');
-    // Step 2: parallel pull all images by digest.
-    // mcp-auth is OPTIONAL per the type def — image-digests.json from
-    // older CLI tarballs may not include it. Bootstrap stays
-    // backward-compat by skipping the mcp-auth entries when the digest
-    // is absent. Newer tarballs include the field, so the consumer side
-    // (services.ts → MCP_AUTH_LOCAL_TAG = 'olam-mcp-auth:local') gets
-    // its expected canonical tag created.
-    const imageRefs = [
-        { name: 'host-cp', ref: `${registry}/olam-host-cp@${digests['host-cp']}` },
-        { name: 'auth', ref: `${registry}/olam-auth@${digests.auth}` },
-        { name: 'devbox', ref: `${registry}/olam-devbox@${digests.devbox}` },
-    ];
-    if (digests['mcp-auth']) {
-        imageRefs.push({ name: 'mcp-auth', ref: `${registry}/olam-mcp-auth@${digests['mcp-auth']}` });
-    }
-    // kg-service: optional (older tarballs don't ship it; opt-out via --skip-kg-service).
-    if (digests['kg-service'] && !opts.skipKgService) {
-        imageRefs.push({ name: 'kg-service', ref: `${registry}/olam-kg-service@${digests['kg-service']}` });
-    }
-    // memory-service: optional (older tarballs don't ship it). When present,
-    // pull and tag as :local so MemoryServiceContainerController resolves it
-    // via the local→dev→published fallback chain without touching :latest.
-    // Skipped when --skip-memory is set (caller doesn't want memory-service).
-    if (digests['memory-service'] && !opts.skipMemory) {
-        imageRefs.push({ name: 'memory-service', ref: `${registry}/olam-memory-service@${digests['memory-service']}` });
-    }
-    // devbox-base: optional (older tarballs don't ship it). When present,
-    // we MUST pull AND tag it as `olam-devbox:base` so the new
-    // `DEFAULT_DEVBOX_IMAGE = olam-devbox:base` resolves on a fresh
-    // `olam bootstrap` host. Without this, the operator's first
-    // `olam create` after bootstrap fails with `404 No such image:
-    // olam-devbox:base` (e2e workflow run 25709257945, fresh-install
-    // matrix). Mirrors the upgrade.ts:1075-1080 logic exactly.
-    if (digests['devbox-base']) {
-        imageRefs.push({
-            name: 'devbox-base',
-            ref: `${registry}/olam-devbox@${digests['devbox-base']}`,
-        });
-    }
-    const pullSpinner = ora(`Pulling images (${imageRefs.length} parallel)`).start();
-    const pullStart = Date.now();
-    const pullResults = await Promise.all(imageRefs.map(async ({ name, ref }) => ({
-        name,
-        ref,
-        result: await pullImageWithRetry(ref, docker),
-    })));
-    const pullElapsed = ((Date.now() - pullStart) / 1000).toFixed(1);
-    const failed = pullResults.filter((r) => r.result.exitCode !== 0);
-    if (failed.length > 0) {
-        pullSpinner.fail(`Pull failed for ${failed.map((r) => r.name).join(', ')}`);
-        for (const f of failed) {
-            process.stderr.write(`  ${pc.red(f.name)} (${f.ref}):\n` +
-                `    exit=${f.result.exitCode}\n` +
-                `    stderr: ${f.result.stderr.split('\n')[0] ?? '(empty)'}\n`);
-        }
-        process.stderr.write('\n  Remedy: `olam bootstrap` is the only on-ramp. Re-run after\n' +
-            '  resolving network / GHCR availability. If a specific image is\n' +
-            '  permanently unavailable, file a bug at github.com/pleri/olam/issues.\n');
-        return {
-            exitCode: EXIT_BOOTSTRAP_PULL_FAILED,
-            summary: `pull failed: ${failed.map((r) => r.name).join(', ')}`,
-        };
-    }
-    pullSpinner.succeed(`Pulled ${imageRefs.length} images in ${pullElapsed}s`);
-    // Step 3: protocol-version handshake — refuse on no-overlap.
-    const handshakeSpinner = ora('Verifying olam.protocol.versions handshake').start();
-    for (const { name, ref } of imageRefs) {
-        const inspect = await docker.inspectLabel(ref, 'olam.protocol.versions');
-        if (inspect.exitCode !== 0) {
-            handshakeSpinner.fail(`Could not inspect ${name}`);
-            process.stderr.write(`${pc.red('error')} docker inspect ${ref} failed: ${inspect.stderr}\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: `inspect failed: ${name}` };
-        }
-        const labelValue = (inspect.stdout || '').trim();
-        const versions = parseProtocolVersionsLabel(labelValue === '<no value>' ? '' : labelValue);
-        const decision = checkProtocolOverlap(versions);
-        if (!decision.compatible) {
-            handshakeSpinner.fail(`Protocol mismatch on ${name}`);
-            process.stderr.write(`${pc.red('error')} ${decision.remedy}\n`);
-            return {
-                exitCode: EXIT_PROTOCOL_MISMATCH,
-                summary: `protocol mismatch: ${name}`,
-            };
-        }
-    }
-    handshakeSpinner.succeed(`Protocol handshake passed (all ${imageRefs.length} images)`);
-    // Step 3b: alias the digest-pinned pulls as `<image>:latest`. compose.yaml
-    // references services by tag (`ghcr.io/pleri/olam-host-cp:latest`), not
-    // by digest, so without this step `compose up` would either pull `:latest`
-    // again from the registry (wasted bandwidth, no digest pinning) or fail
-    // when the operator is offline / GHCR is rate-limited. Re-tagging is
-    // local-only and instant.
-    const tagSpinner = ora('Aliasing pulled digests as :latest').start();
-    // Tag targets are deliberately heterogeneous — each consumer reads
-    // a different canonical name:
-    //   - host-cp's compose.yaml says `image: ghcr.io/pleri/olam-host-cp:latest`
-    //   - AuthContainerController hard-codes DEFAULT_IMAGE = 'olam-auth:local'
-    //     (the legacy local-build tag; predates the published image)
-    //   - devbox: `olam create` runs `docker run olam-devbox:latest` directly
-    //     (DEFAULT_DEVBOX_IMAGE in packages/core/src/world/devbox-image.ts).
-    //     Without the bare-name alias, create fails with "no such image" even
-    //     after bootstrap pulled the digest. PR #281 E2E run 25534306717
-    //     surfaced this when `--workspace` was finally seeded — the registry-
-    //     prefixed tag isn't what the runtime looks up.
-    // Future cleanup: pick one canonical scheme + migrate consumers.
-    const tagPlan = [
-        { name: 'host-cp', from: imageRefs[0].ref, to: `${registry}/olam-host-cp:latest` },
-        { name: 'auth', from: imageRefs[1].ref, to: 'olam-auth:local' },
-        { name: 'devbox', from: imageRefs[2].ref, to: 'olam-devbox:latest' },
-    ];
-    // mcp-auth: only tag when the operator's image-digests.json carried
-    // the digest (older tarballs don't). services.ts's
-    // MCP_AUTH_LOCAL_TAG ('olam-mcp-auth:local') is the consumer; without
-    // this tag, `olam auth up` fails with "mcp-auth image
-    // 'olam-mcp-auth:local' not found locally" and bootstrap is broken
-    // for the D3 conformance smoke + every fresh-machine install.
-    const mcpAuthRef = imageRefs.find((r) => r.name === 'mcp-auth');
-    if (mcpAuthRef) {
-        tagPlan.push({ name: 'mcp-auth', from: mcpAuthRef.ref, to: 'olam-mcp-auth:local' });
-    }
-    // kg-service: tag the published image as the local canonical
-    // (kg-service-container.ts resolves :local → :dev → :latest in that
-    // order). Without this, fresh-bootstrap operators get "kg-service image
-    // not found locally" on `olam services up`.
-    const kgServiceRef = imageRefs.find((r) => r.name === 'kg-service');
-    if (kgServiceRef) {
-        tagPlan.push({ name: 'kg-service', from: kgServiceRef.ref, to: 'olam-kg-service:local' });
-    }
-    // memory-service: tag the published image as :local so
-    // MemoryServiceContainerController's local→dev→published fallback
-    // resolves without touching the registry :latest tag. Mirrors the
-    // kg-service pattern above.
-    const memoryServiceRef = imageRefs.find((r) => r.name === 'memory-service');
-    if (memoryServiceRef) {
-        tagPlan.push({ name: 'memory-service', from: memoryServiceRef.ref, to: 'olam-memory-service:local' });
-    }
-    // devbox-base: tag both bare (`olam-devbox:base`) and
-    // registry-prefixed variants. `olam create`'s
-    // DEFAULT_DEVBOX_IMAGE = 'olam-devbox:base' (devbox-image.ts) is the
-    // consumer; without these tags, every fresh-bootstrap operator's
-    // first `olam create` fails with `404 No such image:
-    // olam-devbox:base`. Mirrors upgrade.ts:1077-1078 exactly.
-    const devboxBaseRef = imageRefs.find((r) => r.name === 'devbox-base');
-    if (devboxBaseRef) {
-        tagPlan.push({ name: 'devbox-base (bare)', from: devboxBaseRef.ref, to: 'olam-devbox:base' });
-        tagPlan.push({
-            name: 'devbox-base (registry)',
-            from: devboxBaseRef.ref,
-            to: `${registry}/olam-devbox:base`,
-        });
-    }
-    for (const { name, from, to } of tagPlan) {
-        const result = await docker.tag(from, to);
-        if (result.exitCode !== 0) {
-            tagSpinner.fail(`Failed to tag ${name}`);
-            process.stderr.write(`${pc.red('error')} docker tag ${from} ${to} failed: ${result.stderr}\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: `tag failed: ${name}` };
-        }
-    }
-    tagSpinner.succeed('Aliased 3 images as :latest');
-    // Steps 4-6: services + auth-login (C3 — scoped to wiring, not re-implementing).
-    const runOlam = deps.runOlamSubcommand ?? REAL_OLAM_SUBCOMMAND;
-    const hostCpSpinner = ora('Starting host-cp').start();
-    const hostCp = runOlam(['host-cp', 'start']);
-    if (hostCp.exitCode !== 0) {
-        hostCpSpinner.fail('host-cp start failed');
-        process.stderr.write(`  stderr: ${hostCp.stderr.split('\n').slice(0, 20).join('\n  ')}\n`);
-        return { exitCode: EXIT_GENERIC_ERROR, summary: 'host-cp start failed' };
-    }
-    hostCpSpinner.succeed('host-cp running');
-    const authUpSpinner = ora('Starting auth-service').start();
-    const authUp = runOlam(['auth', 'up']);
-    if (authUp.exitCode !== 0) {
-        authUpSpinner.fail('auth up failed');
-        // Print BOTH stdout + stderr. servicesUp's helpers print success +
-        // warnings via console.log (→ stdout); only printError goes to
-        // stderr. The most-common failure mode — "olam-auth started but
-        // /health did not respond within 15s" — is a printWarning to
-        // stdout. Pre-fix the bootstrap displayed only stderr, so that
-        // diagnostic was invisible. Operators saw `stderr:` (empty) and
-        // had no pointer to the real cause.
-        if (authUp.stdout.trim().length > 0) {
-            process.stderr.write(`  stdout: ${authUp.stdout.split('\n').slice(0, 20).join('\n  ')}\n`);
-        }
-        if (authUp.stderr.trim().length > 0) {
-            process.stderr.write(`  stderr: ${authUp.stderr.split('\n').slice(0, 20).join('\n  ')}\n`);
-        }
-        if (authUp.stdout.trim().length === 0 && authUp.stderr.trim().length === 0) {
-            process.stderr.write(`  (no stdout/stderr from olam auth up — exit code ${authUp.exitCode})\n`);
-        }
-        return { exitCode: EXIT_GENERIC_ERROR, summary: 'auth up failed' };
-    }
-    authUpSpinner.succeed('auth-service running');
-    // Step 5b: olam-postgres singleton + olam-shared network (Phase A of
-    // olam-hybrid-shared-postgres plan — see plan task A6).
-    //
-    // Brings up the shared postgres service that worlds will use for their
-    // per-world DB namespace (CREATE DATABASE x TEMPLATE atlas_*_seed at
-    // world create time). Mirrors host-cp + auth-service shape: host-level
-    // service, started once per machine, survives across world creates.
-    //
-    // Skipped via --skip-postgres-singleton or in CI where
-    // OLAM_BOOTSTRAP_SKIP_POSTGRES=1 is set. Operators with existing host
-    // postgres can opt out via ~/.olam/postgres.toml (currently surfaces in
-    // a future tracker task — A6 ships singleton-only).
-    if (opts.skipPostgresSingleton || process.env.OLAM_BOOTSTRAP_SKIP_POSTGRES === '1') {
-        printInfo('postgres singleton', 'skipped');
-    }
-    else {
-        const pgSpinner = ora('Starting olam-postgres singleton').start();
-        try {
-            const { ensureOlamPostgresSingleton } = await import('@olam/core/src/auth/postgres-init-helpers.js');
-            const result = await ensureOlamPostgresSingleton();
-            pgSpinner.succeed(`olam-postgres ${result.state} on network ${result.network} → 127.0.0.1:${result.hostPort}`);
-        }
-        catch (err) {
-            pgSpinner.fail('olam-postgres singleton bring-up failed');
-            process.stderr.write(`  ${err instanceof Error ? err.message : String(err)}\n`);
-            process.stderr.write(`  Re-run \`olam bootstrap\` after resolving, or skip via OLAM_BOOTSTRAP_SKIP_POSTGRES=1.\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: 'postgres singleton bring-up failed' };
-        }
-    }
-    // Step 5c: agent-memory Docker container (memory-service-as-docker-peripheral
-    // Phase B). Brings up `olam-memory-service` via `MemoryServiceContainerController`,
-    // identical substrate to kg-service / auth-service / mcp-auth-service. Worlds
-    // reach it via `host.docker.internal:3111` (wire protocol unchanged from the
-    // Phase A host-process model).
-    //
-    // Skipped via --skip-memory or in CI where OLAM_BOOTSTRAP_SKIP_MEMORY=1
-    // is set. Operators without Docker can opt out the same way.
-    if (opts.skipMemory || process.env.OLAM_BOOTSTRAP_SKIP_MEMORY === '1') {
-        printInfo('agent-memory', 'skipped');
-    }
-    else {
-        const memSpinner = ora('Starting agent-memory Docker container').start();
-        const mem = runOlam(['memory', 'start']);
-        if (mem.exitCode !== 0) {
-            memSpinner.fail('agent-memory start failed');
-            if (mem.stdout.trim().length > 0) {
-                process.stderr.write(`  stdout: ${mem.stdout.split('\n').slice(0, 20).join('\n  ')}\n`);
-            }
-            if (mem.stderr.trim().length > 0) {
-                process.stderr.write(`  stderr: ${mem.stderr.split('\n').slice(0, 20).join('\n  ')}\n`);
-            }
-            process.stderr.write(`  Re-run \`olam bootstrap\` after resolving, or skip via OLAM_BOOTSTRAP_SKIP_MEMORY=1.\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: 'agent-memory start failed' };
-        }
-        memSpinner.succeed('agent-memory running');
-    }
-    // Step 6: auth login (interactive). Skipped via --skip-auth-login or in
-    // CI where OLAM_BOOTSTRAP_SKIP_AUTH_LOGIN=1 is set. Gives the operator
-    // a clear bypass; production bootstrap drops them into PKCE.
-    if (opts.skipAuthLogin || process.env.OLAM_BOOTSTRAP_SKIP_AUTH_LOGIN === '1') {
-        printInfo('auth login', 'skipped');
-    }
-    else {
-        printHeader('Authenticate with Anthropic');
-        process.stdout.write('  This opens an OAuth PKCE flow against Anthropic. The auth-service\n' +
-            '  will hold your refresh token; per-world access tokens are issued\n' +
-            '  on demand and rotated every 6h.\n\n' +
-            '  Press Ctrl+C to cancel — re-run `olam bootstrap` to retry.\n\n');
-        const login = runOlam(['auth', 'login']);
-        if (login.exitCode !== 0) {
-            printError('auth login failed (or was cancelled)');
-            process.stderr.write(`  Re-run \`olam bootstrap\` after resolving.\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: 'auth login failed' };
-        }
-        printSuccess('auth login complete');
-    }
-    // Step 7 (optional): --with-smoke creates a smoke-test world.
-    if (opts.withSmoke) {
-        printHeader('Smoke test');
-        const smoke = runOlam([
-            'create',
-            '--workspace',
-            'smoke',
-            '--task',
-            'smoke test from olam bootstrap',
-        ]);
-        if (smoke.exitCode !== 0) {
-            printError('smoke world create failed');
-            process.stderr.write(`  stderr: ${smoke.stderr.split('\n').slice(0, 20).join('\n  ')}\n`);
-            return { exitCode: EXIT_GENERIC_ERROR, summary: 'smoke create failed' };
-        }
-        printSuccess('Smoke world created');
-    }
-    printHeader('Stack ready');
-    printInfo('olam-host-cp', `running (${digests['host-cp'].slice(0, 19)}…)`);
-    printInfo('olam-auth', `running (${digests.auth.slice(0, 19)}…)`);
-    const memorySkipped = opts.skipMemory || process.env.OLAM_BOOTSTRAP_SKIP_MEMORY === '1';
-    printInfo('agent-memory', memorySkipped ? 'skipped' : 'running');
-    printInfo('olam-devbox', `pulled (${digests.devbox.slice(0, 19)}…)`);
-    printInfo('next', '`olam create --task "your task"` to spawn a world');
-    return { exitCode: 0, summary: 'stack ready' };
-}
-// ── Commander registration ────────────────────────────────────────
-/**
- * Build a Commander Command for the substrate bring-up primitive.
- *
- * `olam setup` (registered in commands/setup.ts) is the operator-facing
- * wizard; it invokes `olam bootstrap` as a subprocess to bring the substrate
- * up. This builder is parameterised so future aliases can share the
- * implementation without duplication.
- */
-function buildSetupCommand(program, name) {
-    return program
-        .command(name)
-        .description('Bring up the olam substrate (k3d cluster + base services)')
-        .option('--with-smoke', 'After setup, create a smoke-test world to verify end-to-end')
-        .option('--skip-auth-login', 'Skip the interactive PKCE step (CI / scripted use only)')
-        .option('--skip-postgres-singleton', 'Skip the olam-postgres singleton bring-up (operators with host postgres opt-out, or CI)')
-        .option('--skip-memory', 'Skip the agent-memory Docker container bring-up (CI / scripted use, or hosts without Docker)')
-        .option('--skip-kg-service', 'Skip the olam-kg-service container pull + start (classifier-augmented retrieval; v2 feature)')
-        .option('--registry <ref>', 'Override the registry prefix (default: read from image-digests.json or fall back to ghcr.io/pleri)')
-        // ── k3s substrate options ─────────────────────────────────────────
-        .option('--k3s-cluster <name>', `[k3s] k3d cluster name (default: ${DEFAULT_K3S_CLUSTER})`, DEFAULT_K3S_CLUSTER)
-        .option('--auto-install', '[k3s] auto-install missing tools via brew on macOS (default: ON for macOS)', undefined)
-        .option('--no-auto-install', '[k3s] disable auto-install (operator runs brew themselves)')
-        .option('--skip-observability', '[k3s] skip Loki/Promtail/Grafana/Prom install (already in place)', false)
-        .option('--skip-cluster-create', '[k3s] cluster already exists; install substrate only', false)
-        .option('--skip-prepull', '[k3s] skip pre-pulling olam-* images into the k3d node (pods cold-pull on demand)', false)
-        .option('--verbose', '[k3s] stream all phase output sequentially instead of collapsing to live spinner lines', false)
-        .option('--host-cp-dev-path <path>', '[k3s] DEV-ONLY: mount a local olam source checkout into the k3d node at /host/olam '
-        + '(host-cp will read live source). Regular operators leave this unset — the published '
-        + 'image is self-contained.')
-        .action(async (opts) => {
-        try {
-            const result = await runBootstrap({
-                withSmoke: opts.withSmoke === true,
-                skipAuthLogin: opts.skipAuthLogin === true,
-                skipPostgresSingleton: opts.skipPostgresSingleton === true,
-                skipMemory: opts.skipMemory === true,
-                skipKgService: opts.skipKgService === true,
-                registry: opts.registry,
-                k3sCluster: opts.k3sCluster,
-                // Tri-state: undefined = let runBootstrapKubernetes apply the
-                // platform-default (ON for macOS, OFF otherwise). `--no-auto-install`
-                // sets autoInstall=false explicitly.
-                autoInstall: opts.autoInstall,
-                skipObservability: opts.skipObservability === true,
-                skipClusterCreate: opts.skipClusterCreate === true,
-                skipPrepull: opts.skipPrepull === true,
-                verbose: opts.verbose === true,
-                hostCpDevPath: opts.hostCpDevPath,
-            });
-            process.exitCode = result.exitCode;
-        }
-        catch (err) {
-            printError(err instanceof Error ? err.message : String(err));
-            process.exitCode = EXIT_GENERIC_ERROR;
-        }
-    });
-}
-export function registerBootstrap(program) {
-    // `olam setup` is registered separately in commands/setup.ts as the 7-phase
-    // operator-onboarding wizard (system check → bootstrap → shell init →
-    // auth → doctor). It calls `olam bootstrap` as Phase 3. This command stays
-    // as the lower-level substrate bring-up primitive; operators can call it
-    // directly to re-run just the substrate steps.
-    buildSetupCommand(program, 'bootstrap');
-}
-//# sourceMappingURL=bootstrap.js.map

package/dist/commands/bootstrap.js.map

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

package/dist/commands/clean.d.ts

@@ -1,41 +0,0 @@
-/**
- * olam clean — reap orphan world filesystem state.
- *
- * The "no new orphans" half of the contract:
- *   - destroy.ts → destroyWorld() already calls fs.rmSync on the
- *     workspace dir, but the result is best-effort (try/catch swallows).
- *   - This command audits ~/.olam/worlds/<id>/ against the live
- *     registry + git worktree state, and either lists what's drift
- *     (default, dry-run) or reaps it (`--apply`).
- *
- * Categorisation of each on-disk world:
- *
- *   active     — registry knows about it AND status != destroyed.
- *                Always preserved. Excluded from --apply.
- *
- *   dirty      — git worktree registered AND has uncommitted changes
- *                or unpushed commits. Preserved by default; deletable
- *                via `--include-dirty` (with a final summary list so
- *                the operator sees what's about to disappear).
- *
- *   stale-wt   — git worktree registered but clean (no uncommits, no
- *                unpushed). Reaped via `git worktree remove --force`,
- *                which drops both the registration AND the directory.
- *
- *   orphan     — neither in the registry nor a registered worktree.
- *                Just a directory on disk. Reaped via `rm -rf`.
- *
- * Default invocation prints the table + total reclaimable bytes and
- * exits 0 without touching disk. `--apply` performs the reap.
- */
-import type { Command } from 'commander';
-interface CleanOptions {
-    readonly apply: boolean;
-    readonly includeDirty: boolean;
-    readonly yes: boolean;
-    readonly json: boolean;
-}
-export declare function registerClean(program: Command): void;
-export declare function runClean(opts: CleanOptions): Promise<number>;
-export {};
-//# sourceMappingURL=clean.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,UAAU,YAAY;IACpB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBpD;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CA8FlE"}