@pleri/olam-cli 0.1.200 → 0.1.204

package/dist/lib/config.js

@@ -1,246 +0,0 @@
-/**
- * config.ts — `~/.olam/config.json` / `~/.olam/config.yaml` helper for olam-cli.
- *
- * Phase 1b A1 of olam-host-suite-phase-1b-k3s-beta-flavour (plan
- * ~/.claude/plans/olam-host-suite-phase-1b-k3s-beta-flavour.md).
- *
- * Schema v1 (Decision 1 — config is the substrate-state seam):
- *   {
- *     "config.schema": 1,
- *     "host": { "substrate": "compose" | "kubernetes" },
- *     "install_id": "<uuid-v4>"
- *   }
- *
- * - `install_id` is generated once on first config write; persists thereafter;
- *   never rotated. Used by instrumentation events (D21) to enable
- *   distinct-operator counting at month-6 retro.
- * - Graceful fallback to `{config.schema: 1, host: {substrate: 'compose'}, install_id}`
- *   if file missing or invalid (T1 — never crash).
- * - `~/.olam/state/` directory ensured to exist (recursive mkdir) before any
- *   state-file writes elsewhere in olam-cli (Phase A1 closes feasibility F3-03
- *   from pass-3 review).
- * - Both `config.json` AND `config.yaml` are accepted. Read-priority: `.json`
- *   first (existing behaviour preserved); `.yaml` as fallback. Writes preserve
- *   the source format (yaml-in → yaml-out). Fresh installs default to `.json`.
- */
-import { existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { homedir, tmpdir } from 'node:os';
-import { join, dirname } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
-export const OLAM_HOME = join(homedir(), '.olam');
-export const OLAM_STATE_DIR = join(OLAM_HOME, 'state');
-/**
- * Resolve the global config path within a given olam home directory.
- *
- * Read-precedence: `.json` wins when both files exist (preserves existing
- * behaviour for current operators). `.yaml` used as fallback (per-repo
- * `.olam/config.yaml` parity). Defaults to `.json` when neither exists so
- * fresh installs continue to write JSON.
- */
-export function resolveConfigPath(home = OLAM_HOME) {
-    const jsonPath = join(home, 'config.json');
-    const yamlPath = join(home, 'config.yaml');
-    if (existsSync(jsonPath))
-        return jsonPath;
-    if (existsSync(yamlPath))
-        return yamlPath;
-    return jsonPath;
-}
-/**
- * Get the resolved global config path at call-time.
- *
- * Prefer this over `OLAM_CONFIG_PATH` when you need the live, filesystem-
- * sensitive resolution (e.g. in tests that manipulate HOME). `OLAM_CONFIG_PATH`
- * is resolved once at module-load and is kept for backwards compatibility.
- */
-export function getOlamConfigPath() {
-    return resolveConfigPath();
-}
-/** @deprecated Use `getOlamConfigPath()` for live resolution. Kept for backwards compat. */
-export const OLAM_CONFIG_PATH = resolveConfigPath();
-/**
- * Resolve the default config path for callers that don't inject one.
- *
- * Under Vitest (`process.env.VITEST` is set by the runner), redirect the
- * default to a per-process tmp file so a test that calls `readConfig()` /
- * `writeConfig()` WITHOUT an explicit `configPath` cannot read or clobber the
- * operator's real `~/.olam/config.json`. This closes a real test-pollution
- * bug: a full `npm test` was observed to overwrite the operator's live config
- * (dropping `host.kubectl_context_pinned`) because non-hermetic tests hit the
- * default path. Tests that pass an explicit `configPath` are unaffected.
- */
-function defaultConfigPath() {
-    if (process.env['VITEST']) {
-        return join(tmpdir(), `olam-vitest-config-${process.pid}.json`);
-    }
-    return resolveConfigPath();
-}
-/** Return true when `p` should be treated as YAML (by extension). */
-function isYamlPath(p) {
-    return p.endsWith('.yaml') || p.endsWith('.yml');
-}
-// k3s mode is the canonical olam substrate as of feat/cli-bootstrap-k3s-default
-// (2026-05-22). Fresh installs default to `kubernetes`; existing installs whose
-// ~/.olam/config.json explicitly carries `host.substrate: 'compose'` keep their
-// current behaviour (compose mode remains supported but is no longer the
-// default). To pin compose on a fresh install: `olam config set host.substrate compose`.
-const DEFAULT_SUBSTRATE = 'kubernetes';
-function makeDefaultConfig() {
-    return {
-        'config.schema': 1,
-        host: { substrate: DEFAULT_SUBSTRATE },
-        install_id: randomUUID(),
-    };
-}
-function ensureStateDir(stateDir = OLAM_STATE_DIR) {
-    if (!existsSync(stateDir)) {
-        mkdirSync(stateDir, { recursive: true });
-    }
-}
-export function isValidConfig(value) {
-    if (typeof value !== 'object' || value === null)
-        return false;
-    const v = value;
-    if (v['config.schema'] !== 1)
-        return false;
-    if (typeof v.host !== 'object' || v.host === null)
-        return false;
-    const host = v.host;
-    if (host.substrate !== 'compose' && host.substrate !== 'kubernetes')
-        return false;
-    if (typeof v.install_id !== 'string' || v.install_id.length === 0)
-        return false;
-    return true;
-}
-function atomicWriteJSON(path, value, stderr = process.stderr) {
-    ensureStateDir();
-    const dir = dirname(path);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    const tmp = `${path}.tmp.${process.pid}`;
-    try {
-        writeFileSync(tmp, JSON.stringify(value, null, 2) + '\n', { encoding: 'utf8' });
-        renameSync(tmp, path);
-    }
-    catch (err) {
-        if (existsSync(tmp)) {
-            try {
-                unlinkSync(tmp);
-            }
-            catch {
-                // best-effort cleanup; surface original error to caller
-            }
-        }
-        stderr.write(`[WARN] olam config write failed: ${err instanceof Error ? err.message : String(err)}\n`);
-        throw err;
-    }
-}
-function atomicWriteYaml(path, value, stderr = process.stderr) {
-    ensureStateDir();
-    const dir = dirname(path);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    const tmp = `${path}.tmp.${process.pid}`;
-    try {
-        writeFileSync(tmp, stringifyYaml(value), { encoding: 'utf8' });
-        renameSync(tmp, path);
-    }
-    catch (err) {
-        if (existsSync(tmp)) {
-            try {
-                unlinkSync(tmp);
-            }
-            catch {
-                // best-effort cleanup; surface original error to caller
-            }
-        }
-        stderr.write(`[WARN] olam config write failed: ${err instanceof Error ? err.message : String(err)}\n`);
-        throw err;
-    }
-}
-function atomicWrite(path, value, stderr = process.stderr) {
-    if (isYamlPath(path)) {
-        atomicWriteYaml(path, value, stderr);
-    }
-    else {
-        atomicWriteJSON(path, value, stderr);
-    }
-}
-/**
- * Read `~/.olam/config.json` or `~/.olam/config.yaml` (or `configPath`
- * override). Returns a valid OlamConfig regardless of file state:
- *   - File missing → write default + return.
- *   - File present + valid → return parsed.
- *   - File present + malformed → emit WARN to stderr; write default + return.
- *
- * When `configPath` ends `.yaml` / `.yml` the file is parsed as YAML; otherwise
- * as JSON. Writes preserve the source format (yaml-in → yaml-out).
- *
- * Always ensures `~/.olam/state/` exists as a side-effect.
- *
- * @param opts.configPath — override for tests (default: resolved via `resolveConfigPath()`)
- * @param opts.stateDir — override for tests (default: `~/.olam/state`)
- * @param opts.stderr — override for tests (default: `process.stderr`)
- */
-export function readConfig(opts = {}) {
-    const configPath = opts.configPath ?? defaultConfigPath();
-    const stateDir = opts.stateDir ?? OLAM_STATE_DIR;
-    const stderr = opts.stderr ?? process.stderr;
-    ensureStateDir(stateDir);
-    if (!existsSync(configPath)) {
-        const fresh = makeDefaultConfig();
-        atomicWrite(configPath, fresh, stderr);
-        return fresh;
-    }
-    let parsed;
-    try {
-        const raw = readFileSync(configPath, 'utf8');
-        parsed = isYamlPath(configPath) ? parseYaml(raw) : JSON.parse(raw);
-    }
-    catch (err) {
-        stderr.write(`[WARN] olam config malformed at ${configPath}: ${err instanceof Error ? err.message : String(err)}; falling back to defaults\n`);
-        const fresh = makeDefaultConfig();
-        atomicWrite(configPath, fresh, stderr);
-        return fresh;
-    }
-    if (!isValidConfig(parsed)) {
-        stderr.write(`[WARN] olam config schema invalid at ${configPath}; falling back to defaults\n`);
-        const fresh = makeDefaultConfig();
-        atomicWrite(configPath, fresh, stderr);
-        return fresh;
-    }
-    return parsed;
-}
-/**
- * Apply a partial update to the config and persist atomically.
- *
- * Preserves `install_id` (never rotated by writeConfig). Caller MUST NOT
- * pass `install_id` in updates; if they do, the existing value wins.
- *
- * @param updates — partial config (only `host` is settable via this surface)
- * @param opts — same as readConfig for test injection
- * @returns the new OlamConfig that was persisted
- */
-export function writeConfig(updates, opts = {}) {
-    const configPath = opts.configPath ?? defaultConfigPath();
-    const stderr = opts.stderr ?? process.stderr;
-    const current = readConfig(opts);
-    // Spread `...current` first so unknown top-level keys (e.g. the `repos` /
-    // `runbooks` / `schemaVersion` slices owned by @olam/core's global-config
-    // reader, which shares this same file) survive a host-only update. Without
-    // this, writing any host.* field would silently drop the operator's repo and
-    // runbook configuration. The canonical cli/lib keys are then re-asserted on
-    // top so this writer's invariants (config.schema, preserved install_id) hold.
-    const next = {
-        ...current,
-        'config.schema': 1,
-        host: { ...current.host, ...(updates.host ?? {}) },
-        install_id: current.install_id,
-    };
-    atomicWrite(configPath, next, stderr);
-    return next;
-}
-//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/flywheel-probes.d.ts

@@ -1,58 +0,0 @@
-/**
- * Flywheel doctor probes — callable functions for `olam doctor` to consume.
- *
- * Deliberately separated from `packages/cli/src/commands/doctor.ts` so the
- * probe logic can land + be tested without touching the 945-line doctor's
- * D11 positional-contract churn. doctor.ts wiring is a focused follow-up;
- * the probe functions here are the deliverable.
- *
- * Probes:
- *   - `probeFlywheelShimHealth()` — verifies every registered shim target
- *     (per @olam/cli/lib/shim-generator SHIM_SPECS) exists at
- *     `~/.claude/scripts/<basename>` AND is the olam-generated form
- *     (contains the AUTO-GENERATED marker). Returns the probe result + a
- *     per-target breakdown.
- *
- *   - `probeSettingsHooksAudit()` — closes K1 OQ9. Scans
- *     `~/.claude/settings.json` for hook entries (PreToolUse / PostToolUse /
- *     Stop / SessionStart) that reference hardcoded `~/.claude/scripts/<n>`
- *     paths AND warns if the basename matches a shim-target that has a
- *     `replacedBy` migration path.
- *
- * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-b-tasks.md § B4 + B6
- */
-export interface ProbeResult {
-    ok: boolean;
-    warn: boolean;
-    message: string;
-}
-export interface ShimHealthDetail {
-    basename: string;
-    path: string;
-    status: 'OK' | 'MISSING' | 'STALE' | 'OPERATOR-FILE';
-}
-export interface ShimHealthResult extends ProbeResult {
-    details: ShimHealthDetail[];
-    okCount: number;
-    missingCount: number;
-    staleCount: number;
-    operatorFileCount: number;
-}
-export interface ShimHealthOpts {
-    scriptsDir?: string;
-}
-export declare function probeFlywheelShimHealth(opts?: ShimHealthOpts): ShimHealthResult;
-export interface SettingsHookEntry {
-    block: 'PreToolUse' | 'PostToolUse' | 'Stop' | 'SessionStart' | 'UserPromptSubmit';
-    command: string;
-    matchedShimBasename?: string;
-    suggestedReplacement?: string;
-}
-export interface SettingsHooksAuditResult extends ProbeResult {
-    findings: SettingsHookEntry[];
-}
-export interface SettingsHooksAuditOpts {
-    settingsPath?: string;
-}
-export declare function probeSettingsHooksAudit(opts?: SettingsHooksAuditOpts): SettingsHooksAuditResult;
-//# sourceMappingURL=flywheel-probes.d.ts.map

package/dist/lib/flywheel-probes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"flywheel-probes.d.ts","sourceRoot":"","sources":["../../src/lib/flywheel-probes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAYH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,eAAe,CAAC;CACtD;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,cAAmB,GAAG,gBAAgB,CA2DnF;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,MAAM,GAAG,cAAc,GAAG,kBAAkB,CAAC;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAyB,SAAQ,WAAW;IAC3D,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgBD,wBAAgB,uBAAuB,CAAC,IAAI,GAAE,sBAA2B,GAAG,wBAAwB,CAuDnG"}

package/dist/lib/flywheel-probes.js

@@ -1,163 +0,0 @@
-/**
- * Flywheel doctor probes — callable functions for `olam doctor` to consume.
- *
- * Deliberately separated from `packages/cli/src/commands/doctor.ts` so the
- * probe logic can land + be tested without touching the 945-line doctor's
- * D11 positional-contract churn. doctor.ts wiring is a focused follow-up;
- * the probe functions here are the deliverable.
- *
- * Probes:
- *   - `probeFlywheelShimHealth()` — verifies every registered shim target
- *     (per @olam/cli/lib/shim-generator SHIM_SPECS) exists at
- *     `~/.claude/scripts/<basename>` AND is the olam-generated form
- *     (contains the AUTO-GENERATED marker). Returns the probe result + a
- *     per-target breakdown.
- *
- *   - `probeSettingsHooksAudit()` — closes K1 OQ9. Scans
- *     `~/.claude/settings.json` for hook entries (PreToolUse / PostToolUse /
- *     Stop / SessionStart) that reference hardcoded `~/.claude/scripts/<n>`
- *     paths AND warns if the basename matches a shim-target that has a
- *     `replacedBy` migration path.
- *
- * Plan reference: docs/plans/olam-flywheel-cli-namespace/phase-b-tasks.md § B4 + B6
- */
-import { existsSync, readFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { SHIM_SPECS } from './shim-generator.js';
-import { lookupShimTarget } from '@olam/core/src/lib/shim-targets.js';
-const SHIM_AUTO_GENERATED_MARKER = '# AUTO-GENERATED by `olam flywheel install-shims`';
-const DEFAULT_SCRIPTS_DIR = join(homedir(), '.claude', 'scripts');
-const DEFAULT_SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
-export function probeFlywheelShimHealth(opts = {}) {
-    const scriptsDir = opts.scriptsDir ?? DEFAULT_SCRIPTS_DIR;
-    const details = [];
-    let okCount = 0;
-    let missingCount = 0;
-    let staleCount = 0;
-    let operatorFileCount = 0;
-    for (const spec of SHIM_SPECS) {
-        const path = join(scriptsDir, spec.basename);
-        let status;
-        if (!existsSync(path)) {
-            status = 'MISSING';
-            missingCount += 1;
-        }
-        else {
-            try {
-                const content = readFileSync(path, 'utf8');
-                if (content.includes(SHIM_AUTO_GENERATED_MARKER)) {
-                    status = 'OK';
-                    okCount += 1;
-                }
-                else {
-                    status = 'OPERATOR-FILE';
-                    operatorFileCount += 1;
-                }
-            }
-            catch {
-                status = 'STALE';
-                staleCount += 1;
-            }
-        }
-        details.push({ basename: spec.basename, path, status });
-    }
-    const totalSpecs = SHIM_SPECS.length;
-    if (missingCount === 0 && operatorFileCount === 0 && staleCount === 0) {
-        return {
-            ok: true,
-            warn: false,
-            message: `flywheel-shim-health: ${okCount}/${totalSpecs} shim targets present + auto-generated`,
-            details,
-            okCount,
-            missingCount,
-            staleCount,
-            operatorFileCount,
-        };
-    }
-    const issues = [];
-    if (missingCount > 0)
-        issues.push(`${missingCount} missing`);
-    if (operatorFileCount > 0)
-        issues.push(`${operatorFileCount} operator-file (would be backed up by --force install)`);
-    if (staleCount > 0)
-        issues.push(`${staleCount} stale`);
-    return {
-        ok: false,
-        warn: missingCount === 0 && staleCount === 0, // operator-file alone is WARN, not FAIL
-        message: `flywheel-shim-health: ${okCount}/${totalSpecs} OK, ${issues.join(', ')} — run \`olam flywheel install-shims\` to refresh (--force to backup + overwrite operator files)`,
-        details,
-        okCount,
-        missingCount,
-        staleCount,
-        operatorFileCount,
-    };
-}
-const HOOK_BLOCKS = [
-    'PreToolUse',
-    'PostToolUse',
-    'Stop',
-    'SessionStart',
-    'UserPromptSubmit',
-];
-const SCRIPT_PATH_RE = /~\/.claude\/scripts\/([\w.-]+)|\$HOME\/\.claude\/scripts\/([\w.-]+)|\/Users\/[\w.-]+\/\.claude\/scripts\/([\w.-]+)/;
-export function probeSettingsHooksAudit(opts = {}) {
-    const settingsPath = opts.settingsPath ?? DEFAULT_SETTINGS_PATH;
-    if (!existsSync(settingsPath)) {
-        return {
-            ok: true,
-            warn: false,
-            message: `settings-hooks-audit: ${settingsPath} not present; nothing to audit`,
-            findings: [],
-        };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(readFileSync(settingsPath, 'utf8'));
-    }
-    catch (err) {
-        return {
-            ok: false,
-            warn: false,
-            message: `settings-hooks-audit: cannot parse ${settingsPath} as JSON: ${err instanceof Error ? err.message : 'unknown'}`,
-            findings: [],
-        };
-    }
-    const findings = [];
-    const hooks = parsed.hooks ?? {};
-    for (const block of HOOK_BLOCKS) {
-        const entries = hooks[block] ?? [];
-        for (const entry of entries) {
-            const command = entry.command ?? '';
-            const match = SCRIPT_PATH_RE.exec(command);
-            if (match === null)
-                continue;
-            const basename = match[1] ?? match[2] ?? match[3];
-            if (basename === undefined)
-                continue;
-            const shimTarget = lookupShimTarget(basename);
-            findings.push({
-                block,
-                command,
-                ...(basename ? { matchedShimBasename: basename } : {}),
-                ...(shimTarget?.replacedBy !== undefined ? { suggestedReplacement: shimTarget.replacedBy } : {}),
-            });
-        }
-    }
-    if (findings.length === 0) {
-        return {
-            ok: true,
-            warn: false,
-            message: 'settings-hooks-audit: no hardcoded ~/.claude/scripts/ paths in hook entries',
-            findings: [],
-        };
-    }
-    const shimMatches = findings.filter((f) => f.suggestedReplacement !== undefined).length;
-    return {
-        ok: false,
-        warn: true,
-        message: `settings-hooks-audit: ${findings.length} hook entries reference hardcoded ~/.claude/scripts/<n>${shimMatches > 0 ? `, ${shimMatches} have an olam-flywheel replacement available` : ''}`,
-        findings,
-    };
-}
-//# sourceMappingURL=flywheel-probes.js.map

package/dist/lib/flywheel-probes.js.map

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