@opensip-cli/core 0.1.0

package/dist/lib/__tests__/retry.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect, vi } from 'vitest';
+import { withRetry } from '../../lib/retry.js';
+describe('withRetry', () => {
+    it('returns immediately on first success', async () => {
+        const fn = vi.fn().mockResolvedValue('ok');
+        const result = await withRetry(fn);
+        expect(result).toBe('ok');
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('retries on failure and succeeds', async () => {
+        const fn = vi.fn().mockRejectedValueOnce(new Error('fail1')).mockResolvedValue('ok');
+        const result = await withRetry(fn, { maxAttempts: 3, initialDelayMs: 10 });
+        expect(result).toBe('ok');
+        expect(fn).toHaveBeenCalledTimes(2);
+    });
+    it('throws after max attempts exhausted', async () => {
+        const fn = vi.fn().mockRejectedValue(new Error('always fails'));
+        await expect(withRetry(fn, { maxAttempts: 3, initialDelayMs: 10 })).rejects.toThrow('always fails');
+        expect(fn).toHaveBeenCalledTimes(3);
+    });
+    it('calls onRetry callback before each retry', async () => {
+        const onRetry = vi.fn();
+        const fn = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('fail1'))
+            .mockRejectedValueOnce(new Error('fail2'))
+            .mockResolvedValue('ok');
+        await withRetry(fn, { maxAttempts: 3, initialDelayMs: 10, onRetry });
+        expect(onRetry).toHaveBeenCalledTimes(2);
+        expect(onRetry).toHaveBeenCalledWith(1, expect.any(Error), expect.any(Number));
+        expect(onRetry).toHaveBeenCalledWith(2, expect.any(Error), expect.any(Number));
+    });
+    it('does not call onRetry if first attempt succeeds', async () => {
+        const onRetry = vi.fn();
+        const fn = vi.fn().mockResolvedValue('ok');
+        await withRetry(fn, { onRetry });
+        expect(onRetry).not.toHaveBeenCalled();
+    });
+    it('respects maxDelayMs cap', async () => {
+        const onRetry = vi.fn();
+        const fn = vi.fn().mockRejectedValueOnce(new Error('fail')).mockResolvedValue('ok');
+        await withRetry(fn, {
+            maxAttempts: 3,
+            initialDelayMs: 100,
+            maxDelayMs: 50,
+            backoffMultiplier: 10,
+            onRetry,
+        });
+        // The delay passed to onRetry should not exceed maxDelayMs
+        const delay = onRetry.mock.calls[0][2];
+        expect(delay).toBeLessThanOrEqual(50);
+    });
+    it('wraps non-Error throws in Error', async () => {
+        const fn = vi.fn().mockRejectedValue('string error');
+        await expect(withRetry(fn, { maxAttempts: 1 })).rejects.toThrow('string error');
+    });
+    it('runs at least once when maxAttempts is 0', async () => {
+        const fn = vi.fn().mockResolvedValue('ok');
+        const result = await withRetry(fn, { maxAttempts: 0 });
+        expect(result).toBe('ok');
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+    it('throws the underlying error (not undefined) when maxAttempts is NaN', async () => {
+        // Math.max(1, NaN) returns NaN, so without the Number.isFinite guard the
+        // for-loop never ran and `throw lastError!` propagated `undefined`.
+        const fn = vi.fn().mockRejectedValue(new Error('boom'));
+        await expect(withRetry(fn, { maxAttempts: Number.NaN, initialDelayMs: 10 })).rejects.toThrow('boom');
+        expect(fn).toHaveBeenCalledTimes(1);
+    });
+});
+//# sourceMappingURL=retry.test.js.map

package/dist/lib/__tests__/retry.test.js.map

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

package/dist/lib/__tests__/run-diagnostics.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * RunDiagnostics shape — serialization-safety + lifecycle-phase coverage.
+ *
+ * The contract is "JSON-emittable diagnostics carried on a CommandOutcome", so the
+ * load-bearing guarantee is a clean JSON round-trip (no functions / class
+ * instances leak in) and that every lifecycle phase is expressible.
+ */
+export {};
+//# sourceMappingURL=run-diagnostics.test.d.ts.map

package/dist/lib/__tests__/run-diagnostics.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-diagnostics.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/run-diagnostics.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/lib/__tests__/run-diagnostics.test.js

@@ -0,0 +1,61 @@
+/**
+ * RunDiagnostics shape — serialization-safety + lifecycle-phase coverage.
+ *
+ * The contract is "JSON-emittable diagnostics carried on a CommandOutcome", so the
+ * load-bearing guarantee is a clean JSON round-trip (no functions / class
+ * instances leak in) and that every lifecycle phase is expressible.
+ */
+import { describe, it, expect } from 'vitest';
+const ALL_PHASES = [
+    'discover',
+    'load',
+    'validate',
+    'execute',
+    'render',
+    'deliver',
+    'persist',
+];
+describe('RunDiagnostics', () => {
+    it('expresses an event in every lifecycle phase', () => {
+        const events = ALL_PHASES.map((phase) => ({
+            phase,
+            level: 'info',
+            message: `${phase} ran`,
+            at: '2026-06-07T00:00:00.000Z',
+        }));
+        expect(events).toHaveLength(7);
+        expect(events.map((e) => e.phase)).toEqual(ALL_PHASES);
+    });
+    it('round-trips through JSON unchanged (serialization-safe)', () => {
+        const diagnostics = {
+            runId: 'run_abc',
+            events: [
+                {
+                    phase: 'load',
+                    level: 'debug',
+                    message: 'loaded 3 plugins',
+                    at: '2026-06-07T00:00:00.000Z',
+                    data: { count: 3 },
+                },
+                {
+                    phase: 'validate',
+                    level: 'warn',
+                    message: 'unknown key ignored',
+                    at: '2026-06-07T00:00:01.000Z',
+                },
+            ],
+            metrics: { 'plugins.loaded': 3 },
+            trace: { traceId: 'abcd', spanId: 'ef01' },
+        };
+        // Genuine serialize→parse round-trip (not a deep clone): proves nothing
+        // unserializable leaks into the shape.
+        const wire = JSON.stringify(diagnostics);
+        expect(JSON.parse(wire)).toEqual(diagnostics);
+    });
+    it('is valid with only the required fields (empty run)', () => {
+        const diagnostics = { runId: 'run_empty', events: [] };
+        const wire = JSON.stringify(diagnostics);
+        expect(JSON.parse(wire)).toEqual(diagnostics);
+    });
+});
+//# sourceMappingURL=run-diagnostics.test.js.map

package/dist/lib/__tests__/run-diagnostics.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-diagnostics.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/run-diagnostics.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAI9C,MAAM,UAAU,GAA+B;IAC7C,UAAU;IACV,MAAM;IACN,UAAU;IACV,SAAS;IACT,QAAQ;IACR,SAAS;IACT,SAAS;CACV,CAAC;AAEF,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAsB,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC3D,KAAK;YACL,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,GAAG,KAAK,MAAM;YACvB,EAAE,EAAE,0BAA0B;SAC/B,CAAC,CAAC,CAAC;QACJ,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,WAAW,GAAmB;YAClC,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE;gBACN;oBACE,KAAK,EAAE,MAAM;oBACb,KAAK,EAAE,OAAO;oBACd,OAAO,EAAE,kBAAkB;oBAC3B,EAAE,EAAE,0BAA0B;oBAC9B,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;iBACnB;gBACD;oBACE,KAAK,EAAE,UAAU;oBACjB,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,qBAAqB;oBAC9B,EAAE,EAAE,0BAA0B;iBAC/B;aACF;YACD,OAAO,EAAE,EAAE,gBAAgB,EAAE,CAAC,EAAE;YAChC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;SAC3C,CAAC;QACF,wEAAwE;QACxE,uCAAuC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,WAAW,GAAmB,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACvE,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/__tests__/run-scope.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-scope.test.d.ts.map

package/dist/lib/__tests__/run-scope.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-scope.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/run-scope.test.ts"],"names":[],"mappings":""}

package/dist/lib/__tests__/run-scope.test.js

@@ -0,0 +1,202 @@
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { LanguageParseCache } from '../../languages/parse-cache.js';
+import { LanguageRegistry } from '../../languages/registry.js';
+import { ToolRegistry } from '../../tools/registry.js';
+import { logger as defaultLogger, configureLogger } from '../logger.js';
+import { RunScope, runWithScope, runWithScopeSync, currentScope, enterScope, } from '../run-scope.js';
+describe('RunScope — construction', () => {
+    it('default constructor produces a usable scope', () => {
+        const scope = new RunScope();
+        expect(scope.logger).toBe(defaultLogger);
+        expect(scope.parseCache).toBeInstanceOf(LanguageParseCache);
+        // Fresh empty registries by default — module-level singletons removed in T1 cleanup.
+        expect(scope.tools).toBeInstanceOf(ToolRegistry);
+        expect(scope.languages).toBeInstanceOf(LanguageRegistry);
+        expect(scope.tools.list()).toHaveLength(0);
+        expect(scope.languages.list()).toHaveLength(0);
+        expect(scope.projectContext).toBeUndefined();
+        expect(scope.recipeUnitConfig).toBeDefined();
+        scope.dispose();
+    });
+    it('explicit overrides are stored verbatim', () => {
+        const parseCache = new LanguageParseCache();
+        const scope = new RunScope({
+            logger: defaultLogger,
+            parseCache,
+            datastore: () => ({ kind: 'fake-store' }),
+        });
+        expect(scope.parseCache).toBe(parseCache);
+        expect(scope.datastore()).toEqual({ kind: 'fake-store' });
+        scope.dispose();
+    });
+    it('default datastore thunk returns undefined (no-store semantics, matching prior cli.datastore contract)', () => {
+        const scope = new RunScope();
+        expect(scope.datastore()).toBeUndefined();
+        scope.dispose();
+    });
+    it('default runId is the empty string (matches prior singleton reset semantics)', () => {
+        const scope = new RunScope();
+        expect(scope.runId).toBe('');
+        scope.dispose();
+    });
+    it('explicit runId is stored verbatim', () => {
+        const scope = new RunScope({ runId: 'RUN_abc123' });
+        expect(scope.runId).toBe('RUN_abc123');
+        scope.dispose();
+    });
+});
+describe('RunScope — dispose', () => {
+    it('clears parseCache and recipeUnitConfig', () => {
+        const scope = new RunScope();
+        scope.recipeUnitConfig.set('slug-a', { foo: 1 });
+        expect(scope.recipeUnitConfig.get('slug-a')).toEqual({ foo: 1 });
+        scope.dispose();
+        expect(scope.recipeUnitConfig.get('slug-a')).toBeUndefined();
+    });
+    it('does not throw on a never-used scope', () => {
+        const scope = new RunScope();
+        expect(() => scope.dispose()).not.toThrow();
+    });
+    it('idempotent — calling twice is safe', () => {
+        const scope = new RunScope();
+        scope.dispose();
+        expect(() => scope.dispose()).not.toThrow();
+    });
+});
+describe('runWithScope / currentScope', () => {
+    it('currentScope returns the bound scope inside the callback', async () => {
+        const scope = new RunScope();
+        const captured = await runWithScope(scope, () => Promise.resolve(currentScope()));
+        expect(captured).toBe(scope);
+        scope.dispose();
+    });
+    it('currentScope returns undefined outside any runWithScope block', () => {
+        expect(currentScope()).toBeUndefined();
+    });
+    it('enterScope sets the current scope for the rest of the async context', async () => {
+        // Wrap in an outer runWithScope frame so the enterWith only affects
+        // this frame's async subtree and does not leak into the test runner.
+        const outer = new RunScope();
+        const entered = new RunScope();
+        await runWithScope(outer, async () => {
+            expect(currentScope()).toBe(outer);
+            enterScope(entered);
+            // After enterScope, the current scope is the entered one — without
+            // a callback wrapper, for the remainder of this async context.
+            expect(currentScope()).toBe(entered);
+            await Promise.resolve();
+            expect(currentScope()).toBe(entered);
+        });
+        outer.dispose();
+        entered.dispose();
+    });
+    it('nested runWithScope: inner overrides; outer is restored', async () => {
+        const outer = new RunScope();
+        const inner = new RunScope();
+        let seenOuter;
+        let seenInner;
+        let seenAfter;
+        await runWithScope(outer, async () => {
+            seenOuter = currentScope();
+            await runWithScope(inner, () => {
+                seenInner = currentScope();
+                return Promise.resolve();
+            });
+            seenAfter = currentScope();
+        });
+        expect(seenOuter).toBe(outer);
+        expect(seenInner).toBe(inner);
+        expect(seenAfter).toBe(outer);
+        outer.dispose();
+        inner.dispose();
+    });
+    it('two concurrent scopes in Promise.all do not leak (ALS isolation)', async () => {
+        const scopeA = new RunScope();
+        const scopeB = new RunScope();
+        scopeA.recipeUnitConfig.set('shared', { who: 'a' });
+        scopeB.recipeUnitConfig.set('shared', { who: 'b' });
+        // Each callback yields a tick before reading its scope so the two
+        // chains interleave through the microtask queue. ALS must hold.
+        const a = runWithScope(scopeA, async () => {
+            await Promise.resolve();
+            return currentScope()?.recipeUnitConfig.get('shared');
+        });
+        const b = runWithScope(scopeB, async () => {
+            await Promise.resolve();
+            return currentScope()?.recipeUnitConfig.get('shared');
+        });
+        const [aResult, bResult] = await Promise.all([a, b]);
+        expect(aResult).toEqual({ who: 'a' });
+        expect(bResult).toEqual({ who: 'b' });
+        scopeA.dispose();
+        scopeB.dispose();
+    });
+    it('runWithScopeSync provides synchronous binding', () => {
+        const scope = new RunScope();
+        const captured = runWithScopeSync(scope, () => currentScope());
+        expect(captured).toBe(scope);
+        scope.dispose();
+    });
+});
+describe('runId — scope-bound propagation to logger event-stamping', () => {
+    const stderrCalls = [];
+    afterEach(() => {
+        vi.restoreAllMocks();
+        stderrCalls.length = 0;
+    });
+    it('scope.runId is stamped on log entries inside runWithScope', async () => {
+        vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+            stderrCalls.push(String(chunk));
+            return true;
+        });
+        // Enable stderr output by turning on debugMode. Reset runId on the
+        // singleton so the fallback isn't shadowing the scope-bound value.
+        configureLogger({ debugMode: true, silent: false, runId: '' });
+        const scope = new RunScope({ runId: 'RUN_scope_xyz' });
+        await runWithScope(scope, () => {
+            defaultLogger.info({ evt: 'test.event', msg: 'inside-scope' });
+            return Promise.resolve();
+        });
+        const matched = stderrCalls
+            .map((c) => JSON.parse(c.trim()))
+            .find((e) => e.evt === 'test.event');
+        expect(matched?.runId).toBe('RUN_scope_xyz');
+        scope.dispose();
+    });
+    it('outside any scope, the logger falls back to its singleton-level runId', () => {
+        vi.spyOn(process.stderr, 'write').mockImplementation((chunk) => {
+            stderrCalls.push(String(chunk));
+            return true;
+        });
+        configureLogger({ debugMode: true, silent: false, runId: 'RUN_singleton' });
+        defaultLogger.info({ evt: 'test.outside', msg: 'no-scope-here' });
+        const matched = stderrCalls
+            .map((c) => JSON.parse(c.trim()))
+            .find((e) => e.evt === 'test.outside');
+        expect(matched?.runId).toBe('RUN_singleton');
+    });
+});
+describe('RecipeUnitConfigSlot', () => {
+    it('get/set/setAll/clear round-trip', () => {
+        const scope = new RunScope();
+        const slot = scope.recipeUnitConfig;
+        expect(slot.get('missing')).toBeUndefined();
+        slot.set('a', { x: 1 });
+        expect(slot.get('a')).toEqual({ x: 1 });
+        slot.setAll({ b: { y: 2 }, c: { z: 3 } });
+        // setAll REPLACES the whole map
+        expect(slot.get('a')).toBeUndefined();
+        expect(slot.get('b')).toEqual({ y: 2 });
+        expect(slot.get('c')).toEqual({ z: 3 });
+        slot.clear();
+        expect(slot.get('b')).toBeUndefined();
+        expect(slot.get('c')).toBeUndefined();
+        scope.dispose();
+    });
+    it('get returns undefined for missing slug', () => {
+        const scope = new RunScope();
+        expect(scope.recipeUnitConfig.get('nope')).toBeUndefined();
+        scope.dispose();
+    });
+});
+//# sourceMappingURL=run-scope.test.js.map

package/dist/lib/__tests__/run-scope.test.js.map

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

package/dist/lib/__tests__/run-timer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-timer.test.d.ts.map

package/dist/lib/__tests__/run-timer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-timer.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/run-timer.test.ts"],"names":[],"mappings":""}

package/dist/lib/__tests__/run-timer.test.js

@@ -0,0 +1,152 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createRunLifecycle, createRunTimer } from '../run-timer.js';
+/** Busy-wait so real monotonic elapsed accrues (perf.now can't be faked reliably). */
+function spin(ms) {
+    const start = Date.now();
+    while (Date.now() - start < ms) {
+        /* spin */
+    }
+}
+describe('createRunTimer / RunTimer', () => {
+    it('produces a snapshot with startedAt, completedAt, and non-negative durationMs', () => {
+        const timer = createRunTimer();
+        const snap = timer.snapshot();
+        expect(typeof snap.startedAt).toBe('string');
+        expect(snap.startedAt).toMatch(/^\d{4}-\d{2}-\d{2}T/); // ISO-ish
+        expect(typeof snap.completedAt).toBe('string');
+        expect(typeof snap.durationMs).toBe('number');
+        expect(snap.durationMs).toBeGreaterThanOrEqual(0);
+        expect(snap.startedAt).toBe(timer.startedAt);
+    });
+    it('supports multiple snapshots with non-decreasing duration', () => {
+        const timer = createRunTimer();
+        const s1 = timer.snapshot();
+        // Busy-wait a tiny bit to allow real elapsed to grow (no fake timers on perf.now reliably)
+        const start = Date.now();
+        while (Date.now() - start < 2) {
+            /* spin */
+        }
+        const s2 = timer.snapshot();
+        expect(s2.startedAt).toBe(s1.startedAt);
+        expect(s2.durationMs).toBeGreaterThanOrEqual(s1.durationMs);
+        expect(s2.completedAt >= s1.completedAt || s2.durationMs >= s1.durationMs).toBe(true);
+    });
+    it('elapsedMs grows and snapshot duration reflects it', () => {
+        const timer = createRunTimer();
+        const e0 = timer.elapsedMs();
+        const start = Date.now();
+        while (Date.now() - start < 3) {
+            /* spin */
+        }
+        const e1 = timer.elapsedMs();
+        const snap = timer.snapshot();
+        expect(e1).toBeGreaterThanOrEqual(e0);
+        expect(snap.durationMs).toBeGreaterThanOrEqual(e1 - 1); // allow tiny scheduling noise
+    });
+    it('clamps elapsed / duration to >= 0 even if clock appears to go backwards', () => {
+        // Force the fallback path and simulate a negative delta by stubbing Date.now
+        const realNow = Date.now;
+        let call = 0;
+        const base = 1_700_000_000_000;
+        vi.spyOn(Date, 'now').mockImplementation(() => {
+            call += 1;
+            // First call (construction) returns base; subsequent return values that would yield negative
+            if (call === 1)
+                return base;
+            return base - 50; // would produce negative raw elapsed in fallback
+        });
+        try {
+            const timer = createRunTimer();
+            // Force fallback by making performance absent for this timer instance
+            // (we can't easily delete global, but the impl already captured at create time;
+            // to test clamp we temporarily make the fallback trigger by spying elapsed calc indirectly)
+            const d0 = timer.elapsedMs();
+            expect(d0).toBeGreaterThanOrEqual(0);
+            const snap = timer.snapshot();
+            expect(snap.durationMs).toBeGreaterThanOrEqual(0);
+        }
+        finally {
+            vi.restoreAllMocks();
+            // ensure Date.now is real
+            if (Date.now !== realNow) {
+                Date.now = realNow;
+            }
+        }
+    });
+    it('snapshot after a pause has non-decreasing duration and stable startedAt (enriched per Phase 7 scaffold)', () => {
+        const timer = createRunTimer();
+        const s1 = timer.snapshot();
+        const start = Date.now();
+        while (Date.now() - start < 2) {
+            /* busy-wait to let real elapsed time accrue */
+        }
+        const s2 = timer.snapshot();
+        expect(s2.startedAt).toBe(s1.startedAt);
+        expect(s2.durationMs).toBeGreaterThanOrEqual(s1.durationMs);
+    });
+});
+describe('RunTimer.complete() / RunLifecycle freeze semantics (host-owned-run-timing Phase 8)', () => {
+    it('complete() returns a snapshot with the stable startedAt and a non-negative duration', () => {
+        const timer = createRunTimer();
+        const c = timer.complete();
+        expect(c.startedAt).toBe(timer.startedAt);
+        expect(c.durationMs).toBeGreaterThanOrEqual(0);
+        expect(typeof c.completedAt).toBe('string');
+    });
+    it('is idempotent — the second complete() returns the SAME frozen object', () => {
+        const timer = createRunTimer();
+        const a = timer.complete();
+        spin(3);
+        const b = timer.complete();
+        // Same reference (frozen via `frozen ??=`) — and therefore identical values.
+        expect(b).toBe(a);
+        expect(b.completedAt).toBe(a.completedAt);
+        expect(b.durationMs).toBe(a.durationMs);
+    });
+    it('freezes completedAt + durationMs at the FIRST complete() (later wall time does not advance them)', () => {
+        const timer = createRunTimer();
+        const c = timer.complete();
+        spin(5);
+        // elapsedMs() is still LIVE and keeps ticking past the frozen completion duration.
+        expect(timer.elapsedMs()).toBeGreaterThanOrEqual(c.durationMs);
+        // But a second complete() does not re-read the clock.
+        const c2 = timer.complete();
+        expect(c2.completedAt).toBe(c.completedAt);
+        expect(c2.durationMs).toBe(c.durationMs);
+    });
+    it('snapshot() is LIVE before complete() and FROZEN (same object) after', () => {
+        const timer = createRunTimer();
+        const s1 = timer.snapshot();
+        spin(3);
+        const s2 = timer.snapshot();
+        expect(s2.durationMs).toBeGreaterThanOrEqual(s1.durationMs); // live before completion
+        const c = timer.complete();
+        spin(3);
+        const sAfter = timer.snapshot();
+        // After completion, snapshot returns the frozen completion snapshot verbatim.
+        expect(sAfter).toBe(c);
+        expect(sAfter.completedAt).toBe(c.completedAt);
+        expect(sAfter.durationMs).toBe(c.durationMs);
+    });
+    it('elapsedMs() stays live after complete() (only the snapshot is frozen)', () => {
+        const timer = createRunTimer();
+        timer.complete();
+        const e0 = timer.elapsedMs();
+        spin(3);
+        const e1 = timer.elapsedMs();
+        expect(e1).toBeGreaterThanOrEqual(e0);
+    });
+    it('createRunLifecycle is the spec-named alias of createRunTimer with the same freeze behavior', () => {
+        expect(createRunLifecycle).toBe(createRunTimer);
+        const lifecycle = createRunLifecycle();
+        expect(typeof lifecycle.startedAt).toBe('string');
+        expect(typeof lifecycle.startedAtEpochMs).toBe('number');
+        expect(typeof lifecycle.elapsedMs).toBe('function');
+        expect(typeof lifecycle.snapshot).toBe('function');
+        expect(typeof lifecycle.complete).toBe('function');
+        // Same idempotent freeze contract.
+        const a = lifecycle.complete();
+        expect(lifecycle.complete()).toBe(a);
+    });
+});
+//# sourceMappingURL=run-timer.test.js.map

package/dist/lib/__tests__/run-timer.test.js.map

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

package/dist/lib/__tests__/severity-policy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SeverityPolicy + createSignalFromViolation — the consolidated severity home and
+ * the generic identity-stamping factory (release 2.13.0, §5.9).
+ */
+export {};
+//# sourceMappingURL=severity-policy.test.d.ts.map

package/dist/lib/__tests__/severity-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"severity-policy.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/severity-policy.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/lib/__tests__/severity-policy.test.js

@@ -0,0 +1,47 @@
+/**
+ * SeverityPolicy + createSignalFromViolation — the consolidated severity home and
+ * the generic identity-stamping factory (release 2.13.0, §5.9).
+ */
+import { describe, it, expect } from 'vitest';
+import { createSignalFromViolation } from '../../signals/create-signal-from-violation.js';
+import { SeverityPolicy } from '../severity-policy.js';
+describe('SeverityPolicy', () => {
+    it('lifts author severity UP (error → high, warning → medium)', () => {
+        expect(SeverityPolicy.liftAuthorSeverity('error')).toBe('high');
+        expect(SeverityPolicy.liftAuthorSeverity('warning')).toBe('medium');
+    });
+    it('applies an override only when set (baseline-neutral)', () => {
+        expect(SeverityPolicy.applyOverride('low', undefined)).toBe('low'); // unchanged
+        expect(SeverityPolicy.applyOverride('low', 'error')).toBe('high'); // clamped up
+        expect(SeverityPolicy.applyOverride('high', 'warning')).toBe('medium'); // clamped down
+    });
+    it('isError is the error-rung predicate (critical/high)', () => {
+        expect(SeverityPolicy.isError('critical')).toBe(true);
+        expect(SeverityPolicy.isError('high')).toBe(true);
+        expect(SeverityPolicy.isError('medium')).toBe(false);
+        expect(SeverityPolicy.isError('low')).toBe(false);
+    });
+});
+describe('createSignalFromViolation', () => {
+    it('stamps source/ruleId and lifts severity', () => {
+        const s = createSignalFromViolation('my-check', 'my-check', {
+            message: 'bad thing',
+            severity: 'error',
+            suggestion: 'fix it',
+            file: 'src/a.ts',
+            line: 3,
+            column: 1,
+        });
+        expect(s.source).toBe('my-check');
+        expect(s.ruleId).toBe('my-check');
+        expect(s.severity).toBe('high'); // error → high
+        expect(s.message).toBe('bad thing');
+        expect(s.suggestion).toBe('fix it');
+        expect(s.code).toEqual({ file: 'src/a.ts', line: 3, column: 1 });
+        expect(s.filePath).toBe('src/a.ts'); // mirrored by createSignal
+    });
+    it('lifts a warning to medium', () => {
+        expect(createSignalFromViolation('x', 'x', { message: 'm', severity: 'warning' }).severity).toBe('medium');
+    });
+});
+//# sourceMappingURL=severity-policy.test.js.map

package/dist/lib/__tests__/severity-policy.test.js.map

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

package/dist/lib/__tests__/telemetry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.test.d.ts.map

package/dist/lib/__tests__/telemetry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/telemetry.test.ts"],"names":[],"mappings":""}