@kontourai/survey 0.4.8 → 0.4.10

package/README.md

@@ -87,6 +87,16 @@ application's `body` or `:root` styles. Hosts should mount into an element like:
 The package also exposes `@kontourai/survey/review-workbench/standalone.css` for
 the standalone demo page. Use that only when Survey owns the whole page.
 
+For the full consumer path from `ReviewItem` construction through persisted
+review events, exported results, and optional Surface projection, see
+[`docs/consumer-integration-guide.md`](docs/consumer-integration-guide.md).
+That guide also covers the server-side apply boundary: producers should derive
+write results from reviewed snapshots plus persisted events, not from
+browser-computed decisions or exported result payloads.
+For the current decision on why Survey is not adding a generic review adapter
+builder yet, see
+[`docs/consumer-adapter-abstraction-assessment.md`](docs/consumer-adapter-abstraction-assessment.md).
+
 ## Contributor checks
 
 Install the repo-owned Git hooks once per clone:

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

@@ -231,6 +231,7 @@
 .survey-workbench-embed .workbench{
   position: relative;
   z-index: 1;
+  container-type: inline-size;
   min-height: 100vh;
   padding: 30px 26px 60px;
 }
@@ -239,7 +240,7 @@
   display: grid;
   grid-template-rows: auto minmax(0, 1fr);
   gap: 22px;
-  max-width: 1280px;
+  max-width: 1360px;
   margin: 0 auto;
 }
 
@@ -359,7 +360,7 @@
 
 .survey-workbench-embed .queue-layout{
   display: grid;
-  grid-template-columns: 300px minmax(0, 1fr);
+  grid-template-columns: 280px minmax(0, 1fr);
   gap: 22px;
   align-items: start;
 }
@@ -636,10 +637,11 @@
 
 .survey-workbench-embed .content-grid{
   display: grid;
-  grid-template-columns: minmax(0, 1fr) minmax(360px, 440px);
+  grid-template-columns: minmax(0, 1fr);
   grid-template-areas:
-    "focus decision"
-    "candidates decision";
+    "focus"
+    "decision"
+    "candidates";
   gap: 22px;
   align-items: start;
 }
@@ -774,7 +776,7 @@
   display: grid;
   grid-template-rows: auto auto minmax(0, 1fr);
   gap: 16px;
-  min-height: 560px;
+  min-height: 460px;
   padding: 20px;
   position: relative;
   overflow: hidden;
@@ -916,6 +918,7 @@
 .survey-workbench-embed .decision-column{
   grid-area: decision;
   display: grid;
+  grid-template-columns: minmax(0, 1fr);
   gap: 18px;
   animation: rise 0.6s cubic-bezier(0.22, 1, 0.36, 1) both;
   animation-delay: 0.15s;
@@ -1068,7 +1071,7 @@
 
 .survey-workbench-embed .preview-section-grid{
   display: grid;
-  grid-template-columns: minmax(0, 1fr);
+  grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 10px;
 }
 
@@ -1271,6 +1274,69 @@
   }
 }
 
+@container (max-width: 1100px) {
+  .survey-workbench-embed .topbar,
+  .survey-workbench-embed .queue-layout,
+  .survey-workbench-embed .focus-evidence{
+    grid-template-columns: 1fr;
+  }
+
+  .survey-workbench-embed .queue-layout{
+    grid-template-areas:
+      "content"
+      "queue";
+  }
+
+  .survey-workbench-embed .queue-panel{
+    grid-area: queue;
+    position: static;
+  }
+
+  .survey-workbench-embed .content-grid{
+    grid-area: content;
+    grid-template-columns: 1fr;
+    grid-template-areas:
+      "focus"
+      "decision"
+      "candidates";
+  }
+
+  .survey-workbench-embed .content-grid,
+  .survey-workbench-embed .review-main,
+  .survey-workbench-embed .candidate-grid,
+  .survey-workbench-embed .decision-column{
+    min-width: 0;
+  }
+}
+
+@container (max-width: 860px) {
+  .survey-workbench-embed .candidate-grid,
+  .survey-workbench-embed .focus-values,
+  .survey-workbench-embed .preview-section-grid{
+    grid-template-columns: 1fr;
+  }
+
+  .survey-workbench-embed .candidate-grid::before{
+    display: none;
+  }
+
+  .survey-workbench-embed .candidate-card{
+    min-height: auto;
+  }
+}
+
+@container (max-width: 620px) {
+  .survey-workbench-embed .topbar .meta-grid{
+    display: none;
+  }
+
+  .survey-workbench-embed .decision-buttons,
+  .survey-workbench-embed .summary-grid,
+  .survey-workbench-embed .audit-grid{
+    grid-template-columns: 1fr;
+  }
+}
+
 @media (max-width: 560px) {
   .survey-workbench-embed .workbench{
     padding: 14px 10px 36px;

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

@@ -9,6 +9,15 @@ export interface ReviewWorkbenchSessionExport {
     readonly decisions: readonly ReviewDecision[];
     readonly results: readonly ReviewWorkbenchResult[];
 }
+export type ReviewSessionReplayIssueCode = "unknown-active-item" | "unknown-review-item" | "unknown-candidate";
+export interface ReviewSessionReplayIssue {
+    readonly code: ReviewSessionReplayIssueCode;
+    readonly eventName: string;
+    readonly sequence: number;
+    readonly reviewItemName?: string;
+    readonly candidateId?: string;
+    readonly message: string;
+}
 export interface ReviewSessionEventStore {
     load(session: ReviewQueueSessionState): readonly ReviewSessionEvent[] | undefined;
     save(session: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): void;
@@ -54,6 +63,9 @@ export interface ReviewWorkbenchResult {
 export declare function buildReviewDecisionsFromSession(session: ReviewQueueSessionState): ReviewDecision[];
 export declare function buildReviewWorkbenchResultsFromSession(session: ReviewQueueSessionState): ReviewWorkbenchResult[];
 export declare function buildReviewWorkbenchSessionExport(session: ReviewQueueSessionState, events?: readonly ReviewSessionEvent[]): ReviewWorkbenchSessionExport;
+export declare function validateReviewSessionEventsForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): ReviewSessionReplayIssue[];
+export declare function replayReviewSessionEventsForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): ReviewQueueSessionState;
+export declare function buildReviewWorkbenchSessionExportForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): ReviewWorkbenchSessionExport;
 export declare function createInMemoryReviewSessionEventStore(initialEvents?: readonly ReviewSessionEvent[]): ReviewSessionEventStore & {
     events(): readonly ReviewSessionEvent[];
 };

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

@@ -89,6 +89,60 @@ export function buildReviewWorkbenchSessionExport(session, events = buildReviewS
         results: buildReviewWorkbenchResultsFromSession(session),
     };
 }
+export function validateReviewSessionEventsForSnapshot(snapshot, events) {
+    const itemsByName = new Map(snapshot.items.map((item) => [item.metadata.name, item]));
+    return events.flatMap((event) => {
+        const issues = [];
+        const activeItemName = event.spec.activeItemName;
+        const reviewItemName = event.spec.reviewItemName;
+        const itemName = reviewItemName ?? activeItemName;
+        const eventRef = {
+            eventName: event.metadata.name,
+            sequence: event.spec.sequence,
+        };
+        if (activeItemName && !itemsByName.has(activeItemName)) {
+            issues.push({
+                ...eventRef,
+                code: "unknown-active-item",
+                reviewItemName: activeItemName,
+                message: `ReviewSessionEvent ${event.metadata.name} references active item ${activeItemName}, but the supplied session snapshot does not contain that ReviewItem.`,
+            });
+        }
+        if (reviewItemName && !itemsByName.has(reviewItemName)) {
+            issues.push({
+                ...eventRef,
+                code: "unknown-review-item",
+                reviewItemName,
+                message: `ReviewSessionEvent ${event.metadata.name} references review item ${reviewItemName}, but the supplied session snapshot does not contain that ReviewItem.`,
+            });
+        }
+        if (event.spec.candidateId && itemName && itemsByName.has(itemName)) {
+            const item = itemsByName.get(itemName);
+            const hasCandidate = item?.spec.candidates.some((candidate) => candidate.id === event.spec.candidateId);
+            if (!hasCandidate) {
+                issues.push({
+                    ...eventRef,
+                    code: "unknown-candidate",
+                    reviewItemName: itemName,
+                    candidateId: event.spec.candidateId,
+                    message: `ReviewSessionEvent ${event.metadata.name} references candidate ${event.spec.candidateId}, but ReviewItem ${itemName} in the supplied session snapshot does not contain that candidate.`,
+                });
+            }
+        }
+        return issues;
+    });
+}
+export function replayReviewSessionEventsForSnapshot(snapshot, events) {
+    const issues = validateReviewSessionEventsForSnapshot(snapshot, events);
+    if (issues.length > 0) {
+        throw new Error(`Review session events do not match the supplied session snapshot: ${issues.map((issue) => issue.message).join(" ")}`);
+    }
+    return replayReviewSessionEvents(snapshot, events);
+}
+export function buildReviewWorkbenchSessionExportForSnapshot(snapshot, events) {
+    const replayedSession = replayReviewSessionEventsForSnapshot(snapshot, events);
+    return buildReviewWorkbenchSessionExport(replayedSession, events);
+}
 export function createInMemoryReviewSessionEventStore(initialEvents = []) {
     let savedEvents = [...initialEvents];
     return {

package/dist/src/review-workbench/review-workbench.standalone.css

@@ -78,6 +78,7 @@ p {
 .workbench {
   position: relative;
   z-index: 1;
+  container-type: inline-size;
   min-height: 100vh;
   padding: 30px 26px 60px;
 }
@@ -86,7 +87,7 @@ p {
   display: grid;
   grid-template-rows: auto minmax(0, 1fr);
   gap: 22px;
-  max-width: 1280px;
+  max-width: 1360px;
   margin: 0 auto;
 }
 
@@ -206,7 +207,7 @@ h1 {
 
 .queue-layout {
   display: grid;
-  grid-template-columns: 300px minmax(0, 1fr);
+  grid-template-columns: 280px minmax(0, 1fr);
   gap: 22px;
   align-items: start;
 }
@@ -483,10 +484,11 @@ h1 {
 
 .content-grid {
   display: grid;
-  grid-template-columns: minmax(0, 1fr) minmax(360px, 440px);
+  grid-template-columns: minmax(0, 1fr);
   grid-template-areas:
-    "focus decision"
-    "candidates decision";
+    "focus"
+    "decision"
+    "candidates";
   gap: 22px;
   align-items: start;
 }
@@ -621,7 +623,7 @@ h1 {
   display: grid;
   grid-template-rows: auto auto minmax(0, 1fr);
   gap: 16px;
-  min-height: 560px;
+  min-height: 460px;
   padding: 20px;
   position: relative;
   overflow: hidden;
@@ -763,6 +765,7 @@ h1 {
 .decision-column {
   grid-area: decision;
   display: grid;
+  grid-template-columns: minmax(0, 1fr);
   gap: 18px;
   animation: rise 0.6s cubic-bezier(0.22, 1, 0.36, 1) both;
   animation-delay: 0.15s;
@@ -915,7 +918,7 @@ textarea:focus {
 
 .preview-section-grid {
   display: grid;
-  grid-template-columns: minmax(0, 1fr);
+  grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 10px;
 }
 
@@ -1118,6 +1121,69 @@ pre {
   }
 }
 
+@container (max-width: 1100px) {
+  .topbar,
+  .queue-layout,
+  .focus-evidence {
+    grid-template-columns: 1fr;
+  }
+
+  .queue-layout {
+    grid-template-areas:
+      "content"
+      "queue";
+  }
+
+  .queue-panel {
+    grid-area: queue;
+    position: static;
+  }
+
+  .content-grid {
+    grid-area: content;
+    grid-template-columns: 1fr;
+    grid-template-areas:
+      "focus"
+      "decision"
+      "candidates";
+  }
+
+  .content-grid,
+  .review-main,
+  .candidate-grid,
+  .decision-column {
+    min-width: 0;
+  }
+}
+
+@container (max-width: 860px) {
+  .candidate-grid,
+  .focus-values,
+  .preview-section-grid {
+    grid-template-columns: 1fr;
+  }
+
+  .candidate-grid::before {
+    display: none;
+  }
+
+  .candidate-card {
+    min-height: auto;
+  }
+}
+
+@container (max-width: 620px) {
+  .topbar .meta-grid {
+    display: none;
+  }
+
+  .decision-buttons,
+  .summary-grid,
+  .audit-grid {
+    grid-template-columns: 1fr;
+  }
+}
+
 @media (max-width: 560px) {
   .workbench {
     padding: 14px 10px 36px;

package/package.json

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