@opensip-cli/core 0.1.0

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

@@ -0,0 +1,212 @@
+import { trace } from '@opentelemetry/api';
+import { describe, it, expect, vi } from 'vitest';
+import { currentTraceparent, getTracer, withSpan, withSpanAsync } from '../../lib/telemetry.js';
+/**
+ * Kernel-level telemetry tests assert the **no-op-until-SDK contract** — the
+ * load-bearing guarantee for standalone users. core carries only
+ * `@opentelemetry/api` and NO SDK, so these tests deliberately never register a
+ * provider: they prove `withSpan` runs `fn`, returns its value, and emits
+ * nothing through the API's no-op tracer.
+ *
+ * Span-CAPTURE behavior (assertions that a real span is produced with the
+ * expected name/attributes) is tested in `opensip-cli`, where the OTel
+ * SDK + InMemorySpanExporter legitimately live. Putting span-capture tests
+ * there keeps the SDK out of the kernel — see
+ * `packages/cli/src/telemetry/__tests__/`.
+ */
+describe('telemetry primitive (no-op-until-SDK contract)', () => {
+    it('getTracer returns a tracer whose spans are non-recording when no SDK is registered', () => {
+        // No provider registered ⇒ the global is the API's no-op tracer.
+        expect(trace.getTracerProvider().constructor.name).toMatch(/Noop|Proxy/);
+        let recording;
+        getTracer('test-scope').startActiveSpan('probe', (span) => {
+            recording = span.isRecording();
+            span.end();
+        });
+        // The no-op span never records.
+        expect(recording).toBe(false);
+    });
+    it('withSpan runs fn and returns its value with no SDK registered', () => {
+        const sentinel = { value: 42 };
+        const result = withSpan('test-scope', 'unit', () => sentinel);
+        expect(result).toBe(sentinel);
+    });
+    it('withSpan passes the (no-op) span to fn', () => {
+        let received;
+        withSpan('test-scope', 'unit', (span) => {
+            received = span;
+        });
+        expect(received).toBeDefined();
+        // It is a span object (has the span surface) even when no-op.
+        expect(typeof received.end).toBe('function');
+    });
+    it('withSpan applies attributes before fn runs (no-op span accepts them without throwing)', () => {
+        const setAttributes = vi.fn();
+        // Stub the tracer so we can observe attribute application on the no-op path.
+        const span = {
+            setAttributes,
+            setStatus: vi.fn(),
+            recordException: vi.fn(),
+            end: vi.fn(),
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        try {
+            withSpan('test-scope', 'unit', () => 'ok', { 'k.count': 3, 'k.flag': true });
+            expect(setAttributes).toHaveBeenCalledWith({ 'k.count': 3, 'k.flag': true });
+            expect(span.end).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+    it('withSpan stringifies a thrown non-Error before recording it', () => {
+        const recordException = vi.fn();
+        const span = {
+            setAttributes: vi.fn(),
+            setStatus: vi.fn(),
+            recordException,
+            end: vi.fn(),
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        try {
+            expect(() => withSpan('test-scope', 'unit', () => {
+                // Throwing a bare string exercises the non-Error normalization branch.
+                // eslint-disable-next-line @typescript-eslint/only-throw-error -- exercising non-Error normalization
+                throw 'string boom';
+            })).toThrow('string boom');
+            expect(recordException).toHaveBeenCalledWith('string boom');
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+    it('withSpan records the exception, sets ERROR status, ends the span, and rethrows', () => {
+        const recordException = vi.fn();
+        const setStatus = vi.fn();
+        const end = vi.fn();
+        const span = {
+            setAttributes: vi.fn(),
+            setStatus,
+            recordException,
+            end,
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        const boom = new Error('boom');
+        try {
+            expect(() => withSpan('test-scope', 'unit', () => {
+                throw boom;
+            })).toThrow(boom);
+            expect(recordException).toHaveBeenCalledWith(boom);
+            // SpanStatusCode.ERROR === 2
+            expect(setStatus).toHaveBeenCalledWith({ code: 2 });
+            expect(end).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+});
+describe('withSpanAsync (async-aware span)', () => {
+    it('awaits fn and returns its resolved value with no SDK registered', async () => {
+        const sentinel = { value: 7 };
+        const result = await withSpanAsync('test-scope', 'unit', async () => {
+            await Promise.resolve();
+            return sentinel;
+        });
+        expect(result).toBe(sentinel);
+    });
+    it('ends the span only after the awaited work settles (not when the callback returns)', async () => {
+        const events = [];
+        const span = {
+            setAttributes: vi.fn(),
+            setStatus: vi.fn(),
+            recordException: vi.fn(),
+            end: vi.fn(() => events.push('end')),
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        try {
+            await withSpanAsync('test-scope', 'unit', async () => {
+                await Promise.resolve();
+                events.push('work-done');
+            });
+            // The span must end AFTER the awaited work, proving it spans the await.
+            expect(events).toEqual(['work-done', 'end']);
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+    it('stringifies a non-Error async rejection before recording it', async () => {
+        const recordException = vi.fn();
+        const span = {
+            setAttributes: vi.fn(),
+            setStatus: vi.fn(),
+            recordException,
+            end: vi.fn(),
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        try {
+            await expect(withSpanAsync('test-scope', 'unit', async () => {
+                await Promise.resolve();
+                // eslint-disable-next-line @typescript-eslint/only-throw-error -- exercising non-Error normalization
+                throw 'async string boom';
+            })).rejects.toBe('async string boom');
+            expect(recordException).toHaveBeenCalledWith('async string boom');
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+    it('records an async rejection, sets ERROR status, ends the span, and rejects', async () => {
+        const recordException = vi.fn();
+        const setStatus = vi.fn();
+        const end = vi.fn();
+        const span = {
+            setAttributes: vi.fn(),
+            setStatus,
+            recordException,
+            end,
+            isRecording: () => false,
+        };
+        const spy = vi.spyOn(trace, 'getTracer').mockReturnValue({
+            startActiveSpan: ((_name, fn) => fn(span)),
+        });
+        const boom = new Error('async boom');
+        try {
+            await expect(withSpanAsync('test-scope', 'unit', async () => {
+                await Promise.resolve();
+                throw boom;
+            })).rejects.toBe(boom);
+            expect(recordException).toHaveBeenCalledWith(boom);
+            expect(setStatus).toHaveBeenCalledWith({ code: 2 }); // SpanStatusCode.ERROR
+            expect(end).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            spy.mockRestore();
+        }
+    });
+});
+describe('currentTraceparent (subprocess context propagation)', () => {
+    it('returns undefined when no SDK/propagator is registered (standalone runs)', () => {
+        // No provider/propagator ⇒ the no-op tracer yields an invalid span context,
+        // which the W3C propagator declines to serialize. Standalone runs spawning
+        // a child thus pass no TRACEPARENT, and the child emits no spans.
+        expect(currentTraceparent()).toBeUndefined();
+    });
+});
+//# sourceMappingURL=telemetry.test.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * verdict-policy — the host-owned findings gate (ADR-0035). Pins the truth table
+ * for `policyPasses` and the reserved-key resolution + per-key `{1,0}` fallback
+ * of `resolveVerdictPolicy`, so a future edit can't silently drift the gate.
+ */
+export {};
+//# sourceMappingURL=verdict-policy.test.d.ts.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * verdict-policy — the host-owned findings gate (ADR-0035). Pins the truth table
+ * for `policyPasses` and the reserved-key resolution + per-key `{1,0}` fallback
+ * of `resolveVerdictPolicy`, so a future edit can't silently drift the gate.
+ */
+import { describe, expect, it } from 'vitest';
+import { LanguageRegistry } from '../../languages/registry.js';
+import { ToolRegistry } from '../../tools/registry.js';
+import { RunScope, runWithScopeSync } from '../run-scope.js';
+import { DEFAULT_FAIL_ON_DEGRADED, HOST_VERDICT_POLICY_FALLBACK, policyPasses, resolveFailOnDegraded, resolveVerdictPolicy, } from '../verdict-policy.js';
+/** Fresh scope with empty registries — core-internal stand-in for the retired
+ *  `test-utils/with-scope` sugar (ADR-0040: the shared helper moved to
+ *  `@opensip-cli/test-support`, which core cannot dev-depend on — that
+ *  package depends on core, so the edge would make the package graph cyclic). */
+const makeTestScope = () => new RunScope({ languages: new LanguageRegistry(), tools: new ToolRegistry() });
+describe('policyPasses', () => {
+    // [errors, warnings, failOnErrors, failOnWarnings, expectedPasses]
+    const cases = [
+        // {1,0} fallback: fail on any error, warnings informational.
+        [0, 0, 1, 0, true],
+        [1, 0, 1, 0, false],
+        [0, 5, 1, 0, true], // warning-only run PASSES with failOnWarnings:0
+        // failOnErrors:0 disables the error gate.
+        [3, 0, 0, 0, true],
+        // failOnWarnings:k boundary (k active when > 0).
+        [0, 1, 1, 2, true], // 1 < 2 → pass
+        [0, 2, 1, 2, false], // 2 >= 2 → fail
+        [0, 1, 1, 1, false], // 1 >= 1 → fail
+        // error gate boundary.
+        [2, 0, 3, 0, true], // 2 < 3 → pass
+        [3, 0, 3, 0, false], // 3 >= 3 → fail
+    ];
+    for (const [errors, warnings, failOnErrors, failOnWarnings, expected] of cases) {
+        it(`(${errors}e,${warnings}w) vs {${failOnErrors},${failOnWarnings}} → ${expected ? 'PASS' : 'FAIL'}`, () => {
+            const policy = { failOnErrors, failOnWarnings };
+            expect(policyPasses({ errors, warnings }, policy)).toBe(expected);
+        });
+    }
+});
+/** Resolve a tool's policy inside a scope carrying the given resolved toolConfig. */
+function resolveWith(toolConfig, ns = 'graph') {
+    const scope = makeTestScope();
+    if (toolConfig !== undefined)
+        Object.assign(scope, { toolConfig });
+    return runWithScopeSync(scope, () => resolveVerdictPolicy(ns));
+}
+describe('resolveVerdictPolicy', () => {
+    it('returns the host fallback {1,0} when the namespace declares neither key', () => {
+        expect(resolveWith({ graph: {} })).toEqual(HOST_VERDICT_POLICY_FALLBACK);
+    });
+    it('returns the host fallback {1,0} when there is no toolConfig at all', () => {
+        expect(resolveWith(undefined)).toEqual(HOST_VERDICT_POLICY_FALLBACK);
+    });
+    it('reads both reserved keys when declared', () => {
+        expect(resolveWith({ fitness: { failOnErrors: 0, failOnWarnings: 2 } }, 'fitness')).toEqual({
+            failOnErrors: 0,
+            failOnWarnings: 2,
+        });
+    });
+    it('falls back per-key: a tool may declare one key and inherit the other', () => {
+        expect(resolveWith({ graph: { failOnWarnings: 3 } })).toEqual({
+            failOnErrors: 1, // inherited
+            failOnWarnings: 3, // declared
+        });
+    });
+    it('ignores non-integer / negative values, falling back to the host default', () => {
+        expect(resolveWith({ graph: { failOnErrors: -1, failOnWarnings: 1.5 } })).toEqual(HOST_VERDICT_POLICY_FALLBACK);
+    });
+});
+/** Resolve failOnDegraded inside a scope carrying the given resolved toolConfig. */
+function degradedWith(toolConfig, ns = 'graph') {
+    const scope = makeTestScope();
+    if (toolConfig !== undefined)
+        Object.assign(scope, { toolConfig });
+    return runWithScopeSync(scope, () => resolveFailOnDegraded(ns));
+}
+describe('resolveFailOnDegraded (ADR-0036)', () => {
+    it('defaults to true when no toolConfig / no key is present', () => {
+        expect(DEFAULT_FAIL_ON_DEGRADED).toBe(true);
+        expect(degradedWith(undefined)).toBe(true);
+        expect(degradedWith({ graph: {} })).toBe(true);
+    });
+    it('honours an explicit boolean (ratchet-as-report when false)', () => {
+        expect(degradedWith({ graph: { failOnDegraded: false } })).toBe(false);
+        expect(degradedWith({ graph: { failOnDegraded: true } })).toBe(true);
+    });
+    it('ignores a non-boolean value, falling back to the default', () => {
+        expect(degradedWith({ graph: { failOnDegraded: 'yes' } })).toBe(true);
+    });
+});
+//# sourceMappingURL=verdict-policy.test.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Tests for `readYamlFile` — the permissive helper used
+ * by plugin-discovery sites.
+ */
+export {};
+//# sourceMappingURL=yaml.test.d.ts.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Tests for `readYamlFile` — the permissive helper used
+ * by plugin-discovery sites.
+ */
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { SystemError, ValidationError } from '../errors.js';
+import { readYamlFile, readYamlFileOrThrow } from '../yaml.js';
+let testDir;
+beforeEach(() => {
+    testDir = mkdtempSync(join(tmpdir(), 'opensip-yaml-test-'));
+});
+afterEach(() => {
+    rmSync(testDir, { recursive: true, force: true });
+});
+describe('readYamlFile', () => {
+    it('returns undefined when the file does not exist', () => {
+        expect(readYamlFile(join(testDir, 'missing.yml'))).toBeUndefined();
+    });
+    it('returns undefined for malformed YAML', () => {
+        const path = join(testDir, 'bad.yml');
+        writeFileSync(path, 'a: [unterminated');
+        expect(readYamlFile(path)).toBeUndefined();
+    });
+    it('returns the parsed document for valid YAML', () => {
+        const path = join(testDir, 'good.yml');
+        writeFileSync(path, 'plugins:\n  fit:\n    - one\n    - two\n');
+        expect(readYamlFile(path)).toEqual({ plugins: { fit: ['one', 'two'] } });
+    });
+    it('returns null when the document is an empty YAML', () => {
+        const path = join(testDir, 'empty.yml');
+        writeFileSync(path, '');
+        // js-yaml returns undefined for completely empty input
+        expect(readYamlFile(path)).toBeUndefined();
+    });
+});
+describe('readYamlFileOrThrow (audit-round-2 Finding F)', () => {
+    it('returns the parsed document for valid YAML', () => {
+        const path = join(testDir, 'good.yml');
+        writeFileSync(path, 'fitness:\n  failOnErrors: 1\n');
+        expect(readYamlFileOrThrow(path)).toEqual({ fitness: { failOnErrors: 1 } });
+    });
+    it('returns {} for empty YAML rather than undefined', () => {
+        const path = join(testDir, 'empty.yml');
+        writeFileSync(path, '');
+        expect(readYamlFileOrThrow(path)).toEqual({});
+    });
+    it('throws ValidationError for a missing file with loader attribution', () => {
+        const path = join(testDir, 'missing.yml');
+        expect(() => readYamlFileOrThrow(path, { loader: 'signalers' })).toThrow(ValidationError);
+    });
+    it('throws ValidationError for malformed YAML', () => {
+        const path = join(testDir, 'bad.yml');
+        writeFileSync(path, 'a: [unterminated');
+        try {
+            readYamlFileOrThrow(path, { loader: 'signalers' });
+            throw new Error('expected throw');
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(ValidationError);
+            expect(error.message).toContain('invalid YAML');
+        }
+    });
+    it('throws SystemError when the file exceeds maxBytes', () => {
+        const path = join(testDir, 'big.yml');
+        writeFileSync(path, 'x: '.repeat(2000));
+        try {
+            readYamlFileOrThrow(path, { maxBytes: 64, loader: 'signalers' });
+            throw new Error('expected throw');
+        }
+        catch (error) {
+            expect(error).toBeInstanceOf(SystemError);
+            expect(error.code).toBe('SYSTEM.FILE.TOO_LARGE');
+        }
+    });
+});
+//# sourceMappingURL=yaml.test.js.map

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

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

package/dist/lib/config-version.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Permissive reader for the top-level `schemaVersion:`
+ * field of opensip-cli.config.yml + a compatibility classifier.
+ *
+ * The CLI's pre-action-hook calls these BEFORE any tool's strict loader
+ * runs, so the reader must tolerate every "couldn't determine" case
+ * (missing file, malformed YAML, missing field, non-integer field) and
+ * treat them all as v1. Forward compat for existing user configs
+ * written before the field existed.
+ *
+ * Lives in `core/lib/` alongside `paths.ts` because version detection
+ * is a kernel-level concern; every tool's loader benefits.
+ */
+/**
+ * The schema version this CLI binary knows how to load. Bumped when
+ * the project config structure changes in a way that requires
+ * migration.
+ */
+export declare const CLI_SUPPORTED_SCHEMA_VERSION: 1;
+/** Outcome of `checkSchemaCompat`. */
+export type SchemaCompat = {
+    readonly kind: 'ok';
+    readonly configVersion: number;
+} | {
+    readonly kind: 'older';
+    readonly configVersion: number;
+    readonly cliVersion: number;
+} | {
+    readonly kind: 'cli-too-old';
+    readonly configVersion: number;
+    readonly cliVersion: number;
+};
+/**
+ * Read the top-level `schemaVersion:` field. Returns 1 for any
+ * "couldn't read it" outcome, by design.
+ */
+export declare function readConfigSchemaVersion(configPath: string): number;
+/**
+ * Classify a config's declared version against the CLI's supported version.
+ *
+ *  - 'ok'           — versions match; proceed silently.
+ *  - 'older'        — config is older than CLI; CLI can read it (today).
+ *                     Future: `opensip-cli migrate` updates it. For
+ *                     now the CLI runs it as-is.
+ *  - 'cli-too-old'  — config is newer than CLI knows. CLI cannot safely
+ *                     load it. User must upgrade the CLI.
+ */
+export declare function checkSchemaCompat(configVersion: number): SchemaCompat;
+//# sourceMappingURL=config-version.d.ts.map

package/dist/lib/config-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-version.d.ts","sourceRoot":"","sources":["../../src/lib/config-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAG,CAAU,CAAC;AAEvD,sCAAsC;AACtC,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACvF;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAElG;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOlE;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY,CAQrE"}

package/dist/lib/config-version.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Permissive reader for the top-level `schemaVersion:`
+ * field of opensip-cli.config.yml + a compatibility classifier.
+ *
+ * The CLI's pre-action-hook calls these BEFORE any tool's strict loader
+ * runs, so the reader must tolerate every "couldn't determine" case
+ * (missing file, malformed YAML, missing field, non-integer field) and
+ * treat them all as v1. Forward compat for existing user configs
+ * written before the field existed.
+ *
+ * Lives in `core/lib/` alongside `paths.ts` because version detection
+ * is a kernel-level concern; every tool's loader benefits.
+ */
+import { existsSync } from 'node:fs';
+import { readYamlFile } from './yaml.js';
+/**
+ * The schema version this CLI binary knows how to load. Bumped when
+ * the project config structure changes in a way that requires
+ * migration.
+ */
+export const CLI_SUPPORTED_SCHEMA_VERSION = 1;
+/**
+ * Read the top-level `schemaVersion:` field. Returns 1 for any
+ * "couldn't read it" outcome, by design.
+ */
+export function readConfigSchemaVersion(configPath) {
+    if (!existsSync(configPath))
+        return 1;
+    const doc = readYamlFile(configPath);
+    if (doc === null || typeof doc !== 'object' || Array.isArray(doc))
+        return 1;
+    const raw = doc.schemaVersion;
+    if (typeof raw !== 'number' || !Number.isInteger(raw) || raw < 1)
+        return 1;
+    return raw;
+}
+/**
+ * Classify a config's declared version against the CLI's supported version.
+ *
+ *  - 'ok'           — versions match; proceed silently.
+ *  - 'older'        — config is older than CLI; CLI can read it (today).
+ *                     Future: `opensip-cli migrate` updates it. For
+ *                     now the CLI runs it as-is.
+ *  - 'cli-too-old'  — config is newer than CLI knows. CLI cannot safely
+ *                     load it. User must upgrade the CLI.
+ */
+export function checkSchemaCompat(configVersion) {
+    if (configVersion === CLI_SUPPORTED_SCHEMA_VERSION) {
+        return { kind: 'ok', configVersion };
+    }
+    if (configVersion < CLI_SUPPORTED_SCHEMA_VERSION) {
+        return { kind: 'older', configVersion, cliVersion: CLI_SUPPORTED_SCHEMA_VERSION };
+    }
+    return { kind: 'cli-too-old', configVersion, cliVersion: CLI_SUPPORTED_SCHEMA_VERSION };
+}
+//# sourceMappingURL=config-version.js.map

package/dist/lib/config-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-version.js","sourceRoot":"","sources":["../../src/lib/config-version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAU,CAAC;AAQvD;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,UAAkB;IACxD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAI,GAA+B,CAAC,aAAa,CAAC;IAC3D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3E,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,aAAqB;IACrD,IAAI,aAAa,KAAK,4BAA4B,EAAE,CAAC;QACnD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,aAAa,GAAG,4BAA4B,EAAE,CAAC;QACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,4BAA4B,EAAE,CAAC;IACpF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,4BAA4B,EAAE,CAAC;AAC1F,CAAC"}

package/dist/lib/diagnostics-bus.d.ts

@@ -0,0 +1,48 @@
+/**
+ * DiagnosticsBus — the scope-owned collector that gathers {@link DiagnosticEvent}s
+ * across the uniform tool lifecycle and snapshots them as {@link RunDiagnostics}
+ * to ride on a `CommandOutcome` (north-star §5.10, launch).
+ *
+ * Per-invocation state, held on {@link RunScope} (the no-module-singleton rule):
+ * library code deep in the call tree emits via `currentScope()?.diagnostics`, and
+ * the host assembler attaches `scope.diagnostics.snapshot()` to every outcome.
+ * Additive — the logger, runId, and graph OTEL spans stay; this is the
+ * structured, JSON-emittable layer on top.
+ *
+ * The bus is a runtime collector (like the logger), so it stamps wall-clock time
+ * (`new Date().toISOString()`) — the `Date.now()`-free contract applies to the
+ * pure formatters (`buildSignalEnvelope`), not to this collector. The OTEL trace
+ * bridge is best-effort: `snapshot().trace` carries the active span's
+ * trace/span ids when telemetry is on, parsed from the W3C `traceparent` the
+ * kernel already exposes — so bundled and external tools are observable
+ * identically, with no SDK dependency in the kernel.
+ */
+import type { DiagnosticEvent, DiagnosticLevel, DiagnosticPhase, RunDiagnostics } from './run-diagnostics.js';
+/** A diagnostic event with the timestamp left to the bus to stamp. */
+export type DiagnosticEventInput = Omit<DiagnosticEvent, 'at'> & {
+    readonly at?: string;
+};
+/**
+ * The per-invocation diagnostics collector. Construct one per {@link RunScope}.
+ */
+export declare class DiagnosticsBus {
+    private readonly runId;
+    private readonly events;
+    private readonly metrics;
+    constructor(runId: string);
+    /**
+     * Append a lifecycle event. The bus stamps `at` (ISO-8601) when the caller did
+     * not supply one. Cheap and allocation-light; safe to call from any phase.
+     */
+    emit(event: DiagnosticEventInput): void;
+    /** Convenience: emit at a given phase/level with an optional data bag. */
+    event(phase: DiagnosticPhase, level: DiagnosticLevel, message: string, data?: Readonly<Record<string, unknown>>): void;
+    /** Increment a named counter (e.g. `'plugins.loaded'`). Defaults to +1. */
+    counter(name: string, delta?: number): void;
+    /**
+     * Materialize the JSON-emittable snapshot carried on a `CommandOutcome`. Pure
+     * read: copies the event stream + metrics and bridges the active OTEL trace.
+     */
+    snapshot(): RunDiagnostics;
+}
+//# sourceMappingURL=diagnostics-bus.d.ts.map

package/dist/lib/diagnostics-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-bus.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAe1F;;GAEG;AACH,qBAAa,cAAc;IAIb,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;gBAExB,KAAK,EAAE,MAAM;IAE1C;;;OAGG;IACH,IAAI,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAIvC,0EAA0E;IAC1E,KAAK,CACH,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,IAAI;IAIP,2EAA2E;IAC3E,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,IAAI;IAItC;;;OAGG;IACH,QAAQ,IAAI,cAAc;CAS3B"}