@kontourai/survey 6.1.0 → 7.0.0

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

@@ -832,6 +832,100 @@
   font-size: 12px;
 }
 
+/* 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;

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;
 /**