@kontourai/survey 0.4.4 → 0.4.5

package/README.md

@@ -871,11 +871,18 @@ const learning = buildSurveyLearningProjections(surveyInput);
 const trustInput = buildSurveyTrustInput(surveyInput);
 ```
 
-Learning projections are product-neutral `learning.*` records. Survey currently
-emits `learning.comfort-zone` from structured `ReviewOutcome.withinComfortZone
-=== false` data and `learning.escalation` from unresolved `EscalationRecord`s,
-including unattached records that producer tooling can route but Surface cannot
-attach to a claim event.
+Learning projections are product-neutral `learning.*` records. Survey emits
+`learning.rejected-candidate` from structured candidate rejection data such as
+non-empty `Candidate.rejectionReason` values or a candidate-specific
+`ReviewOutcome.status === "rejected"` outcome with rationale. When both exist,
+Survey emits one rejected-candidate projection enriched with candidate and
+review outcome context.
+Ordinary rejected candidates do not emit `learning.comfort-zone`.
+
+Survey also emits `learning.comfort-zone` from structured
+`ReviewOutcome.withinComfortZone === false` data and `learning.escalation` from
+unresolved `EscalationRecord`s, including unattached records that producer
+tooling can route but Surface cannot attach to a claim event.
 
 These projections are producer/review workflow and evaluation signals. They are
 not claims about truth or veracity, not Surface claim status, not evidence, and

package/dist/src/learning-projections.d.ts

@@ -1,6 +1,6 @@
 import type { SurveyInput } from "./types.js";
-export type LearningProjectionKind = "learning.comfort-zone" | "learning.escalation";
-export type LearningProjectionSignal = "comfort-zone.outside" | "escalation.unresolved";
+export type LearningProjectionKind = "learning.comfort-zone" | "learning.escalation" | "learning.rejected-candidate";
+export type LearningProjectionSignal = "comfort-zone.outside" | "escalation.unresolved" | "rejected-candidate.reason";
 export type LearningProjectionSeverity = "info" | "attention";
 export interface LearningProjection {
     id: string;

package/dist/src/learning-projections.js

@@ -1,7 +1,44 @@
 export function buildSurveyLearningProjections(input) {
     const claimsByCandidateSet = groupBy(input.claims, (claim) => claim.candidateSetId);
     const candidateSetTargets = new Map(input.candidateSets.map((candidateSet) => [candidateSet.id, candidateSet.target]));
+    const extractionsById = new Map(input.extractions.map((extraction) => [extraction.id, extraction]));
+    const rejectedReviewsByCandidate = groupBy(input.reviewOutcomes.filter((reviewOutcome) => reviewOutcome.status === "rejected" && reviewOutcome.candidateId), (reviewOutcome) => `${reviewOutcome.candidateSetId}:${reviewOutcome.candidateId}`);
     const projections = [];
+    for (const candidateSet of input.candidateSets) {
+        for (const candidate of candidateSet.candidates) {
+            const rejectedReviews = rejectedReviewsByCandidate.get(`${candidateSet.id}:${candidate.id}`) ?? [];
+            const candidateReason = normalizeText(candidate.rejectionReason);
+            const reviewOutcome = rejectedReviews[0];
+            const reviewRationale = normalizeText(reviewOutcome?.rationale);
+            const rejectionReason = candidateReason ?? reviewRationale;
+            if (!rejectionReason)
+                continue;
+            const claim = claimsByCandidateSet.get(candidateSet.id)?.find((candidateSetClaim) => candidateSetClaim.candidateId === candidate.id);
+            const extraction = extractionsById.get(candidate.extractionId);
+            projections.push({
+                id: `${candidateSet.id}.${candidate.id}.learning.rejected-candidate`,
+                kind: "learning.rejected-candidate",
+                source: input.source,
+                createdAt: reviewOutcome?.reviewedAt ?? extraction?.extractedAt ?? input.generatedAt,
+                target: candidateSet.target,
+                claimId: claim?.id,
+                reviewOutcomeId: reviewOutcome?.id,
+                signal: "rejected-candidate.reason",
+                severity: "info",
+                summary: `Rejected candidate reason: ${rejectionReason}`,
+                metadata: {
+                    rejectedCandidate: rejectedCandidateMetadata({
+                        candidateSet,
+                        candidate,
+                        extraction,
+                        reviewOutcome,
+                        claim,
+                        rejectionReason,
+                    }),
+                },
+            });
+        }
+    }
     for (const reviewOutcome of input.reviewOutcomes) {
         if (reviewOutcome.withinComfortZone !== false)
             continue;
@@ -48,6 +85,20 @@ export function buildSurveyLearningProjections(input) {
     }
     return projections;
 }
+function rejectedCandidateMetadata(input) {
+    return {
+        candidateId: input.candidate.id,
+        candidateSetId: input.candidateSet.id,
+        target: input.candidateSet.target,
+        rejectionReason: input.rejectionReason,
+        ...(input.reviewOutcome ? { reviewOutcomeId: input.reviewOutcome.id, reviewStatus: input.reviewOutcome.status } : {}),
+        ...(input.claim ? { claimId: input.claim.id } : {}),
+        ...(input.extraction ? { extractionId: input.extraction.id } : {}),
+        ...(input.candidateSet.selectedCandidateId ? { selectedCandidateId: input.candidateSet.selectedCandidateId } : {}),
+        ...(input.candidate.rejectionReason ? { candidateRejectionReason: input.candidate.rejectionReason } : {}),
+        ...(input.reviewOutcome?.rationale ? { reviewRationale: input.reviewOutcome.rationale } : {}),
+    };
+}
 function findClaimForReview(claims, reviewOutcome) {
     if (reviewOutcome.candidateId) {
         return claims.find((claim) => claim.candidateId === reviewOutcome.candidateId);
@@ -75,3 +126,7 @@ function groupBy(items, getKey) {
     }
     return map;
 }
+function normalizeText(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",