@alan512/experienceengine 0.1.3 → 0.2.0

package/dist/experience-management/task-management-signals.js

@@ -0,0 +1,148 @@
+const META_PATTERNS = [
+    /\baudit\b/i,
+    /\breview\b/i,
+    /\bplan\b/i,
+    /\bbaseline\b/i,
+    /\bscenario\b/i,
+    /\binspect\b/i,
+    /\bdoctor\b/i
+];
+const VALIDATION_PATTERNS = [
+    /\bvalidate\b/i,
+    /\bvalidation\b/i,
+    /\bverify\b/i,
+    /\bverification\b/i,
+    /\breal host\b/i,
+    /\bhost wiring\b/i,
+    /\binstall qualification\b/i
+];
+const REAL_DEV_PATTERNS = [
+    /\bimplement\b/i,
+    /\brefactor\b/i,
+    /\bdebug\b/i,
+    /\bfix\b/i,
+    /\bfailing\b/i,
+    /\bruntime error\b/i,
+    /\bpackaging\b/i,
+    /\bprovider routing\b/i
+];
+const BUG_FIX_PATTERNS = [
+    /\bdebug\b/i,
+    /\bfix\b/i,
+    /\bfailing\b/i,
+    /\berror\b/i,
+    /\bregression\b/i,
+    /\bcallback\b/i
+];
+const joinInputText = (input) => [
+    input.task_summary,
+    input.context_summary,
+    ...input.tool_events.flatMap((event) => [event.tool_name, event.output_summary, event.error_signature])
+]
+    .filter(Boolean)
+    .join("\n");
+const matchesAny = (patterns, text) => patterns.some((pattern) => pattern.test(text));
+const deriveSignalsFromSource = (taskType, text) => {
+    const reasons = [];
+    const taskTypeRealDev = taskType === "bug_fix" ||
+        taskType === "config_debug" ||
+        taskType === "integration_fix" ||
+        taskType === "feature_add" ||
+        taskType === "refactor" ||
+        taskType === "test_debug" ||
+        taskType === "build_debug";
+    const bugFixLike = taskType === "bug_fix" ||
+        taskType === "config_debug" ||
+        taskType === "integration_fix" ||
+        taskType === "test_debug" ||
+        taskType === "build_debug" ||
+        matchesAny(BUG_FIX_PATTERNS, text);
+    const metaLikeRaw = matchesAny(META_PATTERNS, text);
+    const validationLike = matchesAny(VALIDATION_PATTERNS, text);
+    const implementationLike = matchesAny(REAL_DEV_PATTERNS, text);
+    const realDevLikely = taskTypeRealDev || implementationLike;
+    const metaLike = metaLikeRaw && !(taskTypeRealDev && implementationLike);
+    if (taskTypeRealDev) {
+        reasons.push(`task_type:${taskType}`);
+    }
+    if (bugFixLike) {
+        reasons.push("bug_fix_signal");
+    }
+    if (metaLike) {
+        reasons.push("meta_wording");
+    }
+    if (validationLike) {
+        reasons.push("validation_wording");
+    }
+    if (implementationLike) {
+        reasons.push("implementation_wording");
+    }
+    const positiveSignals = Number(taskTypeRealDev) + Number(bugFixLike) + Number(realDevLikely) + Number(validationLike) + Number(metaLike);
+    const confidence = positiveSignals >= 3 || (realDevLikely && bugFixLike)
+        ? "high"
+        : positiveSignals >= 2
+            ? "medium"
+            : "low";
+    return {
+        metaLike,
+        validationLike,
+        realDevLikely,
+        bugFixLike,
+        confidence,
+        reasons
+    };
+};
+export const deriveTaskManagementSignals = (input) => deriveSignalsFromSource(input.task_type, joinInputText(input));
+export const deriveNodeManagementSignals = (node) => deriveSignalsFromSource(node.task_type, [
+    node.trigger_pattern,
+    node.compact_hint,
+    node.goal,
+    node.applicability_notes,
+    node.evidence_summary,
+    node.success_signal,
+    ...(node.recommended_steps ?? []),
+    ...(node.avoid_steps ?? []),
+    ...(node.fallback_steps ?? []),
+    node.deviation_pattern,
+    node.corrected_constraint
+]
+    .filter(Boolean)
+    .join("\n"));
+const recordToInput = (record) => ({
+    scope_id: record.scope_id,
+    task_type: record.task_type,
+    task_summary: record.task_summary,
+    context_summary: record.context_summary,
+    tool_events: [],
+    outcome_signal: record.outcome_signal,
+    injected_node_ids: []
+});
+export const deriveNodeOriginProfile = (records) => {
+    const signals = records.map((record) => deriveTaskManagementSignals(recordToInput(record)));
+    const metaCount = signals.filter((signal) => signal.metaLike).length;
+    const validationCount = signals.filter((signal) => signal.validationLike).length;
+    const realDevCount = signals.filter((signal) => signal.realDevLikely).length;
+    const bugFixCount = signals.filter((signal) => signal.bugFixLike).length;
+    const sampleCount = signals.length;
+    const strictPromotionSampleCount = signals.filter((signal) => (signal.metaLike || signal.validationLike) && !signal.realDevLikely).length;
+    const strictPromotion = sampleCount > 0 && strictPromotionSampleCount > realDevCount;
+    const reasons = [
+        `origin_samples:${sampleCount}`,
+        `origin_meta:${metaCount}`,
+        `origin_validation:${validationCount}`,
+        `origin_real_dev:${realDevCount}`,
+        `origin_bug_fix:${bugFixCount}`,
+        `origin_strict_samples:${strictPromotionSampleCount}`,
+        `strict_promotion:${strictPromotion ? "yes" : "no"}`
+    ];
+    return {
+        sampleCount,
+        metaCount,
+        validationCount,
+        realDevCount,
+        bugFixCount,
+        strictPromotion,
+        reasons
+    };
+};
+//# sourceMappingURL=task-management-signals.js.map

package/dist/experience-management/task-management-signals.js.map

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

package/dist/feedback/feedback-manager.d.ts

@@ -1,2 +1,5 @@
 import type { ExperienceInput, ExperienceNode } from "../types/domain.js";
-export declare const applyFeedback: (input: ExperienceInput, nodes: ExperienceNode[], attributionRecordId?: string) => ExperienceNode[];
+import type { NodeOriginProfile } from "../experience-management/task-management-signals.js";
+export declare const applyFeedback: (input: ExperienceInput, nodes: ExperienceNode[], attributionRecordId?: string, options?: {
+    originProfilesByNodeId?: Record<string, NodeOriginProfile | undefined>;
+}) => ExperienceNode[];

package/dist/feedback/feedback-manager.js

@@ -1,42 +1,31 @@
 import { nowIso } from "../utils/clock.js";
+import { applyGovernedNodeFeedback } from "../experience-management/node-lifecycle-governance.js";
 import { detectHarm } from "./harm-detector.js";
-import { transitionState, transitionValidationState } from "./state-transition.js";
 const appendUniqueId = (values, nextId) => {
     if (!nextId) {
         return values;
     }
     return values.includes(nextId) ? values : [...values, nextId];
 };
-export const applyFeedback = (input, nodes, attributionRecordId) => {
+export const applyFeedback = (input, nodes, attributionRecordId, options = {}) => {
     const timestamp = nowIso();
     return nodes.map((node) => {
         if (!input.injected_node_ids.includes(node.id)) {
             return node;
         }
         const harmed = detectHarm(input, node);
-        const next = {
+        const verdict = input.outcome_signal === "success"
+            ? "uncertain"
+            : harmed
+                ? "harmed"
+                : "none";
+        return applyGovernedNodeFeedback({
             ...node,
             usage_count: node.usage_count + 1,
-            helped_count: node.helped_count + Number(input.outcome_signal === "success"),
-            harmed_count: node.harmed_count + Number(harmed),
-            validation_state: input.outcome_signal === "success"
-                ? transitionValidationState(node, "helped")
-                : harmed
-                    ? transitionValidationState(node, "harmed")
-                    : node.validation_state,
-            helped_record_ids: input.outcome_signal === "success"
-                ? appendUniqueId(node.helped_record_ids, attributionRecordId)
-                : node.helped_record_ids,
+            helped_record_ids: node.helped_record_ids,
             harmed_record_ids: harmed ? appendUniqueId(node.harmed_record_ids, attributionRecordId) : node.harmed_record_ids,
-            last_used_at: timestamp,
-            last_helped_at: input.outcome_signal === "success" ? timestamp : node.last_helped_at,
-            last_harmed_at: harmed ? timestamp : node.last_harmed_at,
-            updated_at: timestamp
-        };
-        return {
-            ...next,
-            state: transitionState(next)
-        };
+            last_used_at: timestamp
+        }, verdict, options.originProfilesByNodeId?.[node.id]);
     });
 };
 //# sourceMappingURL=feedback-manager.js.map

package/dist/feedback/feedback-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"feedback-manager.js","sourceRoot":"","sources":["../../src/feedback/feedback-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,MAAM,cAAc,GAAG,CAAC,MAAgB,EAAE,MAAe,EAAY,EAAE;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAsB,EACtB,KAAuB,EACvB,mBAA4B,EACV,EAAE;IACpB,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAE3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAEvC,MAAM,IAAI,GAAG;YACX,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC;YAC5E,YAAY,EAAE,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;YAChD,gBAAgB,EACd,KAAK,CAAC,cAAc,KAAK,SAAS;gBAChC,CAAC,CAAC,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC;gBAC3C,CAAC,CAAC,MAAM;oBACN,CAAC,CAAC,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC;oBAC3C,CAAC,CAAC,IAAI,CAAC,gBAAgB;YAC7B,iBAAiB,EACf,KAAK,CAAC,cAAc,KAAK,SAAS;gBAChC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;gBAC7D,CAAC,CAAC,IAAI,CAAC,iBAAiB;YAC5B,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB;YAChH,YAAY,EAAE,SAAS;YACvB,cAAc,EAAE,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc;YACpF,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc;YACxD,UAAU,EAAE,SAAS;SACtB,CAAC;QAEF,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC;SAC7B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"feedback-manager.js","sourceRoot":"","sources":["../../src/feedback/feedback-manager.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,MAAM,cAAc,GAAG,CAAC,MAAgB,EAAE,MAAe,EAAY,EAAE;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;AAChE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAsB,EACtB,KAAuB,EACvB,mBAA4B,EAC5B,UAAsF,EAAE,EACtE,EAAE;IACpB,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;IAE3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACvC,MAAM,OAAO,GACX,KAAK,CAAC,cAAc,KAAK,SAAS;YAChC,CAAC,CAAC,WAAW;YACb,CAAC,CAAC,MAAM;gBACN,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,MAAM,CAAC;QAEf,OAAO,yBAAyB,CAC9B;YACE,GAAG,IAAI;YACP,WAAW,EAAE,IAAI,CAAC,WAAW,GAAG,CAAC;YACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;YACzC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB;YAChH,YAAY,EAAE,SAAS;SACxB,EACD,OAAO,EACP,OAAO,CAAC,sBAAsB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/feedback/state-transition.d.ts

@@ -1,3 +1,8 @@
 import type { ExperienceNode } from "../types/domain.js";
-export declare const transitionState: (node: ExperienceNode) => ExperienceNode["state"];
+import type { NodeOriginProfile } from "../experience-management/task-management-signals.js";
+type TransitionContext = {
+    originProfile?: NodeOriginProfile;
+};
+export declare const transitionState: (node: ExperienceNode, context?: TransitionContext) => ExperienceNode["state"];
 export declare const transitionValidationState: (node: ExperienceNode, feedback: "helped" | "harmed") => ExperienceNode["validation_state"];
+export {};

package/dist/feedback/state-transition.js

@@ -1,9 +1,12 @@
-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 >= 1 || node.support_count >= 2) {
+        if (node.helped_count >= activationHelpedThreshold || node.support_count >= activationSupportThreshold) {
             return "active";
         }
         if (node.harmed_count > 0) {
@@ -15,7 +18,7 @@ export const transitionState = (node) => {
         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,KAAK,KAAK,oBAAoB,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YACtD,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,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";