@alan512/experienceengine 0.1.2 → 0.2.0

package/dist/feedback/state-transition.js

@@ -1,12 +1,24 @@
-export const transitionState = (node) => {
+export const transitionState = (node, context = {}) => {
+    const strictPromotion = context.originProfile?.strictPromotion ?? false;
+    const activationHelpedThreshold = strictPromotion ? 2 : 1;
+    const activationSupportThreshold = strictPromotion ? 3 : 2;
     if (node.harmed_count >= 3 && node.helped_count === 0) {
         return "retired";
     }
+    if (node.state === "priority_candidate") {
+        if (node.helped_count >= activationHelpedThreshold || node.support_count >= activationSupportThreshold) {
+            return "active";
+        }
+        if (node.harmed_count > 0) {
+            return "candidate";
+        }
+        return "priority_candidate";
+    }
     if (node.harmed_count > node.helped_count) {
         return "cooling";
     }
     if (node.state === "candidate") {
-        if (node.support_count >= 2 || node.helped_count >= 1) {
+        if (node.support_count >= activationSupportThreshold || node.helped_count >= activationHelpedThreshold) {
             return "active";
         }
         return "candidate";

package/dist/feedback/state-transition.js.map

@@ -1 +1 @@
-{"version":3,"file":"state-transition.js","sourceRoot":"","sources":["../../src/feedback/state-transition.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAoB,EAA2B,EAAE;IAC/E,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,EAAE,CAAC;YACtD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,IAAoB,EACpB,QAA6B,EACO,EAAE;IACtC,IAAI,IAAI,CAAC,eAAe,KAAK,wBAAwB,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,0BAA0B,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,oBAAoB,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACzC,OAAO,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACzE,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC"}
+{"version":3,"file":"state-transition.js","sourceRoot":"","sources":["../../src/feedback/state-transition.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAoB,EAAE,UAA6B,EAAE,EAA2B,EAAE;IAChH,MAAM,eAAe,GAAG,OAAO,CAAC,aAAa,EAAE,eAAe,IAAI,KAAK,CAAC;IACxE,MAAM,yBAAyB,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,0BAA0B,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,KAAK,oBAAoB,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,YAAY,IAAI,yBAAyB,IAAI,IAAI,CAAC,aAAa,IAAI,0BAA0B,EAAE,CAAC;YACvG,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,aAAa,IAAI,0BAA0B,IAAI,IAAI,CAAC,YAAY,IAAI,yBAAyB,EAAE,CAAC;YACvG,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,IAAoB,EACpB,QAA6B,EACO,EAAE;IACtC,IAAI,IAAI,CAAC,eAAe,KAAK,wBAAwB,EAAE,CAAC;QACtD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,0BAA0B,EAAE,CAAC;QACzD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,IAAI,IAAI,CAAC,gBAAgB,KAAK,oBAAoB,EAAE,CAAC;QACnD,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC;QACrC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACzC,OAAO,UAAU,IAAI,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,oBAAoB,CAAC;IACzE,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC,CAAC"}

package/dist/hybrid/capsule-builder.d.ts

@@ -0,0 +1,23 @@
+import type { ExperienceLastInspection } from "../interaction/service.js";
+import type { ExperienceNode, OutcomeSignal, TaskRun, ToolEvent } from "../types/domain.js";
+import type { ExplainDecisionCapsule, HybridRouteDecision, PostmortemReviewCapsule } from "./types.js";
+export declare const buildExplainDecisionCapsule: (input: {
+    schemaVersion: string;
+    routeDecision: HybridRouteDecision;
+    inspection: ExperienceLastInspection;
+}) => ExplainDecisionCapsule;
+export declare const buildPostmortemReviewCapsule: (input: {
+    schemaVersion: string;
+    routeDecision: HybridRouteDecision;
+    taskRun: TaskRun;
+    outcomeSignal: OutcomeSignal;
+    triggers: {
+        directionalCorrectionPresent: boolean;
+        injectedNodeInteractionPresent: boolean;
+        retryOrInvalidationSignaturePresent: boolean;
+        meaningfulFailureSignaturePresent: boolean;
+        conservativeTransitionReviewWorthy: boolean;
+    };
+    injectedNodes?: ExperienceNode[];
+    toolEvents?: ToolEvent[];
+}) => PostmortemReviewCapsule;

package/dist/hybrid/capsule-builder.js

@@ -0,0 +1,114 @@
+import { normalizeWhitespace, stripShellLikeTaskCommands, truncate } from "../utils/text.js";
+const MAX_EVIDENCE_TEXT = 240;
+const strictTruncate = (value, max) => value.length <= max ? value : `${value.slice(0, max - 3).trimEnd()}...`;
+const sanitizeEvidenceText = (value) => {
+    const normalized = normalizeWhitespace(stripShellLikeTaskCommands(value));
+    const truncatedText = strictTruncate(truncate(normalized, MAX_EVIDENCE_TEXT), MAX_EVIDENCE_TEXT);
+    return {
+        text: truncatedText,
+        truncated: truncatedText.length < normalized.length
+    };
+};
+const toEvidence = (source, value) => {
+    if (!value) {
+        return undefined;
+    }
+    const { text, truncated } = sanitizeEvidenceText(value);
+    if (!text) {
+        return undefined;
+    }
+    return {
+        source,
+        text,
+        trust: "untrusted_evidence",
+        truncated
+    };
+};
+const defaultDeliveryStateForState = (state) => {
+    switch (state) {
+        case "priority_candidate":
+            return "conservative_only";
+        case "active":
+            return "eligible";
+        case "cooling":
+            return "conservative_only";
+        case "retired":
+            return "quarantined";
+        case "candidate":
+        default:
+            return "shadow_only";
+    }
+};
+export const buildExplainDecisionCapsule = (input) => {
+    const evidence = [
+        toEvidence("task_summary", input.inspection.summary),
+        toEvidence("decision_explanation", input.inspection.decisionExplanation),
+        toEvidence("context_summary", input.inspection.trustSummary),
+        ...input.inspection.retrievalNotes.map((note) => toEvidence("retrieval_note", note)),
+        ...input.inspection.timeline.map((entry) => toEvidence("timeline", entry.summary)),
+        ...input.inspection.evidence.map((entry) => toEvidence("tool_event", entry))
+    ].filter((entry) => Boolean(entry));
+    return {
+        task: "explain_decision",
+        schemaVersion: input.schemaVersion,
+        trusted: {
+            route: input.routeDecision,
+            inspection: {
+                scopeId: input.inspection.scopeId,
+                taskType: input.inspection.taskType,
+                intervention: input.inspection.intervention,
+                deliveryMode: input.inspection.deliveryMode,
+                autoFeedback: input.inspection.autoFeedback,
+                outcome: input.inspection.outcome,
+                learningStatus: input.inspection.learningStatus
+            },
+            scorecard: input.inspection.scorecard
+                ? {
+                    mode: input.inspection.scorecard.mode,
+                    decisionReason: input.inspection.scorecard.decisionReason,
+                    riskLevel: input.inspection.scorecard.riskLevel,
+                    confidence: input.inspection.scorecard.confidence,
+                    budgetClass: input.inspection.scorecard.budgetClass,
+                    fastPathApplied: input.inspection.scorecard.fastPathApplied,
+                    queryRewriteApplied: input.inspection.scorecard.queryRewriteApplied
+                }
+                : undefined
+        },
+        evidence
+    };
+};
+export const buildPostmortemReviewCapsule = (input) => {
+    const evidence = [
+        toEvidence("task_summary", input.taskRun.task_summary),
+        toEvidence("context_summary", input.taskRun.context_summary),
+        ...(input.toolEvents ?? []).map((event) => toEvidence("tool_event", [event.tool_name, event.status, event.output_summary ?? event.error_signature].filter(Boolean).join(": ")))
+    ].filter((entry) => Boolean(entry));
+    return {
+        task: "postmortem_review",
+        schemaVersion: input.schemaVersion,
+        trusted: {
+            route: input.routeDecision,
+            run: {
+                taskRunId: input.taskRun.id,
+                scopeId: input.taskRun.scope_id,
+                taskType: input.taskRun.task_type,
+                finalStatus: input.taskRun.final_status,
+                learningStatus: input.taskRun.learning_status,
+                outcomeSignal: input.outcomeSignal
+            },
+            injectedNodes: (input.injectedNodes ?? []).map((node) => ({
+                nodeId: node.id,
+                nodeType: node.node_type,
+                state: node.state,
+                deliveryState: node.delivery_state ?? defaultDeliveryStateForState(node.state),
+                taskType: node.task_type,
+                helpedCount: node.helped_count,
+                harmedCount: node.harmed_count,
+                compactHint: node.compact_hint
+            })),
+            reviewTriggers: input.triggers
+        },
+        evidence
+    };
+};
+//# sourceMappingURL=capsule-builder.js.map

package/dist/hybrid/capsule-builder.js.map

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

package/dist/hybrid/explain-provider-client.d.ts

@@ -0,0 +1,19 @@
+import type { ExperienceEngineConfig } from "../config/config-schema.js";
+import type { DistillerEndpoint } from "../distillation/providers/types.js";
+type ResolveHybridExplainProviderOptions = {
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+};
+export type HybridExplainProviderResolution = {
+    status: "disabled";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+} | {
+    status: "configured";
+    endpoint: DistillerEndpoint;
+    providerMode: ExperienceEngineConfig["hybridExplainProviderMode"];
+};
+export declare const resolveHybridExplainProviderEndpoint: (config: ExperienceEngineConfig, options?: ResolveHybridExplainProviderOptions) => HybridExplainProviderResolution;
+export {};

package/dist/hybrid/explain-provider-client.js

@@ -0,0 +1,34 @@
+import { resolveDistillerEndpoint } from "../distillation/host-llm.js";
+export const resolveHybridExplainProviderEndpoint = (config, options = {}) => {
+    if (!config.hybridExplainLlmEnabled) {
+        return {
+            status: "disabled",
+            reason: "Phase 2 provider-backed explain is disabled."
+        };
+    }
+    if (config.hybridExplainProviderMode !== "shared_distiller") {
+        return {
+            status: "unavailable",
+            reason: `Unsupported hybrid explain provider mode: ${config.hybridExplainProviderMode}`
+        };
+    }
+    const endpoint = resolveDistillerEndpoint({
+        env: options.env,
+        homeDir: options.homeDir,
+        configProvider: config.distillerProvider,
+        configAuthMode: config.distillationAuthMode,
+        configModel: config.distillerModel
+    });
+    if (!endpoint) {
+        return {
+            status: "unavailable",
+            reason: "Shared ExperienceEngine distillation provider resolution is unavailable."
+        };
+    }
+    return {
+        status: "configured",
+        endpoint,
+        providerMode: "shared_distiller"
+    };
+};
+//# sourceMappingURL=explain-provider-client.js.map

package/dist/hybrid/explain-provider-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain-provider-client.js","sourceRoot":"","sources":["../../src/hybrid/explain-provider-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAuBvE,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAClD,MAA8B,EAC9B,UAA+C,EAAE,EAChB,EAAE;IACnC,IAAI,CAAC,MAAM,CAAC,uBAAuB,EAAE,CAAC;QACpC,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,8CAA8C;SACvD,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,yBAAyB,KAAK,kBAAkB,EAAE,CAAC;QAC5D,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,6CAA6C,MAAM,CAAC,yBAAyB,EAAE;SACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,MAAM,CAAC,iBAAiB;QACxC,cAAc,EAAE,MAAM,CAAC,oBAAoB;QAC3C,WAAW,EAAE,MAAM,CAAC,cAAc;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,0EAA0E;SACnF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,QAAQ;QACR,YAAY,EAAE,kBAAkB;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/hybrid/postmortem-provider-client.d.ts

@@ -0,0 +1,19 @@
+import type { ExperienceEngineConfig } from "../config/config-schema.js";
+import type { DistillerEndpoint } from "../distillation/providers/types.js";
+type ResolveHybridPostmortemProviderOptions = {
+    env?: NodeJS.ProcessEnv;
+    homeDir?: string;
+};
+export type HybridPostmortemProviderResolution = {
+    status: "disabled";
+    reason: string;
+} | {
+    status: "unavailable";
+    reason: string;
+} | {
+    status: "configured";
+    endpoint: DistillerEndpoint;
+    providerMode: ExperienceEngineConfig["hybridPostmortemProviderMode"];
+};
+export declare const resolveHybridPostmortemProviderEndpoint: (config: ExperienceEngineConfig, options?: ResolveHybridPostmortemProviderOptions) => HybridPostmortemProviderResolution;
+export {};

package/dist/hybrid/postmortem-provider-client.js

@@ -0,0 +1,34 @@
+import { resolveDistillerEndpoint } from "../distillation/host-llm.js";
+export const resolveHybridPostmortemProviderEndpoint = (config, options = {}) => {
+    if (!config.hybridAsyncPostmortemLlmEnabled) {
+        return {
+            status: "disabled",
+            reason: "Phase 3 provider-backed postmortem review is disabled."
+        };
+    }
+    if (config.hybridPostmortemProviderMode !== "shared_distiller") {
+        return {
+            status: "unavailable",
+            reason: `Unsupported hybrid postmortem provider mode: ${config.hybridPostmortemProviderMode}`
+        };
+    }
+    const endpoint = resolveDistillerEndpoint({
+        env: options.env,
+        homeDir: options.homeDir,
+        configProvider: config.distillerProvider,
+        configAuthMode: config.distillationAuthMode,
+        configModel: config.distillerModel
+    });
+    if (!endpoint) {
+        return {
+            status: "unavailable",
+            reason: "Shared ExperienceEngine distillation provider resolution is unavailable."
+        };
+    }
+    return {
+        status: "configured",
+        endpoint,
+        providerMode: "shared_distiller"
+    };
+};
+//# sourceMappingURL=postmortem-provider-client.js.map

package/dist/hybrid/postmortem-provider-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postmortem-provider-client.js","sourceRoot":"","sources":["../../src/hybrid/postmortem-provider-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAuBvE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CACrD,MAA8B,EAC9B,UAAkD,EAAE,EAChB,EAAE;IACtC,IAAI,CAAC,MAAM,CAAC,+BAA+B,EAAE,CAAC;QAC5C,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,wDAAwD;SACjE,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,4BAA4B,KAAK,kBAAkB,EAAE,CAAC;QAC/D,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,gDAAgD,MAAM,CAAC,4BAA4B,EAAE;SAC9F,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,cAAc,EAAE,MAAM,CAAC,iBAAiB;QACxC,cAAc,EAAE,MAAM,CAAC,oBAAoB;QAC3C,WAAW,EAAE,MAAM,CAAC,cAAc;KACnC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,0EAA0E;SACnF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,QAAQ;QACR,YAAY,EAAE,kBAAkB;KACjC,CAAC;AACJ,CAAC,CAAC"}

package/dist/hybrid/rollout.d.ts

@@ -0,0 +1,9 @@
+import type { ExperienceEngineConfig } from "../config/config-schema.js";
+import type { HybridRolloutMode } from "./types.js";
+export type HybridRolloutState = {
+    effectiveMode: HybridRolloutMode | "disabled" | "control";
+    hybridActive: boolean;
+    userVisible: boolean;
+    reason: "enabled" | "shadow" | "canary_selected" | "canary_excluded" | "disabled" | "kill_switch";
+};
+export declare const resolveHybridRolloutState: (config: Pick<ExperienceEngineConfig, "hybridEnabled" | "hybridRolloutMode" | "hybridCanaryRate" | "hybridKillSwitch">, key: string) => HybridRolloutState;

package/dist/hybrid/rollout.js

@@ -0,0 +1,49 @@
+const computeBucket = (value) => {
+    let hash = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        hash = (hash * 31 + value.charCodeAt(index)) >>> 0;
+    }
+    return (hash % 10_000) / 10_000;
+};
+export const resolveHybridRolloutState = (config, key) => {
+    if (!config.hybridEnabled) {
+        return {
+            effectiveMode: "disabled",
+            hybridActive: false,
+            userVisible: false,
+            reason: "disabled"
+        };
+    }
+    if (config.hybridKillSwitch) {
+        return {
+            effectiveMode: "disabled",
+            hybridActive: false,
+            userVisible: false,
+            reason: "kill_switch"
+        };
+    }
+    if (config.hybridRolloutMode === "shadow") {
+        return {
+            effectiveMode: "shadow",
+            hybridActive: true,
+            userVisible: false,
+            reason: "shadow"
+        };
+    }
+    if (config.hybridRolloutMode === "canary") {
+        const selected = computeBucket(key) < config.hybridCanaryRate;
+        return {
+            effectiveMode: selected ? "canary" : "control",
+            hybridActive: selected,
+            userVisible: selected,
+            reason: selected ? "canary_selected" : "canary_excluded"
+        };
+    }
+    return {
+        effectiveMode: "live",
+        hybridActive: true,
+        userVisible: true,
+        reason: "enabled"
+    };
+};
+//# sourceMappingURL=rollout.js.map

package/dist/hybrid/rollout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollout.js","sourceRoot":"","sources":["../../src/hybrid/rollout.ts"],"names":[],"mappings":"AAUA,MAAM,aAAa,GAAG,CAAC,KAAa,EAAU,EAAE;IAC9C,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,MAGC,EACD,GAAW,EACS,EAAE;IACtB,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAC1B,OAAO;YACL,aAAa,EAAE,UAAU;YACzB,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,UAAU;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAC5B,OAAO;YACL,aAAa,EAAE,UAAU;YACzB,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,aAAa;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO;YACL,aAAa,EAAE,QAAQ;YACvB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,KAAK;YAClB,MAAM,EAAE,QAAQ;SACjB,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAC9D,OAAO;YACL,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YAC9C,YAAY,EAAE,QAAQ;YACtB,WAAW,EAAE,QAAQ;YACrB,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB;SACzD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAI;QACjB,MAAM,EAAE,SAAS;KAClB,CAAC;AACJ,CAAC,CAAC"}

package/dist/hybrid/router.d.ts

@@ -0,0 +1,4 @@
+import type { HybridRouteDecision, HybridRoutePolicy, HybridRouteSignals } from "./types.js";
+export declare const deriveAsyncPostmortemEligibility: (signals: HybridRouteSignals) => boolean;
+export declare const selectHybridRoute: (signals: HybridRouteSignals, policy?: Partial<HybridRoutePolicy>) => HybridRouteDecision;
+export type { HybridRouteDecision, HybridRoutePolicy, HybridRouteSignals } from "./types.js";

package/dist/hybrid/router.js

@@ -0,0 +1,62 @@
+const DEFAULT_POLICY = {
+    enabled: true,
+    syncExplainEnabled: true,
+    asyncPostmortemEnabled: true,
+    policyVersion: "hybrid-phase1-v1"
+};
+export const deriveAsyncPostmortemEligibility = (signals) => {
+    if (signals.taskStage !== "posttask") {
+        return false;
+    }
+    if (!signals.completedRun || !signals.terminalOutcomeRecorded) {
+        return false;
+    }
+    if (!signals.boundedPosttaskCapsuleAvailable || !signals.rolloutAllowsAsyncPostmortem) {
+        return false;
+    }
+    if (signals.postmortemAlreadyRecorded || signals.lightweightOrExcludedTask) {
+        return false;
+    }
+    return (signals.directionalCorrectionPresent
+        || signals.injectedNodeInteractionPresent
+        || signals.retryOrInvalidationSignaturePresent
+        || signals.meaningfulFailureSignaturePresent
+        || signals.conservativeTransitionReviewWorthy);
+};
+export const selectHybridRoute = (signals, policy = {}) => {
+    const effectivePolicy = { ...DEFAULT_POLICY, ...policy };
+    if (!effectivePolicy.enabled) {
+        return {
+            route: "FAST_PATH",
+            reasonCode: "default_fast_path",
+            policyVersion: effectivePolicy.policyVersion
+        };
+    }
+    if (signals.explicitExplanationRequest && effectivePolicy.syncExplainEnabled) {
+        return {
+            route: "ESCALATE_SYNC_EXPLAIN",
+            reasonCode: "explicit_explanation_request",
+            policyVersion: effectivePolicy.policyVersion
+        };
+    }
+    if (signals.existingConservativePathRequired) {
+        return {
+            route: "FAST_PATH_CONSERVATIVE",
+            reasonCode: "existing_conservative_path_required",
+            policyVersion: effectivePolicy.policyVersion
+        };
+    }
+    if (effectivePolicy.asyncPostmortemEnabled && deriveAsyncPostmortemEligibility(signals)) {
+        return {
+            route: "ESCALATE_ASYNC_POSTMORTEM",
+            reasonCode: "eligible_async_postmortem_review",
+            policyVersion: effectivePolicy.policyVersion
+        };
+    }
+    return {
+        route: "FAST_PATH",
+        reasonCode: "default_fast_path",
+        policyVersion: effectivePolicy.policyVersion
+    };
+};
+//# sourceMappingURL=router.js.map

package/dist/hybrid/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/hybrid/router.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAsB;IACxC,OAAO,EAAE,IAAI;IACb,kBAAkB,EAAE,IAAI;IACxB,sBAAsB,EAAE,IAAI;IAC5B,aAAa,EAAE,kBAAkB;CAClC,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,OAA2B,EAAW,EAAE;IACvF,IAAI,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,OAAO,CAAC,uBAAuB,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,+BAA+B,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;QACtF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,CAAC,yBAAyB,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;QAC3E,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,OAAO,CAAC,4BAA4B;WACjC,OAAO,CAAC,8BAA8B;WACtC,OAAO,CAAC,mCAAmC;WAC3C,OAAO,CAAC,iCAAiC;WACzC,OAAO,CAAC,kCAAkC,CAC9C,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAA2B,EAC3B,SAAqC,EAAE,EAClB,EAAE;IACvB,MAAM,eAAe,GAAsB,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IAE5E,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,KAAK,EAAE,WAAW;YAClB,UAAU,EAAE,mBAAmB;YAC/B,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,0BAA0B,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC;QAC7E,OAAO;YACL,KAAK,EAAE,uBAAuB;YAC9B,UAAU,EAAE,8BAA8B;YAC1C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,gCAAgC,EAAE,CAAC;QAC7C,OAAO;YACL,KAAK,EAAE,wBAAwB;YAC/B,UAAU,EAAE,qCAAqC;YACjD,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,CAAC,sBAAsB,IAAI,gCAAgC,CAAC,OAAO,CAAC,EAAE,CAAC;QACxF,OAAO;YACL,KAAK,EAAE,2BAA2B;YAClC,UAAU,EAAE,kCAAkC;YAC9C,aAAa,EAAE,eAAe,CAAC,aAAa;SAC7C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,WAAW;QAClB,UAAU,EAAE,mBAAmB;QAC/B,aAAa,EAAE,eAAe,CAAC,aAAa;KAC7C,CAAC;AACJ,CAAC,CAAC"}

package/dist/hybrid/types.d.ts

@@ -0,0 +1,140 @@
+import type { DeliveryState, ExperienceNodeType, ExperienceState, FeedbackVerdict, TaskType } from "../types/domain.js";
+export type HybridRoute = "FAST_PATH" | "FAST_PATH_CONSERVATIVE" | "ESCALATE_SYNC_EXPLAIN" | "ESCALATE_ASYNC_POSTMORTEM";
+export type HybridRolloutMode = "live" | "shadow" | "canary";
+export type HybridTaskStage = "prompt" | "posttask";
+export type HybridRouteSignals = {
+    taskStage: HybridTaskStage;
+    explicitExplanationRequest: boolean;
+    existingConservativePathRequired: boolean;
+    completedRun: boolean;
+    terminalOutcomeRecorded: boolean;
+    boundedPosttaskCapsuleAvailable: boolean;
+    postmortemAlreadyRecorded: boolean;
+    lightweightOrExcludedTask: boolean;
+    directionalCorrectionPresent: boolean;
+    injectedNodeInteractionPresent: boolean;
+    retryOrInvalidationSignaturePresent: boolean;
+    meaningfulFailureSignaturePresent: boolean;
+    conservativeTransitionReviewWorthy: boolean;
+    rolloutAllowsAsyncPostmortem: boolean;
+};
+export type HybridRouteDecision = {
+    route: HybridRoute;
+    reasonCode: "default_fast_path" | "existing_conservative_path_required" | "explicit_explanation_request" | "eligible_async_postmortem_review";
+    policyVersion: string;
+};
+export type HybridRoutePolicy = {
+    enabled: boolean;
+    syncExplainEnabled: boolean;
+    asyncPostmortemEnabled: boolean;
+    policyVersion: string;
+};
+export type HybridCapsuleEvidenceSource = "task_summary" | "context_summary" | "decision_explanation" | "retrieval_note" | "timeline" | "tool_event";
+export type HybridCapsuleEvidence = {
+    source: HybridCapsuleEvidenceSource;
+    text: string;
+    trust: "untrusted_evidence";
+    truncated: boolean;
+};
+export type ExplainDecisionCapsule = {
+    task: "explain_decision";
+    schemaVersion: string;
+    trusted: {
+        route: HybridRouteDecision;
+        inspection: {
+            scopeId: string;
+            taskType: string;
+            intervention: "inject" | "skip" | "shadow" | "holdout";
+            deliveryMode?: string;
+            autoFeedback: "helped" | "harmed" | "none";
+            outcome: "success" | "failure" | "unknown";
+            learningStatus?: "captured" | "rejected" | "not_applicable";
+        };
+        scorecard?: {
+            mode?: "inject" | "inject_conservative" | "skip";
+            decisionReason?: string;
+            riskLevel?: "low" | "medium" | "high";
+            confidence?: "low" | "medium" | "high";
+            budgetClass?: "none" | "single_hint" | "multi_hint";
+            fastPathApplied?: boolean;
+            queryRewriteApplied?: boolean;
+        };
+    };
+    evidence: HybridCapsuleEvidence[];
+};
+export type PostmortemReviewCapsule = {
+    task: "postmortem_review";
+    schemaVersion: string;
+    trusted: {
+        route: HybridRouteDecision;
+        run: {
+            taskRunId: string;
+            scopeId: string;
+            taskType: string;
+            finalStatus: "success" | "failure" | "cancelled" | "unknown";
+            learningStatus?: "captured" | "rejected" | "not_applicable";
+            outcomeSignal: "success" | "failure" | "unknown";
+        };
+        injectedNodes?: Array<{
+            nodeId: string;
+            nodeType: ExperienceNodeType;
+            state: ExperienceState;
+            deliveryState: DeliveryState;
+            taskType: TaskType;
+            helpedCount: number;
+            harmedCount: number;
+            compactHint: string;
+        }>;
+        reviewTriggers: {
+            directionalCorrectionPresent: boolean;
+            injectedNodeInteractionPresent: boolean;
+            retryOrInvalidationSignaturePresent: boolean;
+            meaningfulFailureSignaturePresent: boolean;
+            conservativeTransitionReviewWorthy: boolean;
+        };
+    };
+    evidence: HybridCapsuleEvidence[];
+};
+export type HybridApprovalClass = "advisory" | "review_artifact" | "policy_gated" | "blocked";
+export type ExplainDecisionWorkerOutput = {
+    task: "explain_decision";
+    decision: string;
+    reason: string;
+    confidence: "high" | "medium" | "low";
+    evidence_summary?: string;
+};
+export type PostmortemReviewWorkerOutput = {
+    task: "postmortem_review";
+    review_verdict: "review_artifact" | "policy_gated";
+    candidate_recommendation: "capture" | "reject" | "observe";
+    feedback_followup_recommendation: "none" | "mark_helped" | "mark_harmed" | "review";
+    confidence: "high" | "medium" | "low";
+    reason: string;
+    injected_node_reviews?: Array<{
+        node_id: string;
+        feedback_verdict: FeedbackVerdict;
+        confidence: "high" | "medium" | "low";
+        delivery_recommendation: "keep" | "conservative_only" | "quarantine" | "review";
+        reason: string;
+        evidence_summary?: string;
+    }>;
+    review_artifact?: {
+        summary: string;
+        notes: string[];
+    };
+    suggestedFollowUps?: string[];
+    candidateShapingSuggestions?: string[];
+    governanceRecommendations?: string[];
+    lifecycleSuggestions?: string[];
+    writeBackSuggestions?: string[];
+};
+export type HybridValidationSuccess<T> = {
+    status: "accepted";
+    approvalClass: HybridApprovalClass;
+    value: T;
+};
+export type HybridValidationFailure = {
+    status: "rejected";
+    reason: "schema_invalid" | "missing_required_fields" | "trust_boundary_violation" | "policy_violation" | "approval_blocked";
+    detail: string;
+};

package/dist/{packs → hybrid}/types.js.map

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

package/dist/hybrid/validators.d.ts

@@ -0,0 +1,5 @@
+import type { ExplainDecisionWorkerOutput, HybridApprovalClass, HybridValidationFailure, HybridValidationSuccess, PostmortemReviewWorkerOutput } from "./types.js";
+export declare const parsePostmortemReviewOutput: (value: unknown) => PostmortemReviewWorkerOutput | HybridValidationFailure;
+export declare const classifyHybridApproval: (value: ExplainDecisionWorkerOutput | PostmortemReviewWorkerOutput) => HybridApprovalClass;
+export declare const validateExplainDecisionOutput: (value: unknown) => HybridValidationSuccess<ExplainDecisionWorkerOutput> | HybridValidationFailure;
+export declare const validatePostmortemReviewOutput: (value: unknown) => HybridValidationSuccess<PostmortemReviewWorkerOutput> | HybridValidationFailure;