@principles/core 1.73.0

package/dist/runtime-v2/gfi/gfi-read-model.js

@@ -0,0 +1,129 @@
+/**
+ * GFI Observability Read Model
+ *
+ * Pure domain model for building workspace-level GFI snapshots.
+ * Partitions sessions into active vs stale and produces an authoritative snapshot
+ * for operator visibility.
+ *
+ * PRI-78: GFI Observability
+ */
+import { DEFAULT_GFI_POLICY } from './gfi-policy.js';
+import { createGfiSnapshot } from './gfi-kernel.js';
+const DEFAULT_STALE_CUTOFF_MS = 2 * 60 * 60 * 1000; // 2 hours
+const DEFAULT_STALE_GFI_DEGRADED_THRESHOLD = 40;
+export function classifyGfiWorkspaceHealth(snapshot, options) {
+    const staleGfiDegradedThreshold = options?.staleGfiDegradedThreshold ?? DEFAULT_STALE_GFI_DEGRADED_THRESHOLD;
+    if (snapshot.active !== null && snapshot.active.currentGfi >= staleGfiDegradedThreshold) {
+        return {
+            status: 'degraded',
+            reason: `Active session has elevated GFI (${snapshot.active.currentGfi})`,
+            staleGfiDegradedThreshold,
+        };
+    }
+    if (snapshot.activeSessionCount === 0 && snapshot.staleSessionCount > 0) {
+        const maxStaleGfi = snapshot.staleGfiRange?.max ?? 0;
+        if (maxStaleGfi >= staleGfiDegradedThreshold) {
+            return {
+                status: 'degraded',
+                reason: `No active sessions, ${snapshot.staleSessionCount} stale sessions with high GFI (max: ${maxStaleGfi})`,
+                staleGfiDegradedThreshold,
+            };
+        }
+        return {
+            status: 'healthy',
+            reason: `No active sessions, ${snapshot.staleSessionCount} stale sessions with low GFI (max: ${maxStaleGfi})`,
+            staleGfiDegradedThreshold,
+        };
+    }
+    return {
+        status: 'healthy',
+        reason: `${snapshot.activeSessionCount} active, ${snapshot.staleSessionCount} stale sessions`,
+        staleGfiDegradedThreshold,
+    };
+}
+/**
+ * Convert a session's fields to a GfiState for snapshot creation.
+ * Note: lastErrorHash is not persisted across sessions, so we omit it.
+ */
+function sessionToGfiState(session) {
+    return {
+        currentGfi: session.currentGfi ?? 0,
+        gfiBySource: (session.gfiBySource ?? {}),
+        lastErrorSource: session.lastErrorSource,
+        consecutiveErrors: session.consecutiveErrors ?? 0,
+        lastGfiDecayAt: session.lastGfiDecayAt,
+        dailyGfiPeak: session.dailyGfiPeak,
+    };
+}
+/**
+ * Build a workspace-level GFI snapshot from session data.
+ *
+ * Algorithm:
+ * 1. Default stale cutoff to 2 hours if not provided
+ * 2. Partition sessions into active (lastActivityAt >= nowMs - staleCutoffMs) and stale
+ * 3. Select active session with highest currentGfi (tie-break: most recent lastActivityAt)
+ * 4. Build GfiSnapshot for selected active session using createGfiSnapshot
+ * 5. Compute staleGfiRange from stale sessions' currentGfi values
+ * 6. Return GfiWorkspaceSnapshot
+ *
+ * Key invariant: stale sessions do NOT influence the active snapshot.
+ * This prevents old UAT sessions with GFI=197.8 from making current health look critical.
+ */
+export function buildGfiWorkspaceSnapshot(input) {
+    const { sessions, nowMs, policy = DEFAULT_GFI_POLICY } = input;
+    const staleCutoffMs = input.staleCutoffMs ?? DEFAULT_STALE_CUTOFF_MS;
+    if (sessions.length === 0) {
+        return {
+            active: null,
+            staleSessionCount: 0,
+            staleGfiRange: null,
+            totalSessionCount: 0,
+            activeSessionCount: 0,
+            generatedAt: new Date(nowMs).toISOString(),
+        };
+    }
+    const cutoffTime = nowMs - staleCutoffMs;
+    // Partition sessions
+    const activeSessions = [];
+    const staleSessions = [];
+    for (const session of sessions) {
+        if ((session.lastActivityAt ?? 0) >= cutoffTime) {
+            activeSessions.push(session);
+        }
+        else {
+            staleSessions.push(session);
+        }
+    }
+    // Select active session: highest currentGfi, tie-break by most recent lastActivityAt
+    let selectedActive = null;
+    for (const session of activeSessions) {
+        if (selectedActive === null ||
+            (session.currentGfi ?? 0) > (selectedActive.currentGfi ?? 0) ||
+            ((session.currentGfi ?? 0) === (selectedActive.currentGfi ?? 0) &&
+                (session.lastActivityAt ?? 0) > (selectedActive.lastActivityAt ?? 0))) {
+            selectedActive = session;
+        }
+    }
+    // Build snapshot for active session
+    const activeSnapshot = selectedActive
+        ? createGfiSnapshot(sessionToGfiState(selectedActive), policy)
+        : null;
+    // Compute stale GFI range
+    let staleGfiRange = null;
+    if (staleSessions.length > 0) {
+        const staleGfis = staleSessions.map((s) => s.currentGfi ?? 0);
+        staleGfiRange = {
+            min: staleGfis.reduce((a, b) => Math.min(a, b), Infinity),
+            max: staleGfis.reduce((a, b) => Math.max(a, b), -Infinity),
+        };
+    }
+    return {
+        active: activeSnapshot,
+        staleSessionCount: staleSessions.length,
+        staleGfiRange,
+        totalSessionCount: sessions.length,
+        activeSessionCount: activeSessions.length,
+        generatedAt: new Date(nowMs).toISOString(),
+    };
+}
+//# sourceMappingURL=gfi-read-model.js.map

package/dist/runtime-v2/gfi/gfi-read-model.js.map

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

package/dist/runtime-v2/gfi/gfi-types.d.ts

@@ -0,0 +1,70 @@
+export type GfiSource = 'tool_failure' | 'dispatch_error' | 'user_empathy' | 'manual_pain' | 'correction_cue' | 'llm_paralysis' | 'gate_block' | 'unknown';
+export type GfiStage = 'stable' | 'elevated' | 'critical' | 'saturated';
+export interface GfiState {
+    currentGfi: number;
+    /**
+     * Per-source GFI ledger. Invariant: when gfiBySource is non-empty,
+     * currentGfi MUST equal the sum of all source values (within rounding).
+     *
+     * Exception: after session restart or persistence boundary, gfiBySource
+     * may be empty while currentGfi > 0 (source ledger not persisted).
+     * In this state, applyDecay falls back to direct currentGfi decay
+     * using the stage rate until source events repopulate the ledger.
+     */
+    gfiBySource: Partial<Record<GfiSource, number>>;
+    lastErrorHash?: string;
+    lastErrorSource?: string;
+    consecutiveErrors: number;
+    lastGfiDecayAt?: number;
+    dailyGfiPeak?: number;
+}
+export interface GfiPolicy {
+    stageThresholds: {
+        elevated: number;
+        critical: number;
+        saturated: number;
+    };
+    repeatedFailureMultiplier: {
+        base: number;
+        max: number;
+    };
+    decayRatesPerMinute: {
+        stable: number;
+        elevated: number;
+        critical: number;
+        saturated: number;
+    };
+    relief: {
+        toolSuccessRatio: number;
+        minPruneBelow: number;
+    };
+    sourceWeights: Partial<Record<GfiSource, number>>;
+}
+export interface GfiEvent {
+    source: GfiSource;
+    baseScore: number;
+    hash?: string;
+    at?: number;
+    detail?: string;
+}
+export interface GfiSnapshot {
+    currentGfi: number;
+    stage: GfiStage;
+    sources: Partial<Record<GfiSource, number>>;
+    dominantSource: string | null;
+    consecutiveErrors: number;
+    lastErrorSource?: string;
+    lastDecayAt?: string;
+    dailyGfiPeak?: number;
+    policy: {
+        elevatedThreshold: number;
+        criticalThreshold: number;
+        saturatedThreshold: number;
+        repeatedFailureMultiplierMax: number;
+    };
+    consumers: {
+        attitudeMode: 'efficient' | 'conciliatory' | 'humble_recovery';
+        painDiagnosticReason: 'none' | 'high_gfi';
+    };
+}
+//# sourceMappingURL=gfi-types.d.ts.map

package/dist/runtime-v2/gfi/gfi-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gfi-types.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/gfi-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,SAAS,CAAC;AAEd,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAExE,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,eAAe,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,yBAAyB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,mBAAmB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/F,MAAM,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE;QACN,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,4BAA4B,EAAE,MAAM,CAAC;KACtC,CAAC;IACF,SAAS,EAAE;QACT,YAAY,EAAE,WAAW,GAAG,cAAc,GAAG,iBAAiB,CAAC;QAC/D,oBAAoB,EAAE,MAAM,GAAG,UAAU,CAAC;KAC3C,CAAC;CACH"}

package/dist/runtime-v2/gfi/gfi-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gfi-types.js.map

package/dist/runtime-v2/gfi/gfi-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gfi-types.js","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/gfi-types.ts"],"names":[],"mappings":""}

package/dist/runtime-v2/gfi/index.d.ts

@@ -0,0 +1,6 @@
+export { DEFAULT_GFI_POLICY } from './gfi-policy.js';
+export { applyFriction, applyDecay, applyRelief, classifyGfiStage, createGfiSnapshot, } from './gfi-kernel.js';
+export { buildGfiWorkspaceSnapshot, classifyGfiWorkspaceHealth } from './gfi-read-model.js';
+export type { GfiState, GfiEvent, GfiPolicy, GfiStage, GfiSource, GfiSnapshot, } from './gfi-types.js';
+export type { GfiReadModelInput, GfiWorkspaceSnapshot, GfiWorkspaceHealthAssessment } from './gfi-read-model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime-v2/gfi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAE5F,YAAY,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime-v2/gfi/index.js

@@ -0,0 +1,4 @@
+export { DEFAULT_GFI_POLICY } from './gfi-policy.js';
+export { applyFriction, applyDecay, applyRelief, classifyGfiStage, createGfiSnapshot, } from './gfi-kernel.js';
+export { buildGfiWorkspaceSnapshot, classifyGfiWorkspaceHealth } from './gfi-read-model.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime-v2/gfi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime-v2/gfi/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EACL,aAAa,EACb,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime-v2/golden-trace-candidate-builder.d.ts

@@ -0,0 +1,23 @@
+import type { FullTracePayloadV2 } from './full-trace-contract.js';
+import type { RefinedTracePayload } from './trace-refiner.js';
+import type { GoldenTrace } from './golden-trace.js';
+export type GoldenTraceCandidateDecision = 'candidate_created' | 'insufficient_evidence';
+export interface GoldenTraceCandidateBuilderInput {
+    fullTrace: FullTracePayloadV2;
+    refinedTrace: RefinedTracePayload;
+    createdAt?: string;
+}
+export interface GoldenTraceCandidateRefusal {
+    decision: 'insufficient_evidence';
+    reasons: string[];
+    evidenceRefs: string[];
+}
+export interface GoldenTraceCandidateCreated {
+    decision: 'candidate_created';
+    goldenTrace: GoldenTrace;
+    evidenceRefs: string[];
+    builderNotes: string[];
+}
+export type GoldenTraceCandidateBuilderResult = GoldenTraceCandidateCreated | GoldenTraceCandidateRefusal;
+export declare function buildGoldenTraceCandidate(input: GoldenTraceCandidateBuilderInput): GoldenTraceCandidateBuilderResult;
+//# sourceMappingURL=golden-trace-candidate-builder.d.ts.map

package/dist/runtime-v2/golden-trace-candidate-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-trace-candidate-builder.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/golden-trace-candidate-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAEtE,MAAM,MAAM,4BAA4B,GACpC,mBAAmB,GACnB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,kBAAkB,CAAC;IAC9B,YAAY,EAAE,mBAAmB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,uBAAuB,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,MAAM,iCAAiC,GACzC,2BAA2B,GAC3B,2BAA2B,CAAC;AAmHhC,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,gCAAgC,GACtC,iCAAiC,CA4GnC"}

package/dist/runtime-v2/golden-trace-candidate-builder.js

@@ -0,0 +1,193 @@
+const FAILURE_SIGNALS = [
+    'error',
+    'failed',
+    'exception',
+    'timeout',
+    'timed out',
+    'permission denied',
+    'denied',
+    'crashed',
+    'fatal',
+    'abort',
+    'unreachable',
+];
+function containsFailureSignal(text) {
+    const lower = text.toLowerCase();
+    return FAILURE_SIGNALS.some((signal) => lower.includes(signal));
+}
+function extractMetadataString(entry, field) {
+    if (!entry.metadata || typeof entry.metadata !== 'object')
+        return undefined;
+    const meta = entry.metadata;
+    const value = meta[field];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function isFailureEntry(entry) {
+    const errorText = extractMetadataString(entry, 'error');
+    if (errorText)
+        return true;
+    if (containsFailureSignal(entry.summary))
+        return true;
+    if (entry.rawPreview && containsFailureSignal(entry.rawPreview))
+        return true;
+    const status = extractMetadataString(entry, 'status');
+    if (status && containsFailureSignal(status))
+        return true;
+    return false;
+}
+function tryParseJsonParams(raw) {
+    if (!raw || typeof raw !== 'string')
+        return null;
+    const trimmed = raw.trim();
+    if (!trimmed.startsWith('{'))
+        return null;
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function hasFailureResult(timeline, toolCallIndex, toolName) {
+    for (let i = toolCallIndex + 1; i < timeline.length; i++) {
+        const entry = timeline[i];
+        if (!entry)
+            continue;
+        if (entry.kind === 'tool_result') {
+            const resultToolName = extractMetadataString(entry, 'toolName');
+            if (resultToolName === toolName) {
+                return isFailureEntry(entry);
+            }
+        }
+        if (entry.kind === 'tool_call')
+            break;
+    }
+    return false;
+}
+function extractToolCallEvidence(timeline) {
+    const results = [];
+    for (let i = 0; i < timeline.length; i++) {
+        const entry = timeline[i];
+        if (!entry || entry.kind !== 'tool_call')
+            continue;
+        const toolName = extractMetadataString(entry, 'toolName');
+        if (!toolName)
+            continue;
+        const params = tryParseJsonParams(entry.rawPreview);
+        if (!params)
+            continue;
+        const isFailure = isFailureEntry(entry) || hasFailureResult(timeline, i, toolName);
+        results.push({
+            toolName,
+            params,
+            isFailure,
+            timelineIndex: i,
+        });
+    }
+    return results;
+}
+function deterministicHash(input) {
+    let hash = 0;
+    for (let i = 0; i < input.length; i++) {
+        const char = input.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash;
+    }
+    return Math.abs(hash).toString(36);
+}
+export function buildGoldenTraceCandidate(input) {
+    const { fullTrace, refinedTrace } = input;
+    const reasons = [];
+    const builderNotes = [];
+    const toolCallEvidence = extractToolCallEvidence(fullTrace.timeline);
+    const failureEvidence = toolCallEvidence.filter((e) => e.isFailure);
+    const positiveEvidence = toolCallEvidence.filter((e) => !e.isFailure);
+    if (failureEvidence.length === 0) {
+        reasons.push('no_failure_evidence: trace contains no failing tool calls with extractable params');
+    }
+    if (positiveEvidence.length === 0) {
+        reasons.push('no_positive_comparator: trace contains no non-failing tool calls with extractable params');
+    }
+    const noParamsEvidence = fullTrace.timeline.filter((e) => e.kind === 'tool_call' && extractMetadataString(e, 'toolName') && !tryParseJsonParams(e.rawPreview));
+    if (noParamsEvidence.length > 0) {
+        const toolNames = noParamsEvidence
+            .map((e) => extractMetadataString(e, 'toolName'))
+            .filter((n) => n !== undefined);
+        const missingParamsNote = `missing_params: tool calls without extractable params: ${toolNames.join(', ')}`;
+        reasons.push(missingParamsNote);
+        builderNotes.push(missingParamsNote);
+    }
+    if (failureEvidence.length === 0 || positiveEvidence.length === 0) {
+        return {
+            decision: 'insufficient_evidence',
+            reasons,
+            evidenceRefs: [...refinedTrace.evidenceRefs],
+        };
+    }
+    if (refinedTrace.ambiguityNotes.length > 0) {
+        builderNotes.push(...refinedTrace.ambiguityNotes.map((n) => `ambiguous: ${n}`));
+    }
+    if (refinedTrace.refinementNotes.length > 0) {
+        builderNotes.push(...refinedTrace.refinementNotes.map((n) => `refinement: ${n}`));
+    }
+    if (refinedTrace.sanitizationNotes.length > 0) {
+        builderNotes.push(...refinedTrace.sanitizationNotes.map((n) => `sanitized: ${n}`));
+    }
+    const { sourcePainId } = fullTrace;
+    const { sourceTaskId } = fullTrace;
+    const evidenceRefs = [...refinedTrace.evidenceRefs];
+    const cases = [];
+    let negativeIndex = 0;
+    for (const evidence of failureEvidence) {
+        negativeIndex++;
+        const caseId = `neg-${deterministicHash(`${sourceTaskId}:${evidence.toolName}:${negativeIndex}`)}`;
+        cases.push({
+            caseId,
+            kind: 'negative',
+            toolName: evidence.toolName,
+            params: { ...evidence.params },
+            expectedDecision: 'block',
+            sourceRefs: {
+                painId: sourcePainId,
+                candidateId: sourceTaskId,
+            },
+        });
+    }
+    let positiveIndex = 0;
+    for (const evidence of positiveEvidence) {
+        positiveIndex++;
+        const caseId = `pos-${deterministicHash(`${sourceTaskId}:${evidence.toolName}:${positiveIndex}`)}`;
+        cases.push({
+            caseId,
+            kind: 'positive',
+            toolName: evidence.toolName,
+            params: { ...evidence.params },
+            expectedDecision: 'allow',
+            sourceRefs: {
+                painId: sourcePainId,
+                candidateId: sourceTaskId,
+            },
+        });
+    }
+    const traceId = `gtc-${deterministicHash(`${sourceTaskId}:${sourcePainId}:${failureEvidence.map((e) => e.toolName).join(',')}`)}`;
+    const createdAt = input.createdAt ?? new Date().toISOString().replace(/\.\d{3}Z$/, '.000Z');
+    const goldenTrace = {
+        traceId,
+        sourcePainId,
+        sourceCandidateId: sourceTaskId,
+        cases,
+        createdAt,
+        version: 1,
+    };
+    return {
+        decision: 'candidate_created',
+        goldenTrace,
+        evidenceRefs,
+        builderNotes,
+    };
+}
+//# sourceMappingURL=golden-trace-candidate-builder.js.map

package/dist/runtime-v2/golden-trace-candidate-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-trace-candidate-builder.js","sourceRoot":"","sources":["../../src/runtime-v2/golden-trace-candidate-builder.ts"],"names":[],"mappings":"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"}

package/dist/runtime-v2/golden-trace-replay-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GoldenTrace Replay Adapter - Code-to-validator bridge with injected sandbox
+ *
+ * PRI-115: Provides a convenience function that loads raw code string
+ * into a sandbox and runs the replay validator against GoldenTrace cases.
+ *
+ * The sandbox loader is injected to keep core free of node:vm imports.
+ */
+import type { GoldenTraceCase } from './golden-trace.js';
+import { type ReplayValidatorResult, type ReplayValidatorConfig, type ReplayEvaluateFn } from './golden-trace-replay-validator.js';
+export interface ReplayCodeInput {
+    code: string;
+    cases: readonly GoldenTraceCase[];
+    config?: Partial<ReplayValidatorConfig>;
+}
+export type SandboxEvaluateLoader = (code: string) => ReplayEvaluateFn;
+export declare function replayValidateCode(input: ReplayCodeInput, loadEvaluate: SandboxEvaluateLoader): ReplayValidatorResult;
+//# sourceMappingURL=golden-trace-replay-adapter.d.ts.map

package/dist/runtime-v2/golden-trace-replay-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-trace-replay-adapter.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/golden-trace-replay-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACtB,MAAM,oCAAoC,CAAC;AAM5C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,gBAAgB,CAAC;AAMvE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,qBAAqB,GAClC,qBAAqB,CAIvB"}

package/dist/runtime-v2/golden-trace-replay-adapter.js

@@ -0,0 +1,18 @@
+/**
+ * GoldenTrace Replay Adapter - Code-to-validator bridge with injected sandbox
+ *
+ * PRI-115: Provides a convenience function that loads raw code string
+ * into a sandbox and runs the replay validator against GoldenTrace cases.
+ *
+ * The sandbox loader is injected to keep core free of node:vm imports.
+ */
+import { replayGoldenTrace, DEFAULT_REPLAY_VALIDATOR_CONFIG, } from './golden-trace-replay-validator.js';
+// ---------------------------------------------------------------------------
+// Adapter
+// ---------------------------------------------------------------------------
+export function replayValidateCode(input, loadEvaluate) {
+    const config = { ...DEFAULT_REPLAY_VALIDATOR_CONFIG, ...input.config };
+    const evaluateFn = loadEvaluate(input.code);
+    return replayGoldenTrace(evaluateFn, input.cases, config);
+}
+//# sourceMappingURL=golden-trace-replay-adapter.js.map

package/dist/runtime-v2/golden-trace-replay-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-trace-replay-adapter.js","sourceRoot":"","sources":["../../src/runtime-v2/golden-trace-replay-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,iBAAiB,EACjB,+BAA+B,GAIhC,MAAM,oCAAoC,CAAC;AAc5C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,kBAAkB,CAChC,KAAsB,EACtB,YAAmC;IAEnC,MAAM,MAAM,GAAG,EAAE,GAAG,+BAA+B,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IACvE,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,iBAAiB,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC5D,CAAC"}

package/dist/runtime-v2/golden-trace-replay-validator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * GoldenTrace Replay Validator - Pure replay validation for generated L2 rules
+ *
+ * PRI-115: Before L2 registration, generated rule code must pass replay
+ * against GoldenTrace cases. This module provides the pure validation logic.
+ *
+ * TRUST BOUNDARY:
+ *   - Pure functions only, zero side effects
+ *   - No filesystem, VM, process, or network access
+ *   - Sandbox loading is injected via the adapter layer
+ */
+import type { GoldenTraceCase, GoldenTraceDecision } from './golden-trace.js';
+import type { RuleHostDecision, RuleHostInput, RuleHostResult } from './internalization/rule-host-contracts.js';
+import type { RuleHostHelpers } from './internalization/rule-host-helpers.js';
+export interface ReplayValidatorCaseResult {
+    caseId: string;
+    passed: boolean;
+    expectedDecision: GoldenTraceDecision;
+    actualDecision: RuleHostDecision | 'error' | 'non_deterministic';
+    failureReason?: string;
+    repairHint?: string;
+    proposedParamsMatch?: boolean;
+    proposedParamsDiff?: string[];
+    applicationModeMatch?: boolean;
+}
+export interface ReplayValidatorResult {
+    passed: boolean;
+    totalCases: number;
+    passedCases: number;
+    failedCases: number;
+    perCaseResults: readonly ReplayValidatorCaseResult[];
+    failureReasons: readonly string[];
+    repairHints: readonly string[];
+}
+export interface ReplayValidatorConfig {
+    maxRepairAttempts: number;
+}
+export declare const DEFAULT_REPLAY_VALIDATOR_CONFIG: ReplayValidatorConfig;
+export type ReplayEvaluateFn = (input: RuleHostInput, helpers: RuleHostHelpers) => RuleHostResult;
+export declare function diffParams(expected: Record<string, unknown>, actual: Record<string, unknown>): string[];
+export declare function replayGoldenTrace(evaluateFn: ReplayEvaluateFn, cases: readonly GoldenTraceCase[], config?: Partial<ReplayValidatorConfig>): ReplayValidatorResult;
+//# sourceMappingURL=golden-trace-replay-validator.d.ts.map

package/dist/runtime-v2/golden-trace-replay-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-trace-replay-validator.d.ts","sourceRoot":"","sources":["../../src/runtime-v2/golden-trace-replay-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAChH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AAO9E,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,cAAc,EAAE,gBAAgB,GAAG,OAAO,GAAG,mBAAmB,CAAC;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,SAAS,yBAAyB,EAAE,CAAC;IACrD,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,+BAA+B,EAAE,qBAE7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,eAAe,KACrB,cAAc,CAAC;AAoBpB,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,EAAE,CAmCV;AAwJD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,SAAS,eAAe,EAAE,EACjC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GACtC,qBAAqB,CAoCvB"}