@opensip-cli/core 0.1.0

package/dist/lib/diagnostics-bus.js

@@ -0,0 +1,74 @@
+/**
+ * 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 { currentTraceparent } from './telemetry.js';
+/**
+ * Parse the `traceId` / `spanId` out of a W3C `traceparent`
+ * (`version-traceid-spanid-flags`). Returns `undefined` when telemetry is off
+ * (no active recording span → no traceparent) or the string is malformed.
+ */
+function parseTrace() {
+    const traceparent = currentTraceparent();
+    if (traceparent === undefined)
+        return undefined;
+    const parts = traceparent.split('-');
+    if (parts.length < 4)
+        return undefined;
+    return { traceId: parts[1], spanId: parts[2] };
+}
+/**
+ * The per-invocation diagnostics collector. Construct one per {@link RunScope}.
+ */
+export class DiagnosticsBus {
+    runId;
+    events = [];
+    metrics = new Map();
+    constructor(runId) {
+        this.runId = runId;
+    }
+    /**
+     * 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) {
+        this.events.push({ ...event, at: event.at ?? new Date().toISOString() });
+    }
+    /** Convenience: emit at a given phase/level with an optional data bag. */
+    event(phase, level, message, data) {
+        this.emit(data === undefined ? { phase, level, message } : { phase, level, message, data });
+    }
+    /** Increment a named counter (e.g. `'plugins.loaded'`). Defaults to +1. */
+    counter(name, delta = 1) {
+        this.metrics.set(name, (this.metrics.get(name) ?? 0) + delta);
+    }
+    /**
+     * Materialize the JSON-emittable snapshot carried on a `CommandOutcome`. Pure
+     * read: copies the event stream + metrics and bridges the active OTEL trace.
+     */
+    snapshot() {
+        const trace = parseTrace();
+        return {
+            runId: this.runId,
+            events: [...this.events],
+            ...(this.metrics.size > 0 ? { metrics: Object.fromEntries(this.metrics) } : {}),
+            ...(trace ? { trace } : {}),
+        };
+    }
+}
+//# sourceMappingURL=diagnostics-bus.js.map

package/dist/lib/diagnostics-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics-bus.js","sourceRoot":"","sources":["../../src/lib/diagnostics-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAYpD;;;;GAIG;AACH,SAAS,UAAU;IACjB,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,IAAI,WAAW,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,cAAc;IAII;IAHZ,MAAM,GAAsB,EAAE,CAAC;IAC/B,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAErD,YAA6B,KAAa;QAAb,UAAK,GAAL,KAAK,CAAQ;IAAG,CAAC;IAE9C;;;OAGG;IACH,IAAI,CAAC,KAA2B;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,0EAA0E;IAC1E,KAAK,CACH,KAAsB,EACtB,KAAsB,EACtB,OAAe,EACf,IAAwC;QAExC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,2EAA2E;IAC3E,OAAO,CAAC,IAAY,EAAE,KAAK,GAAG,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;QAC3B,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/lib/env-registry.d.ts

@@ -0,0 +1,108 @@
+/**
+ * EnvRegistry — a governed registry of environment variables (north-star §5.12,
+ * launch).
+ *
+ * Environment variables are a user-facing configuration surface, but today they
+ * are read inline (`process.env.X`) across ~half a dozen packages with no
+ * canonical name, no alias policy, no coercion, no documentation, and no
+ * deprecation path. `EnvRegistry` is the single seam every env read flows through:
+ * a tool/host declares an {@link EnvVarSpec} (canonical name, aliases, coercion,
+ * default, docs, deprecation), and all reads go through {@link EnvRegistry.get}.
+ * The `env-via-registry` guardrail (launch) then fails CI on any raw `process.env`
+ * access outside this module.
+ *
+ * Layering / state: this is a KERNEL observability primitive, beside `logger` and
+ * `ids`. Reading `process.env` HERE is the one sanctioned site — the registry IS
+ * the seam the guardrail points everything else at. The DEFINITION table a caller
+ * passes in is an immutable constant; that does not violate the no-module-
+ * singleton rule (which targets mutable per-run state), and it is exactly why the
+ * registry can serve the pre-scope readers (terminal theme, graph heap-preflight)
+ * that run before `RunScope` exists — they read through a static instance over the
+ * immutable table, not a scope-bound one.
+ *
+ * Pure read model: `get` resolves canonical → aliases in declaration order,
+ * coerces, and applies the default; it never mutates `process.env`. Deprecation is
+ * surfaced (not logged here — core stays log-light) so the composing host can emit
+ * a structured `cli.env.read_deprecated` event when a deprecated alias is hit.
+ */
+/**
+ * A deprecation note on an env var or one of its aliases. `since` is the release
+ * the deprecation began; `use` names the canonical replacement to migrate to.
+ */
+export interface EnvDeprecation {
+    readonly since: string;
+    readonly use?: string;
+}
+/**
+ * Declarative description of one environment variable.
+ *
+ * @typeParam T - the coerced value type (defaults to `string` — the raw value).
+ */
+export interface EnvVarSpec<T = string> {
+    /** Canonical, documented name (e.g. `OPENSIP_NO_UPDATE`). */
+    readonly canonical: string;
+    /**
+     * Accepted aliases, in resolution order AFTER the canonical name (e.g. the npm
+     * convention `NO_UPDATE_NOTIFIER`). A hit on an alias marked via
+     * {@link EnvVarSpec.deprecated} is reported by {@link EnvRegistry.get} so the
+     * caller can warn.
+     */
+    readonly aliases?: readonly string[];
+    /**
+     * Pure coercion from the raw string to `T` (e.g. `(raw) => raw === '1'`).
+     * Omitted ⇒ identity (the value type is `string`). Never reads other env.
+     */
+    readonly coerce?: (raw: string) => T;
+    /** Value when neither canonical nor any alias is set. */
+    readonly default?: T;
+    /** One-line documentation surfaced in the generated env-surface reference. */
+    readonly docs: string;
+    /** Deprecation policy for the canonical name (alias-level handled at read). */
+    readonly deprecated?: EnvDeprecation;
+}
+/**
+ * Result of an {@link EnvRegistry.get} read. `value` is the coerced value (or the
+ * spec default, or `undefined`); `source` names which key supplied it; and
+ * `deprecated` carries the note when the resolved key (canonical or alias) is
+ * deprecated, so the caller can emit a structured warning.
+ */
+export interface EnvReadResult<T> {
+    readonly value: T | undefined;
+    readonly source: 'canonical' | 'alias' | 'default' | 'unset';
+    readonly deprecated?: EnvDeprecation;
+}
+/**
+ * The composed registry. Construct once (host) over the full {@link EnvVarSpec}
+ * set; read via {@link EnvRegistry.get} (coerced value only) or
+ * {@link EnvRegistry.read} (value + source + deprecation). The pre-scope static
+ * accessor (terminal theme, heap-preflight) constructs its own instance over the
+ * shared immutable host table.
+ */
+export declare class EnvRegistry {
+    private readonly byCanonical;
+    constructor(specs: readonly EnvVarSpec<unknown>[]);
+    /** True when this canonical name is registered. */
+    has(canonical: string): boolean;
+    /** Every registered spec, for the generated env-surface reference doc. */
+    describe(): readonly EnvVarSpec<unknown>[];
+    /**
+     * Resolve a variable to its coerced value: canonical first, then aliases in
+     * order, else the spec default, else `undefined`. The convenience form of
+     * {@link EnvRegistry.read} when the caller does not need source/deprecation.
+     */
+    get<T = string>(canonical: string): T | undefined;
+    /**
+     * Resolve a variable to its value PLUS provenance. Reads `process.env` for the
+     * canonical name, then each alias in declaration order; the first set key wins.
+     * A deprecation note is attached when the resolved key is deprecated (the
+     * canonical's own `deprecated`, or — for an alias hit — the canonical
+     * `deprecated` if present, since an alias existing at all is the migration
+     * signal). Unknown canonical names throw: a typo in a host spec is a bug, not a
+     * silent `undefined`.
+     *
+     * @throws {Error} When `canonical` is not a registered {@link EnvVarSpec} — a
+     *   host-spec typo surfaces loudly here rather than as a silent `undefined`.
+     */
+    read<T = string>(canonical: string): EnvReadResult<T>;
+}
+//# sourceMappingURL=env-registry.d.ts.map

package/dist/lib/env-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-registry.d.ts","sourceRoot":"","sources":["../../src/lib/env-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;IACrC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACtC;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0C;gBAE1D,KAAK,EAAE,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE;IAMjD,mDAAmD;IACnD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,0EAA0E;IAC1E,QAAQ,IAAI,SAAS,UAAU,CAAC,OAAO,CAAC,EAAE;IAI1C;;;;OAIG;IACH,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIjD;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC;CA4BtD"}

package/dist/lib/env-registry.js

@@ -0,0 +1,92 @@
+/**
+ * EnvRegistry — a governed registry of environment variables (north-star §5.12,
+ * launch).
+ *
+ * Environment variables are a user-facing configuration surface, but today they
+ * are read inline (`process.env.X`) across ~half a dozen packages with no
+ * canonical name, no alias policy, no coercion, no documentation, and no
+ * deprecation path. `EnvRegistry` is the single seam every env read flows through:
+ * a tool/host declares an {@link EnvVarSpec} (canonical name, aliases, coercion,
+ * default, docs, deprecation), and all reads go through {@link EnvRegistry.get}.
+ * The `env-via-registry` guardrail (launch) then fails CI on any raw `process.env`
+ * access outside this module.
+ *
+ * Layering / state: this is a KERNEL observability primitive, beside `logger` and
+ * `ids`. Reading `process.env` HERE is the one sanctioned site — the registry IS
+ * the seam the guardrail points everything else at. The DEFINITION table a caller
+ * passes in is an immutable constant; that does not violate the no-module-
+ * singleton rule (which targets mutable per-run state), and it is exactly why the
+ * registry can serve the pre-scope readers (terminal theme, graph heap-preflight)
+ * that run before `RunScope` exists — they read through a static instance over the
+ * immutable table, not a scope-bound one.
+ *
+ * Pure read model: `get` resolves canonical → aliases in declaration order,
+ * coerces, and applies the default; it never mutates `process.env`. Deprecation is
+ * surfaced (not logged here — core stays log-light) so the composing host can emit
+ * a structured `cli.env.read_deprecated` event when a deprecated alias is hit.
+ */
+/**
+ * The composed registry. Construct once (host) over the full {@link EnvVarSpec}
+ * set; read via {@link EnvRegistry.get} (coerced value only) or
+ * {@link EnvRegistry.read} (value + source + deprecation). The pre-scope static
+ * accessor (terminal theme, heap-preflight) constructs its own instance over the
+ * shared immutable host table.
+ */
+export class EnvRegistry {
+    byCanonical = new Map();
+    constructor(specs) {
+        for (const spec of specs) {
+            this.byCanonical.set(spec.canonical, spec);
+        }
+    }
+    /** True when this canonical name is registered. */
+    has(canonical) {
+        return this.byCanonical.has(canonical);
+    }
+    /** Every registered spec, for the generated env-surface reference doc. */
+    describe() {
+        return [...this.byCanonical.values()];
+    }
+    /**
+     * Resolve a variable to its coerced value: canonical first, then aliases in
+     * order, else the spec default, else `undefined`. The convenience form of
+     * {@link EnvRegistry.read} when the caller does not need source/deprecation.
+     */
+    get(canonical) {
+        return this.read(canonical).value;
+    }
+    /**
+     * Resolve a variable to its value PLUS provenance. Reads `process.env` for the
+     * canonical name, then each alias in declaration order; the first set key wins.
+     * A deprecation note is attached when the resolved key is deprecated (the
+     * canonical's own `deprecated`, or — for an alias hit — the canonical
+     * `deprecated` if present, since an alias existing at all is the migration
+     * signal). Unknown canonical names throw: a typo in a host spec is a bug, not a
+     * silent `undefined`.
+     *
+     * @throws {Error} When `canonical` is not a registered {@link EnvVarSpec} — a
+     *   host-spec typo surfaces loudly here rather than as a silent `undefined`.
+     */
+    read(canonical) {
+        const spec = this.byCanonical.get(canonical);
+        if (spec === undefined) {
+            throw new Error(`EnvRegistry: unknown variable '${canonical}' — declare an EnvVarSpec before reading it.`);
+        }
+        const coerce = (raw) => (spec.coerce ? spec.coerce(raw) : raw);
+        const canonicalRaw = process.env[spec.canonical];
+        if (canonicalRaw !== undefined) {
+            return { value: coerce(canonicalRaw), source: 'canonical', deprecated: spec.deprecated };
+        }
+        for (const alias of spec.aliases ?? []) {
+            const aliasRaw = process.env[alias];
+            if (aliasRaw !== undefined) {
+                return { value: coerce(aliasRaw), source: 'alias', deprecated: spec.deprecated };
+            }
+        }
+        if (spec.default !== undefined) {
+            return { value: spec.default, source: 'default' };
+        }
+        return { value: undefined, source: 'unset' };
+    }
+}
+//# sourceMappingURL=env-registry.js.map

package/dist/lib/env-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-registry.js","sourceRoot":"","sources":["../../src/lib/env-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAmDH;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACL,WAAW,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEtE,YAAY,KAAqC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,0EAA0E;IAC1E,QAAQ;QACN,OAAO,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAa,SAAiB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAI,SAAS,CAAC,CAAC,KAAK,CAAC;IACvC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,CAAa,SAAiB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAA8B,CAAC;QAC1E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,kCAAkC,SAAS,8CAA8C,CAC1F,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAW,EAAK,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAoB,CAAC,CAAC;QAE5F,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC3F,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YACnF,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/B,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QACpD,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Typed error classes and Result pattern for opensip-cli.
+ */
+/**
+ * Closed union of canonical error codes carried by `ToolError` and its
+ * subclasses. Open by intent at the consumer layer — callers may pass
+ * any string in `ToolErrorOptions.code` (subclass-specific subcodes
+ * like `'VALIDATION.RECIPE.DUPLICATE'` are common) — but the base
+ * default for each subclass is one of these literals, which means an
+ * `instanceof` check pairs naturally with an exhaustive switch on
+ * `code` for the no-override case.
+ */
+export type ToolErrorCode = 'VALIDATION_ERROR' | 'NOT_FOUND' | 'SYSTEM_ERROR' | 'TIMEOUT' | 'NETWORK_ERROR' | 'CONFIGURATION_ERROR' | 'PLUGIN_INCOMPATIBLE' | 'UNKNOWN_LIVE_VIEW';
+/** Constructor options for {@link ToolError}: `code` plus arbitrary diagnostic metadata. */
+export interface ToolErrorOptions extends ErrorOptions {
+    code?: string;
+    [key: string]: unknown;
+}
+/** Base class for all opensip-cli errors; carries a `code` for programmatic dispatch. */
+export declare class ToolError extends Error {
+    /**
+     * Error code. Typed as a `string` super-set of `ToolErrorCode` because
+     * subclass call sites may opt into a more specific subcode via
+     * `ToolErrorOptions.code` (e.g. `'VALIDATION.RECIPE.DUPLICATE'`). For
+     * exhaustive-switch use cases, narrow with the `ToolErrorCode` union
+     * after an `instanceof` check.
+     */
+    readonly code: string;
+    constructor(message: string, code: string, options?: ToolErrorOptions);
+}
+/** Thrown when user-supplied input (config, CLI flags, recipes) fails schema or domain validation. */
+export declare class ValidationError extends ToolError {
+    constructor(message: string, options?: ToolErrorOptions);
+}
+/** Thrown when a named resource (check, recipe, file, session) cannot be located. */
+export declare class NotFoundError extends ToolError {
+    constructor(message: string, options?: ToolErrorOptions);
+}
+/** Thrown for internal invariant violations or unexpected runtime failures. */
+export declare class SystemError extends ToolError {
+    constructor(message: string, options?: ToolErrorOptions);
+}
+/** Thrown when an operation exceeds its allotted time budget. */
+export declare class TimeoutError extends ToolError {
+    readonly timeoutMs?: number;
+    constructor(message: string, timeoutOrOptions?: number | ToolErrorOptions);
+}
+/** Thrown for HTTP or socket-level failures during outbound requests. */
+export declare class NetworkError extends ToolError {
+    readonly statusCode?: number;
+    constructor(message: string, options?: ToolErrorOptions & {
+        statusCode?: number;
+    });
+}
+/** Thrown when project or tool configuration is missing, malformed, or contradictory. */
+export declare class ConfigurationError extends ToolError {
+    constructor(message: string, options?: ToolErrorOptions);
+}
+/**
+ * Thrown when a tool plugin is rejected by the compatibility/trust gate
+ * (launch) and the rejection must fail the run rather than skip
+ * silently — i.e. the tool was explicitly requested but is incompatible,
+ * or a project-local executable tool was not allowlisted (deny-by-default).
+ *
+ * Mapped to `EXIT_CODES.PLUGIN_INCOMPATIBLE` (exit 5) by
+ * `mapToolErrorToExitCode` so an incompatible/untrusted plugin is
+ * diagnosable from the exit code alone. Carries the structured
+ * `diagnostic` the admission gate produced (compatibility reason or the
+ * trust-policy message) for surfacing through the CLI error boundary.
+ */
+export declare class PluginIncompatibleError extends ToolError {
+    /** The admission diagnostic (compatibility reason or trust-policy message). */
+    readonly diagnostic?: string;
+    constructor(message: string, options?: ToolErrorOptions & {
+        diagnostic?: string;
+    });
+}
+/**
+ * Thrown when a contribution is routed to a capability domain that no tool
+ * has declared (launch, §5.3). A subclass of {@link NotFoundError}
+ * (so existing not-found handling still catches it) that additionally
+ * carries the structured diagnostic the capability registry produced: the
+ * unknown `domainId` and the set of `knownDomains`. Code defaults to
+ * `'CAPABILITY.DOMAIN.UNKNOWN'`.
+ */
+export declare class UnknownCapabilityDomainError extends NotFoundError {
+    /** The domain id that was routed to but not declared. */
+    readonly domainId: string;
+    /** The domain ids that ARE declared on the registry (for diagnostics). */
+    readonly knownDomains: readonly string[];
+    constructor(message: string, options: ToolErrorOptions & {
+        domainId: string;
+        knownDomains: readonly string[];
+    });
+}
+/**
+ * Thrown when a contribution fails the schema check of the capability
+ * domain it targets (launch, §5.3). A subclass of
+ * {@link ValidationError} that carries the structured diagnostic: the
+ * `domainId`, the owning tool's `ownerToolId`, and a human-readable
+ * `diagnostic` reason. Code defaults to
+ * `'CAPABILITY.CONTRIBUTION.SCHEMA_MISMATCH'`.
+ */
+export declare class CapabilitySchemaMismatchError extends ValidationError {
+    /** The domain id whose schema the contribution failed. */
+    readonly domainId: string;
+    /** The tool that owns the targeted domain. */
+    readonly ownerToolId: string;
+    /** Human-readable reason the contribution failed the schema. */
+    readonly diagnostic: string;
+    constructor(message: string, options: ToolErrorOptions & {
+        domainId: string;
+        ownerToolId: string;
+        diagnostic: string;
+    });
+}
+export type Result<T, E = ToolError> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly error: E;
+};
+/** Constructs a success {@link Result} carrying `value`. */
+export declare function ok<T>(value: T): Result<T, never>;
+/** Constructs a failure {@link Result} carrying `error`. */
+export declare function err<E>(error: E): Result<never, E>;
+/** Wraps an async function in a try/catch, returning a Result instead of throwing. */
+export declare function tryCatchAsync<T>(fn: () => Promise<T>): Promise<Result<T, Error>>;
+/** Wraps a sync function in a try/catch, returning a Result instead of throwing. */
+export declare function tryCatch<T>(fn: () => T): Result<T, Error>;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

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

package/dist/lib/errors.js

@@ -0,0 +1,160 @@
+/**
+ * Typed error classes and Result pattern for opensip-cli.
+ */
+/** Base class for all opensip-cli errors; carries a `code` for programmatic dispatch. */
+export class ToolError extends Error {
+    /**
+     * Error code. Typed as a `string` super-set of `ToolErrorCode` because
+     * subclass call sites may opt into a more specific subcode via
+     * `ToolErrorOptions.code` (e.g. `'VALIDATION.RECIPE.DUPLICATE'`). For
+     * exhaustive-switch use cases, narrow with the `ToolErrorCode` union
+     * after an `instanceof` check.
+     */
+    code;
+    constructor(message, code, options) {
+        super(message, options);
+        this.name = 'ToolError';
+        this.code = code;
+    }
+}
+/** Thrown when user-supplied input (config, CLI flags, recipes) fails schema or domain validation. */
+export class ValidationError extends ToolError {
+    constructor(message, options) {
+        super(message, options?.code ?? 'VALIDATION_ERROR', options);
+        this.name = 'ValidationError';
+    }
+}
+/** Thrown when a named resource (check, recipe, file, session) cannot be located. */
+export class NotFoundError extends ToolError {
+    constructor(message, options) {
+        super(message, options?.code ?? 'NOT_FOUND', options);
+        this.name = 'NotFoundError';
+    }
+}
+/** Thrown for internal invariant violations or unexpected runtime failures. */
+export class SystemError extends ToolError {
+    constructor(message, options) {
+        super(message, options?.code ?? 'SYSTEM_ERROR', options);
+        this.name = 'SystemError';
+    }
+}
+/** Thrown when an operation exceeds its allotted time budget. */
+export class TimeoutError extends ToolError {
+    timeoutMs;
+    constructor(message, timeoutOrOptions) {
+        const options = typeof timeoutOrOptions === 'number' ? undefined : timeoutOrOptions;
+        super(message, options?.code ?? 'TIMEOUT', options);
+        this.name = 'TimeoutError';
+        this.timeoutMs = typeof timeoutOrOptions === 'number' ? timeoutOrOptions : undefined;
+    }
+}
+/** Thrown for HTTP or socket-level failures during outbound requests. */
+export class NetworkError extends ToolError {
+    statusCode;
+    constructor(message, options) {
+        super(message, options?.code ?? 'NETWORK_ERROR', options);
+        this.name = 'NetworkError';
+        this.statusCode = options?.statusCode;
+    }
+}
+/** Thrown when project or tool configuration is missing, malformed, or contradictory. */
+export class ConfigurationError extends ToolError {
+    constructor(message, options) {
+        super(message, options?.code ?? 'CONFIGURATION_ERROR', options);
+        this.name = 'ConfigurationError';
+    }
+}
+/**
+ * Thrown when a tool plugin is rejected by the compatibility/trust gate
+ * (launch) and the rejection must fail the run rather than skip
+ * silently — i.e. the tool was explicitly requested but is incompatible,
+ * or a project-local executable tool was not allowlisted (deny-by-default).
+ *
+ * Mapped to `EXIT_CODES.PLUGIN_INCOMPATIBLE` (exit 5) by
+ * `mapToolErrorToExitCode` so an incompatible/untrusted plugin is
+ * diagnosable from the exit code alone. Carries the structured
+ * `diagnostic` the admission gate produced (compatibility reason or the
+ * trust-policy message) for surfacing through the CLI error boundary.
+ */
+export class PluginIncompatibleError extends ToolError {
+    /** The admission diagnostic (compatibility reason or trust-policy message). */
+    diagnostic;
+    constructor(message, options) {
+        super(message, options?.code ?? 'PLUGIN_INCOMPATIBLE', options);
+        this.name = 'PluginIncompatibleError';
+        this.diagnostic = options?.diagnostic;
+    }
+}
+/**
+ * Thrown when a contribution is routed to a capability domain that no tool
+ * has declared (launch, §5.3). A subclass of {@link NotFoundError}
+ * (so existing not-found handling still catches it) that additionally
+ * carries the structured diagnostic the capability registry produced: the
+ * unknown `domainId` and the set of `knownDomains`. Code defaults to
+ * `'CAPABILITY.DOMAIN.UNKNOWN'`.
+ */
+export class UnknownCapabilityDomainError extends NotFoundError {
+    /** The domain id that was routed to but not declared. */
+    domainId;
+    /** The domain ids that ARE declared on the registry (for diagnostics). */
+    knownDomains;
+    constructor(message, options) {
+        super(message, { ...options, code: options.code ?? 'CAPABILITY.DOMAIN.UNKNOWN' });
+        this.name = 'UnknownCapabilityDomainError';
+        this.domainId = options.domainId;
+        this.knownDomains = options.knownDomains;
+    }
+}
+/**
+ * Thrown when a contribution fails the schema check of the capability
+ * domain it targets (launch, §5.3). A subclass of
+ * {@link ValidationError} that carries the structured diagnostic: the
+ * `domainId`, the owning tool's `ownerToolId`, and a human-readable
+ * `diagnostic` reason. Code defaults to
+ * `'CAPABILITY.CONTRIBUTION.SCHEMA_MISMATCH'`.
+ */
+export class CapabilitySchemaMismatchError extends ValidationError {
+    /** The domain id whose schema the contribution failed. */
+    domainId;
+    /** The tool that owns the targeted domain. */
+    ownerToolId;
+    /** Human-readable reason the contribution failed the schema. */
+    diagnostic;
+    constructor(message, options) {
+        super(message, {
+            ...options,
+            code: options.code ?? 'CAPABILITY.CONTRIBUTION.SCHEMA_MISMATCH',
+        });
+        this.name = 'CapabilitySchemaMismatchError';
+        this.domainId = options.domainId;
+        this.ownerToolId = options.ownerToolId;
+        this.diagnostic = options.diagnostic;
+    }
+}
+/** Constructs a success {@link Result} carrying `value`. */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** Constructs a failure {@link Result} carrying `error`. */
+export function err(error) {
+    return { ok: false, error };
+}
+/** Wraps an async function in a try/catch, returning a Result instead of throwing. */
+export async function tryCatchAsync(fn) {
+    try {
+        return ok(await fn());
+    }
+    catch (error) {
+        return err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+/** Wraps a sync function in a try/catch, returning a Result instead of throwing. */
+export function tryCatch(fn) {
+    try {
+        return ok(fn());
+    }
+    catch (error) {
+        return err(error instanceof Error ? error : new Error(String(error)));
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Execution substrate — scheduleUnits (loop/concurrency/stop), runWithTimeout
+ * (the §4.3 timeout fix), runWithRetry (the fitness-hoisted retry), executePipeline
+ * (the combinator), and deriveRecipeId.
+ */
+export {};
+//# sourceMappingURL=execution.test.d.ts.map

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

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