@kontourai/survey 1.14.0 → 1.16.0

package/dist/src/review-workbench/review-queue-session.js

@@ -1,4 +1,5 @@
 import { publicDirectoryReviewItemExample, reviewWorkbenchQueueExamples } from "./review-workbench-data.js";
+import { assertReviewResolutionConsistency } from "../producer-discipline.js";
 import { reviewResourceApiVersion, } from "../../src/review-resource.js";
 export const reviewWorkbenchSessionStorageKey = "kontourai.survey.review-workbench.session-events.v1";
 export const defaultReviewSessionName = "review-workbench-session";
@@ -21,6 +22,12 @@ export const workbenchDecisionDefinitions = {
         candidateRole: "proposed",
         status: "rejected",
     },
+    "could-not-confirm": {
+        label: "Could not confirm",
+        effect: "The review round ends without changing or escalating the proposed claim.",
+        candidateRole: "proposed",
+        status: "proposed",
+    },
 };
 export function initialReviewWorkbenchState(item = publicDirectoryReviewItemExample) {
     return {
@@ -49,6 +56,7 @@ export function currentReviewWorkbenchState(session) {
         note: session.notesByItemName[item.metadata.name] ?? "",
         decision: session.decisionsByItemName[item.metadata.name],
         editedValue: session.editedValuesByItemName?.[item.metadata.name],
+        attemptEvidenceIds: session.attemptEvidenceIdsByItemName?.[item.metadata.name],
         reviewedAt: session.reviewedAt,
         actorId: session.actorId,
     };
@@ -65,6 +73,9 @@ export function deriveQueueRowStatus(item, session) {
     if (decision === "reject-proposed") {
         return "rejected";
     }
+    if (decision === "could-not-confirm") {
+        return "could-not-confirm";
+    }
     if (decision === "accept-proposed" || decision === "keep-current" || item.spec.candidateSetStatus === "resolved") {
         return "resolved";
     }
@@ -96,6 +107,9 @@ export function reviewSessionSummary(session) {
         if (decision === "reject-proposed") {
             return { ...summary, rejected: summary.rejected + 1 };
         }
+        if (decision === "could-not-confirm") {
+            return { ...summary, couldNotConfirm: (summary.couldNotConfirm ?? 0) + 1 };
+        }
         if (item.spec.candidateSetStatus === "escalated") {
             return { ...summary, escalated: summary.escalated + 1 };
         }
@@ -194,6 +208,9 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
         if (!decision) {
             continue;
         }
+        if (decision === "could-not-confirm" && !note?.trim()) {
+            throw new Error(`ReviewItem ${item.metadata.name} could not confirm requires a non-empty reason.`);
+        }
         const candidate = candidateForDecision(item, decision);
         const definition = workbenchDecisionDefinitions[decision];
         const reviewDecisionName = `${item.metadata.name}-${decision}`;
@@ -203,9 +220,20 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
         // the server apply boundary derives effectiveValue from it. Without this
         // the edit lives only in browser state and never survives replay.
         const editedValue = decision === "accept-proposed" ? session.editedValuesByItemName?.[item.metadata.name] : undefined;
+        const attemptEvidenceIds = decision === "could-not-confirm"
+            ? session.attemptEvidenceIdsByItemName?.[item.metadata.name]
+            : undefined;
+        assertReviewResolutionConsistency(`ReviewItem ${item.metadata.name}`, {
+            status: definition.status,
+            resolution: decision === "could-not-confirm" ? "could_not_confirm" : undefined,
+            resolutionReason: decision === "could-not-confirm" ? note : undefined,
+            attemptEvidenceIds,
+            actor: session.actorId,
+            reviewedAt: session.reviewedAt,
+        });
         const data = editedValue !== undefined
             ? { workbenchDecision: decision, workbenchEditedValue: editedValue }
-            : { workbenchDecision: decision };
+            : { workbenchDecision: decision, ...(attemptEvidenceIds?.length ? { attemptEvidenceIds } : {}) };
         events.push(buildReviewSessionEvent(session, {
             sessionName,
             sequence: events.length + 1,
@@ -215,6 +243,13 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
             reviewDecisionName,
             candidateId: candidate.id,
             status: definition.status,
+            ...(decision === "could-not-confirm"
+                ? {
+                    resolution: "could_not_confirm",
+                    resolutionReason: note,
+                    ...(attemptEvidenceIds ? { attemptEvidenceIds: [...attemptEvidenceIds] } : {}),
+                }
+                : {}),
             data,
         }));
         events.push(buildReviewSessionEvent(session, {
@@ -227,6 +262,13 @@ export function buildReviewSessionEvents(session, sessionName = defaultReviewSes
             candidateId: candidate.id,
             status: definition.status,
             rationale: note,
+            ...(decision === "could-not-confirm"
+                ? {
+                    resolution: "could_not_confirm",
+                    resolutionReason: note,
+                    ...(attemptEvidenceIds ? { attemptEvidenceIds: [...attemptEvidenceIds] } : {}),
+                }
+                : {}),
             data,
         }));
     }
@@ -264,7 +306,13 @@ export function replayReviewSessionEvents(startState, events) {
             if (isClearedWorkbenchDecisionEvent(event)) {
                 const { [itemName]: _removedDecision, ...remainingDecisions } = session.decisionsByItemName;
                 const { [itemName]: _removedEdit, ...remainingEdits } = session.editedValuesByItemName ?? {};
-                return { ...session, decisionsByItemName: remainingDecisions, editedValuesByItemName: remainingEdits };
+                const { [itemName]: _removedAttempts, ...remainingAttempts } = session.attemptEvidenceIdsByItemName ?? {};
+                return {
+                    ...session,
+                    decisionsByItemName: remainingDecisions,
+                    editedValuesByItemName: remainingEdits,
+                    attemptEvidenceIdsByItemName: remainingAttempts,
+                };
             }
             const decision = workbenchDecisionFromEvent(event);
             if (!decision) {
@@ -276,12 +324,19 @@ export function replayReviewSessionEvents(startState, events) {
             // reviewer moved away from.
             const editedValue = workbenchEditedValueFromEvent(event);
             const editedValuesByItemName = { ...session.editedValuesByItemName };
+            const attemptEvidenceIdsByItemName = { ...session.attemptEvidenceIdsByItemName };
             if (decision === "accept-proposed" && editedValue !== undefined) {
                 editedValuesByItemName[itemName] = editedValue;
             }
             else {
                 delete editedValuesByItemName[itemName];
             }
+            if (decision === "could-not-confirm" && event.spec.attemptEvidenceIds?.length) {
+                attemptEvidenceIdsByItemName[itemName] = [...event.spec.attemptEvidenceIds];
+            }
+            else {
+                delete attemptEvidenceIdsByItemName[itemName];
+            }
             return {
                 ...session,
                 decisionsByItemName: {
@@ -289,6 +344,7 @@ export function replayReviewSessionEvents(startState, events) {
                     [itemName]: decision,
                 },
                 editedValuesByItemName,
+                attemptEvidenceIdsByItemName,
             };
         }
         return session;

package/dist/src/review-workbench/review-session-replay.d.ts

@@ -1,6 +1,6 @@
 import type { ReviewSessionEvent } from "../review-resource.js";
 import { type ReviewQueueSessionState } from "./review-queue-session.js";
-export type ReviewSessionReplayIssueCode = "invalid-sequence" | "duplicate-sequence" | "non-contiguous-sequence" | "unknown-active-item" | "unknown-review-item" | "unknown-candidate" | "missing-review-item" | "invalid-workbench-decision" | "decision-candidate-mismatch" | "decision-status-mismatch";
+export type ReviewSessionReplayIssueCode = "invalid-sequence" | "duplicate-sequence" | "non-contiguous-sequence" | "unknown-active-item" | "unknown-review-item" | "unknown-candidate" | "missing-review-item" | "invalid-workbench-decision" | "decision-candidate-mismatch" | "decision-status-mismatch" | "decision-resolution-mismatch" | "missing-resolution-reason";
 export interface ReviewSessionReplayIssue {
     readonly code: ReviewSessionReplayIssueCode;
     readonly eventName: string;

package/dist/src/review-workbench/review-session-replay.js

@@ -76,6 +76,25 @@ export function validateReviewSessionEventsForSnapshot(snapshot, events) {
                         message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects status ${expectedStatus}, but references ${event.spec.status ?? "no status"}.`,
                     });
                 }
+                const expectedResolution = decision === "could-not-confirm" ? "could_not_confirm" : undefined;
+                if (event.spec.resolution !== expectedResolution) {
+                    issues.push({
+                        ...eventRef,
+                        code: "decision-resolution-mismatch",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects resolution ${expectedResolution ?? "none"}, but references ${event.spec.resolution ?? "no resolution"}.`,
+                    });
+                }
+                if (decision === "could-not-confirm" && !event.spec.resolutionReason?.trim()) {
+                    issues.push({
+                        ...eventRef,
+                        code: "missing-resolution-reason",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision could-not-confirm requires a non-empty resolutionReason.`,
+                    });
+                }
             }
         }
         if (event.spec.candidateId && itemName && itemsByName.has(itemName)) {

package/dist/src/review-workbench/review-surface-preview.js

@@ -8,7 +8,7 @@ export function buildSurfaceProjectionPreview(item, decision, presentationAdapte
         canonicalClaim: buildPreviewClaim(item, selectedCandidate, decision, projection, presentationAdapter),
         candidateHistory: buildCandidateHistory(item, selectedCandidate, presentationAdapter),
         sourceEvidence: buildSourceEvidence(selectedCandidate),
-        reviewEvent: buildReviewEvent(decision, projection),
+        reviewEvent: decision.spec.resolution === "could_not_confirm" ? undefined : buildReviewEvent(decision, projection),
         integrityPosture: buildIntegrityPosture(item, selectedCandidate, projection),
         authorityTrace: portableAuthorityTrace(selectedCandidate.producer?.authorityTrace),
         postureDisclaimer: postureDisclaimer(),

package/dist/src/review-workbench/review-workbench-css.generated.js

@@ -6,149 +6,149 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
   color-scheme: dark;
 
   /* structure */
-  --k-bg: #0a0e13;
-  --k-panel: #111824;
-  --k-panel-raised: #16202d;
-  --k-line: rgba(150, 180, 210, 0.12);
-  --k-line-strong: rgba(150, 180, 210, 0.22);
-  --k-shadow: 0 26px 60px -42px rgba(0, 0, 0, 0.95);
+  --k-bg: var(--k-bg, #0a0e13);
+  --k-panel: var(--k-panel, #111824);
+  --k-panel-raised: var(--k-panel-raised, #16202d);
+  --k-line: var(--k-line, rgba(150, 180, 210, 0.12));
+  --k-line-strong: var(--k-line-strong, rgba(150, 180, 210, 0.22));
+  --k-shadow: var(--k-shadow, 0 26px 60px -42px rgba(0, 0, 0, 0.95));
 
   /* text */
-  --k-text: #eef3f8;
-  --k-text-muted: #aebccb;
-  --k-text-faint: #72869b;
+  --k-text: var(--k-text, #eef3f8);
+  --k-text-muted: var(--k-text-muted, #aebccb);
+  --k-text-faint: var(--k-text-faint, #72869b);
 
   /* brand */
-  --k-brand: #5ce0c6;
-  --k-brand-contrast: #06080b;
+  --k-brand: var(--k-brand, #5ce0c6);
+  --k-brand-contrast: var(--k-brand-contrast, #06080b);
 
   /* semantic status scale */
-  --k-positive: #34d399;
-  --k-caution: #f3b14b;
-  --k-negative: #ff6f6f;
-  --k-neutral: #6f8095;
-  --k-active: #7aa2ff;
+  --k-positive: var(--k-positive, #34d399);
+  --k-caution: var(--k-caution, #f3b14b);
+  --k-negative: var(--k-negative, #ff6f6f);
+  --k-neutral: var(--k-neutral, #6f8095);
+  --k-active: var(--k-active, #7aa2ff);
   --k-positive-soft: color-mix(in oklab, var(--k-positive) 14%, transparent);
   --k-caution-soft: color-mix(in oklab, var(--k-caution) 14%, transparent);
   --k-negative-soft: color-mix(in oklab, var(--k-negative) 14%, transparent);
   --k-active-soft: color-mix(in oklab, var(--k-active) 14%, transparent);
 
   /* spacing */
-  --k-space-1: 4px;
-  --k-space-2: 8px;
-  --k-space-3: 12px;
-  --k-space-4: 16px;
-  --k-space-5: 24px;
-  --k-space-6: 32px;
+  --k-space-1: var(--k-space-1, 4px);
+  --k-space-2: var(--k-space-2, 8px);
+  --k-space-3: var(--k-space-3, 12px);
+  --k-space-4: var(--k-space-4, 16px);
+  --k-space-5: var(--k-space-5, 24px);
+  --k-space-6: var(--k-space-6, 32px);
 
   /* radius */
-  --k-radius-sm: 9px;
-  --k-radius-md: 14px;
+  --k-radius-sm: var(--k-radius-sm, 9px);
+  --k-radius-md: var(--k-radius-md, 14px);
 
   /* type */
-  --k-text-xs: 11px;
-  --k-text-sm: 12.5px;
-  --k-text-md: 14px;
-  --k-text-lg: 18px;
-  --k-text-xl: 22px;
-  --k-text-2xl: clamp(26px, 3.4vw, 38px);
+  --k-text-xs: var(--k-text-xs, 11px);
+  --k-text-sm: var(--k-text-sm, 12.5px);
+  --k-text-md: var(--k-text-md, 14px);
+  --k-text-lg: var(--k-text-lg, 18px);
+  --k-text-xl: var(--k-text-xl, 22px);
+  --k-text-2xl: var(--k-text-2xl, clamp(26px, 3.4vw, 38px));
 
   /* fonts */
-  --k-font-display: "Fraunces", Georgia, "Times New Roman", serif;
-  --k-font-ui: "Hanken Grotesk", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
-  --k-font-mono: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
+  --k-font-display: var(--k-font-display, "Fraunces", Georgia, "Times New Roman", serif);
+  --k-font-ui: var(--k-font-ui, "Hanken Grotesk", ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif);
+  --k-font-mono: var(--k-font-mono, "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, monospace);
 
   /* motion */
-  --k-ease: cubic-bezier(0.22, 1, 0.36, 1);
-  --k-dur: 0.16s;
+  --k-ease: var(--k-ease, cubic-bezier(0.22, 1, 0.36, 1));
+  --k-dur: var(--k-dur, 0.16s);
 }
 
 .survey-workbench-embed[data-theme="light"]{
   color-scheme: light;
-  --k-bg: #f5f4ef;
-  --k-panel: #ffffff;
-  --k-panel-raised: #fbfaf7;
-  --k-line: rgba(36, 40, 46, 0.12);
-  --k-line-strong: rgba(36, 40, 46, 0.20);
-  --k-shadow: 0 18px 50px -30px rgba(0, 0, 0, 0.25);
-  --k-text: #202124;
-  --k-text-muted: #5b626b;
-  --k-text-faint: #707782;
-  --k-brand-contrast: #ffffff;
-  --k-positive: #168257;
-  --k-caution: #8a5a00;
-  --k-negative: #c83b3b;
-  --k-neutral: #5f6975;
-  --k-active: #3f6fd6;
+  --k-bg: var(--k-bg, #f5f4ef);
+  --k-panel: var(--k-panel, #ffffff);
+  --k-panel-raised: var(--k-panel-raised, #fbfaf7);
+  --k-line: var(--k-line, rgba(36, 40, 46, 0.12));
+  --k-line-strong: var(--k-line-strong, rgba(36, 40, 46, 0.20));
+  --k-shadow: var(--k-shadow, 0 18px 50px -30px rgba(0, 0, 0, 0.25));
+  --k-text: var(--k-text, #202124);
+  --k-text-muted: var(--k-text-muted, #5b626b);
+  --k-text-faint: var(--k-text-faint, #707782);
+  --k-brand-contrast: var(--k-brand-contrast, #ffffff);
+  --k-positive: var(--k-positive, #168257);
+  --k-caution: var(--k-caution, #8a5a00);
+  --k-negative: var(--k-negative, #c83b3b);
+  --k-neutral: var(--k-neutral, #5f6975);
+  --k-active: var(--k-active, #3f6fd6);
 }
 
 
 .survey-workbench-embed.theme-survey{
-  --k-bg: #06080b;
-  --k-brand: #5ce0c6;
-  --k-text-faint: #6f8095;
+  --k-bg: var(--k-bg, #06080b);
+  --k-brand: var(--k-brand, #5ce0c6);
+  --k-text-faint: var(--k-text-faint, #6f8095);
 }
 
 .survey-workbench-embed.theme-console{
-  --k-font-ui: "Aptos Narrow", "DIN Condensed", "IBM Plex Sans Condensed", "Gill Sans", sans-serif;
-  --k-font-display: "Aptos Narrow", "DIN Condensed", "IBM Plex Sans Condensed", "Gill Sans", sans-serif;
-  --k-radius-sm: 0;
-  --k-radius-md: 0;
-  --k-brand: #c9ff4a;
-  --k-brand-contrast: #11120f;
-  --k-bg: #11120f;
-  --k-panel: #191b16;
-  --k-panel-raised: #20231e;
-  --k-line: #3a4035;
-  --k-line-strong: #8ea36e;
-  --k-text: #f2f0e8;
-  --k-text-muted: #a6ab9c;
-  --k-text-faint: #747a6c;
-  --k-positive: #a6d37b;
-  --k-caution: #e8c15f;
-  --k-negative: #ee776f;
-  --k-active: #84d8c8;
+  --k-font-ui: var(--k-font-ui, "Aptos Narrow", "DIN Condensed", "IBM Plex Sans Condensed", "Gill Sans", sans-serif);
+  --k-font-display: var(--k-font-display, "Aptos Narrow", "DIN Condensed", "IBM Plex Sans Condensed", "Gill Sans", sans-serif);
+  --k-radius-sm: var(--k-radius-sm, 0);
+  --k-radius-md: var(--k-radius-md, 0);
+  --k-brand: var(--k-brand, #c9ff4a);
+  --k-brand-contrast: var(--k-brand-contrast, #11120f);
+  --k-bg: var(--k-bg, #11120f);
+  --k-panel: var(--k-panel, #191b16);
+  --k-panel-raised: var(--k-panel-raised, #20231e);
+  --k-line: var(--k-line, #3a4035);
+  --k-line-strong: var(--k-line-strong, #8ea36e);
+  --k-text: var(--k-text, #f2f0e8);
+  --k-text-muted: var(--k-text-muted, #a6ab9c);
+  --k-text-faint: var(--k-text-faint, #747a6c);
+  --k-positive: var(--k-positive, #a6d37b);
+  --k-caution: var(--k-caution, #e8c15f);
+  --k-negative: var(--k-negative, #ee776f);
+  --k-active: var(--k-active, #84d8c8);
 }
 
 .survey-workbench-embed.theme-flow{
-  --k-brand: #2f88a6;
+  --k-brand: var(--k-brand, #2f88a6);
 }
 
 .survey-workbench-embed.theme-surface{
-  --k-brand: #14a37a;
+  --k-brand: var(--k-brand, #14a37a);
 }
 
 .survey-workbench-embed[data-theme="light"].theme-survey,
 .survey-workbench-embed[data-theme="light"] .theme-survey{
-  --k-brand: #16806f;
+  --k-brand: var(--k-brand, #16806f);
 }
 
 .survey-workbench-embed[data-theme="light"].theme-console,
 .survey-workbench-embed[data-theme="light"] .theme-console{
-  --k-brand: #6c9400;
-  --k-brand-contrast: #ffffff;
-  --k-bg: #f3f5eb;
-  --k-panel: #fbfcf7;
-  --k-panel-raised: #eef2e6;
-  --k-line: #ccd5bf;
-  --k-line-strong: #8fa36f;
-  --k-text: #1e2319;
-  --k-text-muted: #596250;
-  --k-text-faint: #77816d;
-  --k-positive: #2f7d32;
-  --k-caution: #8a6500;
-  --k-negative: #b93a36;
-  --k-active: #247f75;
+  --k-brand: var(--k-brand, #6c9400);
+  --k-brand-contrast: var(--k-brand-contrast, #ffffff);
+  --k-bg: var(--k-bg, #f3f5eb);
+  --k-panel: var(--k-panel, #fbfcf7);
+  --k-panel-raised: var(--k-panel-raised, #eef2e6);
+  --k-line: var(--k-line, #ccd5bf);
+  --k-line-strong: var(--k-line-strong, #8fa36f);
+  --k-text: var(--k-text, #1e2319);
+  --k-text-muted: var(--k-text-muted, #596250);
+  --k-text-faint: var(--k-text-faint, #77816d);
+  --k-positive: var(--k-positive, #2f7d32);
+  --k-caution: var(--k-caution, #8a6500);
+  --k-negative: var(--k-negative, #b93a36);
+  --k-active: var(--k-active, #247f75);
 }
 
 .survey-workbench-embed[data-theme="light"].theme-flow,
 .survey-workbench-embed[data-theme="light"] .theme-flow{
-  --k-brand: #1f6f88;
+  --k-brand: var(--k-brand, #1f6f88);
 }
 
 .survey-workbench-embed[data-theme="light"].theme-surface,
 .survey-workbench-embed[data-theme="light"] .theme-surface{
-  --k-brand: #0f6b52;
+  --k-brand: var(--k-brand, #0f6b52);
 }
 
 
@@ -437,6 +437,7 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
 .survey-workbench-embed .field[data-state="accepted"] .stripe{ background: var(--k-positive); }
 .survey-workbench-embed .field[data-state="kept"] .stripe{ background: var(--k-faint); }
 .survey-workbench-embed .field[data-state="rejected"] .stripe{ background: var(--k-negative); }
+.survey-workbench-embed .field[data-state="could-not-confirm"] .stripe{ background: var(--k-caution); }
 .survey-workbench-embed .field[data-state="review"] .stripe{ background: var(--k-brand); }
 
 .survey-workbench-embed .fbody{
@@ -491,6 +492,7 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
 .survey-workbench-embed .chip.accepted{ color: var(--k-positive); background: var(--k-positive-wash); }
 .survey-workbench-embed .chip.kept{ color: var(--k-muted); background: var(--k-sunken); }
 .survey-workbench-embed .chip.rejected{ color: var(--k-negative); background: var(--k-negative-wash); }
+.survey-workbench-embed .chip.could-not-confirm{ color: var(--k-caution); background: var(--k-caution-wash); }
 
 .survey-workbench-embed .frow1 .push{
   margin-left: auto;
@@ -755,6 +757,12 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
   background: var(--k-panel-raised, var(--k-raised));
 }
 
+.survey-workbench-embed .btn.unconfirmed{
+  border-color: var(--k-caution);
+  color: var(--k-caution);
+  background: var(--k-caution-wash);
+}
+
 /* "Suggestion was wrong" — optional quiet calibration toggle on Keep current.
    Ticking it turns a keep-current decision into the reject signal. Not a third action. */
 .survey-workbench-embed .wrong{