@alan512/experienceengine 0.3.4 → 0.3.5

package/dist/interaction/quality-band.js

@@ -0,0 +1,149 @@
+export const deriveNodeRisk = (node) => {
+    if (node.state === "candidate") {
+        return "high";
+    }
+    if (node.state === "priority_candidate") {
+        return "medium";
+    }
+    if (node.state === "cooling" || node.harmed_count > 0 || node.node_type === "warning") {
+        return node.harmed_count > node.helped_count ? "high" : "medium";
+    }
+    return "low";
+};
+export const deriveNodeConfidence = (node) => {
+    if (node.validation_state === "validated_by_reuse" && node.state === "active" && node.harmed_count === 0) {
+        return "high";
+    }
+    if (node.state === "candidate" || node.harmed_count > node.helped_count) {
+        return "low";
+    }
+    return "medium";
+};
+const firstUnique = (items) => [...new Set(items)];
+const buildEvidenceRefs = (node) => [
+    { kind: "node", id: node.id },
+    ...node.origin_record_ids.map((id) => ({ kind: "origin_record", id })),
+    ...node.helped_record_ids.map((id) => ({ kind: "helped_record", id })),
+    ...node.harmed_record_ids.map((id) => ({ kind: "harmed_record", id }))
+];
+const actionForBand = (node, band) => {
+    if (band === "risky") {
+        return {
+            label: "Review this node before trusting it in live guidance.",
+            command: `ee inspect node ${node.id}`
+        };
+    }
+    if (band === "building") {
+        return {
+            label: "Use as tentative guidance and keep collecting outcome evidence.",
+            command: `ee inspect node ${node.id}`
+        };
+    }
+    return undefined;
+};
+export const deriveQualityBandExplanation = (node) => {
+    const reasonCodes = [];
+    const reasons = [];
+    const isHighHygieneRisk = node.delivery_state === "quarantined" || Boolean(node.quarantined_at);
+    const harmOutweighsHelp = node.harmed_count > node.helped_count;
+    let band = "building";
+    if (node.state === "retired" ||
+        node.state === "cooling" ||
+        node.validation_state === "invalidated" ||
+        harmOutweighsHelp ||
+        isHighHygieneRisk) {
+        band = "risky";
+    }
+    else if (node.state === "active" &&
+        node.validation_state === "validated_by_reuse" &&
+        node.harmed_count === 0 &&
+        (!node.delivery_state || node.delivery_state === "eligible")) {
+        band = "strong";
+    }
+    if (node.state === "active" && (!node.delivery_state || node.delivery_state === "eligible")) {
+        reasonCodes.push("active_eligible");
+        reasons.push("This node is active and eligible for normal delivery.");
+    }
+    if (node.validation_state === "validated_by_reuse") {
+        reasonCodes.push("validated_by_reuse");
+        reasons.push("This node has already been validated by successful reuse.");
+    }
+    if (node.helped_count > 0 && node.harmed_count === 0) {
+        reasonCodes.push("helped_without_harm");
+        reasons.push("Helpful outcomes exist and no harmful outcome has been recorded for this node.");
+    }
+    if (node.helped_count === 0 && node.harmed_count === 0) {
+        reasonCodes.push("limited_reuse_evidence");
+        reasons.push("This node still has limited reuse evidence.");
+    }
+    if (node.state === "candidate" || node.state === "priority_candidate") {
+        reasonCodes.push("early_lifecycle");
+        reasons.push("This node is still early in its lifecycle and needs more runtime evidence.");
+    }
+    if (node.delivery_state === "conservative_only") {
+        reasonCodes.push("conservative_only");
+        reasons.push("Delivery governance limits this node to conservative use.");
+    }
+    if (node.delivery_state === "shadow_only") {
+        reasonCodes.push("shadow_only");
+        reasons.push("Delivery governance keeps this node in shadow-only observation.");
+    }
+    if (node.state === "retired") {
+        reasonCodes.push("retired");
+        reasons.push("This node is retired and should not be reused without review.");
+    }
+    if (node.state === "cooling") {
+        reasonCodes.push("cooling");
+        reasons.push("This node is in cooling state because recent runtime evidence weakened confidence.");
+    }
+    if (harmOutweighsHelp) {
+        reasonCodes.push("harm_outweighs_help");
+        reasons.push("Harmful outcomes currently outweigh helpful ones for this node.");
+    }
+    else if (node.helped_count > node.harmed_count) {
+        reasons.push("Helpful outcomes still outweigh harmful ones for this node.");
+    }
+    if (node.delivery_state === "quarantined") {
+        reasonCodes.push("quarantined");
+        reasons.push(node.quarantine_reason ?? "Delivery governance has quarantined this node.");
+    }
+    if (isHighHygieneRisk) {
+        reasonCodes.push("high_hygiene_risk");
+    }
+    if (node.node_type === "warning") {
+        reasonCodes.push("warning_guidance");
+        reasons.push("This is warning guidance, so reuse should stay narrow and evidence-led.");
+    }
+    if (node.validation_state === "invalidated") {
+        reasonCodes.push("invalidated");
+        reasons.push("Reuse validation has invalidated this node.");
+    }
+    const summary = band === "strong"
+        ? "Strong guidance: active, reuse-validated guidance with no harmful feedback."
+        : band === "risky"
+            ? "Risky guidance: review before reuse because governance or outcome evidence weakened confidence."
+            : "Building guidance: usable with caution while ExperienceEngine gathers stronger reuse evidence.";
+    return {
+        band,
+        summary,
+        reasonCodes: firstUnique(reasonCodes),
+        reasons: firstUnique(reasons).slice(0, 4),
+        evidenceRefs: buildEvidenceRefs(node),
+        recommendedAction: actionForBand(node, band)
+    };
+};
+export const summarizeQualityBandDistribution = (explanations) => {
+    const distribution = explanations.reduce((counts, explanation) => {
+        counts[explanation.band] += 1;
+        return counts;
+    }, { strong: 0, building: 0, risky: 0 });
+    const total = explanations.length;
+    const summary = total === 0
+        ? "No experience nodes are available for this scope yet."
+        : `${distribution.strong} strong, ${distribution.building} building, ${distribution.risky} risky node(s) in this scope.`;
+    return {
+        ...distribution,
+        summary
+    };
+};
+//# sourceMappingURL=quality-band.js.map

package/dist/interaction/quality-band.js.map

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

package/dist/interaction/repo-summary.d.ts

@@ -2,6 +2,7 @@ import type { BenchmarkSummary } from "../evaluation/benchmark-summary.js";
 import type { RepoPolicyInspection } from "../experience-management/repo-policy.js";
 import type { RepoPolicy } from "../types/domain.js";
 import type { ExperienceLastInspection, ExperienceLearningSummary } from "./service.js";
+import type { QualityBandDistribution } from "./quality-band.js";
 export type ExperienceRepoSummary = {
     scope: {
         scopeId: string;
@@ -19,6 +20,7 @@ export type ExperienceRepoSummary = {
         latestTrustSummary?: ExperienceLastInspection["trustSummary"];
     };
     benchmark: BenchmarkSummary;
+    quality: QualityBandDistribution;
     policy?: {
         configuredMode: RepoPolicy["configured_mode"];
         effectiveMode: RepoPolicy["effective_mode"];
@@ -42,6 +44,7 @@ export declare const buildRepoSummary: (input: {
     };
     latest?: ExperienceLastInspection;
     learning: ExperienceLearningSummary;
+    quality: QualityBandDistribution;
     policy?: RepoPolicy;
     policyInspection?: RepoPolicyInspection;
 }) => ExperienceRepoSummary;

package/dist/interaction/repo-summary.js

@@ -25,6 +25,7 @@ export const buildRepoSummary = (input) => {
             latestTrustSummary: input.latest?.trustSummary
         },
         benchmark: input.learning.benchmark,
+        quality: input.quality,
         policy: policy
             ? {
                 configuredMode: policy.configured_mode,

package/dist/interaction/repo-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"repo-summary.js","sourceRoot":"","sources":["../../src/interaction/repo-summary.ts"],"names":[],"mappings":"AAsCA,MAAM,uBAAuB,GAAG,CAAC,SAA2B,EAAU,EAAE;IACtE,QAAQ,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1B,KAAK,SAAS;YACZ,OAAO,gFAAgF,CAAC;QAC1F,KAAK,YAAY;YACf,OAAO,yGAAyG,CAAC;QACnH,KAAK,SAAS;YACZ,OAAO,sGAAsG,CAAC;QAChH;YACE,OAAO,uHAAuH,CAAC;IACnI,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAUhC,EAAyB,EAAE;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAE9D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE;YACN,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS;YACxC,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;YACxC,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS;YACzC,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;YAC9C,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;YAC9C,wBAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;YAC1D,yBAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,mBAAmB;YAC5D,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;SAC/C;QACD,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS;QACnC,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC;gBACE,cAAc,EAAE,MAAM,CAAC,eAAe;gBACtC,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,YAAY,EAAE,MAAM,CAAC,aAAa;gBAClC,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,uBAAuB,EAAE,MAAM,CAAC,yBAAyB;gBACzD,SAAS,EAAE,MAAM,CAAC,UAAU;gBAC5B,aAAa,EAAE,MAAM,CAAC,eAAe;gBACrC,UAAU,EAAE,MAAM,CAAC,WAAW;gBAC9B,eAAe,EAAE,KAAK,CAAC,gBAAgB,EAAE,eAAe;gBACxD,QAAQ,EAAE,KAAK,CAAC,gBAAgB,EAAE,QAAQ;gBAC1C,eAAe,EAAE,KAAK,CAAC,gBAAgB,EAAE,eAAe;aACzD;YACH,CAAC,CAAC,SAAS;QACb,qBAAqB,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;KACzE,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"repo-summary.js","sourceRoot":"","sources":["../../src/interaction/repo-summary.ts"],"names":[],"mappings":"AAwCA,MAAM,uBAAuB,GAAG,CAAC,SAA2B,EAAU,EAAE;IACtE,QAAQ,SAAS,CAAC,OAAO,EAAE,CAAC;QAC1B,KAAK,SAAS;YACZ,OAAO,gFAAgF,CAAC;QAC1F,KAAK,YAAY;YACf,OAAO,yGAAyG,CAAC;QACnH,KAAK,SAAS;YACZ,OAAO,sGAAsG,CAAC;QAChH;YACE,OAAO,uHAAuH,CAAC;IACnI,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAWhC,EAAyB,EAAE;IAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,gBAAgB,EAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC;IAE9D,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE;YACN,eAAe,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS;YACxC,iBAAiB,EAAE,KAAK,CAAC,MAAM,EAAE,OAAO;YACxC,gBAAgB,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS;YACzC,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;YAC9C,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;YAC9C,wBAAwB,EAAE,KAAK,CAAC,MAAM,EAAE,kBAAkB;YAC1D,yBAAyB,EAAE,KAAK,CAAC,MAAM,EAAE,mBAAmB;YAC5D,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,YAAY;SAC/C;QACD,SAAS,EAAE,KAAK,CAAC,QAAQ,CAAC,SAAS;QACnC,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC;gBACE,cAAc,EAAE,MAAM,CAAC,eAAe;gBACtC,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,YAAY,EAAE,MAAM,CAAC,aAAa;gBAClC,aAAa,EAAE,MAAM,CAAC,cAAc;gBACpC,uBAAuB,EAAE,MAAM,CAAC,yBAAyB;gBACzD,SAAS,EAAE,MAAM,CAAC,UAAU;gBAC5B,aAAa,EAAE,MAAM,CAAC,eAAe;gBACrC,UAAU,EAAE,MAAM,CAAC,WAAW;gBAC9B,eAAe,EAAE,KAAK,CAAC,gBAAgB,EAAE,eAAe;gBACxD,QAAQ,EAAE,KAAK,CAAC,gBAAgB,EAAE,QAAQ;gBAC1C,eAAe,EAAE,KAAK,CAAC,gBAAgB,EAAE,eAAe;aACzD;YACH,CAAC,CAAC,SAAS;QACb,qBAAqB,EAAE,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC;KACzE,CAAC;AACJ,CAAC,CAAC"}

package/dist/interaction/service.d.ts

@@ -7,6 +7,7 @@ import { type HybridRouteDecision } from "../hybrid/router.js";
 import type { CandidateLifecycleState, DistillationSource, DistillationJobState, EvaluationMode, ExperienceInputRecord, FeedbackAttributionReason, AttributionRecord, EpisodeProjection, InjectionEvent, InjectionScorecard, ExperienceNode, ExperienceNodeType, ExperienceState, TaskRun } from "../types/domain.js";
 import { type ExperienceRepoSummary } from "./repo-summary.js";
 import { type RetrievalPolicyInspectionSummary } from "./retrieval-policy-inspection.js";
+import { type ExperienceQualityBandExplanation } from "./quality-band.js";
 export type ExperienceNodeSummary = {
     id: string;
     type: ExperienceNode["node_type"];
@@ -30,6 +31,7 @@ export type ExperienceNodeSummary = {
     hint: string;
     qualityBand: "strong" | "building" | "risky";
     qualityDrivers: string[];
+    quality: ExperienceQualityBandExplanation;
     applicabilityProfile: {
         bestFit: string;
         scopeValidity: string;
@@ -74,6 +76,7 @@ export type ExperienceLastInspection = {
     scorecard?: InjectionScorecard;
     decisionExplanation?: string;
     trustSummary?: string;
+    qualityContext?: ExperienceQualityBandExplanation;
     retrievalNotes: string[];
     retrievalPolicySummary?: RetrievalPolicyInspectionSummary;
     timeline: ExperienceTimelineEntry[];

package/dist/interaction/service.js

@@ -30,6 +30,7 @@ import { nowIso } from "../utils/clock.js";
 import { createId, stableId } from "../utils/ids.js";
 import { buildRepoSummary } from "./repo-summary.js";
 import { buildRetrievalPolicyInspectionSummary } from "./retrieval-policy-inspection.js";
+import { deriveNodeConfidence, deriveNodeRisk, deriveQualityBandExplanation, summarizeQualityBandDistribution } from "./quality-band.js";
 const normalizeHybridExplainPrompt = (value) => value
     .toLowerCase()
     .replace(/\s+/g, " ")
@@ -163,90 +164,43 @@ const toManualOverrideAttributionRecord = (input) => {
         resolved_at: timestamp
     };
 };
-const deriveNodeRisk = (node) => {
-    if (node.state === "candidate") {
-        return "high";
-    }
-    if (node.state === "priority_candidate") {
-        return "medium";
-    }
-    if (node.state === "cooling" || node.harmed_count > 0 || node.node_type === "warning") {
-        return node.harmed_count > node.helped_count ? "high" : "medium";
-    }
-    return "low";
-};
-const deriveQualityBand = (node) => {
-    if (node.state === "retired" || node.harmed_count > node.helped_count || deriveNodeRisk(node) === "high") {
-        return "risky";
-    }
-    if (node.state === "active" &&
-        node.validation_state === "validated_by_reuse" &&
-        node.harmed_count === 0) {
-        return "strong";
-    }
-    return "building";
-};
-const buildQualityDrivers = (node) => {
-    const drivers = [];
-    if (node.validation_state === "validated_by_reuse") {
-        drivers.push("This node has already been validated by successful reuse.");
-    }
-    if (node.helped_count > node.harmed_count) {
-        drivers.push("Helpful outcomes still outweigh harmful ones for this node.");
-    }
-    else if (node.harmed_count > node.helped_count) {
-        drivers.push("Harmful outcomes currently outweigh helpful ones for this node.");
-    }
-    if (node.state === "candidate" || node.state === "priority_candidate") {
-        drivers.push("This node is still early in its lifecycle and needs more runtime evidence.");
-    }
-    else if (node.state === "cooling") {
-        drivers.push("This node is in cooling state because recent runtime evidence weakened confidence.");
-    }
-    return drivers.slice(0, 3);
-};
-const deriveConfidence = (node) => {
-    if (node.validation_state === "validated_by_reuse" && node.state === "active" && node.harmed_count === 0) {
-        return "high";
-    }
-    if (node.state === "candidate" || node.harmed_count > node.helped_count) {
-        return "low";
-    }
-    return "medium";
-};
 const formatTaskFamily = (taskType) => taskType === "general" ? "general tasks" : `${taskType} tasks`;
 const buildApplicabilityProfile = (node) => ({
     bestFit: `${formatTaskFamily(node.task_type)} in this repo scope`,
     scopeValidity: node.applicability_notes ?? "Use within the same repo scope unless fresh evidence says otherwise.",
-    confidence: deriveConfidence(node),
+    confidence: deriveNodeConfidence(node),
     risk: deriveNodeRisk(node),
     avoidWhen: node.stop_condition ?? node.escalation_condition ?? node.avoid_steps?.[0]
 });
-const toNodeSummary = (node) => ({
-    id: node.id,
-    type: node.node_type,
-    taskType: node.task_type,
-    state: node.state,
-    sourceKind: node.source_kind,
-    distillationMode: node.distillation_mode_used,
-    distillationSource: node.distillation_source,
-    redistilledFrom: node.redistilled_from,
-    promotionSignal: node.promotion_signal,
-    promotionReason: node.promotion_reason,
-    mergeDecision: node.merge_decision,
-    mergeReason: node.merge_reason,
-    priorityPromotionApplied: node.priority_promotion_applied,
-    triggerPattern: node.trigger_pattern,
-    evidenceSummary: node.evidence_summary,
-    originRecordIds: node.origin_record_ids,
-    helped: node.helped_count,
-    harmed: node.harmed_count,
-    lastUsedAt: node.last_used_at,
-    hint: node.compact_hint,
-    qualityBand: deriveQualityBand(node),
-    qualityDrivers: buildQualityDrivers(node),
-    applicabilityProfile: buildApplicabilityProfile(node)
-});
+const toNodeSummary = (node) => {
+    const quality = deriveQualityBandExplanation(node);
+    return {
+        id: node.id,
+        type: node.node_type,
+        taskType: node.task_type,
+        state: node.state,
+        sourceKind: node.source_kind,
+        distillationMode: node.distillation_mode_used,
+        distillationSource: node.distillation_source,
+        redistilledFrom: node.redistilled_from,
+        promotionSignal: node.promotion_signal,
+        promotionReason: node.promotion_reason,
+        mergeDecision: node.merge_decision,
+        mergeReason: node.merge_reason,
+        priorityPromotionApplied: node.priority_promotion_applied,
+        triggerPattern: node.trigger_pattern,
+        evidenceSummary: node.evidence_summary,
+        originRecordIds: node.origin_record_ids,
+        helped: node.helped_count,
+        harmed: node.harmed_count,
+        lastUsedAt: node.last_used_at,
+        hint: node.compact_hint,
+        qualityBand: quality.band,
+        qualityDrivers: quality.reasons,
+        quality,
+        applicabilityProfile: buildApplicabilityProfile(node)
+    };
+};
 const toNodeDetail = (node) => ({
     ...toNodeSummary(node),
     scopeId: node.scope_id,
@@ -390,6 +344,18 @@ const buildTrustSummary = (input) => {
     const confidence = scorecard.confidence ? ` ${scorecard.confidence}-confidence` : "";
     return `${scorecard.riskLevel}-risk${confidence} ${primaryNode.state} guidance with ${primaryNode.helped} helped and ${primaryNode.harmed} harmed signal(s).`;
 };
+const buildQualityContext = (input) => {
+    const primaryInjected = input.injectedNodes[0]?.quality;
+    if (primaryInjected) {
+        return primaryInjected;
+    }
+    const topCandidateId = input.scorecard?.topCandidates?.[0]?.id;
+    if (!topCandidateId) {
+        return undefined;
+    }
+    const candidateNode = input.lookupNode(topCandidateId);
+    return candidateNode ? deriveQualityBandExplanation(candidateNode) : undefined;
+};
 const buildRetrievalNotes = (scorecard) => {
     if (!scorecard) {
         return [];
@@ -579,6 +545,12 @@ export class ExperienceInteractionService {
             outcome: record.outcome_signal
         });
         const decisionExplanation = buildDecisionExplanation({ intervention, scorecard });
+        const injectedNodeSummaries = injectedNodes.map(toNodeSummary);
+        const qualityContext = buildQualityContext({
+            scorecard,
+            injectedNodes: injectedNodeSummaries,
+            lookupNode: (nodeId) => this.nodeRepo.getById(nodeId)
+        });
         return {
             sessionId: record.session_id,
             episodeId: record.episode_id,
@@ -592,12 +564,13 @@ export class ExperienceInteractionService {
             attributionRecords,
             episodeProjection,
             outcome: record.outcome_signal,
-            injectedNodes: injectedNodes.map(toNodeSummary),
+            injectedNodes: injectedNodeSummaries,
             hints: injectedNodes.map((node) => node.compact_hint),
             evidence: record.evidence,
             scorecard,
             decisionExplanation,
-            trustSummary: buildTrustSummary({ scorecard, injectedNodes: injectedNodes.map(toNodeSummary) }),
+            trustSummary: buildTrustSummary({ scorecard, injectedNodes: injectedNodeSummaries }),
+            qualityContext,
             retrievalNotes: buildRetrievalNotes(scorecard),
             retrievalPolicySummary: buildRetrievalPolicyInspectionSummary(scorecard),
             timeline: buildLatestTimeline({
@@ -645,6 +618,12 @@ export class ExperienceInteractionService {
             (taskRun?.final_status === "success" ? "success" : taskRun?.final_status === "failure" ? "failure" : "unknown");
         const summary = event.task_summary ?? taskRun?.task_summary ?? "Latest injection event";
         const decisionExplanation = buildDecisionExplanation({ intervention, scorecard: event.scorecard });
+        const injectedNodeSummaries = injectedNodes.map(toNodeSummary);
+        const qualityContext = buildQualityContext({
+            scorecard: event.scorecard,
+            injectedNodes: injectedNodeSummaries,
+            lookupNode: (nodeId) => this.nodeRepo.getById(nodeId)
+        });
         return {
             sessionId: event.session_id,
             episodeId: event.episode_id,
@@ -663,12 +642,13 @@ export class ExperienceInteractionService {
             attributionRecords,
             episodeProjection,
             outcome,
-            injectedNodes: injectedNodes.map(toNodeSummary),
+            injectedNodes: injectedNodeSummaries,
             hints: injectedNodes.map((node) => node.compact_hint),
             evidence: [],
             scorecard: event.scorecard,
             decisionExplanation,
-            trustSummary: buildTrustSummary({ scorecard: event.scorecard, injectedNodes: injectedNodes.map(toNodeSummary) }),
+            trustSummary: buildTrustSummary({ scorecard: event.scorecard, injectedNodes: injectedNodeSummaries }),
+            qualityContext,
             retrievalNotes: buildRetrievalNotes(event.scorecard),
             retrievalPolicySummary: buildRetrievalPolicyInspectionSummary(event.scorecard),
             timeline: buildLatestTimeline({
@@ -889,6 +869,7 @@ export class ExperienceInteractionService {
         const latest = latestRecord ? this.inspectRecord(latestRecord) : undefined;
         const learning = this.buildLearningSummary(scope.scope_id);
         const policyInspection = this.inspectRepoPolicy(cwd);
+        const quality = summarizeQualityBandDistribution(this.nodeRepo.listByScope(scope.scope_id).map((node) => deriveQualityBandExplanation(node)));
         return buildRepoSummary({
             scope: {
                 scopeId: scope.scope_id,
@@ -897,6 +878,7 @@ export class ExperienceInteractionService {
             },
             latest: latest && latest.scopeId === scope.scope_id ? latest : undefined,
             learning,
+            quality,
             policyInspection
         });
     }