@kontourai/survey 6.0.0 → 7.0.0

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

@@ -1,4 +1,4 @@
-import { candidateForDecision, decisionSelectsNoCandidate, isClearedWorkbenchDecisionEvent, workbenchDecisionDefinitions, } from "./review-queue-session.js";
+import { candidateForDecision, conflictSelectionIssue, decisionSelectsNoCandidate, isClearedWorkbenchDecisionEvent, workbenchDecisionDefinitions, } from "./review-queue-session.js";
 import { checkEditedValueForItem } from "./edited-value.js";
 export function validateReviewSessionEventsForSnapshot(snapshot, events) {
     const itemsByName = new Map(snapshot.items.map((item) => [item.metadata.name, item]));
@@ -53,6 +53,40 @@ export function validateReviewSessionEventsForSnapshot(snapshot, events) {
                     message: `ReviewSessionEvent ${event.metadata.name} is a decision event but does not include a replayable workbench decision.`,
                 });
             }
+            else if (itemName && itemsByName.has(itemName) && decision === "select-proposed") {
+                // The event's candidateId is the choice; it must name one proposed
+                // candidate of an item that holds a conflict.
+                const item = itemsByName.get(itemName);
+                const selectionIssue = conflictSelectionIssue(item, event.spec.candidateId);
+                if (selectionIssue) {
+                    issues.push({
+                        ...eventRef,
+                        code: "invalid-conflict-selection",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name}: ${selectionIssue}`,
+                    });
+                }
+                const expectedStatus = workbenchDecisionDefinitions[decision].status;
+                if (event.spec.status !== expectedStatus) {
+                    issues.push({
+                        ...eventRef,
+                        code: "decision-status-mismatch",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects status ${expectedStatus}, but references ${event.spec.status ?? "no status"}.`,
+                    });
+                }
+                if (event.spec.resolution !== undefined) {
+                    issues.push({
+                        ...eventRef,
+                        code: "decision-resolution-mismatch",
+                        reviewItemName: itemName,
+                        candidateId: event.spec.candidateId,
+                        message: `ReviewSessionEvent ${event.metadata.name} decision ${decision} expects resolution none, but references ${event.spec.resolution}.`,
+                    });
+                }
+            }
             else if (itemName && itemsByName.has(itemName)) {
                 const item = itemsByName.get(itemName);
                 const expectedCandidate = item ? candidateForDecision(item, decision) : undefined;

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

@@ -835,7 +835,102 @@ export const REVIEW_WORKBENCH_CSS = `/* Bundled, scoped Survey Review Workbench
   font-size: 12px;
 }
 
-.survey-workbench-embed .excerpt-verification{
+/* A queue that came from an extraction import but was not checked against
+   it (unverified), or that does not match it (diverges, shown instead of the
+   queue). */
+.survey-workbench-embed .queue-attestation{
+  display: flex;
+  align-items: flex-start;
+  gap: var(--k-space-2);
+  margin: 0 0 var(--k-space-3);
+  padding: var(--k-space-2) var(--k-space-3);
+  border-radius: 9px;
+  font-size: 13px;
+  line-height: 1.45;
+  color: var(--k-caution);
+  background: var(--k-caution-wash);
+}
+
+.survey-workbench-embed .queue-attestation svg{
+  flex: none;
+  margin-top: 2px;
+}
+
+.survey-workbench-embed .queue-attestation.diverges{
+  color: var(--k-negative);
+  background: var(--k-negative-wash);
+}
+
+/* Conflicting proposed values: each value is listed with its own choice
+   control until the field is decided, then marked chosen or not chosen. */
+.survey-workbench-embed .conflict-values ul{
+  list-style: none;
+  margin: var(--k-space-2) 0 0;
+  padding: 0;
+  display: grid;
+  gap: var(--k-space-2);
+}
+
+.survey-workbench-embed .conflict-values li{
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--k-space-3);
+  flex-wrap: wrap;
+  padding: var(--k-space-2) var(--k-space-3);
+  border: 1px solid var(--k-line);
+  border-radius: 9px;
+}
+
+.survey-workbench-embed .conflict-values li[data-chosen="true"]{
+  border-color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .conflict-values .conflict-text{
+  display: inline-flex;
+  align-items: baseline;
+  gap: var(--k-space-2);
+  flex-wrap: wrap;
+  min-width: 0;
+}
+
+.survey-workbench-embed .conflict-values .vtext{
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values q{
+  color: var(--k-muted);
+  font-size: 12.5px;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values .btn.choose{
+  min-height: 36px;
+  padding: 0 14px;
+  font-size: 13px;
+}
+
+.survey-workbench-embed .choice-tag{
+  font-size: 12px;
+  font-weight: 600;
+  padding: 2px 8px;
+  border-radius: 999px;
+}
+
+.survey-workbench-embed .choice-tag.chosen{
+  color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .choice-tag.not-chosen{
+  color: var(--k-muted);
+  background: var(--k-sunken);
+}
+
+.survey-workbench-embed .excerpt-verification,
+.survey-workbench-embed .support-verification{
   margin: 0;
   font-size: 12px;
   color: var(--k-muted);

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

@@ -34,6 +34,7 @@
  */
 import { type ReviewQueueSessionState, type ReviewWorkbenchState } from "./review-workbench.js";
 import type { ReviewPresentationAdapter } from "./review-presentation.js";
+import type { ExtractionEnvelopeImport, ExtractionEnvelopeImportResult } from "../extraction-envelope.js";
 import { type ExtractionInspectorInput } from "./extraction-inspector.js";
 export declare class SurveyReviewWorkbenchElement extends HTMLElement {
     #private;
@@ -45,6 +46,15 @@ export declare class SurveyReviewWorkbenchElement extends HTMLElement {
     /** Optional presentation adapter for custom labels, value summaries, and links. */
     get presentationAdapter(): ReviewPresentationAdapter | undefined;
     set presentationAdapter(value: ReviewPresentationAdapter | undefined);
+    /**
+     * The extraction import record the queue was built from, as stored beside
+     * it. The workbench checks the queue against it (see
+     * `MountReviewWorkbenchOptions.extractionImport`). When unset, the import of
+     * a single-import `extractionInspector` is used; with neither, a queue whose
+     * items came from an extraction import shows an "Unverified queue" notice.
+     */
+    get extractionImport(): ExtractionEnvelopeImport | ExtractionEnvelopeImportResult | null;
+    set extractionImport(value: ExtractionEnvelopeImport | ExtractionEnvelopeImportResult | null | undefined);
     /** Optional read-only source pane attached to this workbench's existing review lifecycle. */
     get extractionInspector(): ExtractionInspectorInput | null;
     set extractionInspector(value: ExtractionInspectorInput | null | undefined);

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

@@ -169,6 +169,7 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
     #session = null;
     #presentationAdapter = undefined;
     #extractionInspector = null;
+    #extractionImport = null;
     #unmountInspector;
     #root;
     #mountRoot;
@@ -340,6 +341,18 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
         this.#presentationAdapter = value;
         this.#remount();
     }
+    /**
+     * The extraction import record the queue was built from, as stored beside
+     * it. The workbench checks the queue against it (see
+     * `MountReviewWorkbenchOptions.extractionImport`). When unset, the import of
+     * a single-import `extractionInspector` is used; with neither, a queue whose
+     * items came from an extraction import shows an "Unverified queue" notice.
+     */
+    get extractionImport() { return this.#extractionImport; }
+    set extractionImport(value) {
+        this.#extractionImport = value ?? null;
+        this.#remount();
+    }
     /** Optional read-only source pane attached to this workbench's existing review lifecycle. */
     get extractionInspector() { return this.#extractionInspector; }
     set extractionInspector(value) {
@@ -423,9 +436,14 @@ export class SurveyReviewWorkbenchElement extends HTMLElement {
             this.#renderEmpty();
             return;
         }
-        const options = this.#presentationAdapter
-            ? { presentationAdapter: this.#presentationAdapter }
-            : {};
+        const inspectorImport = this.#extractionInspector && !("imports" in this.#extractionInspector)
+            ? this.#extractionInspector.importResult
+            : undefined;
+        const extractionImport = this.#extractionImport ?? inspectorImport;
+        const options = {
+            ...(this.#presentationAdapter ? { presentationAdapter: this.#presentationAdapter } : {}),
+            ...(extractionImport ? { extractionImport } : {}),
+        };
         this.#applyThemeClasses();
         mountReviewWorkbench(this.#mountRoot, this.#session, options);
         this.#unmountInspector?.();

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

@@ -832,7 +832,102 @@
   font-size: 12px;
 }
 
-.survey-workbench-embed .excerpt-verification{
+/* A queue that came from an extraction import but was not checked against
+   it (unverified), or that does not match it (diverges, shown instead of the
+   queue). */
+.survey-workbench-embed .queue-attestation{
+  display: flex;
+  align-items: flex-start;
+  gap: var(--k-space-2);
+  margin: 0 0 var(--k-space-3);
+  padding: var(--k-space-2) var(--k-space-3);
+  border-radius: 9px;
+  font-size: 13px;
+  line-height: 1.45;
+  color: var(--k-caution);
+  background: var(--k-caution-wash);
+}
+
+.survey-workbench-embed .queue-attestation svg{
+  flex: none;
+  margin-top: 2px;
+}
+
+.survey-workbench-embed .queue-attestation.diverges{
+  color: var(--k-negative);
+  background: var(--k-negative-wash);
+}
+
+/* Conflicting proposed values: each value is listed with its own choice
+   control until the field is decided, then marked chosen or not chosen. */
+.survey-workbench-embed .conflict-values ul{
+  list-style: none;
+  margin: var(--k-space-2) 0 0;
+  padding: 0;
+  display: grid;
+  gap: var(--k-space-2);
+}
+
+.survey-workbench-embed .conflict-values li{
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: var(--k-space-3);
+  flex-wrap: wrap;
+  padding: var(--k-space-2) var(--k-space-3);
+  border: 1px solid var(--k-line);
+  border-radius: 9px;
+}
+
+.survey-workbench-embed .conflict-values li[data-chosen="true"]{
+  border-color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .conflict-values .conflict-text{
+  display: inline-flex;
+  align-items: baseline;
+  gap: var(--k-space-2);
+  flex-wrap: wrap;
+  min-width: 0;
+}
+
+.survey-workbench-embed .conflict-values .vtext{
+  font-weight: 600;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values q{
+  color: var(--k-muted);
+  font-size: 12.5px;
+  overflow-wrap: anywhere;
+}
+
+.survey-workbench-embed .conflict-values .btn.choose{
+  min-height: 36px;
+  padding: 0 14px;
+  font-size: 13px;
+}
+
+.survey-workbench-embed .choice-tag{
+  font-size: 12px;
+  font-weight: 600;
+  padding: 2px 8px;
+  border-radius: 999px;
+}
+
+.survey-workbench-embed .choice-tag.chosen{
+  color: var(--k-positive);
+  background: var(--k-positive-wash);
+}
+
+.survey-workbench-embed .choice-tag.not-chosen{
+  color: var(--k-muted);
+  background: var(--k-sunken);
+}
+
+.survey-workbench-embed .excerpt-verification,
+.survey-workbench-embed .support-verification{
   margin: 0;
   font-size: 12px;
   color: var(--k-muted);

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

@@ -2,16 +2,25 @@ import { type ReviewQueueSessionState, type ReviewWorkbenchDecision, type Review
 import { type ReviewSessionReplayIssue, type ReviewSessionReplayWarning } from "./review-session-replay.js";
 import { type ReviewPresentationAdapter } from "./review-presentation.js";
 import { type ReviewCandidate, type ReviewDecision, type ReviewItem, type ReviewSession, type ReviewSessionEvent, type ReviewValueDescriptor } from "../review-resource.js";
+import type { ExtractionEnvelopeImport, ExtractionEnvelopeImportResult } from "../extraction-envelope.js";
 export { reviewAuditRowKeys, type ReviewAuditRowKey } from "./audit-rows.js";
-export { assertReviewQueueAgainstExtractionImport, assertReviewQueueBinding, bindReviewQueue, hashReviewQueueSnapshot, UnattestedExtractionQueueError, UnattestedReviewQueueError, validateReviewQueueAgainstExtractionImport, validateReviewQueueBinding, type BindReviewQueueOptions, type ReviewQueueBinding, type ReviewQueueBindingIssue, type ReviewQueueBindingIssueCode, type ReviewQueueExtractionIssue, type ReviewQueueExtractionIssueCode, type ValidateReviewQueueBindingOptions, } from "./queue-binding.js";
+export { assertReviewQueueAgainstExtractionImport, assertReviewQueueBinding, attestReviewQueueExtraction, bindReviewQueue, reviewItemCarriesExtractionBinding, unverifiedExtractionQueueSentence, hashReviewQueueSnapshot, UnattestedExtractionQueueError, UnattestedReviewQueueError, validateReviewQueueAgainstExtractionImport, validateReviewQueueBinding, type BindReviewQueueOptions, type ReviewQueueBinding, type ReviewQueueBindingIssue, type ReviewQueueBindingIssueCode, type ReviewQueueExtractionAttestation, type ReviewQueueExtractionIssue, type ReviewQueueExtractionIssueCode, type ValidateReviewQueueBindingOptions, } from "./queue-binding.js";
 export { buildExtractionInspectorModel, exportExtractionInspector, filterExtractionInspectorCandidates, mountExtractionInspector, type ExtractionAlignmentState, type ArtifactUnavailableCode, type BuiltExtractionInspectorCandidate, type BuiltExtractionInspectorModel, type ExtractionInspectorCandidate, type ExtractionInspectorEntry, type ExtractionInspectorExportOptions, type ExtractionInspectorFilters, type ExtractionInspectorInput, type ExtractionInspectorMountOptions, type ExtractionInspectorModel, type ExtractionInspectorSource, type ResolvedExtractionArtifact, } from "./extraction-inspector.js";
-export { buildReviewSessionEvents, buildReviewSessionEvent, buildReviewSessionResource, candidateForDecision, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, currentReviewItem, currentReviewWorkbenchState, defaultReviewSessionName, deriveQueueRowStatus, initialReviewQueueSessionState, initialReviewWorkbenchState, nextUnresolvedItemName, replayReviewSessionEvents, reviewSessionSummary, reviewWorkbenchSessionStorageKey, selectedCandidateRole, workbenchDecisionDefinitions, type ReviewQueueRowStatus, type ReviewQueueSessionState, type ReviewSessionSummary, type ReviewWorkbenchDecision, type ReviewWorkbenchState, } from "./review-queue-session.js";
-export { buildReviewCandidatePresentation, buildReviewItemPresentation, buildReviewResultPresentation, humanizeIdentifier, type ReviewCandidatePresentation, type ReviewCandidatePresentationContext, type ReviewItemPresentation, type ReviewItemPresentationContext, type ReviewPresentationAdapter, type ReviewPresentationLink, type ReviewResultPresentation, type ReviewTracePresentationContext, type ReviewTraceRef, type ReviewValuePresentationContext, } from "./review-presentation.js";
+export { buildReviewSessionEvents, buildReviewSessionEvent, buildReviewSessionResource, candidateForDecision, conflictSelectionIssue, unchosenProposedCandidates, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, currentReviewItem, currentReviewWorkbenchState, defaultReviewSessionName, deriveQueueRowStatus, initialReviewQueueSessionState, initialReviewWorkbenchState, nextUnresolvedItemName, replayReviewSessionEvents, reviewSessionSummary, reviewWorkbenchSessionStorageKey, selectedCandidateRole, workbenchDecisionDefinitions, type ReviewQueueRowStatus, type ReviewQueueSessionState, type ReviewSessionSummary, type ReviewWorkbenchDecision, type ReviewWorkbenchState, } from "./review-queue-session.js";
+export { buildReviewCandidatePresentation, buildReviewItemPresentation, buildReviewResultPresentation, humanizeIdentifier, type ExcludedProposalPresentation, type ExcludedProposalsUnreadable, type ReviewCandidatePresentation, type ReviewCandidatePresentationContext, type ReviewItemPresentation, type ReviewItemPresentationContext, type ReviewPresentationAdapter, type ReviewPresentationLink, type ReviewResultPresentation, type ReviewTracePresentationContext, type ReviewTraceRef, type ReviewValuePresentationContext, } from "./review-presentation.js";
 export { buildSurfaceProjectionPreview, type PreviewAuthorityTrace, type PreviewCandidateHistory, type PreviewClaim, type PreviewIntegrityPosture, type PreviewReviewEvent, type PreviewSourceAuthority, type PreviewSourceEvidence, type SurfaceProjectionPreview, } from "./review-surface-preview.js";
 export { reviewSessionReplayWarningsForSnapshot, validateReviewSessionEventsForSnapshot, type ReviewSessionReplayIssue, type ReviewSessionReplayIssueCode, type ReviewSessionReplayWarning, } from "./review-session-replay.js";
 export { checkEditedValueForItem, editedValueFromEditorText, type EditedValueCheck, } from "./edited-value.js";
 export { assertReviewDecisionModeAllows, DecisionModeViolationError, validateReviewDecisionMode, type ReviewDecisionModeIssue, type ReviewDecisionModeIssueCode, type ReviewDecisionModeResult, } from "./producer-decision-mode.js";
-export declare function buildReviewDecision(state: ReviewWorkbenchState): ReviewDecision | undefined;
+/**
+ * Options for building review decisions. The decision prompt is rendered from
+ * the item when the decision is built, so pass the same presentation adapter
+ * the card used, or the recorded prompt renders values its own way.
+ */
+export interface ReviewDecisionBuildOptions {
+    readonly presentationAdapter?: ReviewPresentationAdapter;
+}
+export declare function buildReviewDecision(state: ReviewWorkbenchState, options?: ReviewDecisionBuildOptions): ReviewDecision | undefined;
 export interface ReviewWorkbenchSessionExport {
     readonly session: ReviewSession;
     readonly events: readonly ReviewSessionEvent[];
@@ -31,6 +40,8 @@ export interface DeriveReviewSessionApplyResultForSnapshotOptions {
     readonly snapshot: ReviewQueueSessionState;
     readonly events: readonly ReviewSessionEvent[];
     readonly requiredResolvedItems?: ReviewSessionApplyResolutionRequirement;
+    /** The adapter the reviewer's card used; the recorded decision prompts render values with it. */
+    readonly presentationAdapter?: ReviewPresentationAdapter;
 }
 export type DeriveReviewSessionApplyResultForSnapshotResult = {
     readonly ok: true;
@@ -89,6 +100,13 @@ export interface PersistentReviewSessionEventStoreOptions {
 export interface MountReviewWorkbenchOptions {
     readonly eventStore?: ReviewSessionEventStore;
     readonly presentationAdapter?: ReviewPresentationAdapter;
+    /**
+     * The extraction import record the queue was built from, as stored beside
+     * it. When supplied, the workbench checks the queue against it and refuses to
+     * present a queue that diverges. When absent and the queue's items came from
+     * an extraction import, the workbench shows an "Unverified queue" notice.
+     */
+    readonly extractionImport?: ExtractionEnvelopeImport | ExtractionEnvelopeImportResult;
     /** Maximum review cards mounted at once. Defaults to 50 and is capped at 250. */
     readonly pageSize?: number;
 }
@@ -189,15 +207,15 @@ export interface MapReviewWorkbenchResultsToApplyActionsOptions<TAction> {
     readonly skip?: (context: ReviewApplyActionContext) => boolean;
     readonly map: (context: ReviewApplyActionContext) => TAction | readonly TAction[] | undefined;
 }
-export declare function buildReviewDecisionsFromSession(session: ReviewQueueSessionState): ReviewDecision[];
+export declare function buildReviewDecisionsFromSession(session: ReviewQueueSessionState, options?: ReviewDecisionBuildOptions): ReviewDecision[];
 export declare function requireReviewResultForItem(item: ReviewItem, results: readonly ReviewWorkbenchResult[]): ReviewWorkbenchResult;
 export declare function assertReviewResultMatches(result: ReviewWorkbenchResult, expectation: ReviewApplyResultExpectation): void;
 export declare function mapReviewWorkbenchResultsToApplyActions<TAction>(options: MapReviewWorkbenchResultsToApplyActionsOptions<TAction>): ReviewApplyActionMapping<TAction>[];
 export declare const mapReviewApplyActions: typeof mapReviewWorkbenchResultsToApplyActions;
-export declare function buildReviewWorkbenchResultsFromSession(session: ReviewQueueSessionState): ReviewWorkbenchResult[];
-export declare function buildReviewWorkbenchSessionExport(session: ReviewQueueSessionState, events?: readonly ReviewSessionEvent[]): ReviewWorkbenchSessionExport;
+export declare function buildReviewWorkbenchResultsFromSession(session: ReviewQueueSessionState, options?: ReviewDecisionBuildOptions): ReviewWorkbenchResult[];
+export declare function buildReviewWorkbenchSessionExport(session: ReviewQueueSessionState, events?: readonly ReviewSessionEvent[], options?: ReviewDecisionBuildOptions): ReviewWorkbenchSessionExport;
 export declare function replayReviewSessionEventsForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): ReviewQueueSessionState;
-export declare function buildReviewWorkbenchSessionExportForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[]): ReviewWorkbenchSessionExport;
+export declare function buildReviewWorkbenchSessionExportForSnapshot(snapshot: ReviewQueueSessionState, events: readonly ReviewSessionEvent[], options?: ReviewDecisionBuildOptions): ReviewWorkbenchSessionExport;
 export declare function deriveReviewSessionApplyResultForSnapshot(options: DeriveReviewSessionApplyResultForSnapshotOptions): DeriveReviewSessionApplyResultForSnapshotResult;
 export declare function createInMemoryReviewSessionEventStore(initialEvents?: readonly ReviewSessionEvent[]): ReviewSessionEventStore & {
     events(): readonly ReviewSessionEvent[];
@@ -210,6 +228,8 @@ export declare function createPersistentReviewSessionEventStore(options: Persist
 export declare function renderReviewWorkbenchHtml(state: ReviewWorkbenchState | ReviewQueueSessionState, _events?: readonly ReviewSessionEvent[], options?: {
     readonly presentationAdapter?: ReviewPresentationAdapter;
     readonly queueView?: Partial<ReviewQueueView>;
+    /** See {@link MountReviewWorkbenchOptions.extractionImport}. */
+    readonly extractionImport?: ExtractionEnvelopeImport | ExtractionEnvelopeImportResult;
 }): string;
 export declare function buildReviewQueueWindow(session: ReviewQueueSessionState, view?: Partial<ReviewQueueView>): ReviewQueueWindow;
 /**