npm - @indexnetwork/protocol - Versions diffs - 4.16.0-rc.358.1 → 4.17.0-rc.360.1 - Mend

@indexnetwork/protocol 4.16.0-rc.358.1 → 4.17.0-rc.360.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (66) hide show

package/dist/opportunity/discriminator/discriminator.adjustments.js CHANGED Viewed

@@ -16,29 +16,36 @@
  *   reasoning (opportunity-presentation-safety).
  */
 import { POOL_ADJUSTMENT_FACTOR_OTHER, POOL_ADJUSTMENT_FACTOR_UNKNOWN, POOL_ADJUSTMENT_FLOOR } from "./discriminator.env.js";
-/** Reads the adjustments array off an opportunity's metadata (tolerant). */
-export function readPoolAdjustments(metadata) {
+/** Reads valid adjustments, optionally narrowed to one recipient + intent. */
+export function readPoolAdjustments(metadata, provenance) {
     const raw = metadata?.poolAdjustments;
     if (!Array.isArray(raw))
         return [];
-    return raw.filter((a) => typeof a === "object" && a !== null &&
-        typeof a.questionId === "string" &&
-        typeof a.factor === "number");
+    return raw.filter((a) => {
+        if (typeof a !== "object" || a === null ||
+            typeof a.questionId !== "string" ||
+            typeof a.recipientUserId !== "string" ||
+            typeof a.intentId !== "string" ||
+            typeof a.factor !== "number")
+            return false;
+        return provenance === undefined || (a.recipientUserId === provenance.recipientUserId &&
+            a.intentId === provenance.intentId);
+    });
 }
 /**
  * Cumulative adjustment multiplier for an opportunity, floored at
- * {@link POOL_ADJUSTMENT_FLOOR}. 1 when no adjustments exist.
+ * {@link POOL_ADJUSTMENT_FLOOR}. 1 when no scoped adjustments exist.
  */
-export function poolAdjustmentMultiplier(metadata) {
-    const adjustments = readPoolAdjustments(metadata);
+export function poolAdjustmentMultiplier(metadata, provenance) {
+    const adjustments = readPoolAdjustments(metadata, provenance);
     if (adjustments.length === 0)
         return 1;
     const product = adjustments.reduce((acc, a) => acc * (Number.isFinite(a.factor) && a.factor > 0 ? a.factor : 1), 1);
     return Math.max(POOL_ADJUSTMENT_FLOOR, product);
 }
 /** Adjusted confidence: `confidence × Π factor`, floored. */
-export function adjustedConfidence(confidence, metadata) {
-    return confidence * poolAdjustmentMultiplier(metadata);
+export function adjustedConfidence(confidence, metadata, provenance) {
+    return confidence * poolAdjustmentMultiplier(metadata, provenance);
 }
 /**
  * Build one P3-compatible adjustment and signal. This is the only place that
@@ -53,6 +60,8 @@ export function buildPoolAdjustment(input) {
     return {
         adjustment: {
             questionId: input.questionId,
+            recipientUserId: input.recipientUserId,
+            intentId: input.intentId,
             label: input.label,
             side,
             factor,
@@ -62,6 +71,8 @@ export function buildPoolAdjustment(input) {
         signal: {
             type: "pool_discriminator",
             weight,
+            recipientUserId: input.recipientUserId,
+            intentId: input.intentId,
             detail: isUnknown ? `${input.label}: unassigned` : `${input.label}: ${input.chosenSide}`,
             questionId: input.questionId,
         },
@@ -75,9 +86,11 @@ export function buildPoolAdjustment(input) {
  * @param discriminator  The asked discriminator (from detection.pool).
  * @param chosenSide     The selected option label (chip label = side label).
  * @param questionId     Reversal key.
+ * @param recipientUserId User whose answer produced the preference.
+ * @param intentId       Intent whose candidate pool was ranked.
  * @param now            ISO-8601 timestamp.
  */
-export function planPoolAdjustments(discriminator, chosenSide, questionId, now) {
+export function planPoolAdjustments(discriminator, chosenSide, questionId, recipientUserId, intentId, now) {
     // Chip labels are word-capped side labels; match on the capped prefix too.
     const matchesSide = (side) => side === chosenSide || side.startsWith(chosenSide) || chosenSide.startsWith(side);
     const chosen = discriminator.sides.find(matchesSide);
@@ -89,6 +102,8 @@ export function planPoolAdjustments(discriminator, chosenSide, questionId, now)
             opportunityId: a.opportunityId,
             ...buildPoolAdjustment({
                 questionId,
+                recipientUserId,
+                intentId,
                 label: discriminator.label,
                 assignedSide: a.side,
                 chosenSide: chosen,
@@ -100,23 +115,27 @@ export function planPoolAdjustments(discriminator, chosenSide, questionId, now)
 }
 /**
  * Merges one adjustment into an opportunity's existing metadata, replacing
- * any prior entry for the same questionId (re-answer semantics). Returns the
- * NEW metadata object (caller persists it wholesale).
+ * only the entry for the same question + recipient + intent provenance.
+ * Returns the NEW metadata object (caller persists it wholesale).
  */
 export function mergePoolAdjustment(metadata, adjustment) {
-    const existing = readPoolAdjustments(metadata).filter((a) => a.questionId !== adjustment.questionId);
+    const existing = readPoolAdjustments(metadata).filter((a) => !(a.questionId === adjustment.questionId &&
+        a.recipientUserId === adjustment.recipientUserId &&
+        a.intentId === adjustment.intentId));
     return { ...(metadata ?? {}), poolAdjustments: [...existing, adjustment] };
 }
-/** Latest user-explainable demotion detail for card presentation, if any. */
-export function latestPoolDemotionDetail(metadata) {
-    return [...readPoolAdjustments(metadata)]
+/** Latest scoped user-explainable demotion detail for card presentation. */
+export function latestPoolDemotionDetail(metadata, provenance) {
+    return [...readPoolAdjustments(metadata, provenance)]
         .reverse()
         .find((adjustment) => adjustment.factor < 1 && typeof adjustment.detail === 'string' && adjustment.detail.length > 0)
         ?.detail;
 }
-/** Removes all adjustments for a questionId (dismissal/withdrawal reversal). */
-export function removePoolAdjustment(metadata, questionId) {
-    const remaining = readPoolAdjustments(metadata).filter((a) => a.questionId !== questionId);
+/** Removes one question adjustment for exact recipient + intent provenance. */
+export function removePoolAdjustment(metadata, questionId, provenance) {
+    const remaining = readPoolAdjustments(metadata).filter((a) => !(a.questionId === questionId &&
+        a.recipientUserId === provenance.recipientUserId &&
+        a.intentId === provenance.intentId));
     return { ...(metadata ?? {}), poolAdjustments: remaining };
 }
 //# sourceMappingURL=discriminator.adjustments.js.map

package/dist/opportunity/discriminator/discriminator.adjustments.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"discriminator.adjustments.js","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.adjustments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAmB7H,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CAAC,QAAoD;IACtF,MAAM,GAAG,GAAG,QAAQ,EAAE,eAAe,CAAC;IACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAuB,EAAE,CAC3C,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI;QACnC,OAAQ,CAAoB,CAAC,UAAU,KAAK,QAAQ;QACpD,OAAQ,CAAoB,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAoD;IAC3F,MAAM,WAAW,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpH,OAAO,IAAI,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,QAAoD;IACzG,OAAO,UAAU,GAAG,wBAAwB,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAoBD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAA+B;IAIjE,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC;IAC9C,MAAM,QAAQ,GAAG,CAAC,SAAS,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,UAAU,CAAC;IACvE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,4BAA4B,CAAC;IACxG,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,IAAI,SAAS,CAAC;IAC7C,OAAO;QACL,UAAU,EAAE;YACV,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,IAAI;YACJ,MAAM;YACN,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,eAAe,KAAK,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/F,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B;QACD,MAAM,EAAE;YACN,IAAI,EAAE,oBAAoB;YAC1B,MAAM;YACN,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,UAAU,EAAE;YACxF,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B;KACF,CAAC;AACJ,CAAC;AASD;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,aAAwC,EACxC,UAAkB,EAClB,UAAkB,EAClB,GAAW;IAEX,2EAA2E;IAC3E,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAC5C,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC,CAAC,yDAAyD;IAEjF,MAAM,IAAI,GAA8B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC;YACR,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,GAAG,mBAAmB,CAAC;gBACrB,UAAU;gBACV,KAAK,EAAE,aAAa,CAAC,KAAK;gBAC1B,YAAY,EAAE,CAAC,CAAC,IAAI;gBACpB,UAAU,EAAE,MAAM;gBAClB,SAAS,EAAE,GAAG;aACf,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAoD,EACpD,UAA0B;IAE1B,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,UAAU,CAAC,CAAC;IACrG,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,GAAG,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,wBAAwB,CACtC,QAAoD;IAEpD,OAAO,CAAC,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;SACtC,OAAO,EAAE;SACT,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACrH,EAAE,MAAM,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAClC,QAAoD,EACpD,UAAkB;IAElB,MAAM,SAAS,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAC3F,OAAO,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AAC7D,CAAC","sourcesContent":["/*\n Pool-adjustment domain logic (IND-419) — pure functions, no I/O.\n \n When a user answers a pool_discovery question, every candidate the mining\n * pass assigned to a side gets a multiplicative adjustment written to\n * `opportunities.metadata.poolAdjustments`. The home feed (flag-gated) orders\n * by `confidence × Π factor`, floored so demoted candidates stay visible.\n \n Invariants:\n * - Deterministic and O(pool): no LLM at answer time — the applyPlan was\n * computed (and evidence-verified) at mining time.\n * - Reversible: entries are keyed by questionId; re-answering replaces them,\n * dismissal-driven reversal removes them.\n * - `detail` carries the template chip text built from the user's OWN answer\n * (\"Hands-on builders vs advisors: you chose Advisor\") — never LLM\n * reasoning (opportunity-presentation-safety).\n /\nimport { POOL_ADJUSTMENT_FACTOR_OTHER, POOL_ADJUSTMENT_FACTOR_UNKNOWN, POOL_ADJUSTMENT_FLOOR } from \"./discriminator.env.js\";\nimport type { QuestionPoolDiscriminator } from \"../../shared/schemas/question.schema.js\";\n\n/* One applied adjustment on an opportunity (stored in metadata.poolAdjustments). /\nexport interface PoolAdjustment {\n /* The answered question that produced this adjustment (reversal key). /\n questionId: string;\n /* Discriminator label, e.g. \"Hands-on builders vs advisors\". /\n label: string;\n /* Side this candidate was assigned to (or \"unknown\"). /\n side: string;\n /* Multiplicative factor: chosen 1.0, other 0.6, unknown 0.9. /\n factor: number;\n /* Template chip text from the user's own answer. Set on demotions only. /\n detail?: string;\n /* ISO-8601 apply timestamp. /\n appliedAt: string;\n}\n\n/* Reads the adjustments array off an opportunity's metadata (tolerant). /\nexport function readPoolAdjustments(metadata: Record<string, unknown> \| null \| undefined): PoolAdjustment[] {\n const raw = metadata?.poolAdjustments;\n if (!Array.isArray(raw)) return [];\n return raw.filter((a): a is PoolAdjustment =>\n typeof a === \"object\" && a !== null &&\n typeof (a as PoolAdjustment).questionId === \"string\" &&\n typeof (a as PoolAdjustment).factor === \"number\");\n}\n\n/\n Cumulative adjustment multiplier for an opportunity, floored at\n * {@link POOL_ADJUSTMENT_FLOOR}. 1 when no adjustments exist.\n /\nexport function poolAdjustmentMultiplier(metadata: Record<string, unknown> \| null \| undefined): number {\n const adjustments = readPoolAdjustments(metadata);\n if (adjustments.length === 0) return 1;\n const product = adjustments.reduce((acc, a) => acc (Number.isFinite(a.factor) && a.factor > 0 ? a.factor : 1), 1);\n return Math.max(POOL_ADJUSTMENT_FLOOR, product);\n}\n\n/** Adjusted confidence: `confidence × Π factor`, floored. /\nexport function adjustedConfidence(confidence: number, metadata: Record<string, unknown> \| null \| undefined): number {\n return confidence poolAdjustmentMultiplier(metadata);\n}\n\n/** Deterministic provenance signal stored alongside one adjustment. /\nexport interface PoolAdjustmentSignal {\n type: \"pool_discriminator\";\n weight: 1 \| -1 \| 0;\n detail: string;\n questionId: string;\n}\n\n/* Pure helper input shared by Tier-0 answers and newborn stamping. /\nexport interface BuildPoolAdjustmentInput {\n questionId: string;\n label: string;\n /* Verified side assignment, or null when the candidate is unassigned. /\n assignedSide: string \| null;\n chosenSide: string;\n appliedAt: string;\n}\n\n/\n Build one P3-compatible adjustment and signal. This is the only place that\n * defines chosen/other/unknown factors, weights, and safe template details.\n /\nexport function buildPoolAdjustment(input: BuildPoolAdjustmentInput): {\n adjustment: PoolAdjustment;\n signal: PoolAdjustmentSignal;\n} {\n const isUnknown = input.assignedSide === null;\n const isChosen = !isUnknown && input.assignedSide === input.chosenSide;\n const factor = isUnknown ? POOL_ADJUSTMENT_FACTOR_UNKNOWN : isChosen ? 1 : POOL_ADJUSTMENT_FACTOR_OTHER;\n const weight = isUnknown ? 0 : isChosen ? 1 : -1;\n const side = input.assignedSide ?? \"unknown\";\n return {\n adjustment: {\n questionId: input.questionId,\n label: input.label,\n side,\n factor,\n ...(!isChosen && !isUnknown ? { detail: `${input.label}: you chose ${input.chosenSide}` } : {}),\n appliedAt: input.appliedAt,\n },\n signal: {\n type: \"pool_discriminator\",\n weight,\n detail: isUnknown ? `${input.label}: unassigned` : `${input.label}: ${input.chosenSide}`,\n questionId: input.questionId,\n },\n };\n}\n\n/* Plan entry: what to write on one opportunity for one answer. /\nexport interface PoolAdjustmentPlanEntry {\n opportunityId: string;\n adjustment: PoolAdjustment;\n signal: PoolAdjustmentSignal;\n}\n\n/\n Computes the write plan for one answered discriminator. Pure: the caller\n * loads/patches rows. \"Both matter\" (or any label not in `sides`) yields an\n * empty plan — no preference, no adjustments.\n \n @param discriminator The asked discriminator (from detection.pool).\n * @param chosenSide The selected option label (chip label = side label).\n * @param questionId Reversal key.\n * @param now ISO-8601 timestamp.\n /\nexport function planPoolAdjustments(\n discriminator: QuestionPoolDiscriminator,\n chosenSide: string,\n questionId: string,\n now: string,\n): PoolAdjustmentPlanEntry[] {\n // Chip labels are word-capped side labels; match on the capped prefix too.\n const matchesSide = (side: string): boolean =>\n side === chosenSide \|\| side.startsWith(chosenSide) \|\| chosenSide.startsWith(side);\n const chosen = discriminator.sides.find(matchesSide);\n if (!chosen) return []; // \"Both matter\" or unrecognized option → no adjustments.\n\n const plan: PoolAdjustmentPlanEntry[] = [];\n for (const a of discriminator.assignments) {\n plan.push({\n opportunityId: a.opportunityId,\n ...buildPoolAdjustment({\n questionId,\n label: discriminator.label,\n assignedSide: a.side,\n chosenSide: chosen,\n appliedAt: now,\n }),\n });\n }\n return plan;\n}\n\n/\n Merges one adjustment into an opportunity's existing metadata, replacing\n * any prior entry for the same questionId (re-answer semantics). Returns the\n * NEW metadata object (caller persists it wholesale).\n /\nexport function mergePoolAdjustment(\n metadata: Record<string, unknown> \| null \| undefined,\n adjustment: PoolAdjustment,\n): Record<string, unknown> {\n const existing = readPoolAdjustments(metadata).filter((a) => a.questionId !== adjustment.questionId);\n return { ...(metadata ?? {}), poolAdjustments: [...existing, adjustment] };\n}\n\n/* Latest user-explainable demotion detail for card presentation, if any. /\nexport function latestPoolDemotionDetail(\n metadata: Record<string, unknown> \| null \| undefined,\n): string \| undefined {\n return [...readPoolAdjustments(metadata)]\n .reverse()\n .find((adjustment) => adjustment.factor < 1 && typeof adjustment.detail === 'string' && adjustment.detail.length > 0)\n ?.detail;\n}\n\n/* Removes all adjustments for a questionId (dismissal/withdrawal reversal). */\nexport function removePoolAdjustment(\n metadata: Record<string, unknown> \| null \| undefined,\n questionId: string,\n): Record<string, unknown> {\n const remaining = readPoolAdjustments(metadata).filter((a) => a.questionId !== questionId);\n return { ...(metadata ?? {}), poolAdjustments: remaining };\n}\n"]}
1	+ {"version":3,"file":"discriminator.adjustments.js","sourceRoot":"/","sources":["opportunity/discriminator/discriminator.adjustments.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Pool-adjustment domain logic (IND-419) — pure functions, no I/O.\n \n When a user answers a pool_discovery question, every candidate the mining\n * pass assigned to a side gets a multiplicative adjustment written to\n * `opportunities.metadata.poolAdjustments`. The home feed (flag-gated) orders\n * by `confidence × Π factor`, floored so demoted candidates stay visible.\n \n Invariants:\n * - Deterministic and O(pool): no LLM at answer time — the applyPlan was\n * computed (and evidence-verified) at mining time.\n * - Reversible: entries are keyed by questionId; re-answering replaces them,\n * dismissal-driven reversal removes them.\n * - `detail` carries the template chip text built from the user's OWN answer\n * (\"Hands-on builders vs advisors: you chose Advisor\") — never LLM\n * reasoning (opportunity-presentation-safety).\n /\nimport { POOL_ADJUSTMENT_FACTOR_OTHER, POOL_ADJUSTMENT_FACTOR_UNKNOWN, POOL_ADJUSTMENT_FLOOR } from \"./discriminator.env.js\";\nimport type { QuestionPoolDiscriminator } from \"../../shared/schemas/question.schema.js\";\n\n/* Recipient and intent provenance that scopes one pool preference. /\nexport interface PoolAdjustmentProvenance {\n recipientUserId: string;\n intentId: string;\n}\n\n/* One applied adjustment on an opportunity (stored in metadata.poolAdjustments). /\nexport interface PoolAdjustment extends PoolAdjustmentProvenance {\n /* The answered question that produced this adjustment (reversal key). /\n questionId: string;\n /* Discriminator label, e.g. \"Hands-on builders vs advisors\". /\n label: string;\n /* Side this candidate was assigned to (or \"unknown\"). /\n side: string;\n /* Multiplicative factor: chosen 1.0, other 0.6, unknown 0.9. /\n factor: number;\n /* Template chip text from the user's own answer. Set on demotions only. /\n detail?: string;\n /* ISO-8601 apply timestamp. /\n appliedAt: string;\n}\n\n/* Reads valid adjustments, optionally narrowed to one recipient + intent. /\nexport function readPoolAdjustments(\n metadata: Record<string, unknown> \| null \| undefined,\n provenance?: PoolAdjustmentProvenance,\n): PoolAdjustment[] {\n const raw = metadata?.poolAdjustments;\n if (!Array.isArray(raw)) return [];\n return raw.filter((a): a is PoolAdjustment => {\n if (\n typeof a !== \"object\" \|\| a === null \|\|\n typeof (a as PoolAdjustment).questionId !== \"string\" \|\|\n typeof (a as PoolAdjustment).recipientUserId !== \"string\" \|\|\n typeof (a as PoolAdjustment).intentId !== \"string\" \|\|\n typeof (a as PoolAdjustment).factor !== \"number\"\n ) return false;\n return provenance === undefined \|\| (\n (a as PoolAdjustment).recipientUserId === provenance.recipientUserId &&\n (a as PoolAdjustment).intentId === provenance.intentId\n );\n });\n}\n\n/\n Cumulative adjustment multiplier for an opportunity, floored at\n * {@link POOL_ADJUSTMENT_FLOOR}. 1 when no scoped adjustments exist.\n /\nexport function poolAdjustmentMultiplier(\n metadata: Record<string, unknown> \| null \| undefined,\n provenance: PoolAdjustmentProvenance,\n): number {\n const adjustments = readPoolAdjustments(metadata, provenance);\n if (adjustments.length === 0) return 1;\n const product = adjustments.reduce((acc, a) => acc (Number.isFinite(a.factor) && a.factor > 0 ? a.factor : 1), 1);\n return Math.max(POOL_ADJUSTMENT_FLOOR, product);\n}\n\n/** Adjusted confidence: `confidence × Π factor`, floored. /\nexport function adjustedConfidence(\n confidence: number,\n metadata: Record<string, unknown> \| null \| undefined,\n provenance: PoolAdjustmentProvenance,\n): number {\n return confidence poolAdjustmentMultiplier(metadata, provenance);\n}\n\n/** Deterministic provenance signal stored alongside one adjustment. /\nexport interface PoolAdjustmentSignal extends PoolAdjustmentProvenance {\n type: \"pool_discriminator\";\n weight: 1 \| -1 \| 0;\n detail: string;\n questionId: string;\n}\n\n/* Pure helper input shared by Tier-0 answers and newborn stamping. /\nexport interface BuildPoolAdjustmentInput extends PoolAdjustmentProvenance {\n questionId: string;\n label: string;\n /* Verified side assignment, or null when the candidate is unassigned. /\n assignedSide: string \| null;\n chosenSide: string;\n appliedAt: string;\n}\n\n/\n Build one P3-compatible adjustment and signal. This is the only place that\n * defines chosen/other/unknown factors, weights, and safe template details.\n /\nexport function buildPoolAdjustment(input: BuildPoolAdjustmentInput): {\n adjustment: PoolAdjustment;\n signal: PoolAdjustmentSignal;\n} {\n const isUnknown = input.assignedSide === null;\n const isChosen = !isUnknown && input.assignedSide === input.chosenSide;\n const factor = isUnknown ? POOL_ADJUSTMENT_FACTOR_UNKNOWN : isChosen ? 1 : POOL_ADJUSTMENT_FACTOR_OTHER;\n const weight = isUnknown ? 0 : isChosen ? 1 : -1;\n const side = input.assignedSide ?? \"unknown\";\n return {\n adjustment: {\n questionId: input.questionId,\n recipientUserId: input.recipientUserId,\n intentId: input.intentId,\n label: input.label,\n side,\n factor,\n ...(!isChosen && !isUnknown ? { detail: `${input.label}: you chose ${input.chosenSide}` } : {}),\n appliedAt: input.appliedAt,\n },\n signal: {\n type: \"pool_discriminator\",\n weight,\n recipientUserId: input.recipientUserId,\n intentId: input.intentId,\n detail: isUnknown ? `${input.label}: unassigned` : `${input.label}: ${input.chosenSide}`,\n questionId: input.questionId,\n },\n };\n}\n\n/* Plan entry: what to write on one opportunity for one answer. /\nexport interface PoolAdjustmentPlanEntry {\n opportunityId: string;\n adjustment: PoolAdjustment;\n signal: PoolAdjustmentSignal;\n}\n\n/\n Computes the write plan for one answered discriminator. Pure: the caller\n * loads/patches rows. \"Both matter\" (or any label not in `sides`) yields an\n * empty plan — no preference, no adjustments.\n \n @param discriminator The asked discriminator (from detection.pool).\n * @param chosenSide The selected option label (chip label = side label).\n * @param questionId Reversal key.\n * @param recipientUserId User whose answer produced the preference.\n * @param intentId Intent whose candidate pool was ranked.\n * @param now ISO-8601 timestamp.\n /\nexport function planPoolAdjustments(\n discriminator: QuestionPoolDiscriminator,\n chosenSide: string,\n questionId: string,\n recipientUserId: string,\n intentId: string,\n now: string,\n): PoolAdjustmentPlanEntry[] {\n // Chip labels are word-capped side labels; match on the capped prefix too.\n const matchesSide = (side: string): boolean =>\n side === chosenSide \|\| side.startsWith(chosenSide) \|\| chosenSide.startsWith(side);\n const chosen = discriminator.sides.find(matchesSide);\n if (!chosen) return []; // \"Both matter\" or unrecognized option → no adjustments.\n\n const plan: PoolAdjustmentPlanEntry[] = [];\n for (const a of discriminator.assignments) {\n plan.push({\n opportunityId: a.opportunityId,\n ...buildPoolAdjustment({\n questionId,\n recipientUserId,\n intentId,\n label: discriminator.label,\n assignedSide: a.side,\n chosenSide: chosen,\n appliedAt: now,\n }),\n });\n }\n return plan;\n}\n\n/\n Merges one adjustment into an opportunity's existing metadata, replacing\n * only the entry for the same question + recipient + intent provenance.\n * Returns the NEW metadata object (caller persists it wholesale).\n /\nexport function mergePoolAdjustment(\n metadata: Record<string, unknown> \| null \| undefined,\n adjustment: PoolAdjustment,\n): Record<string, unknown> {\n const existing = readPoolAdjustments(metadata).filter((a) => !(\n a.questionId === adjustment.questionId &&\n a.recipientUserId === adjustment.recipientUserId &&\n a.intentId === adjustment.intentId\n ));\n return { ...(metadata ?? {}), poolAdjustments: [...existing, adjustment] };\n}\n\n/* Latest scoped user-explainable demotion detail for card presentation. /\nexport function latestPoolDemotionDetail(\n metadata: Record<string, unknown> \| null \| undefined,\n provenance: PoolAdjustmentProvenance,\n): string \| undefined {\n return [...readPoolAdjustments(metadata, provenance)]\n .reverse()\n .find((adjustment) => adjustment.factor < 1 && typeof adjustment.detail === 'string' && adjustment.detail.length > 0)\n ?.detail;\n}\n\n/* Removes one question adjustment for exact recipient + intent provenance. */\nexport function removePoolAdjustment(\n metadata: Record<string, unknown> \| null \| undefined,\n questionId: string,\n provenance: PoolAdjustmentProvenance,\n): Record<string, unknown> {\n const remaining = readPoolAdjustments(metadata).filter((a) => !(\n a.questionId === questionId &&\n a.recipientUserId === provenance.recipientUserId &&\n a.intentId === provenance.intentId\n ));\n return { ...(metadata ?? {}), poolAdjustments: remaining };\n}\n"]}

package/dist/opportunity/feed/feed.categorizer.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"feed.categorizer.d.ts","sourceRoot":"/","sources":["opportunity/feed/feed.categorizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;~~AAyB3D~~,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,CAAC;AAgFF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAA2C;;IAMxD;;OAEG;IAEG,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;~~CAoD5E~~"}
1	+ {"version":3,"file":"feed.categorizer.d.ts","sourceRoot":"/","sources":["opportunity/feed/feed.categorizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA0B3D,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CACjC,CAAC;AAgFF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,CAA2C;;IAMxD;;OAEG;IAEG,UAAU,CAAC,KAAK,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA0D5E"}

package/dist/opportunity/feed/feed.categorizer.js CHANGED Viewed

@@ -21,6 +21,7 @@ import { protocolLogger } from '../../shared/observability/protocol.logger.js';
 import { Timed } from "../../shared/observability/performance.js";
 import { createStructuredModel } from "../../shared/agent/model.config.js";
 import { invokeWithAbortSignal } from "../../shared/agent/model-signal.js";
+import { hasUnsupportedOpportunityClaim } from '../opportunity.claim-safety.js';
 const logger = protocolLogger('HomeCategorizer');
 const categorizationSchema = z.object({
     sections: z.array(z.object({
@@ -144,6 +145,11 @@ Rules:
                 iconName: s.iconName,
                 itemIndices: s.itemIndices.filter((i) => i >= 0 && i <= maxIndex),
             }));
+            if (sections.some((section) => hasUnsupportedOpportunityClaim(section.title)
+                || hasUnsupportedOpportunityClaim(section.subtitle))) {
+                logger.warn('HomeCategorizer emitted unsupported affiliation/presence claim; using fallback');
+                return buildFallbackResult(cards);
+            }
             const reconciledSections = reconcileSections(sections, maxIndex);
             return { sections: reconciledSections };
         }

package/dist/opportunity/feed/feed.categorizer.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"feed.categorizer.js","sourceRoot":"/","sources":["opportunity/feed/feed.categorizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;;;;;;;;;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,+CAA+C,CAAC;AAC/E,OAAO,EAAE,KAAK,EAAE,MAAM,2CAA2C,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,MAAM,MAAM,GAAG,cAAc,CAAC,iBAAiB,CAAC,CAAC;AAEjD,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,QAAQ,EAAE,CAAC,CAAC,KAAK,CACf,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QAC9D,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CACP,mGAAmG,CACpG;QACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;QAC3F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC;QACrF,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACxF,CAAC,CACH;CACF,CAAC,CAAC;AAeH,MAAM,wBAAwB,GAAG,eAAe,CAAC;AACjD,MAAM,2BAA2B,GAAG,6BAA6B,CAAC;AAElE,6EAA6E;AAC7E,SAAS,mBAAmB,CAAC,KAA6B;IACxD,OAAO;QACL,QAAQ,EAAE;YACR;gBACE,EAAE,EAAE,eAAe;gBACnB,KAAK,EAAE,eAAe;gBACtB,QAAQ,EAAE,yBAAyB;gBACnC,WAAW,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,KAA6B;IACvD,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC;QACrC,MAAM,MAAM,GAAG,CAAC,CAAC,iBAAiB,IAAI,SAAS,CAAC;QAChD,OAAO,IAAI,CAAC,CAAC,KAAK,UAAU,IAAI,YAAY,MAAM,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC;IAChH,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,QAA+B,EAAE,QAAgB;IAC1E,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,MAAM,kBAAkB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAClD,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAC9B,IAAI,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,QAAQ,CAAC,CAAC,CAChF,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAExB,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;YAClC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,OAAO;YACL,GAAG,OAAO;YACV,WAAW,EAAE,aAAa;SAC3B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,QAAQ,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,MAAM,eAAe,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,wBAAwB,CAAC,CAAC;IACtG,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,WAAW,GAAG,KAAK,CAAC,IAAI,CACtC,IAAI,GAAG,CAAC,CAAC,GAAG,eAAe,CAAC,WAAW,EAAE,GAAG,cAAc,CAAC,CAAC,CAC7D,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,GAAG,kBAAkB;QACrB;YACE,EAAE,EAAE,wBAAwB;YAC5B,KAAK,EAAE,2BAA2B;YAClC,QAAQ,EAAE,yBAAyB;YACnC,WAAW,EAAE,cAAc;SAC5B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,oBAAoB;IAG/B;QACE,IAAI,CAAC,KAAK,GAAG,qBAAqB,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IACzG,CAAC;IAED;;OAEG;IAEG,AAAN,KAAK,CAAC,UAAU,CAAC,KAA6B;QAC5C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAElC,MAAM,YAAY,GAAG;;;;;;;;oEAQ2C,QAAQ;oFACQ,QAAQ;;;;;;mOAMuI,CAAC;QAEhO,MAAM,WAAW,GAAG,yBAAyB,aAAa,iGAAiG,CAAC;QAE5J,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,KAAK,EAAE;gBACrD,IAAI,aAAa,CAAC,YAAY,CAAC;gBAC/B,IAAI,YAAY,CAAC,WAAW,CAAC;aAC9B,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACrE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,QAAQ,GAA0B,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvE,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,SAAS;gBACjC,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC;aAClE,CAAC,CAAC,CAAC;YACJ,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC;QAC1C,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAClF,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AApDO;IADL,KAAK,EAAE;;;;sDAoDP","sourcesContent":["/*\n Home Categorizer Agent\n \n Takes a list of presenter-produced opportunity cards and returns dynamic sections\n * with CTA-style titles and Lucide icon names. Used by the home graph after\n * generateCardText.\n /\n\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport type { HomeSectionProposal } from './feed.state.js';\nimport { getIconNamesForPrompt, DEFAULT_HOME_SECTION_ICON } from '../../shared/ui/lucide.icon-catalog.js';\nimport { protocolLogger } from '../../shared/observability/protocol.logger.js';\nimport { Timed } from \"../../shared/observability/performance.js\";\nimport { createStructuredModel } from \"../../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../../shared/agent/model-signal.js\";\n\nconst logger = protocolLogger('HomeCategorizer');\n\nconst categorizationSchema = z.object({\n sections: z.array(\n z.object({\n id: z.string().describe('Short kebab-case id for the section'),\n title: z\n .string()\n .describe(\n 'Call-to-action style section heading (e.g. REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU)'\n ),\n subtitle: z.string().nullable().describe('Optional one-line description; use null if none'),\n iconName: z.string().describe('Lucide icon name in kebab-case from the allowed list'),\n itemIndices: z.array(z.number()).describe('Indices of cards in this section (0-based)'),\n })\n ),\n});\n\nexport type CategorizerInputItem = {\n index: number;\n headline?: string;\n mainText: string;\n name: string;\n viewerRole?: string;\n opportunityStatus?: string;\n};\n\nexport type CategorizerResult = {\n sections: HomeSectionProposal[];\n};\n\nconst UNCATEGORIZED_SECTION_ID = 'uncategorized';\nconst UNCATEGORIZED_SECTION_TITLE = 'UNCATEGORIZED OPPORTUNITIES';\n\n/* Single-section fallback grouping every card under one generic heading. /\nfunction buildFallbackResult(cards: CategorizerInputItem[]): CategorizerResult {\n return {\n sections: [\n {\n id: 'opportunities',\n title: 'OPPORTUNITIES',\n iconName: DEFAULT_HOME_SECTION_ICON,\n itemIndices: cards.map((c) => c.index),\n },\n ],\n };\n}\n\n/\n Build card summaries for the categorizer prompt.\n /\nfunction buildCardSummaries(cards: CategorizerInputItem[]): string {\n return cards\n .map((c) => {\n const role = c.viewerRole ?? 'party';\n const status = c.opportunityStatus ?? 'pending';\n return `[${c.index}] role=${role}; status=${status}; ${c.headline ?? c.mainText.slice(0, 60)}... (${c.name})`;\n })\n .join('\\n');\n}\n\nfunction reconcileSections(sections: HomeSectionProposal[], maxIndex: number): HomeSectionProposal[] {\n const assigned = new Set<number>();\n\n const normalizedSections = sections.map((section) => {\n const uniqueIndices = Array.from(\n new Set(section.itemIndices.filter((index) => index >= 0 && index <= maxIndex))\n ).sort((a, b) => a - b);\n\n for (const index of uniqueIndices) {\n assigned.add(index);\n }\n\n return {\n ...section,\n itemIndices: uniqueIndices,\n };\n });\n\n const missingIndices: number[] = [];\n for (let index = 0; index <= maxIndex; index += 1) {\n if (!assigned.has(index)) {\n missingIndices.push(index);\n }\n }\n\n if (missingIndices.length === 0) {\n return normalizedSections;\n }\n\n const fallbackSection = normalizedSections.find((section) => section.id === UNCATEGORIZED_SECTION_ID);\n if (fallbackSection) {\n fallbackSection.itemIndices = Array.from(\n new Set([...fallbackSection.itemIndices, ...missingIndices])\n ).sort((a, b) => a - b);\n return normalizedSections;\n }\n\n return [\n ...normalizedSections,\n {\n id: UNCATEGORIZED_SECTION_ID,\n title: UNCATEGORIZED_SECTION_TITLE,\n iconName: DEFAULT_HOME_SECTION_ICON,\n itemIndices: missingIndices,\n },\n ];\n}\n\nexport class HomeCategorizerAgent {\n private model: ReturnType<typeof createStructuredModel>;\n\n constructor() {\n this.model = createStructuredModel(\"homeCategorizer\", categorizationSchema, { name: 'home_sections' });\n }\n\n /\n Categorize presenter-produced cards into 1–5 sections with CTA-style titles and icons.\n */\n @Timed()\n async categorize(cards: CategorizerInputItem[]): Promise<CategorizerResult> {\n if (cards.length === 0) {\n return { sections: [] };\n }\n const iconList = getIconNamesForPrompt();\n const cardSummaries = buildCardSummaries(cards);\n const maxIndex = cards.length - 1;\n\n const systemPrompt = `You are organizing connection opportunities into dynamic sections for a user's home feed.\n\nGiven a list of opportunity cards (each with index, headline/summary, and name), group them into 1–5 sections.\n\nEach section must have:\n- id: short kebab-case identifier (e.g. waiting-for-action, your-perspective, connector)\n- title: CALL-TO-ACTION style section heading in uppercase. Write as an action or invitation, not a neutral label. Examples: REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU, INTROS READY TO SEND, PEOPLE YOU SHOULD MEET\n- subtitle: optional one-line description\n- iconName: exactly ONE icon from this list (use the name as-is): ${iconList}\n- itemIndices: array of card indices that belong in this section (each index 0 to ${maxIndex} at most once)\n\nRules:\n- Use only icon names from the list above.\n- Every card index must appear in exactly one section.\n- Section titles must read as calls-to-action or invitations, not passive labels.\n- If a card has role=introducer and status=pending, prioritize grouping those cards under a connector curation section with a CTA title like \"YOU'RE THE CONNECTOR THEY NEED\", \"MAKE THE INTRO\", or \"DECIDE IF IT'S A GOOD MATCH\".`;\n\n const userContent = `Cards to categorize:\\n${cardSummaries}\\n\\nOutput sections with id, title (CTA-style), subtitle (optional), iconName, and itemIndices.`;\n\n try {\n const result = await invokeWithAbortSignal(this.model, [\n new SystemMessage(systemPrompt),\n new HumanMessage(userContent),\n ]);\n const parsed = categorizationSchema.safeParse(result);\n if (!parsed.success) {\n logger.warn('HomeCategorizer parse failed', { error: parsed.error });\n return buildFallbackResult(cards);\n }\n const sections: HomeSectionProposal[] = parsed.data.sections.map((s) => ({\n id: s.id,\n title: s.title,\n subtitle: s.subtitle ?? undefined,\n iconName: s.iconName,\n itemIndices: s.itemIndices.filter((i) => i >= 0 && i <= maxIndex),\n }));\n const reconciledSections = reconcileSections(sections, maxIndex);\n return { sections: reconciledSections };\n } catch (e) {\n const err = e instanceof Error ? { message: e.message, name: e.name } : String(e);\n logger.error('HomeCategorizer categorize failed', { error: err });\n return buildFallbackResult(cards);\n }\n }\n}\n"]}
1	+ {"version":3,"file":"feed.categorizer.js","sourceRoot":"/","sources":["opportunity/feed/feed.categorizer.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Home Categorizer Agent\n \n Takes a list of presenter-produced opportunity cards and returns dynamic sections\n * with CTA-style titles and Lucide icon names. Used by the home graph after\n * generateCardText.\n /\n\nimport { HumanMessage, SystemMessage } from '@langchain/core/messages';\nimport { z } from 'zod';\n\nimport type { HomeSectionProposal } from './feed.state.js';\nimport { getIconNamesForPrompt, DEFAULT_HOME_SECTION_ICON } from '../../shared/ui/lucide.icon-catalog.js';\nimport { protocolLogger } from '../../shared/observability/protocol.logger.js';\nimport { Timed } from \"../../shared/observability/performance.js\";\nimport { createStructuredModel } from \"../../shared/agent/model.config.js\";\nimport { invokeWithAbortSignal } from \"../../shared/agent/model-signal.js\";\nimport { hasUnsupportedOpportunityClaim } from '../opportunity.claim-safety.js';\n\nconst logger = protocolLogger('HomeCategorizer');\n\nconst categorizationSchema = z.object({\n sections: z.array(\n z.object({\n id: z.string().describe('Short kebab-case id for the section'),\n title: z\n .string()\n .describe(\n 'Call-to-action style section heading (e.g. REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU)'\n ),\n subtitle: z.string().nullable().describe('Optional one-line description; use null if none'),\n iconName: z.string().describe('Lucide icon name in kebab-case from the allowed list'),\n itemIndices: z.array(z.number()).describe('Indices of cards in this section (0-based)'),\n })\n ),\n});\n\nexport type CategorizerInputItem = {\n index: number;\n headline?: string;\n mainText: string;\n name: string;\n viewerRole?: string;\n opportunityStatus?: string;\n};\n\nexport type CategorizerResult = {\n sections: HomeSectionProposal[];\n};\n\nconst UNCATEGORIZED_SECTION_ID = 'uncategorized';\nconst UNCATEGORIZED_SECTION_TITLE = 'UNCATEGORIZED OPPORTUNITIES';\n\n/* Single-section fallback grouping every card under one generic heading. /\nfunction buildFallbackResult(cards: CategorizerInputItem[]): CategorizerResult {\n return {\n sections: [\n {\n id: 'opportunities',\n title: 'OPPORTUNITIES',\n iconName: DEFAULT_HOME_SECTION_ICON,\n itemIndices: cards.map((c) => c.index),\n },\n ],\n };\n}\n\n/\n Build card summaries for the categorizer prompt.\n /\nfunction buildCardSummaries(cards: CategorizerInputItem[]): string {\n return cards\n .map((c) => {\n const role = c.viewerRole ?? 'party';\n const status = c.opportunityStatus ?? 'pending';\n return `[${c.index}] role=${role}; status=${status}; ${c.headline ?? c.mainText.slice(0, 60)}... (${c.name})`;\n })\n .join('\\n');\n}\n\nfunction reconcileSections(sections: HomeSectionProposal[], maxIndex: number): HomeSectionProposal[] {\n const assigned = new Set<number>();\n\n const normalizedSections = sections.map((section) => {\n const uniqueIndices = Array.from(\n new Set(section.itemIndices.filter((index) => index >= 0 && index <= maxIndex))\n ).sort((a, b) => a - b);\n\n for (const index of uniqueIndices) {\n assigned.add(index);\n }\n\n return {\n ...section,\n itemIndices: uniqueIndices,\n };\n });\n\n const missingIndices: number[] = [];\n for (let index = 0; index <= maxIndex; index += 1) {\n if (!assigned.has(index)) {\n missingIndices.push(index);\n }\n }\n\n if (missingIndices.length === 0) {\n return normalizedSections;\n }\n\n const fallbackSection = normalizedSections.find((section) => section.id === UNCATEGORIZED_SECTION_ID);\n if (fallbackSection) {\n fallbackSection.itemIndices = Array.from(\n new Set([...fallbackSection.itemIndices, ...missingIndices])\n ).sort((a, b) => a - b);\n return normalizedSections;\n }\n\n return [\n ...normalizedSections,\n {\n id: UNCATEGORIZED_SECTION_ID,\n title: UNCATEGORIZED_SECTION_TITLE,\n iconName: DEFAULT_HOME_SECTION_ICON,\n itemIndices: missingIndices,\n },\n ];\n}\n\nexport class HomeCategorizerAgent {\n private model: ReturnType<typeof createStructuredModel>;\n\n constructor() {\n this.model = createStructuredModel(\"homeCategorizer\", categorizationSchema, { name: 'home_sections' });\n }\n\n /\n Categorize presenter-produced cards into 1–5 sections with CTA-style titles and icons.\n */\n @Timed()\n async categorize(cards: CategorizerInputItem[]): Promise<CategorizerResult> {\n if (cards.length === 0) {\n return { sections: [] };\n }\n const iconList = getIconNamesForPrompt();\n const cardSummaries = buildCardSummaries(cards);\n const maxIndex = cards.length - 1;\n\n const systemPrompt = `You are organizing connection opportunities into dynamic sections for a user's home feed.\n\nGiven a list of opportunity cards (each with index, headline/summary, and name), group them into 1–5 sections.\n\nEach section must have:\n- id: short kebab-case identifier (e.g. waiting-for-action, your-perspective, connector)\n- title: CALL-TO-ACTION style section heading in uppercase. Write as an action or invitation, not a neutral label. Examples: REACH OUT NOW, YOUR MOVE, CONNECTIONS WAITING FOR YOU, INTROS READY TO SEND, PEOPLE YOU SHOULD MEET\n- subtitle: optional one-line description\n- iconName: exactly ONE icon from this list (use the name as-is): ${iconList}\n- itemIndices: array of card indices that belong in this section (each index 0 to ${maxIndex} at most once)\n\nRules:\n- Use only icon names from the list above.\n- Every card index must appear in exactly one section.\n- Section titles must read as calls-to-action or invitations, not passive labels.\n- If a card has role=introducer and status=pending, prioritize grouping those cards under a connector curation section with a CTA title like \"YOU'RE THE CONNECTOR THEY NEED\", \"MAKE THE INTRO\", or \"DECIDE IF IT'S A GOOD MATCH\".`;\n\n const userContent = `Cards to categorize:\\n${cardSummaries}\\n\\nOutput sections with id, title (CTA-style), subtitle (optional), iconName, and itemIndices.`;\n\n try {\n const result = await invokeWithAbortSignal(this.model, [\n new SystemMessage(systemPrompt),\n new HumanMessage(userContent),\n ]);\n const parsed = categorizationSchema.safeParse(result);\n if (!parsed.success) {\n logger.warn('HomeCategorizer parse failed', { error: parsed.error });\n return buildFallbackResult(cards);\n }\n const sections: HomeSectionProposal[] = parsed.data.sections.map((s) => ({\n id: s.id,\n title: s.title,\n subtitle: s.subtitle ?? undefined,\n iconName: s.iconName,\n itemIndices: s.itemIndices.filter((i) => i >= 0 && i <= maxIndex),\n }));\n if (sections.some((section) =>\n hasUnsupportedOpportunityClaim(section.title)\n \|\| hasUnsupportedOpportunityClaim(section.subtitle))) {\n logger.warn('HomeCategorizer emitted unsupported affiliation/presence claim; using fallback');\n return buildFallbackResult(cards);\n }\n const reconciledSections = reconcileSections(sections, maxIndex);\n return { sections: reconciledSections };\n } catch (e) {\n const err = e instanceof Error ? { message: e.message, name: e.name } : String(e);\n logger.error('HomeCategorizer categorize failed', { error: err });\n return buildFallbackResult(cards);\n }\n }\n}\n"]}

package/dist/opportunity/feed/feed.graph.d.ts CHANGED Viewed

@@ -48,6 +48,8 @@ export type HomeGraphInvokeResult = {
 export declare const DEFAULT_HOME_STATUSES: OpportunityStatus[];
 /** Full status enumeration. Pass this to `HomeGraphInvokeInput.statuses` to restore pre-Issue-3 (unfiltered) behavior. */
 export declare const ALL_OPPORTUNITY_STATUSES: OpportunityStatus[];
+/** Pure cache policy for presenter cards; degraded current-request copy retries later. */
+export declare function isHomePresentationCacheable(card: Pick<HomeCardItem, 'presentationPending' | '_presentationFallback' | 'name'>, status: OpportunityStatus | undefined): boolean;
 /**
  * Strip leading narrator name from remark when the UI already prepends "Name: " to the chip.
  * Avoids duplication like "Yankı Ekin Yüksel: Yankı Ekin Yüksel introduced you two..."

package/dist/opportunity/feed/feed.graph.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"feed.graph.d.ts","sourceRoot":"/","sources":["opportunity/feed/feed.graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAwB,MAAM,iBAAiB,CAAC;~~AAQtI~~,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;~~AAgBzE~~,8HAA8H;AAC9H,KAAK,WAAW,GAAG,iBAAiB,CAAC;AAErC,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAA0B,CAAC;AAgBhF,0HAA0H;AAC1H,eAAO,MAAM,wBAAwB,EAAE,iBAAiB,EAEhC,CAAC;~~AAczB~~;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAarF;~~AAwFD~~,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ;IAAe,OAAO,CAAC,KAAK;gBAApC,QAAQ,EAAE,WAAW,EAAU,KAAK,EAAE,gBAAgB;IAE1E,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;~~CAuqBZ~~"}
1	+ {"version":3,"file":"feed.graph.d.ts","sourceRoot":"/","sources":["opportunity/feed/feed.graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAC1G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAwB,MAAM,iBAAiB,CAAC;AAStI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAiBzE,8HAA8H;AAC9H,KAAK,WAAW,GAAG,iBAAiB,CAAC;AAErC,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,IAAI,EAAE;QAAE,kBAAkB,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAA0B,CAAC;AAgBhF,0HAA0H;AAC1H,eAAO,MAAM,wBAAwB,EAAE,iBAAiB,EAEhC,CAAC;AAOzB,0FAA0F;AAC1F,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,qBAAqB,GAAG,uBAAuB,GAAG,MAAM,CAAC,EAClF,MAAM,EAAE,iBAAiB,GAAG,SAAS,GACpC,OAAO,CAST;AASD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAarF;AAmHD,qBAAa,gBAAgB;IACf,OAAO,CAAC,QAAQ;IAAe,OAAO,CAAC,KAAK;gBAApC,QAAQ,EAAE,WAAW,EAAU,KAAK,EAAE,gBAAgB;IAE1E,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyrBZ"}

package/dist/opportunity/feed/feed.graph.js CHANGED Viewed

@@ -18,10 +18,11 @@ import { canUserSeeOpportunity, isActionableForViewer, selectByComposition } fro
 import { resolveHomeSectionIcon, DEFAULT_HOME_SECTION_ICON } from '../../shared/ui/lucide.icon-catalog.js';
 import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from '../opportunity.labels.js';
 import { safeFallbackSummary } from '../opportunity.safe-presentation.js';
+import { buildHomeCardPresentationCacheKey, buildHomeCategoryPresentationCacheKey } from '../opportunity.presentation-cache.js';
 import { protocolLogger } from '../../shared/observability/protocol.logger.js';
 import { timed } from '../../shared/observability/performance.js';
 import { requestContext } from "../../shared/observability/request-context.js";
-import { adjustedConfidence, latestPoolDemotionDetail } from '../discriminator/discriminator.adjustments.js';
+import { adjustedConfidence, latestPoolDemotionDetail, readPoolAdjustments } from '../discriminator/discriminator.adjustments.js';
 import { poolQuestionsRanking } from '../discriminator/discriminator.env.js';
 const logger = protocolLogger('HomeGraph');
 const checkCategorizerCacheLog = protocolLogger('HomeGraph:checkCategorizerCache');
@@ -52,11 +53,20 @@ const MAX_ITEMS_PER_SECTION = 20;
 const PRESENTATION_CONCURRENCY = 50;
 const MAX_REASONING_SNIPPET_LENGTH = 240;
 const HOME_CACHE_TTL = 24 * 60 * 60; // 24 hours in seconds
+/** Pure cache policy for presenter cards; degraded current-request copy retries later. */
+export function isHomePresentationCacheable(card, status) {
+    return Boolean(status &&
+        status !== 'negotiating' &&
+        !card.presentationPending &&
+        !card._presentationFallback &&
+        card.name &&
+        card.name !== 'Unknown');
+}
 /** Redis key for the categorizer cache, derived from the user and the ordered opportunity-id set. */
 function buildCategorizerCacheKey(userId, cards) {
     const oppIds = cards.map((c) => c.opportunityId).join(',');
     const hash = createHash('sha256').update(oppIds).digest('hex').slice(0, 16);
-    return `home:categories:${userId}:${hash}`;
+    return buildHomeCategoryPresentationCacheKey(userId, hash);
 }
 /**
  * Strip leading narrator name from remark when the UI already prepends "Name: " to the chip.
@@ -122,11 +132,20 @@ const getRawConfidence = (opp) => {
  * their stored factors (floor 0.3) so the user's answers re-rank the feed.
  * Flag off → identical to raw confidence (adjustments are write-only).
  */
-const getConfidence = (opp) => {
+const getPoolRankingProvenance = (state) => {
+    if (poolQuestionsRanking() !== 'on' ||
+        !state.userId ||
+        state.scopeType !== 'intent' ||
+        !state.scopeId)
+        return null;
+    return { recipientUserId: state.userId, intentId: state.scopeId };
+};
+const hasPoolAdjustment = (opp, provenance) => readPoolAdjustments(opp.metadata, provenance).length > 0;
+const getConfidence = (opp, provenance) => {
     const raw = getRawConfidence(opp);
-    if (poolQuestionsRanking() !== 'on')
+    if (!provenance)
         return raw;
-    return adjustedConfidence(raw, opp.metadata);
+    return adjustedConfidence(raw, opp.metadata, provenance);
 };
 /** Unique non-introducer, non-viewer userIds for an opportunity (actors can repeat). */
 const getUniqueCounterpartUserIds = (opp, viewerId) => {
@@ -178,6 +197,7 @@ export class HomeGraphFactory {
                     // its soft targets, even after visibility filtering and dedup.
                     const fetchLimit = Math.min(150, Math.max(50, state.limit * 3));
                     const statuses = state.statuses ?? DEFAULT_HOME_STATUSES;
+                    const poolRankingProvenance = getPoolRankingProvenance(state);
                     const options = {
                         limit: fetchLimit,
                         statuses,
@@ -229,11 +249,12 @@ export class HomeGraphFactory {
                         // off. When on, re-order the already-deduped lifecycle set by
                         // adjusted confidence so each client-side radar bucket reflects
                         // pool answers immediately.
-                        if (poolQuestionsRanking() !== 'on') {
+                        if (!poolRankingProvenance ||
+                            !dedupedByCounterpart.some((opportunity) => hasPoolAdjustment(opportunity, poolRankingProvenance))) {
                             return { opportunities: dedupedByCounterpart.slice(0, state.limit) };
                         }
                         const adjustedOrder = [...dedupedByCounterpart].sort((a, b) => {
-                            const confidenceDelta = getConfidence(b) - getConfidence(a);
+                            const confidenceDelta = getConfidence(b, poolRankingProvenance) - getConfidence(a, poolRankingProvenance);
                             if (confidenceDelta !== 0)
                                 return confidenceDelta;
                             return safeParseDate(b.updatedAt) - safeParseDate(a.updatedAt);
@@ -248,8 +269,8 @@ export class HomeGraphFactory {
                         const bIsIntroducer = b.actors.some((ac) => ac.userId === state.userId && ac.role === 'introducer');
                         if (aIsIntroducer !== bIsIntroducer)
                             return aIsIntroducer ? 1 : -1;
-                        const confA = getConfidence(a);
-                        const confB = getConfidence(b);
+                        const confA = getConfidence(a, poolRankingProvenance);
+                        const confB = getConfidence(b, poolRankingProvenance);
                         if (confB !== confA)
                             return confB - confA;
                         const aTime = safeParseDate(a.updatedAt);
@@ -278,6 +299,7 @@ export class HomeGraphFactory {
         const checkPresenterCacheNode = async (state) => {
             return timed("HomeGraph.checkPresenterCache", async () => {
                 const { opportunities, userId } = state;
+                const poolRankingProvenance = getPoolRankingProvenance(state);
                 if (opportunities.length === 0) {
                     return { cachedCards: new Map(), uncachedOpportunities: [] };
                 }
@@ -295,7 +317,7 @@ export class HomeGraphFactory {
                     // transitions (e.g. negotiating → pending) don't serve stale cards.
                     const cacheable = opportunities.filter((opp) => opp.status !== 'negotiating');
                     const liveNegotiating = opportunities.filter((opp) => opp.status === 'negotiating');
-                    const keys = cacheable.map((opp) => `home:card:${opp.id}:${opp.status}:${userId}`);
+                    const keys = cacheable.map((opp) => buildHomeCardPresentationCacheKey(opp.id, opp.status, userId));
                     const results = keys.length > 0 ? await this.cache.mget(keys) : [];
                     const cachedCards = new Map();
                     const uncachedOpportunities = [...liveNegotiating];
@@ -305,8 +327,8 @@ export class HomeGraphFactory {
                             const originalIndex = opportunities.indexOf(cacheable[i]);
                             // Stamp the live status: pre-status cache entries lack the field,
                             // and the key already guarantees it matches the current status.
-                            const deprioritizedReason = poolQuestionsRanking() === 'on'
-                                ? latestPoolDemotionDetail(cacheable[i].metadata)
+                            const deprioritizedReason = poolRankingProvenance
+                                ? latestPoolDemotionDetail(cacheable[i].metadata, poolRankingProvenance)
                                 : undefined;
                             cachedCards.set(cacheable[i].id, {
                                 ...cached,
@@ -494,6 +516,7 @@ export class HomeGraphFactory {
                             viewerRole,
                             isGhost: isCounterpartGhost,
                             ...(secondPartyData ? { secondParty: secondPartyData } : {}),
+                            _presentationFallback: true,
                             _cardIndex: cardIndex,
                         });
                         try {
@@ -514,6 +537,9 @@ export class HomeGraphFactory {
                             const _presenterDuration = Date.now() - presenterStart;
                             agentTimingsAccum.push({ name: 'opportunity.presenter', durationMs: _presenterDuration });
                             _traceEmitterPresenter?.({ type: "agent_end", name: "opportunity-presenter", durationMs: _presenterDuration, summary: `Presented: ${userName}` });
+                            if (presentation.isFallback) {
+                                return fallbackCard();
+                            }
                             let narratorChip;
                             // Only show a person as narrator when they are the introducer and not the display counterpart
                             // (bad data can have same user as introducer and party, e.g. "Amina introduced you to Amina")
@@ -571,11 +597,12 @@ export class HomeGraphFactory {
         const cachePresenterResultsNode = async (state) => {
             return timed("HomeGraph.cachePresenterResults", async () => {
                 const { cards, cachedCards, userId, opportunities } = state;
+                const poolRankingProvenance = getPoolRankingProvenance(state);
                 const liveById = new Map(opportunities.map((opportunity) => [opportunity.id, opportunity]));
                 const cardsWithAdjustments = cards.map((card) => {
                     const opportunity = liveById.get(card.opportunityId);
-                    const deprioritizedReason = poolQuestionsRanking() === 'on'
-                        ? latestPoolDemotionDetail(opportunity?.metadata)
+                    const deprioritizedReason = poolRankingProvenance
+                        ? latestPoolDemotionDetail(opportunity?.metadata, poolRankingProvenance)
                         : undefined;
                     return { ...card, deprioritizedReason };
                 });
@@ -585,18 +612,11 @@ export class HomeGraphFactory {
                 try {
                     await Promise.all(newCards.map((card) => {
                         const status = statusById.get(card.opportunityId);
-                        // Skip persisting negotiating cards — see read-side note.
-                        if (!status || status === 'negotiating')
-                            return Promise.resolve();
-                        // Never cache skeleton cards — they carry no presenter text and
-                        // would otherwise be served as "complete" for the full TTL.
-                        if (card.presentationPending)
-                            return Promise.resolve();
-                        // Skip caching cards with unresolved names — transient DB failures
-                        // would persist "Unknown" placeholders for the full TTL.
-                        if (!card.name || card.name === 'Unknown')
+                        // Negotiating, skeleton, fallback, and unresolved-name cards are
+                        // safe for the current response but must not become 24h entries.
+                        if (!status || !isHomePresentationCacheable(card, status))
                             return Promise.resolve();
-                        return this.cache.set(`home:card:${card.opportunityId}:${status}:${userId}`, card, { ttl: HOME_CACHE_TTL });
+                        return this.cache.set(buildHomeCardPresentationCacheKey(card.opportunityId, status, userId), card, { ttl: HOME_CACHE_TTL });
                     }));
                 }
                 catch (e) {
@@ -632,7 +652,10 @@ export class HomeGraphFactory {
                 // status, so dynamic categorization would erase the adjusted order on
                 // the full second-phase response. Flag off retains the legacy path.
                 // Chunk by MAX_ITEMS_PER_SECTION because normalizeAndSort caps sections.
-                const preserveAdjustedLifecycleOrder = (state.statuses?.length ?? 0) > 0 && poolQuestionsRanking() === 'on';
+                const poolRankingProvenance = getPoolRankingProvenance(state);
+                const preserveAdjustedLifecycleOrder = (state.statuses?.length ?? 0) > 0 &&
+                    poolRankingProvenance !== null &&
+                    state.opportunities.some((opportunity) => hasPoolAdjustment(opportunity, poolRankingProvenance));
                 if (state.presentation === 'skeleton' || preserveAdjustedLifecycleOrder) {
                     const sectionProposals = [];
                     for (let start = 0; start < state.cards.length; start += MAX_ITEMS_PER_SECTION) {
@@ -704,7 +727,9 @@ export class HomeGraphFactory {
         };
         const cacheCategorizerResultsNode = async (state) => {
             return timed("HomeGraph.cacheCategorizerResults", async () => {
-                if (state.categoryCacheHit || state.sectionProposals.length === 0) {
+                if (state.categoryCacheHit ||
+                    state.sectionProposals.length === 0 ||
+                    state.cards.some((card) => card._presentationFallback)) {
                     return {};
                 }
                 try {
@@ -738,7 +763,7 @@ export class HomeGraphFactory {
                         .map((i) => {
                         usedIndices.add(i);
                         const card = cards[i];
-                        const { _cardIndex, ...rest } = card;
+                        const { _cardIndex, _presentationFallback, ...rest } = card;
                         return rest;
                     });
                     return {