@pellux/goodvibes-sdk 0.30.3 → 0.33.1

package/dist/platform/runtime/forensics/collector.js

@@ -13,14 +13,10 @@
  * event is emitted so the panel can refresh.
  */
 import { randomUUID } from 'node:crypto';
-import { createEventEnvelope } from '../events/index.js';
 import { summarizeError } from '../../utils/error-display.js';
 import { logger } from '../../utils/logger.js';
 import { classifyFailure, summariseFailure } from './classifier.js';
 import { emitForensicsReportCreated } from '../emitters/forensics.js';
-// ---------------------------------------------------------------------------
-// Internal turn/task tracking
-// ---------------------------------------------------------------------------
 /** Maximum orphaned trackers retained before evicting oldest entries. */
 const MAX_TRACKER_SIZE = 500;
 // ---------------------------------------------------------------------------
@@ -43,14 +39,40 @@ export class ForensicsCollector {
     }
     _start() {
         // Subscribe to turn domain
-        this._unsubs.push(this._bus.onDomain('turn', (env) => this._handleTurnEnvelope(env)));
+        this._unsubs.push(this._bus.onDomain('turn', (env) => this._collect('turn', env, () => {
+            this._handleTurnEnvelope(env);
+        })));
         // Subscribe to tasks domain
-        this._unsubs.push(this._bus.onDomain('tasks', (env) => this._handleTaskEnvelope(env)));
+        this._unsubs.push(this._bus.onDomain('tasks', (env) => this._collect('tasks', env, () => {
+            this._handleTaskEnvelope(env);
+        })));
         // Subscribe to tools domain for permission/failure context
-        this._unsubs.push(this._bus.onDomain('tools', (env) => this._handleToolEnvelope(env)));
-        this._unsubs.push(this._bus.onDomain('permissions', (env) => this._handlePermissionEnvelope(env)));
+        this._unsubs.push(this._bus.onDomain('tools', (env) => this._collect('tools', env, () => {
+            this._handleToolEnvelope(env);
+        })));
+        this._unsubs.push(this._bus.onDomain('permissions', (env) => this._collect('permissions', env, () => {
+            this._handlePermissionEnvelope(env);
+        })));
         // Subscribe to session domain for cascade/compaction events
-        this._unsubs.push(this._bus.onDomain('compaction', (env) => this._handleCompactionEnvelope(env)));
+        this._unsubs.push(this._bus.onDomain('compaction', (env) => this._collect('compaction', env, () => {
+            this._handleCompactionEnvelope(env);
+        })));
+    }
+    _collect(domain, env, handle) {
+        try {
+            handle();
+        }
+        catch (error) {
+            logger.warn('Forensics collector event collection failed', {
+                domain,
+                type: env.type,
+                sessionId: env.sessionId,
+                traceId: env.traceId,
+                turnId: env.turnId,
+                taskId: env.taskId,
+                error: summarizeError(error),
+            });
+        }
     }
     // ── Turn handling ──────────────────────────────────────────────────────────
     _handleTurnEnvelope(env) {
@@ -63,13 +85,21 @@ export class ForensicsCollector {
                 // Evict oldest orphaned tracker if at cap
                 if (this._turns.size >= MAX_TRACKER_SIZE) {
                     const firstKey = this._turns.keys().next().value;
-                    if (firstKey !== undefined)
+                    if (firstKey !== undefined) {
+                        const evicted = this._turns.get(firstKey);
                         this._turns.delete(firstKey);
+                        logger.warn('Forensics collector evicted active turn tracker', {
+                            turnId: firstKey,
+                            sessionId: evicted?.sessionId,
+                            traceId: evicted?.traceId,
+                            maxTrackerSize: MAX_TRACKER_SIZE,
+                        });
+                    }
                 }
                 this._turns.set(turnId, {
                     turnId,
-                    sessionId: env.sessionId,
-                    traceId: env.traceId,
+                    sessionId: env.sessionId ?? '',
+                    traceId: env.traceId ?? '',
                     startedAt: env.ts,
                     phaseTimings: [],
                     phaseLedger: [],
@@ -182,13 +212,21 @@ export class ForensicsCollector {
                 // Evict oldest orphaned tracker if at cap
                 if (this._tasks.size >= MAX_TRACKER_SIZE) {
                     const firstKey = this._tasks.keys().next().value;
-                    if (firstKey !== undefined)
+                    if (firstKey !== undefined) {
+                        const evicted = this._tasks.get(firstKey);
                         this._tasks.delete(firstKey);
+                        logger.warn('Forensics collector evicted active task tracker', {
+                            taskId: firstKey,
+                            sessionId: evicted?.sessionId,
+                            traceId: evicted?.traceId,
+                            maxTrackerSize: MAX_TRACKER_SIZE,
+                        });
+                    }
                 }
                 this._tasks.set(taskId, {
                     taskId,
-                    sessionId: env.sessionId,
-                    traceId: env.traceId,
+                    sessionId: env.sessionId ?? '',
+                    traceId: env.traceId ?? '',
                     startedAt: env.ts,
                     phaseTimings: [],
                     phaseLedger: [],
@@ -415,13 +453,7 @@ export class ForensicsCollector {
             budgetBreaches: tracker.budgetBreaches,
             jumpLinks,
         };
-        this._registry.push(report);
-        emitForensicsReportCreated(this._bus, { sessionId: tracker.sessionId, traceId: tracker.traceId, source: 'ForensicsCollector' }, {
-            reportId: report.id,
-            classification: report.classification,
-            errorMessage: report.errorMessage,
-            turnId: report.turnId,
-        });
+        this._publishReport(report, { turnId: tracker.turnId });
     }
     _finalise_task(tracker, errorMessage, wasCancelled) {
         const classification = classifyFailure({
@@ -456,13 +488,7 @@ export class ForensicsCollector {
             budgetBreaches: tracker.budgetBreaches,
             jumpLinks,
         };
-        this._registry.push(report);
-        emitForensicsReportCreated(this._bus, { sessionId: tracker.sessionId, traceId: tracker.traceId, source: 'ForensicsCollector' }, {
-            reportId: report.id,
-            classification: report.classification,
-            errorMessage: report.errorMessage,
-            taskId: report.taskId,
-        });
+        this._publishReport(report, { taskId: tracker.taskId });
     }
     // ── Helpers ────────────────────────────────────────────────────────────────
     _transitionPhase(t, domain, nextPhase, ts, eventType) {
@@ -505,6 +531,40 @@ export class ForensicsCollector {
             context,
         });
     }
+    _publishReport(report, context) {
+        try {
+            this._registry.push(report);
+        }
+        catch (error) {
+            logger.warn('Forensics collector failed to store report', {
+                reportId: report.id,
+                classification: report.classification,
+                sessionId: report.sessionId,
+                traceId: report.traceId,
+                ...context,
+                error: summarizeError(error),
+            });
+            return;
+        }
+        try {
+            emitForensicsReportCreated(this._bus, { sessionId: report.sessionId, traceId: report.traceId, source: 'ForensicsCollector' }, {
+                reportId: report.id,
+                classification: report.classification,
+                errorMessage: report.errorMessage,
+                ...context,
+            });
+        }
+        catch (error) {
+            logger.warn('Forensics collector failed to emit report event', {
+                reportId: report.id,
+                classification: report.classification,
+                sessionId: report.sessionId,
+                traceId: report.traceId,
+                ...context,
+                error: summarizeError(error),
+            });
+        }
+    }
     /** Derive a short human-readable report ID from a trace ID. */
     _shortId(traceId) {
         // Use the first 8 hex chars of the trace ID, fall back to a fresh UUID prefix

package/dist/platform/runtime/forensics/registry.d.ts

@@ -15,19 +15,19 @@ export interface ReplaySnapshotInput {
         readonly rev: number;
         readonly kind: string;
         readonly description: string;
-        readonly eventName?: string;
-        readonly ownerDomain?: string;
-        readonly failureMode?: string;
-        readonly relatedTurnId?: string;
+        readonly eventName?: string | undefined;
+        readonly ownerDomain?: string | undefined;
+        readonly failureMode?: string | undefined;
+        readonly relatedTurnId?: string | undefined;
     }>;
     readonly turnSummaries: ReadonlyArray<{
         readonly turnId: string;
         readonly outcome: 'completed' | 'failed' | 'cancelled';
         readonly terminalEvent: 'PREFLIGHT_FAIL' | 'TURN_COMPLETED' | 'TURN_ERROR' | 'TURN_CANCEL';
-        readonly startedRev?: number;
+        readonly startedRev?: number | undefined;
         readonly terminalRev: number;
-        readonly stopReason?: string;
-        readonly message?: string;
+        readonly stopReason?: string | undefined;
+        readonly message?: string | undefined;
     }>;
 }
 /** Default maximum number of failure reports retained in memory. */
@@ -44,9 +44,9 @@ export declare class ForensicsRegistry {
      */
     push(report: FailureReport): void;
     /**
-     * Return the most recently generated report, or undefined if none exist.
+     * Return the most recently generated report, or null if none exist.
      */
-    latest(): FailureReport | undefined;
+    latest(): FailureReport | null;
     /**
      * Return a report by its short ID, or undefined if not found.
      */

package/dist/platform/runtime/forensics/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/forensics/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAIhB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC,CAAC;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QACvD,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;QAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEnC,KAAK,GAAE,MAA+B;IAIzD;;;OAGG;IACI,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAWxC;;OAEG;IACI,MAAM,IAAI,aAAa,GAAG,SAAS;IAI1C;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;OAEG;IACI,MAAM,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACI,KAAK,IAAI,MAAM;IAItB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMnD;;;OAGG;IACI,WAAW,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,eAAe,GAAG,SAAS;IAmC9B;;;OAGG;IACI,kBAAkB,CACvB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,MAAM,GAAG,SAAS;IAMrB;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKlD,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,oBAAoB;IAqE5B,OAAO,CAAC,QAAQ;CAQjB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/forensics/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EAIhB,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAC7C,CAAC,CAAC;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QACvD,QAAQ,CAAC,aAAa,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,YAAY,GAAG,aAAa,CAAC;QAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACvC,CAAC,CAAC;CACJ;AAED,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;gBAEnC,KAAK,GAAE,MAA+B;IAIzD;;;OAGG;IACI,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAWxC;;OAEG;IACI,MAAM,IAAI,aAAa,GAAG,IAAI;IAIrC;;OAEG;IACI,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIrD;;OAEG;IACI,MAAM,IAAI,aAAa,EAAE;IAIhC;;OAEG;IACI,KAAK,IAAI,MAAM;IAItB;;;OAGG;IACI,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMnD;;;OAGG;IACI,WAAW,CAChB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,eAAe,GAAG,SAAS;IAmC9B;;;OAGG;IACI,kBAAkB,CACvB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE;QAAE,cAAc,CAAC,EAAE,mBAAmB,CAAA;KAAO,GACrD,MAAM,GAAG,SAAS;IAMrB;;OAEG;IACI,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAKlD,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,oBAAoB;IAqE5B,OAAO,CAAC,QAAQ;CAQjB"}

package/dist/platform/runtime/forensics/registry.js

@@ -26,10 +26,10 @@ export class ForensicsRegistry {
         this._notify();
     }
     /**
-     * Return the most recently generated report, or undefined if none exist.
+     * Return the most recently generated report, or null if none exist.
      */
     latest() {
-        return this._reports.at(-1);
+        return this._reports.at(-1) ?? null;
     }
     /**
      * Return a report by its short ID, or undefined if not found.

package/dist/platform/runtime/forensics/types.d.ts

@@ -21,13 +21,13 @@ export interface PhaseTimingEntry {
     /** Epoch ms when the phase started. */
     readonly startedAt: number;
     /** Epoch ms when the phase ended (undefined if still in progress at report time). */
-    readonly endedAt?: number;
+    readonly endedAt?: number | undefined;
     /** Duration in ms (undefined if still in progress). */
-    readonly durationMs?: number;
+    readonly durationMs?: number | undefined;
     /** Whether this phase completed successfully. */
     readonly success: boolean;
     /** Error message if the phase failed. */
-    readonly error?: string;
+    readonly error?: string | undefined;
 }
 export type PhaseLedgerOutcome = 'in_progress' | 'succeeded' | 'failed' | 'cancelled';
 export interface PhaseLedgerEntry {
@@ -36,11 +36,11 @@ export interface PhaseLedgerEntry {
     readonly phase: string;
     readonly enterEventType: string;
     readonly enteredAt: number;
-    readonly exitEventType?: string;
-    readonly exitedAt?: number;
-    readonly durationMs?: number;
+    readonly exitEventType?: string | undefined;
+    readonly exitedAt?: number | undefined;
+    readonly durationMs?: number | undefined;
     readonly outcome: PhaseLedgerOutcome;
-    readonly error?: string;
+    readonly error?: string | undefined;
 }
 /**
  * A single link in the failure's causal chain.
@@ -56,7 +56,7 @@ export interface CausalChainEntry {
     /** Event type that produced this link (from the event bus). */
     readonly sourceEventType: string;
     /** Optional structured context (tool name, error code, domain, etc.). */
-    readonly context?: Readonly<Record<string, string | number | boolean>>;
+    readonly context?: Readonly<Record<string, string | number | boolean>> | undefined;
     /** Whether this link is the diagnosed root cause. */
     readonly isRootCause: boolean;
 }
@@ -79,7 +79,7 @@ export interface ForensicsJumpLink {
     /** Panel ID or slash command string (without leading slash). */
     readonly target: string;
     /** Optional arguments (e.g. task ID or turn ID to pre-select). */
-    readonly args?: string;
+    readonly args?: string | undefined;
 }
 /**
  * Complete failure forensics report.
@@ -99,15 +99,15 @@ export interface FailureReport {
     /** Human-readable summary of the failure for the panel header. */
     readonly summary: string;
     /** Stop reason from the LLM provider (if applicable). */
-    readonly stopReason?: string;
+    readonly stopReason?: string | undefined;
     /** Terminal error message (most specific error available). */
-    readonly errorMessage?: string;
+    readonly errorMessage?: string | undefined;
     /** Task ID if this is a task failure. */
-    readonly taskId?: string;
+    readonly taskId?: string | undefined;
     /** Turn ID if this is a turn failure. */
-    readonly turnId?: string;
+    readonly turnId?: string | undefined;
     /** Agent ID if this failure was associated with a specific agent. */
-    readonly agentId?: string;
+    readonly agentId?: string | undefined;
     /** Ordered phase timings from the originating turn or task execution. */
     readonly phaseTimings: readonly PhaseTimingEntry[];
     /** Ordered phase transition ledger for explicit runtime reconstruction. */
@@ -126,15 +126,15 @@ export interface FailureReport {
 export interface PermissionEvidenceEntry {
     readonly callId: string;
     readonly tool: string;
-    readonly requestedAt?: number;
-    readonly decidedAt?: number;
-    readonly durationMs?: number;
-    readonly approved?: boolean;
-    readonly source?: string;
-    readonly reasonCode?: string;
-    readonly classification?: string;
-    readonly riskLevel?: string;
-    readonly summary?: string;
+    readonly requestedAt?: number | undefined;
+    readonly decidedAt?: number | undefined;
+    readonly durationMs?: number | undefined;
+    readonly approved?: boolean | undefined;
+    readonly source?: string | undefined;
+    readonly reasonCode?: string | undefined;
+    readonly classification?: string | undefined;
+    readonly riskLevel?: string | undefined;
+    readonly summary?: string | undefined;
 }
 export interface BudgetBreachEvidence {
     readonly callId: string;
@@ -148,25 +148,25 @@ export interface ForensicsReplayMismatchEvidence {
     readonly rev: number;
     readonly kind: string;
     readonly description: string;
-    readonly eventName?: string;
-    readonly ownerDomain?: string;
-    readonly failureMode?: string;
-    readonly relatedTurnId?: string;
+    readonly eventName?: string | undefined;
+    readonly ownerDomain?: string | undefined;
+    readonly failureMode?: string | undefined;
+    readonly relatedTurnId?: string | undefined;
 }
 export interface ForensicsReplayTurnEvidence {
     readonly turnId: string;
     readonly outcome: 'completed' | 'failed' | 'cancelled';
     readonly terminalEvent: 'PREFLIGHT_FAIL' | 'TURN_COMPLETED' | 'TURN_ERROR' | 'TURN_CANCEL';
-    readonly startedRev?: number;
+    readonly startedRev?: number | undefined;
     readonly terminalRev: number;
-    readonly stopReason?: string;
-    readonly message?: string;
+    readonly stopReason?: string | undefined;
+    readonly message?: string | undefined;
 }
 export interface ForensicsReplayEvidence {
     readonly status: 'unavailable' | 'not_loaded' | 'available';
-    readonly runId?: string;
-    readonly currentRev?: number;
-    readonly totalRevisions?: number;
+    readonly runId?: string | undefined;
+    readonly currentRev?: number | undefined;
+    readonly totalRevisions?: number | undefined;
     readonly mismatchCount: number;
     readonly mismatches: readonly ForensicsReplayMismatchEvidence[];
     readonly relatedMismatches: readonly ForensicsReplayMismatchEvidence[];
@@ -176,12 +176,12 @@ export interface ForensicsReplayEvidence {
         readonly byOwnerDomain: Readonly<Record<string, number>>;
     };
     readonly turnSummaries: readonly ForensicsReplayTurnEvidence[];
-    readonly matchingTurnSummary?: ForensicsReplayTurnEvidence;
+    readonly matchingTurnSummary?: ForensicsReplayTurnEvidence | undefined;
 }
 export interface ForensicsEvidenceSummary {
-    readonly rootCause?: string;
-    readonly terminalPhase?: string;
-    readonly terminalOutcome?: PhaseLedgerOutcome;
+    readonly rootCause?: string | undefined;
+    readonly terminalPhase?: string | undefined;
+    readonly terminalOutcome?: PhaseLedgerOutcome | undefined;
     readonly phaseCount: number;
     readonly causalCount: number;
     readonly cascadeCount: number;
@@ -191,9 +191,9 @@ export interface ForensicsEvidenceSummary {
     readonly slowPhases: readonly string[];
     readonly jumpLinkCount: number;
     readonly relatedIds: {
-        readonly turnId?: string;
-        readonly taskId?: string;
-        readonly agentId?: string;
+        readonly turnId?: string | undefined;
+        readonly taskId?: string | undefined;
+        readonly agentId?: string | undefined;
     };
 }
 export interface ForensicsBundle {

package/dist/platform/runtime/forensics/types.d.ts.map

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

package/dist/platform/runtime/foundation-clients.d.ts

@@ -15,7 +15,7 @@ export interface RuntimeFoundationClientsOptions extends OperatorClientServicesO
         getSnapshot(): UiTasksSnapshot;
     };
     readonly taskManager: TaskManager;
-    readonly opsControlPlane?: OpsControlPlane;
+    readonly opsControlPlane?: OpsControlPlane | undefined;
 }
 export interface RuntimeFoundationClients {
     readonly transportServices: DirectTransportServices;

package/dist/platform/runtime/foundation-clients.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundation-clients.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/foundation-clients.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,+BAAgC,SAAQ,6BAA6B;IACpF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE;QACvB,WAAW,IAAI,eAAe,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;CAC5C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,wBAAwB,CAkC1B"}
+{"version":3,"file":"foundation-clients.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/foundation-clients.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,6BAA6B,EACnC,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,WAAW,+BAAgC,SAAQ,6BAA6B;IACpF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE;QACvB,WAAW,IAAI,eAAe,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;IACpD,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,+BAA+B,GACvC,wBAAwB,CAkC1B"}

package/dist/platform/runtime/guidance.d.ts

@@ -19,10 +19,10 @@ export interface ContextualGuidanceSnapshot {
     readonly recommendations: readonly EcosystemRecommendation[];
 }
 export interface GuidancePersistenceOptions {
-    readonly guidancePath?: string;
-    readonly userRoot?: string;
-    readonly homeDirectory?: string;
-    readonly surfaceRoot?: string;
+    readonly guidancePath?: string | undefined;
+    readonly userRoot?: string | undefined;
+    readonly homeDirectory?: string | undefined;
+    readonly surfaceRoot?: string | undefined;
 }
 export declare function dismissGuidance(id: string, options?: GuidancePersistenceOptions): void;
 export declare function resetGuidance(id?: string, options?: GuidancePersistenceOptions): void;

package/dist/platform/runtime/guidance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/guidance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAOD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAgCD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAItF;AAED,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAQrF;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,wBAAwB,EACrC,OAAO,CAAC,EAAE,0BAA0B,GACnC,YAAY,EAAE,CAuFhB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAQ5E"}
+{"version":3,"file":"guidance.d.ts","sourceRoot":"","sources":["../../../src/platform/runtime/guidance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAG9E,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,UAAU,GAAG,cAAc,CAAC;AAE1F,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,eAAe,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAOD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAgCD,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAItF;AAED,wBAAgB,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GAAG,IAAI,CAQrF;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,wBAAwB,EACrC,OAAO,CAAC,EAAE,0BAA0B,GACnC,YAAY,EAAE,CAuFhB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,MAAM,EAAE,CAQ5E"}

package/dist/platform/runtime/health/aggregator.js

@@ -89,7 +89,7 @@ export class RuntimeHealthAggregator {
     getDomainHealth(domain) {
         const health = this.domainHealth.get(domain);
         if (!health) {
-            // Defensive fallback: domain not in ALL_DOMAINS list
+            // Defensive record for a domain outside ALL_DOMAINS.
             return {
                 domain,
                 status: 'unknown',

package/dist/platform/runtime/health/effect-handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-handlers.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/health/effect-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AA0ChF,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAiHN"}
+{"version":3,"file":"effect-handlers.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/health/effect-handlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAwB,MAAM,oBAAoB,CAAC;AA2BhF,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAiHN"}

package/dist/platform/runtime/health/effect-handlers.js

@@ -20,25 +20,10 @@ import { createEventEnvelope } from '../events/index.js';
  * cross-domain cast in a single, documented location rather than duplicating it
  * at each call site.
  */
-/**
- * GC-ARCH-002 allowlist: This file is explicitly permitted to call
- * RuntimeEventBus.emit() directly because it emits synthetic health events
- * (CASCADE_APPLIED, EMIT_EVENT effects) that are intentionally outside the
- * AnyRuntimeEvent typed union. The necessary cast is isolated here to avoid
- * duplicating it at every effect-handler call site.
- *
- * Do NOT copy this pattern elsewhere — use typed emitters from
- * src/runtime/emitters/ for all standard domain events.
- */
 function emitHealthEvent(bus, envelope) {
-    // GC-ARCH-002: CASCADE_APPLIED and synthetic health events live outside the AnyRuntimeEvent
-    // typed union by design. We use the implementation overload of bus.emit directly to route
-    // them without polluting the AnyRuntimeEvent union. The single-step cast (not via unknown)
-    // is audited and intentional — health events are valid RuntimeEventEnvelope objects whose
-    // type discriminant is a string literal unknown to the compile-time union.
-    //
-    // Do NOT copy this pattern elsewhere — use typed emitters from src/runtime/emitters/ for
-    // all standard domain events.
+    // CASCADE_APPLIED and synthetic health events live outside the AnyRuntimeEvent typed union
+    // by design. Keep the cross-domain cast isolated here so standard domain events can continue
+    // using typed emitters.
     bus.emit(
     // Health events use 'session' as the routing domain — it is the most general
     // domain and health cascades originate from session-level failures.

package/dist/platform/runtime/health/types.d.ts

@@ -19,9 +19,9 @@ export interface DomainHealth {
     /** Unix timestamp (ms) of the last status transition */
     lastTransitionAt: number;
     /** Capabilities reduced when the domain is degraded (not failed) */
-    degradedCapabilities?: string[];
+    degradedCapabilities?: string[] | undefined;
     /** Human-readable reason for the current failure, if any */
-    failureReason?: string;
+    failureReason?: string | undefined;
     /** Number of recovery attempts made since last failure */
     recoveryAttempts: number;
     /** Maximum recovery attempts allowed before cascading */
@@ -105,22 +105,22 @@ export interface CascadeResult {
      */
     recoveryExhausted: boolean;
     /** Optional context about the entity that triggered the cascade (e.g. { pluginId: 'foo' }) */
-    sourceContext?: Record<string, string>;
+    sourceContext?: Record<string, string> | undefined;
     /**
      * Wall-clock latency (ms) of the cascade rule evaluation that produced this result.
      * Populated by CascadeTimer; undefined when evaluated directly via CascadeEngine.
      */
-    latencyMs?: number;
+    latencyMs?: number | undefined;
     /**
      * Severity tier derived from the cascade effect type and recovery state.
      * Populated by CascadeTimer; undefined when evaluated directly via CascadeEngine.
      */
-    severity?: string;
+    severity?: string | undefined;
     /**
      * Playbook IDs providing remediation actions for this cascade type.
      * Populated by CascadeTimer; empty when evaluated directly via CascadeEngine.
      */
-    remediationPlaybookIds?: readonly string[];
+    remediationPlaybookIds?: readonly string[] | undefined;
 }
 /**
  * Return value of CascadeEngine.evaluate().
@@ -151,22 +151,22 @@ export interface CascadeAppliedEvent {
     /** Whether recovery was exhausted before this cascade was applied */
     recoveryExhausted: boolean;
     /** Optional context about the entity that triggered the cascade */
-    sourceContext?: Record<string, string>;
+    sourceContext?: Record<string, string> | undefined;
     /**
      * Wall-clock latency (ms) of the cascade evaluation that produced this event.
      * Populated when the event is created from a TimedCascadeResult.
      */
-    latencyMs?: number;
+    latencyMs?: number | undefined;
     /**
      * Severity tier of this cascade event.
      * Populated when the event is created from a TimedCascadeResult.
      */
-    severity?: string;
+    severity?: string | undefined;
     /**
      * Playbook IDs that provide remediation actions for this cascade type.
      * Populated when the event is created from a TimedCascadeResult.
      */
-    remediationPlaybookIds?: readonly string[];
+    remediationPlaybookIds?: readonly string[] | undefined;
 }
 /**
  * Create a CascadeAppliedEvent from a CascadeResult.

package/dist/platform/runtime/health/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/health/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,eAAe,GACf,aAAa,GACb,OAAO,GACP,QAAQ,GACR,SAAS,GACT,KAAK,GACL,WAAW,GACX,SAAS,GACT,YAAY,GACZ,cAAc,GACd,OAAO,GACP,QAAQ,GACR,UAAU,GACV,gBAAgB,GAChB,QAAQ,GACR,KAAK,GACL,cAAc,GACd,WAAW,GACX,KAAK,GACL,WAAW,GACX,cAAc,GACd,aAAa,CAAC;AAElB,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAC;IACrB,4BAA4B;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,6DAA6D;AAC7D,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,OAAO,EAAE,YAAY,CAAC;IACtB,6CAA6C;IAC7C,OAAO,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;IACzC,0CAA0C;IAC1C,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,wCAAwC;IACxC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,GAC9E;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,MAAM,EAAE,YAAY,CAAC;IACrB,qEAAqE;IACrE,WAAW,EAAE,YAAY,CAAC;IAC1B,oDAAoD;IACpD,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,wCAAwC;IACxC,MAAM,EAAE,aAAa,CAAC;IACtB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,iDAAiD;IACjD,MAAM,EAAE,aAAa,CAAC;IACtB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,iBAAiB,EAAE,OAAO,CAAC;IAC3B,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,kEAAkE;IAClE,eAAe,EAAE,aAAa,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,iBAAiB,CAAC;IACxB,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,YAAY,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IAC7B,kCAAkC;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,mBAAmB,CAcpF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/platform/runtime/health/types.ts"],"names":[],"mappings":"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"}

package/dist/platform/runtime/health/wiring.d.ts

@@ -41,7 +41,7 @@ export declare class HealthStoreWiring {
      * changes — callers should use `evaluateDomain()` for explicit cascade evaluation.
      *
      * Calling `start()` on an already-started wiring replaces the existing
-     * subscription without leaking the old one.
+     * subscription without leaking the previous one.
      */
     start(): void;
     /**

package/dist/platform/runtime/health/wiring.js

@@ -42,7 +42,7 @@ export class HealthStoreWiring {
      * changes — callers should use `evaluateDomain()` for explicit cascade evaluation.
      *
      * Calling `start()` on an already-started wiring replaces the existing
-     * subscription without leaking the old one.
+     * subscription without leaking the previous one.
      */
     start() {
         // Release any existing subscription before re-subscribing