@pleri/olam-cli 0.1.11 → 0.1.13

package/dist/commands/__tests__/crystallize.test.js

@@ -0,0 +1,133 @@
+// A1 (Phase A — fresh-install self-bootstrap): when PLERI is not configured,
+// `olam crystallize` exits 2 (named constant) with a stderr-only warn so
+// piped scripts can detect "skipped" without parsing stdout.
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import { Command } from 'commander';
+import { registerCrystallize } from '../crystallize.js';
+import { EXIT_PLERI_NOT_CONFIGURED } from '../../exit-codes.js';
+import * as ctxModule from '../../context.js';
+function captureStreams() {
+    const sink = { stdout: '', stderr: '' };
+    const origStdout = process.stdout.write.bind(process.stdout);
+    const origStderr = process.stderr.write.bind(process.stderr);
+    process.stdout.write = (chunk) => {
+        sink.stdout += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString();
+        return true;
+    };
+    process.stderr.write = (chunk) => {
+        sink.stderr += typeof chunk === 'string' ? chunk : Buffer.from(chunk).toString();
+        return true;
+    };
+    // Save originals on the sink so the caller can restore them.
+    sink.restore = () => {
+        process.stdout.write = origStdout;
+        process.stderr.write = origStderr;
+    };
+    return sink;
+}
+describe('olam crystallize — PLERI not configured', () => {
+    let originalExitCode;
+    beforeEach(() => {
+        originalExitCode = process.exitCode;
+        process.exitCode = 0;
+    });
+    afterEach(() => {
+        process.exitCode = originalExitCode ?? 0;
+        vi.restoreAllMocks();
+    });
+    it('exits with EXIT_PLERI_NOT_CONFIGURED (2) when ctx.pleriClient is null', async () => {
+        // Stub loadContext to return a ctx with no pleriClient (PLERI not configured).
+        vi.spyOn(ctxModule, 'loadContext').mockResolvedValue({
+            ctx: {
+                // Minimal shape — only the field crystallize reads at the gate is needed.
+                pleriClient: null,
+            },
+            error: undefined,
+        });
+        const program = new Command();
+        registerCrystallize(program);
+        const sink = captureStreams();
+        try {
+            // commander throws on `process.exit` calls but we set exitCode + return,
+            // so this is just an async function call.
+            await program.parseAsync(['node', 'olam', 'crystallize', 'fake-world-id']);
+        }
+        finally {
+            sink.restore();
+        }
+        expect(process.exitCode).toBe(EXIT_PLERI_NOT_CONFIGURED);
+        expect(process.exitCode).toBe(2);
+        expect(sink.stderr).toContain('crystallize requires PLERI_BASE_URL');
+        expect(sink.stdout).toBe('');
+    });
+    it('keeps stdout empty so piped consumers can distinguish skip from success', async () => {
+        vi.spyOn(ctxModule, 'loadContext').mockResolvedValue({
+            // Match production shape: pleriClient is `undefined` when not configured
+            // (set conditionally inside `if (config.pleri)` in context.ts).
+            ctx: {
+                pleriClient: undefined,
+            },
+            error: undefined,
+        });
+        const program = new Command();
+        registerCrystallize(program);
+        const sink = captureStreams();
+        try {
+            await program.parseAsync(['node', 'olam', 'crystallize', 'any-world']);
+        }
+        finally {
+            sink.restore();
+        }
+        // The contract: stdout is empty on skip; stderr carries the warn.
+        expect(sink.stdout.length).toBe(0);
+        expect(sink.stderr.length).toBeGreaterThan(0);
+    });
+    it('exits 2 on a truly fresh install (no .olam/ dir → OlamConfigNotFoundError)', async () => {
+        // The "fresh-install" scenario this epic is named after: a user runs
+        // `npm i -g @pleri/olam-cli && olam crystallize <world>` on a project
+        // with no `.olam/` directory at all. PLERI is by definition not
+        // configured; the skip semantics should match the partial-config case.
+        const configNotFound = new Error('No olam config found');
+        configNotFound.name = 'OlamConfigNotFoundError';
+        vi.spyOn(ctxModule, 'loadContext').mockResolvedValue({
+            ctx: undefined,
+            error: configNotFound,
+        });
+        const program = new Command();
+        registerCrystallize(program);
+        const sink = captureStreams();
+        try {
+            await program.parseAsync(['node', 'olam', 'crystallize', 'fresh-install-world']);
+        }
+        finally {
+            sink.restore();
+        }
+        expect(process.exitCode).toBe(EXIT_PLERI_NOT_CONFIGURED);
+        expect(sink.stderr).toContain('crystallize requires PLERI_BASE_URL');
+        expect(sink.stderr).toContain('Olam is not initialised');
+        expect(sink.stdout).toBe('');
+    });
+    it('warn message names the remediation path (config or env var)', async () => {
+        vi.spyOn(ctxModule, 'loadContext').mockResolvedValue({
+            // Match production shape: pleriClient is `undefined` when not configured
+            // (set conditionally inside `if (config.pleri)` in context.ts).
+            ctx: {
+                pleriClient: undefined,
+            },
+            error: undefined,
+        });
+        const program = new Command();
+        registerCrystallize(program);
+        const sink = captureStreams();
+        try {
+            await program.parseAsync(['node', 'olam', 'crystallize', 'world']);
+        }
+        finally {
+            sink.restore();
+        }
+        // Operators looking at the warn line need to know how to enable the feature.
+        expect(sink.stderr).toMatch(/PLERI_BASE_URL/);
+        expect(sink.stderr).toMatch(/\.olam\/config\.yaml/);
+    });
+});
+//# sourceMappingURL=crystallize.test.js.map

package/dist/commands/__tests__/crystallize.test.js.map

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

package/dist/commands/__tests__/upgrade.all-three.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Verifies Phase 2a A4 sequential build orchestration: `olam upgrade` invokes
+ * `bash build-auth.sh` → `bash build-devbox.sh` → `bash build-host-cp.sh` in
+ * that order with `OLAM_TAG=olam-next` env, and the devbox step uses inherit
+ * stdio (live tee) for cold-cache visibility.
+ *
+ * The CLI source is read as text and parsed for the load-bearing invariants:
+ *   - Build scripts listed in correct order
+ *   - OLAM_TAG=olam-next env propagated
+ *   - Devbox uses tee (inherit stdio) per F13 audit fix
+ *   - Other two use silent runStep capture
+ *
+ * Direct integration testing (spawning real `bash build-*.sh`) lives at
+ * tests/integration/build-scripts-olam-tag.sh — manual smoke; not in CI.
+ *
+ * Run: `cd packages/cli && npx vitest run src/commands/__tests__/upgrade.all-three.test.ts`
+ */
+export {};
+//# sourceMappingURL=upgrade.all-three.test.d.ts.map

package/dist/commands/__tests__/upgrade.all-three.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.all-three.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/upgrade.all-three.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/commands/__tests__/upgrade.all-three.test.js

@@ -0,0 +1,92 @@
+/**
+ * Verifies Phase 2a A4 sequential build orchestration: `olam upgrade` invokes
+ * `bash build-auth.sh` → `bash build-devbox.sh` → `bash build-host-cp.sh` in
+ * that order with `OLAM_TAG=olam-next` env, and the devbox step uses inherit
+ * stdio (live tee) for cold-cache visibility.
+ *
+ * The CLI source is read as text and parsed for the load-bearing invariants:
+ *   - Build scripts listed in correct order
+ *   - OLAM_TAG=olam-next env propagated
+ *   - Devbox uses tee (inherit stdio) per F13 audit fix
+ *   - Other two use silent runStep capture
+ *
+ * Direct integration testing (spawning real `bash build-*.sh`) lives at
+ * tests/integration/build-scripts-olam-tag.sh — manual smoke; not in CI.
+ *
+ * Run: `cd packages/cli && npx vitest run src/commands/__tests__/upgrade.all-three.test.ts`
+ */
+import { describe, it, expect } from 'vitest';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+function findRepoRoot(start) {
+    let dir = start;
+    for (let i = 0; i < 10; i++) {
+        if (fs.existsSync(path.join(dir, 'packages', 'host-cp', 'compose.yaml')))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    throw new Error(`Could not find repo root from ${start}`);
+}
+const REPO_ROOT = findRepoRoot(process.cwd());
+const UPGRADE_TS = path.join(REPO_ROOT, 'packages', 'cli', 'src', 'commands', 'upgrade.ts');
+describe('Phase 2a A4 — sequential build orchestration', () => {
+    let body;
+    it('reads the upgrade.ts source', () => {
+        body = fs.readFileSync(UPGRADE_TS, 'utf-8');
+        expect(body.length).toBeGreaterThan(1000);
+    });
+    it('declares OLAM_TAG=olam-next env for the build steps', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        expect(body).toMatch(/OLAM_TAG:\s*['"]olam-next['"]/);
+    });
+    it('lists the three build scripts in correct order (auth → devbox → host-cp) inside buildScripts[]', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        // Scope the order check to the buildScripts array literal (other mentions
+        // of build-host-cp.sh exist in the file's doc comment + the printed plan).
+        const arrayMatch = body.match(/buildScripts:[\s\S]*?=\s*\[[\s\S]*?\];/);
+        expect(arrayMatch).not.toBeNull();
+        const arrayBody = arrayMatch[0];
+        const authIdx = arrayBody.indexOf('build-auth.sh');
+        const devboxIdx = arrayBody.indexOf('build-devbox.sh');
+        const hostCpIdx = arrayBody.indexOf('build-host-cp.sh');
+        expect(authIdx).toBeGreaterThan(0);
+        expect(devboxIdx).toBeGreaterThan(authIdx);
+        expect(hostCpIdx).toBeGreaterThan(devboxIdx);
+    });
+    it('marks the devbox step as tee:true (inherit stdio) for cold-cache visibility (F13 fix)', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        // The devbox entry in the buildScripts array should have tee: true.
+        // Look for the literal "build-devbox.sh" entry and verify the same line
+        // (or nearby) sets tee: true.
+        const devboxLine = body
+            .split('\n')
+            .find((line) => line.includes('build-devbox.sh') && line.includes('tee'));
+        expect(devboxLine).toBeDefined();
+        expect(devboxLine).toMatch(/tee:\s*true/);
+    });
+    it('marks auth + host-cp steps as tee:false (silent runStep)', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        const lines = body.split('\n');
+        const authLine = lines.find((line) => line.includes('build-auth.sh') && line.includes('tee'));
+        const hostCpLine = lines.find((line) => line.includes('build-host-cp.sh') && line.includes('tee'));
+        expect(authLine).toMatch(/tee:\s*false/);
+        expect(hostCpLine).toMatch(/tee:\s*false/);
+    });
+    it('uses spawnSync with stdio: inherit for the tee branch', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        // The tee branch should call spawnSync with stdio: 'inherit'.
+        expect(body).toMatch(/spawnSync\([\s\S]*?stdio:\s*['"]inherit['"]/);
+    });
+    it('failure path exits with code 1 on any build script failure', () => {
+        body ??= fs.readFileSync(UPGRADE_TS, 'utf-8');
+        // The orchestration loop should set process.exitCode = 1 on failure.
+        // Look for the buildScripts loop body containing the exitCode = 1 pattern.
+        const loopMatch = body.match(/for\s*\(\s*const\s+step\s+of\s+buildScripts[\s\S]*?\n\s*\}\n/);
+        expect(loopMatch).not.toBeNull();
+        expect(loopMatch[0]).toMatch(/process\.exitCode\s*=\s*1/);
+    });
+});
+//# sourceMappingURL=upgrade.all-three.test.js.map

package/dist/commands/__tests__/upgrade.all-three.test.js.map

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

package/dist/commands/__tests__/upgrade.history.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Phase 2c — verifies C1 (~/.olam/upgrade.log JSONL writer) + C2 (--history flag).
+ *
+ * Tests:
+ *   - appendUpgradeLog: open-per-write, mkdir defensively
+ *   - readUpgradeLog: ENOENT → empty; corrupt JSON skipped + stderr warn
+ *   - formatHistoryTable / formatHistoryJson: render shape
+ *   - formatDuration: ms / s / m / h
+ *   - parseHistoryOpts: --history -n <N> --json
+ *   - handleHistory wired from upgrade.ts
+ *
+ * Run: `cd packages/cli && npx vitest run src/commands/__tests__/upgrade.history.test.ts`
+ */
+export {};
+//# sourceMappingURL=upgrade.history.test.d.ts.map

package/dist/commands/__tests__/upgrade.history.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.history.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/upgrade.history.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/commands/__tests__/upgrade.history.test.js

@@ -0,0 +1,199 @@
+/**
+ * Phase 2c — verifies C1 (~/.olam/upgrade.log JSONL writer) + C2 (--history flag).
+ *
+ * Tests:
+ *   - appendUpgradeLog: open-per-write, mkdir defensively
+ *   - readUpgradeLog: ENOENT → empty; corrupt JSON skipped + stderr warn
+ *   - formatHistoryTable / formatHistoryJson: render shape
+ *   - formatDuration: ms / s / m / h
+ *   - parseHistoryOpts: --history -n <N> --json
+ *   - handleHistory wired from upgrade.ts
+ *
+ * Run: `cd packages/cli && npx vitest run src/commands/__tests__/upgrade.history.test.ts`
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { appendUpgradeLog, readUpgradeLog, formatHistoryTable, formatHistoryJson, formatDuration, } from '../upgrade-log.js';
+import { parseHistoryOpts } from '../upgrade-history.js';
+let tmpHome;
+let tmpLogPath;
+beforeEach(() => {
+    tmpHome = fs.mkdtempSync(path.join(os.tmpdir(), 'olam-history-test-'));
+    tmpLogPath = path.join(tmpHome, '.olam', 'upgrade.log');
+});
+afterEach(() => {
+    try {
+        fs.rmSync(tmpHome, { recursive: true, force: true });
+    }
+    catch {
+        /* best effort */
+    }
+});
+function makeRow(overrides = {}) {
+    return {
+        ts: '2026-05-07T10:00:00.000Z',
+        started_at: 1000,
+        ended_at: 2000,
+        sha_target: '1234567890abcdef1234567890abcdef12345678',
+        sha_before: { hostCp: 'aaaaaaaa', authService: 'aaaaaaaa', devbox: 'aaaaaaaa' },
+        sha_after: { hostCp: '12345678', authService: '12345678', devbox: '12345678' },
+        status: 'success',
+        failed_step: null,
+        durations_ms: { 'git pull': 200, 'bash build-host-cp.sh': 800 },
+        ...overrides,
+    };
+}
+describe('appendUpgradeLog', () => {
+    it('creates ~/.olam/ defensively before append', () => {
+        // Note: HOME is set to tmpHome by beforeEach.
+        const expectedPath = path.join(tmpHome, '.olam', 'upgrade.log');
+        expect(fs.existsSync(path.dirname(expectedPath))).toBe(false);
+        appendUpgradeLog(makeRow(), tmpLogPath);
+        expect(fs.existsSync(path.dirname(expectedPath))).toBe(true);
+        expect(fs.existsSync(expectedPath)).toBe(true);
+    });
+    it('appends one JSONL row per call (newline-terminated)', () => {
+        appendUpgradeLog(makeRow({ ts: '2026-05-07T10:00:00.000Z' }), tmpLogPath);
+        appendUpgradeLog(makeRow({ ts: '2026-05-07T10:05:00.000Z' }), tmpLogPath);
+        const logPath = path.join(tmpHome, '.olam', 'upgrade.log');
+        const raw = fs.readFileSync(logPath, 'utf-8');
+        const lines = raw.split('\n').filter((l) => l.length > 0);
+        expect(lines.length).toBe(2);
+        const parsed1 = JSON.parse(lines[0]);
+        const parsed2 = JSON.parse(lines[1]);
+        expect(parsed1.ts).toBe('2026-05-07T10:00:00.000Z');
+        expect(parsed2.ts).toBe('2026-05-07T10:05:00.000Z');
+    });
+    it('failure to append is swallowed (does not throw)', () => {
+        // Make ~/.olam unwritable: replace with a regular file.
+        fs.mkdirSync(tmpHome, { recursive: true });
+        fs.writeFileSync(path.join(tmpHome, '.olam'), 'this-is-a-file-not-a-dir');
+        // Should not throw; logs warning to stderr (we don't assert on stderr here).
+        expect(() => appendUpgradeLog(makeRow(), path.join(tmpHome, '.olam', 'upgrade.log'))).not.toThrow();
+    });
+});
+describe('readUpgradeLog', () => {
+    it('returns empty array when log file is missing', () => {
+        const rows = readUpgradeLog(10, tmpLogPath);
+        expect(rows).toEqual([]);
+    });
+    it('returns empty array when log file is empty', () => {
+        fs.mkdirSync(path.join(tmpHome, '.olam'), { recursive: true });
+        fs.writeFileSync(path.join(tmpHome, '.olam', 'upgrade.log'), '');
+        expect(readUpgradeLog(10, tmpLogPath)).toEqual([]);
+    });
+    it('reads the most-recent N rows (chronological order, last-N)', () => {
+        for (let i = 0; i < 5; i++) {
+            appendUpgradeLog(makeRow({ ts: `2026-05-07T${String(i).padStart(2, '0')}:00:00.000Z` }), tmpLogPath);
+        }
+        const rows = readUpgradeLog(3, tmpLogPath);
+        expect(rows.length).toBe(3);
+        // Should be the LAST three (chronologically — most recent in the file).
+        expect(rows[0].ts).toBe('2026-05-07T02:00:00.000Z');
+        expect(rows[1].ts).toBe('2026-05-07T03:00:00.000Z');
+        expect(rows[2].ts).toBe('2026-05-07T04:00:00.000Z');
+    });
+    it('skips corrupt JSON lines + warns to stderr (does not crash)', () => {
+        fs.mkdirSync(path.join(tmpHome, '.olam'), { recursive: true });
+        const logPath = path.join(tmpHome, '.olam', 'upgrade.log');
+        const goodLine = JSON.stringify(makeRow({ ts: '2026-05-07T10:00:00.000Z' }));
+        const corrupt = '{ this is not valid JSON';
+        fs.writeFileSync(logPath, `${goodLine}\n${corrupt}\n${goodLine}\n`);
+        const stderr = vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        const rows = readUpgradeLog(10, tmpLogPath);
+        expect(rows.length).toBe(2); // 2 good, 1 skipped corrupt
+        expect(stderr).toHaveBeenCalled();
+        stderr.mockRestore();
+    });
+    it('skips rows that lack required fields (defensive shape check)', () => {
+        fs.mkdirSync(path.join(tmpHome, '.olam'), { recursive: true });
+        const logPath = path.join(tmpHome, '.olam', 'upgrade.log');
+        const badShape = JSON.stringify({ random: 'object', without: 'required fields' });
+        const good = JSON.stringify(makeRow());
+        fs.writeFileSync(logPath, `${badShape}\n${good}\n`);
+        const stderr = vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        const rows = readUpgradeLog(10, tmpLogPath);
+        expect(rows.length).toBe(1);
+        stderr.mockRestore();
+    });
+});
+describe('formatHistoryTable', () => {
+    it('returns friendly first-run message on empty rows', () => {
+        expect(formatHistoryTable([])).toMatch(/No upgrade history yet/);
+    });
+    it('renders header + rows for a populated log', () => {
+        const out = formatHistoryTable([makeRow()]);
+        expect(out).toMatch(/TIMESTAMP/);
+        expect(out).toMatch(/STATUS/);
+        expect(out).toMatch(/DURATION/);
+        expect(out).toMatch(/12345678/); // first 8 of sha_target
+        expect(out).toMatch(/✓ success/);
+    });
+    it('marks failed rows with ✗ + step label', () => {
+        const out = formatHistoryTable([
+            makeRow({ status: 'failed', failed_step: 'bash build-auth.sh' }),
+        ]);
+        expect(out).toMatch(/✗ failed/);
+        expect(out).toContain('bash build-auth.sh');
+    });
+    it('marks rolled_back rows with ↩', () => {
+        const out = formatHistoryTable([makeRow({ status: 'rolled_back' })]);
+        expect(out).toMatch(/↩ rolled_back/);
+    });
+});
+describe('formatHistoryJson', () => {
+    it('returns JSONL (one JSON object per line, no trailing newline)', () => {
+        const out = formatHistoryJson([makeRow({ ts: '2026-05-07T10:00:00.000Z' }), makeRow({ ts: '2026-05-07T10:05:00.000Z' })]);
+        const lines = out.split('\n');
+        expect(lines.length).toBe(2);
+        const parsed1 = JSON.parse(lines[0]);
+        const parsed2 = JSON.parse(lines[1]);
+        expect(parsed1.ts).toBe('2026-05-07T10:00:00.000Z');
+        expect(parsed2.ts).toBe('2026-05-07T10:05:00.000Z');
+    });
+    it('returns empty string on empty rows', () => {
+        expect(formatHistoryJson([])).toBe('');
+    });
+});
+describe('formatDuration', () => {
+    it('renders ms for sub-second', () => {
+        expect(formatDuration(500)).toBe('500ms');
+    });
+    it('renders s for sub-minute', () => {
+        expect(formatDuration(45_000)).toBe('45s');
+    });
+    it('renders m + s for sub-hour', () => {
+        expect(formatDuration(125_000)).toBe('2m05s');
+    });
+    it('renders h + m for hour-plus', () => {
+        expect(formatDuration(3_780_000)).toBe('1h03m');
+    });
+});
+describe('parseHistoryOpts', () => {
+    it('parses -n string number', () => {
+        expect(parseHistoryOpts({ n: '5' }).limit).toBe(5);
+    });
+    it('parses -n numeric', () => {
+        expect(parseHistoryOpts({ n: 7 }).limit).toBe(7);
+    });
+    it('defaults limit to 10 when -n absent', () => {
+        expect(parseHistoryOpts({}).limit).toBe(10);
+    });
+    it('clamps non-positive -n to default 10', () => {
+        expect(parseHistoryOpts({ n: '0' }).limit).toBe(10);
+        expect(parseHistoryOpts({ n: '-3' }).limit).toBe(10);
+    });
+    it('parses --json flag', () => {
+        expect(parseHistoryOpts({ json: true }).json).toBe(true);
+        expect(parseHistoryOpts({ json: false }).json).toBe(false);
+    });
+});
+describe('Phase 2c — wired in handleUpgrade', () => {
+    it('upgrade.ts dispatches to handleHistory when opts.history', () => {
+        const upgradeTs = fs.readFileSync(path.join(__dirname, '..', 'upgrade.ts'), 'utf-8');
+        expect(upgradeTs).toMatch(/if\s*\(opts\.history\)\s*\{[\s\S]*?handleHistory\(/);
+    });
+});
+//# sourceMappingURL=upgrade.history.test.js.map

package/dist/commands/__tests__/upgrade.history.test.js.map

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

package/dist/commands/__tests__/upgrade.lock.test.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Unit tests for `olam upgrade` CLI lock (Phase 2a — A1).
+ *
+ * Verifies the contract from `packages/cli/src/commands/upgrade-lock.ts`:
+ *   - Atomic create-or-fail via fs.openSync 'wx'
+ *   - Stale-lock recovery (empty / parse-error / dead-pid / >30min timeout)
+ *   - PID liveness check via process.kill(pid, 0)
+ *   - Command-name check via `ps -p <pid> -o comm=`
+ *   - Idempotent release
+ *   - Concurrent-acquisition refusal
+ *
+ * Run: `cd packages/cli && npx vitest run src/commands/__tests__/upgrade.lock.test.ts`
+ */
+export {};
+//# sourceMappingURL=upgrade.lock.test.d.ts.map

package/dist/commands/__tests__/upgrade.lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.lock.test.d.ts","sourceRoot":"","sources":["../../../src/commands/__tests__/upgrade.lock.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}