@kontourai/survey 0.4.5 → 0.4.7

package/dist/src/review-workbench/vendor/console-kit/tokens/fonts.css

@@ -0,0 +1 @@
+@import url("https://fonts.googleapis.com/css2?family=Fraunces:opsz,wght@9..144,400;9..144,600;9..144,700;9..144,900&family=Hanken+Grotesk:wght@400;500;600;700;800&family=IBM+Plex+Mono:wght@400;500;600&display=swap");

package/dist/src/review-workbench/vendor/console-kit/tokens/index.css

@@ -0,0 +1,2 @@
+@import "./tokens.css";
+@import "./themes.css";

package/dist/src/review-workbench/vendor/console-kit/tokens/themes.css

@@ -0,0 +1,67 @@
+.theme-survey {
+  --k-bg: #06080b;
+  --k-brand: #5ce0c6;
+  --k-text-faint: #6f8095;
+}
+
+.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;
+}
+
+.theme-flow {
+  --k-brand: #2f88a6;
+}
+
+.theme-surface {
+  --k-brand: #14a37a;
+}
+
+[data-theme="light"].theme-survey,
+[data-theme="light"] .theme-survey {
+  --k-brand: #16806f;
+}
+
+[data-theme="light"].theme-console,
+[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;
+}
+
+[data-theme="light"].theme-flow,
+[data-theme="light"] .theme-flow {
+  --k-brand: #1f6f88;
+}
+
+[data-theme="light"].theme-surface,
+[data-theme="light"] .theme-surface {
+  --k-brand: #0f6b52;
+}

package/dist/src/review-workbench/vendor/console-kit/tokens/tokens.css

@@ -0,0 +1,79 @@
+:root {
+  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);
+
+  /* text */
+  --k-text: #eef3f8;
+  --k-text-muted: #aebccb;
+  --k-text-faint: #72869b;
+
+  /* brand */
+  --k-brand: #5ce0c6;
+  --k-brand-contrast: #06080b;
+
+  /* semantic status scale */
+  --k-positive: #34d399;
+  --k-caution: #f3b14b;
+  --k-negative: #ff6f6f;
+  --k-neutral: #6f8095;
+  --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;
+
+  /* radius */
+  --k-radius-sm: 9px;
+  --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);
+
+  /* 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;
+
+  /* motion */
+  --k-ease: cubic-bezier(0.22, 1, 0.36, 1);
+  --k-dur: 0.16s;
+}
+
+[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;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontourai/survey",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Producer-side source, extraction, candidate, and review contracts for projecting verified claims into Surface.",
   "license": "Apache-2.0",
   "type": "module",
@@ -18,6 +18,12 @@
   },
   "exports": {
     ".": "./dist/src/index.js",
+    "./review-workbench": {
+      "types": "./dist/src/review-workbench/review-workbench.d.ts",
+      "default": "./dist/src/review-workbench/review-workbench.js"
+    },
+    "./review-workbench.css": "./dist/src/review-workbench/review-workbench.css",
+    "./review-workbench/standalone.css": "./dist/src/review-workbench/review-workbench.standalone.css",
     "./fixtures/public-field-review": "./dist/fixtures/public-field-review.js",
     "./fixtures/corrected-document-candidates": "./dist/fixtures/corrected-document-candidates.js",
     "./fixtures/public-directory-review-resource": "./dist/fixtures/public-directory-review-resource.js",
@@ -30,11 +36,15 @@
     "README.md"
   ],
   "scripts": {
-    "build": "rm -rf dist && tsc",
+    "build": "rm -rf dist && tsc && node scripts/copy-review-workbench-package-assets.cjs",
+    "prepare": "npm run build",
     "typecheck": "tsc --noEmit",
     "test": "npm run build && node --test dist/tests/*.test.js",
-    "verify": "node scripts/check-content-boundary.cjs && npm run typecheck && npm test && npm run check:review-workbench",
+    "test:browser": "playwright test",
+    "verify": "node scripts/check-content-boundary.cjs && npm run typecheck && npm test && npm run check:review-workbench-assets && npm run check:review-workbench && npm run test:browser",
     "check:content-boundary": "node scripts/check-content-boundary.cjs",
+    "sync:review-workbench-assets": "node scripts/sync-review-workbench-assets.cjs",
+    "check:review-workbench-assets": "node scripts/sync-review-workbench-assets.cjs --check",
     "check:review-workbench": "npm run check:review-workbench:static",
     "check:review-workbench:static": "npm run build && node scripts/check-review-workbench.cjs",
     "setup:repo-hooks": "node scripts/setup-repo-hooks.cjs",
@@ -44,6 +54,8 @@
     "@kontourai/surface": "^0.5.1"
   },
   "devDependencies": {
+    "@kontourai/console-kit": "^0.1.0",
+    "@playwright/test": "^1.60.0",
     "@types/node": "^25.6.0",
     "typescript": "^5.8.0"
   },

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

@@ -1,122 +0,0 @@
-import { publicDirectoryReviewItemFixture, reviewWorkbenchQueueFixtures } from "./review-workbench-data.js";
-export const workbenchDecisionDefinitions = {
-    "accept-proposed": {
-        label: "Accept proposed",
-        effect: "Proposed value becomes the verified review outcome.",
-        candidateRole: "proposed",
-        status: "verified",
-    },
-    "keep-current": {
-        label: "Keep current",
-        effect: "Current value remains the verified review outcome.",
-        candidateRole: "current",
-        status: "verified",
-    },
-    "reject-proposed": {
-        label: "Reject proposed",
-        effect: "Proposed value is rejected and the current value remains unmodified.",
-        candidateRole: "proposed",
-        status: "rejected",
-    },
-};
-export function initialReviewWorkbenchState(item = publicDirectoryReviewItemFixture) {
-    return {
-        item,
-        note: "",
-        decision: undefined,
-        reviewedAt: "2026-06-04T00:00:00.000Z",
-        actorId: "review-workbench-operator",
-    };
-}
-export function initialReviewQueueSessionState(items = reviewWorkbenchQueueFixtures) {
-    return {
-        items,
-        activeItemName: items[0]?.metadata.name ?? "",
-        notesByItemName: {},
-        decisionsByItemName: {},
-        reviewedAt: "2026-06-04T00:00:00.000Z",
-        actorId: "review-workbench-operator",
-    };
-}
-export function currentReviewWorkbenchState(session) {
-    const item = currentReviewItem(session);
-    return {
-        item,
-        note: session.notesByItemName[item.metadata.name] ?? "",
-        decision: session.decisionsByItemName[item.metadata.name],
-        reviewedAt: session.reviewedAt,
-        actorId: session.actorId,
-    };
-}
-export function currentReviewItem(session) {
-    const item = session.items.find((entry) => entry.metadata.name === session.activeItemName) ?? session.items[0];
-    if (!item) {
-        throw new Error("Review queue session has no ReviewItems.");
-    }
-    return item;
-}
-export function deriveQueueRowStatus(item, session) {
-    const decision = session.decisionsByItemName[item.metadata.name];
-    if (decision === "reject-proposed") {
-        return "rejected";
-    }
-    if (decision === "accept-proposed" || decision === "keep-current" || item.spec.candidateSetStatus === "resolved") {
-        return "resolved";
-    }
-    if (item.spec.candidateSetStatus === "escalated") {
-        return "escalated";
-    }
-    if (item.metadata.name === session.activeItemName) {
-        return "in-review";
-    }
-    return "pending";
-}
-export function nextUnresolvedItemName(session) {
-    const activeIndex = session.items.findIndex((item) => item.metadata.name === session.activeItemName);
-    const orderedItems = [
-        ...session.items.slice(Math.max(activeIndex, 0) + 1),
-        ...session.items.slice(0, Math.max(activeIndex, 0) + 1),
-    ];
-    return orderedItems.find((item) => deriveQueueRowStatus(item, session) === "pending")?.metadata.name;
-}
-export function reviewSessionSummary(session) {
-    return session.items.reduce((summary, item) => {
-        const decision = session.decisionsByItemName[item.metadata.name];
-        if (decision === "accept-proposed") {
-            return { ...summary, accepted: summary.accepted + 1 };
-        }
-        if (decision === "keep-current") {
-            return { ...summary, keptCurrent: summary.keptCurrent + 1 };
-        }
-        if (decision === "reject-proposed") {
-            return { ...summary, rejected: summary.rejected + 1 };
-        }
-        if (item.spec.candidateSetStatus === "escalated") {
-            return { ...summary, escalated: summary.escalated + 1 };
-        }
-        if (item.spec.candidateSetStatus === "resolved") {
-            return { ...summary, accepted: summary.accepted + 1 };
-        }
-        return { ...summary, unresolved: summary.unresolved + 1 };
-    }, {
-        accepted: 0,
-        keptCurrent: 0,
-        rejected: 0,
-        escalated: 0,
-        unresolved: 0,
-    });
-}
-export function candidateForDecision(item, decision) {
-    const definition = workbenchDecisionDefinitions[decision];
-    const candidate = item.spec.candidates.find((entry) => entry.role === definition.candidateRole);
-    if (!candidate) {
-        throw new Error(`ReviewItem ${item.metadata.name} has no ${definition.candidateRole} candidate.`);
-    }
-    return candidate;
-}
-export function selectedCandidateRole(state) {
-    if (!state.decision) {
-        return undefined;
-    }
-    return workbenchDecisionDefinitions[state.decision].candidateRole;
-}

package/dist/examples/review-workbench/review-workbench-data.d.ts

@@ -1,261 +0,0 @@
-import { type ReviewItem } from "../../src/review-resource.js";
-export declare const publicDirectoryReviewItemFixture: {
-    apiVersion: "survey.kontourai.io/v1alpha1";
-    kind: "ReviewItem";
-    metadata: {
-        name: string;
-        labels: {
-            domain: string;
-        };
-        producer: {
-            displayName: string;
-            slug: string;
-        };
-    };
-    spec: {
-        target: string;
-        selectedCandidateId: string;
-        candidateSetStatus: "resolved";
-        rationale: string;
-        candidates: ({
-            id: string;
-            role: "current";
-            value: string;
-            confidence: number;
-            source: {
-                sourceId: string;
-                sourceRef: string;
-                kind: "web-page";
-                observedAt: string;
-                fetchedAt: string;
-                locatorScheme: "html";
-            };
-            locator: {
-                scheme: "html";
-                locator: string;
-                excerpt: string;
-            };
-            extraction: {
-                extractionId: string;
-                target: string;
-                confidence: number;
-                extractor: string;
-                extractedAt: string;
-            };
-            claimTarget: {
-                claimId: string;
-                subjectType: string;
-                subjectId: string;
-                surface: string;
-                claimType: string;
-                fieldOrBehavior: string;
-                impactLevel: "medium";
-                collectedBy: string;
-            };
-            projection: {
-                rawSourceId: string;
-                extractionId: string;
-                candidateSetId: string;
-                candidateId: string;
-                reviewOutcomeId: string;
-                claimId: string;
-            };
-            producer: {
-                sourceAuthority: {
-                    authorityClass: string;
-                    declaredBy: string;
-                    scope: string;
-                };
-                proposalId?: undefined;
-                oldValue?: undefined;
-            };
-        } | {
-            id: string;
-            role: "proposed";
-            value: string;
-            confidence: number;
-            source: {
-                sourceId: string;
-                sourceRef: string;
-                kind: "web-page";
-                observedAt: string;
-                fetchedAt: string;
-                locatorScheme: "html";
-            };
-            locator: {
-                scheme: "html";
-                locator: string;
-                excerpt: string;
-            };
-            extraction: {
-                extractionId: string;
-                target: string;
-                confidence: number;
-                extractor: string;
-                extractedAt: string;
-            };
-            claimTarget: {
-                claimId: string;
-                subjectType: string;
-                subjectId: string;
-                surface: string;
-                claimType: string;
-                fieldOrBehavior: string;
-                impactLevel: "medium";
-                collectedBy: string;
-            };
-            projection: {
-                rawSourceId: string;
-                extractionId: string;
-                candidateSetId: string;
-                candidateId: string;
-                claimId: string;
-                reviewOutcomeId?: undefined;
-            };
-            producer: {
-                proposalId: string;
-                oldValue: string;
-                sourceAuthority: {
-                    authorityClass: string;
-                    declaredBy: string;
-                    scope: string;
-                };
-            };
-        })[];
-    };
-    status: {
-        observedCandidateCount: number;
-        selectedCandidateId: string;
-        reviewDecisionName: string;
-    };
-};
-export declare const reviewWorkbenchQueueFixtures: (ReviewItem | {
-    apiVersion: "survey.kontourai.io/v1alpha1";
-    kind: "ReviewItem";
-    metadata: {
-        name: string;
-        labels: {
-            domain: string;
-        };
-        producer: {
-            displayName: string;
-            slug: string;
-        };
-    };
-    spec: {
-        target: string;
-        selectedCandidateId: string;
-        candidateSetStatus: "resolved";
-        rationale: string;
-        candidates: ({
-            id: string;
-            role: "current";
-            value: string;
-            confidence: number;
-            source: {
-                sourceId: string;
-                sourceRef: string;
-                kind: "web-page";
-                observedAt: string;
-                fetchedAt: string;
-                locatorScheme: "html";
-            };
-            locator: {
-                scheme: "html";
-                locator: string;
-                excerpt: string;
-            };
-            extraction: {
-                extractionId: string;
-                target: string;
-                confidence: number;
-                extractor: string;
-                extractedAt: string;
-            };
-            claimTarget: {
-                claimId: string;
-                subjectType: string;
-                subjectId: string;
-                surface: string;
-                claimType: string;
-                fieldOrBehavior: string;
-                impactLevel: "medium";
-                collectedBy: string;
-            };
-            projection: {
-                rawSourceId: string;
-                extractionId: string;
-                candidateSetId: string;
-                candidateId: string;
-                reviewOutcomeId: string;
-                claimId: string;
-            };
-            producer: {
-                sourceAuthority: {
-                    authorityClass: string;
-                    declaredBy: string;
-                    scope: string;
-                };
-                proposalId?: undefined;
-                oldValue?: undefined;
-            };
-        } | {
-            id: string;
-            role: "proposed";
-            value: string;
-            confidence: number;
-            source: {
-                sourceId: string;
-                sourceRef: string;
-                kind: "web-page";
-                observedAt: string;
-                fetchedAt: string;
-                locatorScheme: "html";
-            };
-            locator: {
-                scheme: "html";
-                locator: string;
-                excerpt: string;
-            };
-            extraction: {
-                extractionId: string;
-                target: string;
-                confidence: number;
-                extractor: string;
-                extractedAt: string;
-            };
-            claimTarget: {
-                claimId: string;
-                subjectType: string;
-                subjectId: string;
-                surface: string;
-                claimType: string;
-                fieldOrBehavior: string;
-                impactLevel: "medium";
-                collectedBy: string;
-            };
-            projection: {
-                rawSourceId: string;
-                extractionId: string;
-                candidateSetId: string;
-                candidateId: string;
-                claimId: string;
-                reviewOutcomeId?: undefined;
-            };
-            producer: {
-                proposalId: string;
-                oldValue: string;
-                sourceAuthority: {
-                    authorityClass: string;
-                    declaredBy: string;
-                    scope: string;
-                };
-            };
-        })[];
-    };
-    status: {
-        observedCandidateCount: number;
-        selectedCandidateId: string;
-        reviewDecisionName: string;
-    };
-})[];