@kontourai/survey 7.0.0 → 8.1.0

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

@@ -1,6 +1,6 @@
 import { canonicalJson } from "./canonical.js";
 import { assertReviewResolutionConsistency } from "../producer-discipline.js";
-import { candidateForDecision, conflictSelectionIssue, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, unchosenProposedCandidates, buildReviewSessionEvent, buildReviewSessionEvents, buildReviewSessionResource, currentReviewWorkbenchState, defaultReviewSessionName, effectiveValueForDecision, initialReviewQueueSessionState, replayReviewSessionEvents, reviewWorkbenchSessionStorageKey, workbenchDecisionDefinitions, } from "./review-queue-session.js";
+import { candidateForDecision, conflictSelectionIssue, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, unchosenProposedCandidates, buildReviewSessionEvent, buildReviewSessionEvents, buildReviewSessionResource, currentReviewWorkbenchState, defaultReviewSessionName, effectiveValueForDecision, initialReviewQueueSessionState, isScoreBlind, assertReviewSessionConditions, sessionConditionsStamp, replayReviewSessionEvents, reviewWorkbenchSessionStorageKey, workbenchDecisionDefinitions, } from "./review-queue-session.js";
 import { reviewSessionReplayWarningsForSnapshot, validateReviewSessionEventsForSnapshot, } from "./review-session-replay.js";
 import { buildSurfaceProjectionPreview, formatValue, } from "./review-surface-preview.js";
 import { buildReviewCandidatePresentation, buildReviewItemPresentation, } from "./review-presentation.js";
@@ -9,11 +9,14 @@ import { validateAuthorizing, buildAuthorizedActionAuthorizing } from "../review
 import { attestReviewQueueExtraction } from "./queue-binding.js";
 import { candidateVerificationNotes, excludedProposalsSentence, excludedProposalsUnreadableSentence } from "./review-presentation.js";
 import { editedValueFromEditorText, isIsoCalendarDate, parsePlainDecimal } from "./edited-value.js";
+import { renderFieldStatesHtml } from "./field-state-view.js";
 import { createAuditFactTrace, } from "./audit-rows.js";
 export { reviewAuditRowKeys } from "./audit-rows.js";
 export { assertReviewQueueAgainstExtractionImport, assertReviewQueueBinding, attestReviewQueueExtraction, bindReviewQueue, reviewItemCarriesExtractionBinding, unverifiedExtractionQueueSentence, hashReviewQueueSnapshot, UnattestedExtractionQueueError, UnattestedReviewQueueError, validateReviewQueueAgainstExtractionImport, validateReviewQueueBinding, } from "./queue-binding.js";
 export { buildExtractionInspectorModel, exportExtractionInspector, filterExtractionInspectorCandidates, mountExtractionInspector, } from "./extraction-inspector.js";
-export { buildReviewSessionEvents, buildReviewSessionEvent, buildReviewSessionResource, candidateForDecision, conflictSelectionIssue, unchosenProposedCandidates, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, currentReviewItem, currentReviewWorkbenchState, defaultReviewSessionName, deriveQueueRowStatus, initialReviewQueueSessionState, initialReviewWorkbenchState, nextUnresolvedItemName, replayReviewSessionEvents, reviewSessionSummary, reviewWorkbenchSessionStorageKey, selectedCandidateRole, workbenchDecisionDefinitions, } from "./review-queue-session.js";
+export { renderFieldStatesHtml } from "./field-state-view.js";
+export { drawRandomAuditSample, openRandomAuditSession, } from "./audit-sample.js";
+export { buildReviewSessionEvents, buildReviewSessionEvent, buildReviewSessionResource, candidateForDecision, conflictSelectionIssue, unchosenProposedCandidates, decisionCandidateId, decisionSelectsNoCandidate, keepActionDecision, currentReviewItem, currentReviewWorkbenchState, defaultReviewSessionName, deriveQueueRowStatus, initialReviewQueueSessionState, initialReviewWorkbenchState, isScoreBlind, assertReviewSessionConditions, nextUnresolvedItemName, replayReviewSessionEvents, reviewSessionSummary, reviewWorkbenchSessionStorageKey, selectedCandidateRole, workbenchDecisionDefinitions, } from "./review-queue-session.js";
 export { buildReviewCandidatePresentation, buildReviewItemPresentation, buildReviewResultPresentation, humanizeIdentifier, } from "./review-presentation.js";
 export { buildSurfaceProjectionPreview, } from "./review-surface-preview.js";
 export { reviewSessionReplayWarningsForSnapshot, validateReviewSessionEventsForSnapshot, } from "./review-session-replay.js";
@@ -24,6 +27,7 @@ export function buildReviewDecision(state, options = {}) {
         return undefined;
     }
     const definition = workbenchDecisionDefinitions[state.decision];
+    assertReviewSessionConditions(state);
     if (state.decision === "could-not-confirm" && !state.note.trim()) {
         throw new Error("Could not confirm requires a non-empty reason.");
     }
@@ -70,6 +74,10 @@ export function buildReviewDecision(state, options = {}) {
                 : {}),
             // A choice between conflicting values records the rivals it passed over.
             ...(unchosen.length ? { unselectedCandidateIds: unchosen.map((entry) => entry.id) } : {}),
+            // The session's conditions, never the reviewer's: a score-blind session
+            // records that the decision was made without scores on screen.
+            ...(state.presentation !== undefined ? { presentation: { scoreBlind: state.presentation.scoreBlind } } : {}),
+            ...(state.sampling !== undefined ? { sampling: { ...state.sampling } } : {}),
         },
         status: {
             ...(candidateProjection?.claimId ? { appliedToClaimIds: [candidateProjection.claimId] } : {}),
@@ -140,7 +148,8 @@ function decisionCardRenderedPrompt(state, presentation, adapter) {
     const excluded = excludedProposalsSentence(presentation.excludedProposals);
     const unreadable = excludedProposalsUnreadableSentence(presentation.excludedProposalsUnreadable);
     // Likewise the verifier records the card shows, read against the same value.
-    const verification = candidateVerificationNotes(state.item, state.decision === "accept-proposed" ? state.editedValue : undefined).map((note) => note.sentence);
+    // A score-blind card shows no verifier result, so the recorded prompt names none.
+    const verification = isScoreBlind(state) ? [] : candidateVerificationNotes(state.item, state.decision === "accept-proposed" ? state.editedValue : undefined).map((note) => note.sentence);
     return [decisionCardBasePrompt(state, presentation.targetLabel, adapter), ...(excluded ? [excluded] : []), ...(unreadable ? [unreadable] : []), ...verification].join(" ");
 }
 function decisionCardBasePrompt(state, targetLabel, adapter) {
@@ -514,7 +523,7 @@ export function createPersistentReviewSessionEventStore(options) {
 }
 export function renderReviewWorkbenchHtml(state, _events, options = {}) {
     const session = queueSessionFromStartState(state);
-    return renderReviewQueueSessionHtml(session, options.presentationAdapter, normalizeReviewQueueView(options.queueView), attestReviewQueueExtraction(session.items, options.extractionImport));
+    return renderReviewQueueSessionHtml(session, options.presentationAdapter, normalizeReviewQueueView(options.queueView), attestReviewQueueExtraction(session.items, options.extractionImport), options.fieldStates);
 }
 /**
  * The visual/decision state of a field card, derived from the reviewer's local
@@ -602,7 +611,7 @@ function isEmptyValue(value) {
 }
 const ARROW_SVG = "<svg width=\"20\" height=\"20\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" aria-hidden=\"true\"><path d=\"M5 12h14M13 6l6 6-6 6\"/></svg>";
 const WARNING_SVG = "<svg width=\"15\" height=\"15\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" aria-hidden=\"true\"><path d=\"M12 9v4M12 17h.01\"/><path d=\"M10.3 3.9 1.8 18a2 2 0 0 0 1.7 3h17a2 2 0 0 0 1.7-3L13.7 3.9a2 2 0 0 0-3.4 0Z\"/></svg>";
-function renderReviewQueueSessionHtml(session, presentationAdapter, queueView, attestation) {
+function renderReviewQueueSessionHtml(session, presentationAdapter, queueView, attestation, fieldStates) {
     // A queue that does not match its stored extraction import is not reviewed:
     // its items could hide or alter what the source said.
     if (attestation.state === "diverges") {
@@ -625,6 +634,9 @@ function renderReviewQueueSessionHtml(session, presentationAdapter, queueView, a
       ${attestation.state === "unverified"
         ? `<div class="queue-attestation unverified" data-testid="queue-attestation" data-state="unverified" role="note">${WARNING_SVG}<span>${escapeHtml(attestation.message)}</span></div>`
         : ""}
+      ${isScoreBlind(session)
+        ? `<div class="queue-attestation score-blind" data-testid="score-blind-notice" data-sampling="${escapeHtml(session.sampling?.kind ?? "")}" role="note"><span>${escapeHtml(scoreBlindNotice(session))}</span></div>`
+        : ""}
       <header class="rhead">
         <div class="top">
           <div class="subj">
@@ -641,6 +653,7 @@ function renderReviewQueueSessionHtml(session, presentationAdapter, queueView, a
           <button class="apply" type="button" data-testid="apply-button"${decidedCount === 0 ? " disabled" : ""}>Apply ${decidedCount} decision${decidedCount === 1 ? "" : "s"}</button>
         </div>
       </header>
+      ${fieldStates ? renderFieldStatesHtml(fieldStates, session) : ""}
       <nav class="queue-controls" aria-label="Review queue navigation">
         <label>
           <span>Find fields</span>
@@ -730,9 +743,9 @@ function renderFieldCard(item, session, presentationAdapter) {
         : proposedCandidates.length > 1
             ? renderConflictingProposals(item, proposedCandidates, presentationAdapter, presentation.targetLabel, decision, session.selectedCandidateIdsByItemName?.[item.metadata.name])
             : "<p class=\"field-value\">No proposed value is available for this field.</p>"}
-        ${proposed ? renderProvenanceRow(item, proposed, presentationAdapter) : ""}
+        ${proposed ? renderProvenanceRow(item, proposed, presentationAdapter, isScoreBlind(session)) : ""}
         ${renderExtractionImportNotes(presentation)}
-        ${renderVerificationNotes(candidateVerificationNotes(item, decision === "accept-proposed" ? editedValue : undefined))}
+        ${isScoreBlind(session) ? "" : renderVerificationNotes(candidateVerificationNotes(item, decision === "accept-proposed" ? editedValue : undefined))}
         <div class="decide">
           ${keepDecision === undefined ? "" : `<button class="btn keep" type="button" data-testid="keep-current" data-item-name="${escapeHtml(item.metadata.name)}">${keepLabel}</button>`}
           ${proposed ? `<button class="btn use" type="button" data-testid="use-proposed" data-item-name="${escapeHtml(item.metadata.name)}">Use proposed</button>
@@ -955,7 +968,7 @@ export function validateProposedValue(descriptor, rawValue) {
             return undefined;
     }
 }
-function renderProvenanceRow(item, proposed, presentationAdapter) {
+function renderProvenanceRow(item, proposed, presentationAdapter, scoreBlind) {
     const excerpt = proposed.locator?.excerpt;
     if (!excerpt) {
         return `
@@ -968,7 +981,8 @@ function renderProvenanceRow(item, proposed, presentationAdapter) {
       </div>
     `;
     }
-    const confidence = proposed.extraction.confidence ?? proposed.confidence;
+    // A score-blind session never renders the proposer's confidence.
+    const confidence = scoreBlind ? undefined : proposed.extraction.confidence ?? proposed.confidence;
     const presentation = buildReviewCandidatePresentation(item, proposed, presentationAdapter);
     const sourceLinkHtml = presentation.sourceLink
         ? `<a href="${escapeHtml(presentation.sourceLink.href)}">${escapeHtml(presentation.sourceLink.label ?? presentation.sourceText)}</a>`
@@ -1064,6 +1078,8 @@ function renderAuditDetails(item, current, proposed, session, presentationAdapte
         selectedCandidateId: session.selectedCandidateIdsByItemName?.[item.metadata.name],
         reviewedAt: session.reviewedAt,
         actorId: session.actorId,
+        ...(session.presentation !== undefined ? { presentation: session.presentation } : {}),
+        ...(session.sampling !== undefined ? { sampling: session.sampling } : {}),
     };
     const reviewDecisionPayload = buildReviewDecision(state, { presentationAdapter });
     const preview = buildSurfaceProjectionPreview(item, reviewDecisionPayload, presentationAdapter);
@@ -1348,10 +1364,14 @@ function createReviewWorkbenchController(root, startState, options) {
         const attemptEvidenceIds = itemName && decision === "could-not-confirm"
             ? session.attemptEvidenceIdsByItemName?.[itemName]
             : undefined;
+        const conditions = sessionConditionsStamp(session);
         const defaultData = decision
-            ? (editedValue !== undefined
-                ? { workbenchDecision: decision, workbenchEditedValue: editedValue }
-                : { workbenchDecision: decision, ...(attemptEvidenceIds?.length ? { attemptEvidenceIds } : {}) })
+            ? {
+                ...(editedValue !== undefined
+                    ? { workbenchDecision: decision, workbenchEditedValue: editedValue }
+                    : { workbenchDecision: decision, ...(attemptEvidenceIds?.length ? { attemptEvidenceIds } : {}) }),
+                ...(conditions ? { sessionConditions: conditions } : {}),
+            }
             : undefined;
         return buildReviewSessionEvent(session, {
             sessionName: defaultReviewSessionName,
@@ -1439,7 +1459,7 @@ function createReviewWorkbenchController(root, startState, options) {
         currentSession: () => session,
         currentSessionExport: () => buildReviewWorkbenchSessionExport(session, events, { presentationAdapter: options.presentationAdapter }),
         presentationAdapter: options.presentationAdapter,
-        renderCurrentState: () => renderCurrentState(root, session, controller, options.presentationAdapter, queueView, attestation),
+        renderCurrentState: () => renderCurrentState(root, session, controller, options.presentationAdapter, queueView, attestation, options.fieldStates),
         setDecision,
         clearDecision,
         updateReviewerNote,
@@ -1459,8 +1479,8 @@ function reviewSessionStorageKey(session, keyPrefix) {
     const itemNames = buildReviewSessionResource(session).spec.reviewItemNames.join(",");
     return `${keyPrefix}:${itemNames}`;
 }
-function renderCurrentState(root, session, controller, presentationAdapter, queueView, attestation) {
-    root.innerHTML = renderReviewQueueSessionHtml(session, presentationAdapter, queueView ?? normalizeReviewQueueView(undefined), attestation ?? attestReviewQueueExtraction(session.items, undefined));
+function renderCurrentState(root, session, controller, presentationAdapter, queueView, attestation, fieldStates) {
+    root.innerHTML = renderReviewQueueSessionHtml(session, presentationAdapter, queueView ?? normalizeReviewQueueView(undefined), attestation ?? attestReviewQueueExtraction(session.items, undefined), fieldStates);
     bindFieldCardInteractions(root, controller);
     bindApplyButton(root, controller);
     bindClampToggles(root);
@@ -1513,8 +1533,14 @@ function queueSessionFromStartState(startState) {
             : {}),
         reviewedAt: startState.reviewedAt,
         actorId: startState.actorId,
+        ...(startState.presentation !== undefined ? { presentation: startState.presentation } : {}),
+        ...(startState.sampling !== undefined ? { sampling: startState.sampling } : {}),
     };
 }
+function scoreBlindNotice(session) {
+    const audit = session.sampling?.kind === "random-audit" ? "Random audit sample. " : "";
+    return `${audit}Score-blind review: confidence and verifier results are hidden for this whole session. Decide from the source and its excerpt.`;
+}
 const COULD_NOT_CONFIRM_REASON_REQUIRED = "A reason is required when you could not confirm.";
 /**
  * Opens every collapsed region between `control` and the card before anything

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

@@ -91,31 +91,13 @@
 .queue-result-count { margin-left: auto; color: var(--k-muted); }
 .queue-empty { padding: 2rem; color: var(--k-muted); text-align: center; }
 
-/* Re-assert the base structural tokens for light mode. themes.css's `.theme-*`
-   preset classes hardcode a dark --k-bg/--k-panel/etc (so the preset "just
-   works" without requiring [data-theme] to be set), and a bare class selector
-   ties with the `[data-theme="light"]` selector in tokens.css on specificity —
-   so source order decides, and themes.css loads after tokens.css. Re-declaring
-   the light values here (loaded after themes.css) wins that tie-break. Presets
-   still control --k-brand (and theme-console's fuller palette) via their own,
-   more specific `[data-theme="light"].theme-*` rules in themes.css. */
+/* Light-mode token values come from @kontourai/ui (tokens.css plus each
+   theme's light block, which since 1.17 re-sets every mode-dependent value
+   its dark preset sets). Only color-scheme is re-asserted here: the :root rule
+   above sets it to dark and would otherwise win the source-order tie with
+   tokens.css's [data-theme="light"], leaving native controls dark. */
 [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;
 }
 
 * {
@@ -409,6 +391,30 @@ h1, h2, h3, p {
 .chip.rejected { color: var(--k-negative); background: var(--k-negative-wash); }
 .chip.could-not-confirm { color: var(--k-caution); background: var(--k-caution-wash); }
 
+/* Field-state panel: one row per field, content and lifecycle derived from
+   the records, never stored labels. A field that was not read is listed. */
+.field-states { padding: var(--k-space-3, 12px) 1rem; border-bottom: 1px solid var(--k-line); background: var(--k-panel); }
+.field-states h2 { margin: 0 0 8px; font-size: 13px; font-weight: 700; color: var(--k-text); }
+.field-states ul { list-style: none; margin: 0; padding: 0; display: grid; gap: 6px; }
+.field-states-lead { margin: 0 0 8px; font-size: 13px; line-height: 1.45; color: var(--k-caution); }
+.field-state-row { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 4px 12px; align-items: center; padding: 6px 0; border-top: 1px solid var(--k-line); }
+.field-state-row:first-child { border-top: 0; }
+.field-state-name { font-family: var(--k-font-mono, ui-monospace, monospace); font-size: 12px; color: var(--k-text); overflow-wrap: anywhere; }
+.field-state-chips { display: inline-flex; flex-wrap: wrap; gap: 6px; justify-content: flex-end; }
+.field-state-note { grid-column: 1 / -1; font-size: 12px; color: var(--k-muted); }
+.field-state-note.signal { color: var(--k-caution); }
+.chip.state-content.value { color: var(--k-positive); background: var(--k-positive-wash); }
+.chip.state-content.conflicting,
+.chip.state-content.excluded,
+.chip.state-content.not_covered { color: var(--k-caution); background: var(--k-caution-wash); }
+.chip.state-content.unsupported { color: var(--k-negative); background: var(--k-negative-wash); }
+.chip.state-content.none,
+.chip.state-lifecycle.superseded { color: var(--k-muted); background: var(--k-sunken); }
+.chip.state-lifecycle.pending { color: var(--k-brand); background: var(--k-brand-wash); }
+.chip.state-lifecycle.accepted { color: var(--k-positive); background: var(--k-positive-wash); }
+.chip.state-lifecycle.rejected { color: var(--k-negative); background: var(--k-negative-wash); }
+.chip.state-lifecycle.could_not_confirm { color: var(--k-caution); background: var(--k-caution-wash); }
+
 .frow1 .push {
   margin-left: auto;
 }
@@ -653,6 +659,12 @@ h1, h2, h3, p {
   background: var(--k-negative-wash);
 }
 
+/* A score-blind session: an informational note, not a warning. */
+.queue-attestation.score-blind {
+  color: var(--k-active);
+  background: var(--k-active-soft);
+}
+
 /* Conflicting proposed values: each value is listed with its own choice
    control until the field is decided, then marked chosen or not chosen. */
 .conflict-values ul {
@@ -1213,6 +1225,8 @@ pre[data-testid="decision-payload"] {
 /* The diff-collapse must also hold in host contexts without a query container
    (e.g. an embed that doesn't establish `container-type`): fall back to viewport. */
 @media (max-width: 620px) {
+  .field-state-row { grid-template-columns: minmax(0, 1fr); }
+  .field-state-chips { justify-content: flex-start; }
   .diff {
     grid-template-columns: 1fr;
   }

package/dist/src/review-workbench/vendor/kontourai-ui/tokens/themes.css

@@ -1,7 +1,39 @@
+/* Product themes. Each theme sets its brand (identity) and, beside it, the
+   action and focus roles. The roles hold their own values rather than aliasing
+   the brand, so a later brand override cannot break primary actions or focus.
+   Every scope that sets --k-action also sets --k-action-contrast: a theme
+   nested under another theme's scope would otherwise inherit that scope's text
+   color onto its own fill.
+
+   Every scope that sets --k-focus also redeclares --k-focus-ring, and every
+   scope that sets a status hue redeclares its soft fill: a var()-derived token
+   resolves where it is declared, so without this a scope below the root would
+   inherit the root's value (issue 78). check:tokens enforces both.
+
+   Each light block matches three placements of the theme class and
+   data-theme="light": on one element, the theme class below the light
+   attribute, and the light attribute below the theme class. The last is
+   wrapped in :where() so it weighs the same as the bare [data-theme="light"]
+   block in tokens.css (which it follows, so it wins there) and less than a
+   theme class sitting on the light element itself: a nested theme keeps its
+   own identity.
+
+   Scoping rule (ui#80, ui#84; DESIGN.md "Theme and mode scoping"): the
+   nearest data-theme picks the mode and the nearest theme class picks the
+   product. The :where(:not(...)) tails enforce "nearest" without changing a
+   selector's weight: the class-below-attribute form stops at a nearer
+   data-theme="dark", and the attribute-below-class form stops at a nearer
+   (or its own) other theme class. Weights are unchanged, so an override
+   declared later with these selectors still wins. */
+
 .theme-survey {
   --k-bg: #06080b;
   --k-brand: #5ce0c6;
-  --k-text-faint: #6f8095;
+  --k-action: #5ce0c6;
+  --k-action-contrast: #06080b;
+  --k-focus: #5ce0c6;
+  --k-text-faint: #78889b;
+  --k-focus-ring: var(--k-focus);
 }
 
 .theme-console {
@@ -13,6 +45,9 @@
   --k-radius-overlay: 0;
   --k-brand: #c9ff4a;
   --k-brand-contrast: #11120f;
+  --k-action: #c9ff4a;
+  --k-action-contrast: #11120f;
+  --k-focus: #c9ff4a;
   --k-bg: #11120f;
   --k-panel: #191b16;
   --k-panel-raised: #20231e;
@@ -20,30 +55,81 @@
   --k-line-strong: #8ea36e;
   --k-text: #f2f0e8;
   --k-text-muted: #a6ab9c;
-  --k-text-faint: #747a6c;
+  --k-text-faint: #858b7e;
   --k-positive: #a6d37b;
   --k-caution: #e8c15f;
   --k-negative: #ee776f;
   --k-active: #84d8c8;
+  --k-status-contrast: #11120f;
+  --k-focus-ring: var(--k-focus);
+  --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);
 }
 
+/* Flow dark: the brand is the accent lightened (OKLCH hue within 0.3°, same chroma)
+   just enough to read as text at 4.5:1 on bg, panel and raised panel; the
+   action and focus keep the accent, which clears their 3:1 and dark-text
+   pairs. */
 .theme-flow {
-  --k-brand: #2f88a6;
+  --k-brand: #3890ae;
+  --k-action: #2f88a6;
+  --k-action-contrast: #06080b;
+  --k-focus: #2f88a6;
+  --k-focus-ring: var(--k-focus);
 }
 
 .theme-surface {
   --k-brand: #14a37a;
+  --k-action: #14a37a;
+  --k-action-contrast: #06080b;
+  --k-focus: #14a37a;
+  --k-focus-ring: var(--k-focus);
 }
 
+/* Station: the draft accent, adjusted per mode only where WCAG AA needs it.
+   Dark: the accent carries white text as a fill but is too dark to read as
+   text on the dark panel, so the focus ring is the accent lightened to clear
+   contrast, and the brand is lightened a little further (OKLCH hue within 0.1°) to
+   read as text at 4.5:1 on bg, panel and raised panel; the action keeps the
+   draft accent. */
+.theme-station {
+  --k-brand: #966aff;
+  --k-action: #7c3aed;
+  --k-action-contrast: #ffffff;
+  --k-focus: #9364ff;
+  --k-focus-ring: var(--k-focus);
+}
+
+/* Survey light: the brand is the accent darkened (same OKLCH hue and chroma) just enough
+   to read as text at 4.5:1 on the light canvas; the action and focus keep the
+   accent. */
 [data-theme="light"].theme-survey,
-[data-theme="light"] .theme-survey {
-  --k-brand: #16806f;
+[data-theme="light"] .theme-survey:where(:not([data-theme="dark"], [data-theme="light"] [data-theme="dark"] *)),
+:where(.theme-survey) [data-theme="light"]:where(:not(.theme-console, .theme-flow, .theme-surface, .theme-station, .theme-survey :is(.theme-console, .theme-flow, .theme-surface, .theme-station) *)) {
+  --k-bg: #f5f4ef;
+  --k-text-faint: #6a707b;
+  --k-brand: #107e6d;
+  --k-action: #16806f;
+  --k-action-contrast: #ffffff;
+  --k-focus: #16806f;
+  --k-focus-ring: var(--k-focus);
 }
 
+/* Console light: the brand is the lime darkened (OKLCH hue within 0.1°) just enough
+   to read as text at 4.5:1 on bg, panel and raised panel, and it keeps white
+   brand-contrast text (5.1:1; dark text would be 3.7:1). The action and focus
+   keep the brighter lime with dark text. */
 [data-theme="light"].theme-console,
-[data-theme="light"] .theme-console {
-  --k-brand: #6c9400;
+[data-theme="light"] .theme-console:where(:not([data-theme="dark"], [data-theme="light"] [data-theme="dark"] *)),
+:where(.theme-console) [data-theme="light"]:where(:not(.theme-survey, .theme-flow, .theme-surface, .theme-station, .theme-console :is(.theme-survey, .theme-flow, .theme-surface, .theme-station) *)) {
+  --k-brand: #577800;
   --k-brand-contrast: #ffffff;
+  --k-action: #6c9400;
+  --k-action-contrast: #11120f;
+  --k-focus: #6c9400;
+  --k-focus-ring: var(--k-focus);
   --k-bg: #f3f5eb;
   --k-panel: #fbfcf7;
   --k-panel-raised: #eef2e6;
@@ -51,19 +137,112 @@
   --k-line-strong: #8fa36f;
   --k-text: #1e2319;
   --k-text-muted: #596250;
-  --k-text-faint: #77816d;
+  --k-text-faint: #68705f;
   --k-positive: #2f7d32;
   --k-caution: #8a6500;
   --k-negative: #b93a36;
   --k-active: #247f75;
+  --k-status-contrast: #ffffff;
+  --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);
 }
 
 [data-theme="light"].theme-flow,
-[data-theme="light"] .theme-flow {
+[data-theme="light"] .theme-flow:where(:not([data-theme="dark"], [data-theme="light"] [data-theme="dark"] *)),
+:where(.theme-flow) [data-theme="light"]:where(:not(.theme-survey, .theme-console, .theme-surface, .theme-station, .theme-flow :is(.theme-survey, .theme-console, .theme-surface, .theme-station) *)) {
   --k-brand: #1f6f88;
+  --k-action: #1f6f88;
+  --k-action-contrast: #ffffff;
+  --k-focus: #1f6f88;
+  --k-focus-ring: var(--k-focus);
 }
 
 [data-theme="light"].theme-surface,
-[data-theme="light"] .theme-surface {
+[data-theme="light"] .theme-surface:where(:not([data-theme="dark"], [data-theme="light"] [data-theme="dark"] *)),
+:where(.theme-surface) [data-theme="light"]:where(:not(.theme-survey, .theme-console, .theme-flow, .theme-station, .theme-surface :is(.theme-survey, .theme-console, .theme-flow, .theme-station) *)) {
   --k-brand: #0f6b52;
+  --k-action: #0f6b52;
+  --k-action-contrast: #ffffff;
+  --k-focus: #0f6b52;
+  --k-focus-ring: var(--k-focus);
+}
+
+[data-theme="light"].theme-station,
+[data-theme="light"] .theme-station:where(:not([data-theme="dark"], [data-theme="light"] [data-theme="dark"] *)),
+:where(.theme-station) [data-theme="light"]:where(:not(.theme-survey, .theme-console, .theme-flow, .theme-surface, .theme-station :is(.theme-survey, .theme-console, .theme-flow, .theme-surface) *)) {
+  --k-brand: #7c3aed;
+  --k-action: #7c3aed;
+  --k-action-contrast: #ffffff;
+  --k-focus: #7c3aed;
+  --k-focus-ring: var(--k-focus);
+}
+
+
+/* Dark islands (ui#80): a data-theme="dark" element below a light element
+   takes its nearest theme's dark values. tokens.css resets it to the default
+   dark contract first; each block below repeats its theme's mode-dependent
+   base values (check:contrast fails if one drifts) and, like the light
+   blocks, yields to a nearer theme class. Without a light ancestor nothing
+   needs resetting, so these blocks do not match and the element inherits. */
+
+[data-theme="dark"]:where(.theme-survey *):where([data-theme="light"] *):where(:not(.theme-console, .theme-flow, .theme-surface, .theme-station, .theme-survey :is(.theme-console, .theme-flow, .theme-surface, .theme-station) *)) {
+  --k-bg: #06080b;
+  --k-brand: #5ce0c6;
+  --k-action: #5ce0c6;
+  --k-action-contrast: #06080b;
+  --k-focus: #5ce0c6;
+  --k-text-faint: #78889b;
+  --k-focus-ring: var(--k-focus);
+}
+
+[data-theme="dark"]:where(.theme-console *):where([data-theme="light"] *):where(:not(.theme-survey, .theme-flow, .theme-surface, .theme-station, .theme-console :is(.theme-survey, .theme-flow, .theme-surface, .theme-station) *)) {
+  --k-brand: #c9ff4a;
+  --k-brand-contrast: #11120f;
+  --k-action: #c9ff4a;
+  --k-action-contrast: #11120f;
+  --k-focus: #c9ff4a;
+  --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: #858b7e;
+  --k-positive: #a6d37b;
+  --k-caution: #e8c15f;
+  --k-negative: #ee776f;
+  --k-active: #84d8c8;
+  --k-status-contrast: #11120f;
+  --k-focus-ring: var(--k-focus);
+  --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);
+}
+
+[data-theme="dark"]:where(.theme-flow *):where([data-theme="light"] *):where(:not(.theme-survey, .theme-console, .theme-surface, .theme-station, .theme-flow :is(.theme-survey, .theme-console, .theme-surface, .theme-station) *)) {
+  --k-brand: #3890ae;
+  --k-action: #2f88a6;
+  --k-action-contrast: #06080b;
+  --k-focus: #2f88a6;
+  --k-focus-ring: var(--k-focus);
+}
+
+[data-theme="dark"]:where(.theme-surface *):where([data-theme="light"] *):where(:not(.theme-survey, .theme-console, .theme-flow, .theme-station, .theme-surface :is(.theme-survey, .theme-console, .theme-flow, .theme-station) *)) {
+  --k-brand: #14a37a;
+  --k-action: #14a37a;
+  --k-action-contrast: #06080b;
+  --k-focus: #14a37a;
+  --k-focus-ring: var(--k-focus);
+}
+
+[data-theme="dark"]:where(.theme-station *):where([data-theme="light"] *):where(:not(.theme-survey, .theme-console, .theme-flow, .theme-surface, .theme-station :is(.theme-survey, .theme-console, .theme-flow, .theme-surface) *)) {
+  --k-brand: #966aff;
+  --k-action: #7c3aed;
+  --k-action-contrast: #ffffff;
+  --k-focus: #9364ff;
+  --k-focus-ring: var(--k-focus);
 }