@pleri/olam-cli 0.1.201 → 0.1.205

package/dist/commands/substrate.d.ts

@@ -1,87 +0,0 @@
-/**
- * olam substrate — Manage the operator-facing deployment substrate.
- *
- * Phase 1b A2 of olam-host-suite-phase-1b-k3s-beta-flavour (plan
- * ~/.claude/plans/olam-host-suite-phase-1b-k3s-beta-flavour.md).
- *
- * Subcommands:
- *   olam substrate get               — print active substrate (+ flavor + beta-expiry)
- *   olam substrate set <substrate>   — switch to compose | kubernetes
- *
- * Decisions consumed:
- *   D1 — `~/.olam/config.json` schema-versioned seam (host.substrate)
- *   D2 — user-facing vocab is `compose | kubernetes` (NOT docker | k3s)
- *   D7 — telemetry is opt-in stdout-emission (stderr `OLAM_INSTR`)
- *   D21 — canonical instrumentation event schema (olam.instr.v1)
- *
- * Risk mitigations:
- *   T2 — pre-flight via `runDoctor` programmatically with `engine: <target>` override.
- *        Refuses with actionable remediation if prereqs fail.
- *   T3 — refuses if worlds exist on current substrate (operator must `olam destroy --all`).
- *
- * Beta-expiry date: 2026-11-16 (Phase 1b ship-date + 6 months per Falsifiable
- * signal section; surfaced in `get` output so operators see the commitment).
- */
-import type { Command } from 'commander';
-import { readConfig, writeConfig } from '../lib/config.js';
-import { emitSubstrateSet } from '../lib/instrumentation.js';
-import { type RunDoctorDeps } from './doctor.js';
-export declare const BETA_EXPIRY_DATE: "2026-11-16";
-type DoctorRunner = (opts: {
-    json?: boolean;
-}, deps?: RunDoctorDeps) => Promise<{
-    exitCode: number;
-}>;
-/** Narrowed k8s preflight runner type (matches runK8sPreflight signature). */
-type K8sPreflightRunner = (opts: {
-    json?: boolean;
-}) => Promise<{
-    exitCode: number;
-}>;
-/** Narrowed compose preflight runner type (matches runComposePreflight signature). */
-type ComposePreflightRunner = (opts: {
-    json?: boolean;
-}) => Promise<{
-    exitCode: number;
-}>;
-type WorldsCounter = () => Promise<number>;
-export type SubstrateDeps = {
-    readonly readConfig?: typeof readConfig;
-    readonly writeConfig?: typeof writeConfig;
-    readonly emit?: typeof emitSubstrateSet;
-    /**
-     * Full doctor runner. Kept on the deps surface for tests that want to assert
-     * the narrowed preflights bypass full doctor on substrate-switch. The handler
-     * itself no longer routes through this for substrate set; both directions use
-     * the narrowed preflights below.
-     */
-    readonly runDoctor?: DoctorRunner;
-    /** Narrowed k8s preflight runner (Issue #713). When omitted defaults to runK8sPreflight. */
-    readonly runK8sPreflightFn?: K8sPreflightRunner;
-    /**
-     * Narrowed compose preflight runner. Mirrors Issue #713 for the compose
-     * direction — only checks the docker daemon is reachable (the one gate an
-     * operator can satisfy BEFORE `olam bootstrap`). When omitted defaults to
-     * runComposePreflight.
-     */
-    readonly runComposePreflightFn?: ComposePreflightRunner;
-    readonly countWorlds?: WorldsCounter;
-    readonly stdout?: NodeJS.WritableStream;
-    readonly stderr?: NodeJS.WritableStream;
-};
-/**
- * Implementation of `olam substrate get`. Reads the config + prints a single
- * human-readable line. Exported for testability.
- */
-export declare function handleGet(deps?: SubstrateDeps): Promise<number>;
-/**
- * Implementation of `olam substrate set <substrate>`. Validates target, runs
- * pre-flight via doctor with the target engine, refuses on worlds-exist OR
- * doctor-fail, persists config, emits instrumentation. Exported for testability.
- *
- * Returns the desired process exit code (0 = success, 1 = refused/fail).
- */
-export declare function handleSet(target: string, deps?: SubstrateDeps): Promise<number>;
-export declare function registerSubstrate(program: Command): void;
-export {};
-//# sourceMappingURL=substrate.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"substrate.d.ts","sourceRoot":"","sources":["../../src/commands/substrate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAkB,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAmD,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKlG,eAAO,MAAM,gBAAgB,EAAG,YAAqB,CAAC;AAEtD,KAAK,YAAY,GAAG,CAClB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACxB,IAAI,CAAC,EAAE,aAAa,KACjB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnC,8EAA8E;AAC9E,KAAK,kBAAkB,GAAG,CACxB,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnC,sFAAsF;AACtF,KAAK,sBAAsB,GAAG,CAC5B,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,KACrB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEnC,KAAK,aAAa,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,WAAW,CAAC;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,gBAAgB,CAAC;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IAChD;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CACzC,CAAC;AAiBF;;;GAGG;AACH,wBAAsB,SAAS,CAAC,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAMzE;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,CAsHzF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiCxD"}

package/dist/commands/substrate.js

@@ -1,194 +0,0 @@
-/**
- * olam substrate — Manage the operator-facing deployment substrate.
- *
- * Phase 1b A2 of olam-host-suite-phase-1b-k3s-beta-flavour (plan
- * ~/.claude/plans/olam-host-suite-phase-1b-k3s-beta-flavour.md).
- *
- * Subcommands:
- *   olam substrate get               — print active substrate (+ flavor + beta-expiry)
- *   olam substrate set <substrate>   — switch to compose | kubernetes
- *
- * Decisions consumed:
- *   D1 — `~/.olam/config.json` schema-versioned seam (host.substrate)
- *   D2 — user-facing vocab is `compose | kubernetes` (NOT docker | k3s)
- *   D7 — telemetry is opt-in stdout-emission (stderr `OLAM_INSTR`)
- *   D21 — canonical instrumentation event schema (olam.instr.v1)
- *
- * Risk mitigations:
- *   T2 — pre-flight via `runDoctor` programmatically with `engine: <target>` override.
- *        Refuses with actionable remediation if prereqs fail.
- *   T3 — refuses if worlds exist on current substrate (operator must `olam destroy --all`).
- *
- * Beta-expiry date: 2026-11-16 (Phase 1b ship-date + 6 months per Falsifiable
- * signal section; surfaced in `get` output so operators see the commitment).
- */
-import pc from 'picocolors';
-import { readConfig, writeConfig } from '../lib/config.js';
-import { emitSubstrateSet } from '../lib/instrumentation.js';
-import { runDoctor, runK8sPreflight, runComposePreflight } from './doctor.js';
-import { loadContext } from '../context.js';
-import { printError, printInfo, printSuccess, printWarning } from '../output.js';
-import { registerSubstrateAuditLog } from './substrate-audit-log.js';
-export const BETA_EXPIRY_DATE = '2026-11-16';
-async function defaultCountWorlds() {
-    const { ctx } = await loadContext();
-    if (!ctx)
-        return 0;
-    return ctx.worldManager.listWorlds().length;
-}
-function formatBetaLine(cfg) {
-    if (cfg.host.substrate === 'compose') {
-        return `Substrate: ${pc.bold('compose')}`;
-    }
-    // flavor is informational only; left to D11 doctor probe to detect at runtime.
-    // Static get-time output names `k3s` as the first-supported flavor per the plan.
-    return `Substrate: ${pc.bold('kubernetes')} (beta until ${BETA_EXPIRY_DATE}, flavor=k3s)`;
-}
-/**
- * Implementation of `olam substrate get`. Reads the config + prints a single
- * human-readable line. Exported for testability.
- */
-export async function handleGet(deps = {}) {
-    const read = deps.readConfig ?? readConfig;
-    const stdout = deps.stdout ?? process.stdout;
-    const cfg = read();
-    stdout.write(formatBetaLine(cfg) + '\n');
-    return 0;
-}
-/**
- * Implementation of `olam substrate set <substrate>`. Validates target, runs
- * pre-flight via doctor with the target engine, refuses on worlds-exist OR
- * doctor-fail, persists config, emits instrumentation. Exported for testability.
- *
- * Returns the desired process exit code (0 = success, 1 = refused/fail).
- */
-export async function handleSet(target, deps = {}) {
-    const stderr = deps.stderr ?? process.stderr;
-    const stdout = deps.stdout ?? process.stdout;
-    const read = deps.readConfig ?? readConfig;
-    const write = deps.writeConfig ?? writeConfig;
-    const emit = deps.emit ?? emitSubstrateSet;
-    const runDoctorFn = deps.runDoctor ?? runDoctor;
-    const k8sPreflightFn = deps.runK8sPreflightFn ?? runK8sPreflight;
-    const composePreflightFn = deps.runComposePreflightFn ?? runComposePreflight;
-    const countWorlds = deps.countWorlds ?? defaultCountWorlds;
-    // Suppress unused-var lint when the handler doesn't currently call runDoctorFn.
-    // It stays on the deps surface for tests that assert it was NOT called.
-    void runDoctorFn;
-    if (target !== 'compose' && target !== 'kubernetes') {
-        stderr.write(`${pc.red('error:')} unsupported substrate "${target}". Expected: compose | kubernetes.\n`);
-        return 1;
-    }
-    const targetSubstrate = target;
-    const current = read();
-    if (current.host.substrate === targetSubstrate) {
-        stdout.write(`Substrate already set to ${pc.bold(targetSubstrate)}. No change.\n`);
-        return 0;
-    }
-    // T3: refuse if worlds exist on the current substrate. Operator must
-    // explicitly `olam destroy --all` to avoid bisected worlds.db state.
-    let worldsCount;
-    try {
-        worldsCount = await countWorlds();
-    }
-    catch (err) {
-        stderr.write(`${pc.yellow('warn:')} could not list worlds (${err instanceof Error ? err.message : String(err)}); assuming none exist and proceeding.\n`);
-        worldsCount = 0;
-    }
-    if (worldsCount > 0) {
-        stderr.write(`${pc.red('error:')} ${worldsCount} world(s) exist on the current substrate (${pc.bold(current.host.substrate)}). Switching substrates abandons their state.\n`);
-        stderr.write(`       Run ${pc.bold('olam destroy --all')} first, then re-run this command.\n`);
-        return 1;
-    }
-    // T2: pre-flight for the target engine.
-    //
-    // BOTH directions use a NARROWED preflight that only checks the single gate
-    // an operator can satisfy BEFORE the deploy step:
-    //   - kubernetes: kubectl present + cluster API reachable (runK8sPreflight, Issue #713)
-    //   - compose:    docker daemon reachable                  (runComposePreflight)
-    //
-    // The full `runDoctor` probe suite (host-cp health, auth vault, KG storage,
-    // engine header) requires host-cp to already be deployed on the target engine.
-    // Running it pre-deploy causes false failures — the symmetric bug to Issue #713
-    // observed in the compose direction when an operator switches FROM kubernetes
-    // TO compose on a host that has never run compose host-cp.
-    //
-    // Operators run the full `olam doctor` AFTER `olam upgrade` / `olam bootstrap`
-    // to confirm post-deploy health.
-    stdout.write(`Running pre-flight for ${pc.bold(targetSubstrate)} substrate…\n`);
-    let doctorResult;
-    try {
-        if (targetSubstrate === 'kubernetes') {
-            doctorResult = await k8sPreflightFn({ json: true });
-        }
-        else {
-            doctorResult = await composePreflightFn({ json: true });
-        }
-    }
-    catch (err) {
-        stderr.write(`${pc.red('error:')} pre-flight crashed: ${err instanceof Error ? err.message : String(err)}\n`);
-        return 1;
-    }
-    if (doctorResult.exitCode !== 0) {
-        stderr.write(`${pc.red('error:')} pre-flight failed for ${pc.bold(targetSubstrate)} substrate.\n`);
-        stderr.write(`       Run ${pc.bold(`olam doctor${targetSubstrate === 'kubernetes' ? ' --substrate=kubernetes' : ''}`)} to see what's missing, fix the named prereqs, then re-run.\n`);
-        return 1;
-    }
-    // Persist + emit only after the gates pass.
-    const next = write({ host: { substrate: targetSubstrate } });
-    emit({
-        substrate: targetSubstrate,
-        flavor: targetSubstrate === 'kubernetes' ? 'k3s' : undefined,
-    });
-    stdout.write(formatBetaLine(next) + '\n');
-    if (targetSubstrate === 'kubernetes') {
-        stdout.write(`\nKubernetes substrate is in beta until ${BETA_EXPIRY_DATE}.\n` +
-            `Rollback: ${pc.bold('olam substrate set compose')} (preserves compose worlds you create after this).\n` +
-            `Next: ${pc.bold('olam upgrade')} to deploy host-cp to your kubectl context.\n`);
-    }
-    else {
-        stdout.write(`\nNext: ${pc.bold('olam upgrade')} to redeploy host-cp on the compose substrate.\n`);
-    }
-    return 0;
-}
-export function registerSubstrate(program) {
-    const sub = program.command('substrate').description('Manage deployment substrate (beta)');
-    sub
-        .command('get')
-        .description('Print the active substrate')
-        .action(async () => {
-        try {
-            const code = await handleGet();
-            if (code !== 0)
-                process.exitCode = code;
-        }
-        catch (err) {
-            printError(`olam substrate get failed: ${err instanceof Error ? err.message : String(err)}`);
-            process.exitCode = 1;
-        }
-    });
-    sub
-        .command('set <substrate>')
-        .description('Switch substrate (compose | kubernetes)')
-        .action(async (target) => {
-        try {
-            const code = await handleSet(target);
-            if (code !== 0)
-                process.exitCode = code;
-        }
-        catch (err) {
-            printError(`olam substrate set failed: ${err instanceof Error ? err.message : String(err)}`);
-            process.exitCode = 1;
-        }
-    });
-    // Phase 1b C3 — D19: manifest-refresh audit log inspection.
-    registerSubstrateAuditLog(sub);
-}
-// Silence unused-import lints when these helpers are referenced only via
-// indirect calls (printInfo/printWarning/printSuccess are imported for parity
-// with sibling commands' patterns even though substrate uses stdout/stderr
-// directly for clean test injection).
-void printInfo;
-void printWarning;
-void printSuccess;
-//# sourceMappingURL=substrate.js.map

package/dist/commands/substrate.js.map

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

package/dist/commands/update.d.ts

@@ -1,89 +0,0 @@
-/**
- * olam update — Friendly wrapper around `npm install -g @pleri/olam-cli@<channel>`.
- *
- * F1: core install flow with snapshot-prev → install → restore-on-failure (D24)
- *     + scan-and-reconcile skill symlinks (T22/OQ29).
- * F2: --to=<ver>, --rollback, --check, --channel=<ch>.
- * F3: --freeze, --force, upgrade_blocked field check.
- *
- * T23 note: self-replace while running is harmless on POSIX — the OS keeps the
- * old inode open until exit; the new binary is a separate inode. No special
- * handling needed.
- */
-import type { Command } from 'commander';
-import { reconcileSkillSymlinks } from '../lib/symlink-reconcile.js';
-/**
- * Normalize a version string to the `vX.Y.Z` tag shape the changelog page
- * (and GitHub release tags) use. npm reports versions without the leading
- * `v` (e.g. `0.1.196`); the changelog route keys on the tag form.
- */
-export declare function normalizeVersionTag(version: string): string;
-/**
- * Build the version-range changelog URL of the shape
- * `https://olam.bar.dev/changelog/<from>/to/<to>`. Both ends are normalized
- * to the `vX.Y.Z` tag form. The range is immutable once both versions are
- * released, so the page is safely cacheable.
- */
-export declare function buildChangelogUrl(fromVersion: string, toVersion: string): string;
-/**
- * Compute the operator-facing "what changed" lines to print after an update,
- * given the from-version (previously installed) and to-version (just installed).
- *
- * Edge cases (matches the feature spec):
- *   - same version (no-op): no changelog line at all
- *   - first install (no from-version): link to the full releases page
- *   - downgrade (from > to): still emit the range URL (the page renders it)
- *   - normal upgrade: emit the range URL
- */
-export declare function changelogMessages(prevVersion: string | null | undefined, newVersion: string | null | undefined): string[];
-export interface ExecResult {
-    readonly exitCode: number;
-    readonly stdout: string;
-    readonly stderr: string;
-}
-export type ExecFn = (cmd: string) => ExecResult;
-export declare function getCurrentVersion(_exec?: ExecFn): string | null;
-export declare function readLastStable(file?: string): string | null;
-export declare function writeLastStable(version: string, file?: string): void;
-export interface UpdateOptions {
-    readonly channel?: string;
-    readonly quiet?: boolean;
-    readonly force?: boolean;
-}
-export interface UpdateResult {
-    readonly action: 'installed' | 'restored' | 'failed';
-    readonly version?: string;
-    readonly prevVersion?: string;
-    readonly exitCode: 0 | 11;
-    readonly symlinks?: {
-        added: string[];
-        removed: string[];
-    };
-}
-/** Exit code 10: `--check` returns "already on latest". */
-export interface CheckResult {
-    readonly action: 'already-current' | 'update-available';
-    readonly current: string | null;
-    readonly latest: string | null;
-    readonly exitCode: 0 | 10;
-}
-/** Exit code 14: `--rollback` with no cache. */
-export interface RollbackResult {
-    readonly action: 'rolled-back' | 'nothing-to-rollback' | 'already-at-cached' | 'failed';
-    readonly restoredVersion?: string;
-    readonly exitCode: 0 | 11 | 14;
-}
-export type WriteConfigFn = (channel: string) => Promise<void>;
-/**
- * Check whether the published package has upgrade_blocked: true in its package.json.
- * Returns true when the field is present and truthy; false otherwise (including on error).
- */
-export declare function isUpgradeBlocked(channelOrVersion: string, _exec?: ExecFn): boolean;
-export type ReadConfigFn = () => Promise<{
-    channel?: string;
-} | null>;
-export declare function doUpdate(opts: UpdateOptions, _exec?: ExecFn, _reconcile?: typeof reconcileSkillSymlinks, _readConfig?: ReadConfigFn, _getNpmRoot?: ExecFn): Promise<UpdateResult>;
-export declare function doCheck(_exec?: ExecFn): Promise<CheckResult>;
-export declare function doRollback(_exec?: ExecFn, _reconcile?: typeof reconcileSkillSymlinks, _getNpmRoot?: ExecFn): Promise<RollbackResult>;
-export declare function registerUpdate(program: Command): void;
-//# sourceMappingURL=update.d.ts.map

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

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