@kontourai/survey 0.3.0 → 0.4.0

package/README.md

@@ -197,6 +197,22 @@ This is useful for corrected documents, source-of-truth choices, and review
 queues where losing candidates should remain visible for transparency rather
 than disappearing from the trust trail.
 
+## Reviewed current/proposed resolutions
+
+Use `reviewedCurrentProposedResolution` when a producer has exactly two
+candidate roles for the same target: the current value the producer would keep
+absent a change, and a proposed value introduced by new source material,
+extraction, or review work. The helper consumes full observations, selects
+either the current or proposed candidate through `selectedCandidateRole`, and
+wraps the result with `reviewedCandidateResolution`.
+
+The helper may promote the selected candidate to a caller-supplied
+`selectedClaimId`. The unselected observation keeps its caller-authored claim
+id, so producers can keep losing candidates as candidate-specific history.
+Survey does not decide producer policy: callers still own review status,
+selected and unselected claim statuses, source details, claim vocabulary, and
+domain metadata.
+
 ## Repeated observations
 
 Use `repeatedObservation` when a producer wants to describe a repeated field or

package/dist/src/index.d.ts

@@ -3,6 +3,8 @@ export { candidateReviewRecord, SurveyInputBuilder } from "./builder.js";
 export type { CandidateReviewRecordInput, SurveyClaimRecord, SurveyInputBuilderArgs, SurveyObservationInput, } from "./builder.js";
 export { reviewedCandidateResolution } from "./reviewed-candidate-resolution.js";
 export type { ReviewedCandidateResolutionInput } from "./reviewed-candidate-resolution.js";
+export { reviewedCurrentProposedResolution } from "./reviewed-current-proposed-resolution.js";
+export type { CurrentProposedCandidateRole, ReviewedCurrentProposedResolutionInput, } from "./reviewed-current-proposed-resolution.js";
 export { buildSurveyTrustInput } from "./to-surface.js";
 export { fieldObservation } from "./field-observation.js";
 export type { FieldObservationInput } from "./field-observation.js";

package/dist/src/index.js

@@ -1,5 +1,6 @@
 export { candidateReviewRecord, SurveyInputBuilder } from "./builder.js";
 export { reviewedCandidateResolution } from "./reviewed-candidate-resolution.js";
+export { reviewedCurrentProposedResolution } from "./reviewed-current-proposed-resolution.js";
 export { buildSurveyTrustInput } from "./to-surface.js";
 export { fieldObservation } from "./field-observation.js";
 export { repeatedObservation } from "./repeated-observation.js";

package/dist/src/reviewed-current-proposed-resolution.d.ts

@@ -0,0 +1,10 @@
+import { type ReviewedCandidateResolutionInput } from "./reviewed-candidate-resolution.js";
+import type { SurveyClaimRecord, SurveyObservationInput } from "./builder.js";
+export type CurrentProposedCandidateRole = "current" | "proposed";
+export interface ReviewedCurrentProposedResolutionInput extends Omit<ReviewedCandidateResolutionInput, "observations" | "selectedCandidateId"> {
+    currentObservation: SurveyObservationInput;
+    proposedObservation: SurveyObservationInput;
+    selectedCandidateRole: CurrentProposedCandidateRole;
+    selectedClaimId?: string;
+}
+export declare function reviewedCurrentProposedResolution(input: ReviewedCurrentProposedResolutionInput): SurveyClaimRecord[];

package/dist/src/reviewed-current-proposed-resolution.js

@@ -0,0 +1,49 @@
+import { reviewedCandidateResolution } from "./reviewed-candidate-resolution.js";
+export function reviewedCurrentProposedResolution(input) {
+    const currentCandidateId = candidateIdFor(input, "current", input.currentObservation);
+    const proposedCandidateId = candidateIdFor(input, "proposed", input.proposedObservation);
+    const selectedCandidateId = input.selectedCandidateRole === "current"
+        ? currentCandidateId
+        : proposedCandidateId;
+    return reviewedCandidateResolution({
+        ...input,
+        selectedCandidateId,
+        observations: [
+            observationForRole({
+                input,
+                role: "current",
+                candidateId: currentCandidateId,
+                observation: input.currentObservation,
+            }),
+            observationForRole({
+                input,
+                role: "proposed",
+                candidateId: proposedCandidateId,
+                observation: input.proposedObservation,
+            }),
+        ],
+    });
+}
+function observationForRole(input) {
+    const selected = input.input.selectedCandidateRole === input.role;
+    return {
+        ...input.observation,
+        candidate: {
+            ...input.observation.candidate,
+            id: input.candidateId,
+            metadata: {
+                ...input.observation.candidate?.metadata,
+                candidateRole: input.role,
+            },
+        },
+        claim: {
+            ...input.observation.claim,
+            id: selected && input.input.selectedClaimId
+                ? input.input.selectedClaimId
+                : input.observation.claim.id,
+        },
+    };
+}
+function candidateIdFor(input, role, observation) {
+    return observation.candidate?.id ?? `${input.id}.${role}.candidate`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",
@@ -31,7 +31,8 @@
     "build": "rm -rf dist && tsc",
     "typecheck": "tsc --noEmit",
     "test": "npm run build && node --test dist/tests/*.test.js",
-    "verify": "npm run typecheck && npm test"
+    "verify": "node scripts/check-content-boundary.cjs && npm run typecheck && npm test",
+    "check:content-boundary": "node scripts/check-content-boundary.cjs"
   },
   "dependencies": {
     "@kontourai/surface": "^0.5.0"