@kontourai/survey 0.4.5 → 0.4.7

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

@@ -0,0 +1,536 @@
+import { type ReviewItem } from "../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 regulatedRuleConflictReviewItemFixture: {
+    apiVersion: "survey.kontourai.io/v1alpha1";
+    kind: "ReviewItem";
+    metadata: {
+        name: string;
+        labels: {
+            domain: string;
+        };
+        producer: {
+            displayName: string;
+            jurisdiction: string;
+            reportingPeriod: string;
+        };
+    };
+    spec: {
+        target: string;
+        selectedCandidateId: string;
+        candidateSetStatus: "conflict";
+        rationale: string;
+        projection: {
+            candidateSetId: string;
+        };
+        producerPolicy: {
+            decisionMode: string;
+            sourceAuthorityProjection: string;
+            feedbackTags: string[];
+        };
+        candidates: ({
+            id: string;
+            role: "current";
+            value: number;
+            confidence: number;
+            source: {
+                sourceId: string;
+                sourceRef: string;
+                kind: "manual-entry";
+                observedAt: string;
+                locatorScheme: "structured-field";
+            };
+            locator: {
+                scheme: "structured-field";
+                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: "high";
+                evidenceType: "human_attestation";
+                evidenceMethod: "attestation";
+                collectedBy: string;
+            };
+            projection: {
+                rawSourceId: string;
+                extractionId: string;
+                candidateSetId: string;
+                candidateId: string;
+                claimId: string;
+            };
+            producer: {
+                status: string;
+                sourceSection?: undefined;
+                sourcePage?: undefined;
+                sourceAuthority?: undefined;
+            };
+            sourceRank?: undefined;
+        } | {
+            id: string;
+            role: "proposed";
+            value: number;
+            confidence: number;
+            sourceRank: number;
+            source: {
+                sourceId: string;
+                sourceRef: string;
+                kind: "uploaded-document";
+                observedAt: string;
+                locatorScheme: "pdf";
+            };
+            locator: {
+                scheme: "pdf";
+                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: "high";
+                evidenceType: "policy_rule";
+                evidenceMethod: "extraction";
+                collectedBy: string;
+            };
+            projection: {
+                rawSourceId: string;
+                extractionId: string;
+                candidateSetId: string;
+                candidateId: string;
+                claimId: string;
+            };
+            producer: {
+                sourceSection: string;
+                sourcePage: number;
+                sourceAuthority: {
+                    authorityClass: string;
+                    declaredBy: string;
+                    scope: string;
+                };
+                status?: undefined;
+            };
+        })[];
+    };
+    status: {
+        observedCandidateCount: number;
+        selectedCandidateId: 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;
+    };
+} | {
+    apiVersion: "survey.kontourai.io/v1alpha1";
+    kind: "ReviewItem";
+    metadata: {
+        name: string;
+        labels: {
+            domain: string;
+        };
+        producer: {
+            displayName: string;
+            jurisdiction: string;
+            reportingPeriod: string;
+        };
+    };
+    spec: {
+        target: string;
+        selectedCandidateId: string;
+        candidateSetStatus: "conflict";
+        rationale: string;
+        projection: {
+            candidateSetId: string;
+        };
+        producerPolicy: {
+            decisionMode: string;
+            sourceAuthorityProjection: string;
+            feedbackTags: string[];
+        };
+        candidates: ({
+            id: string;
+            role: "current";
+            value: number;
+            confidence: number;
+            source: {
+                sourceId: string;
+                sourceRef: string;
+                kind: "manual-entry";
+                observedAt: string;
+                locatorScheme: "structured-field";
+            };
+            locator: {
+                scheme: "structured-field";
+                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: "high";
+                evidenceType: "human_attestation";
+                evidenceMethod: "attestation";
+                collectedBy: string;
+            };
+            projection: {
+                rawSourceId: string;
+                extractionId: string;
+                candidateSetId: string;
+                candidateId: string;
+                claimId: string;
+            };
+            producer: {
+                status: string;
+                sourceSection?: undefined;
+                sourcePage?: undefined;
+                sourceAuthority?: undefined;
+            };
+            sourceRank?: undefined;
+        } | {
+            id: string;
+            role: "proposed";
+            value: number;
+            confidence: number;
+            sourceRank: number;
+            source: {
+                sourceId: string;
+                sourceRef: string;
+                kind: "uploaded-document";
+                observedAt: string;
+                locatorScheme: "pdf";
+            };
+            locator: {
+                scheme: "pdf";
+                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: "high";
+                evidenceType: "policy_rule";
+                evidenceMethod: "extraction";
+                collectedBy: string;
+            };
+            projection: {
+                rawSourceId: string;
+                extractionId: string;
+                candidateSetId: string;
+                candidateId: string;
+                claimId: string;
+            };
+            producer: {
+                sourceSection: string;
+                sourcePage: number;
+                sourceAuthority: {
+                    authorityClass: string;
+                    declaredBy: string;
+                    scope: string;
+                };
+                status?: undefined;
+            };
+        })[];
+    };
+    status: {
+        observedCandidateCount: number;
+        selectedCandidateId: string;
+    };
+})[];

package/dist/{examples → src}/review-workbench/review-workbench-data.js

@@ -1,4 +1,4 @@
-import { reviewResourceApiVersion } from "../../src/review-resource.js";
+import { reviewResourceApiVersion } from "../review-resource.js";
 // Browser-safe mirror of fixtures/public-directory-review-resource.ts.
 // scripts/check-review-workbench.cjs fails if this data drifts from the canonical fixture.
 export const publicDirectoryReviewItemFixture = {
@@ -131,6 +131,142 @@ export const publicDirectoryReviewItemFixture = {
         reviewDecisionName: "public-directory-availability-operator-decision",
     },
 };
+export const regulatedRuleConflictReviewItemFixture = {
+    apiVersion: reviewResourceApiVersion,
+    kind: "ReviewItem",
+    metadata: {
+        name: "regulated-rule-conflict-standard-threshold",
+        labels: {
+            domain: "regulated-rule-source",
+        },
+        producer: {
+            displayName: "Regulated Rule Review",
+            jurisdiction: "example-jurisdiction",
+            reportingPeriod: "2026",
+        },
+    },
+    spec: {
+        target: "standardThreshold",
+        selectedCandidateId: "regulated-rule-conflict-standard-threshold:candidate:current",
+        candidateSetStatus: "conflict",
+        rationale: "A newly extracted source candidate conflicts with the currently managed rule value.",
+        projection: {
+            candidateSetId: "regulated-rule-conflict-standard-threshold:candidate-set",
+        },
+        producerPolicy: {
+            decisionMode: "keep-current",
+            sourceAuthorityProjection: "only-for-selected-source-backed-value",
+            feedbackTags: ["rule-conflict", "source-extraction-review"],
+        },
+        candidates: [
+            {
+                id: "regulated-rule-conflict-standard-threshold:candidate:current",
+                role: "current",
+                value: 15000,
+                confidence: 1,
+                source: {
+                    sourceId: "regulated-rule-conflict-standard-threshold:source:current",
+                    sourceRef: "survey-example://rules/example-jurisdiction/2026/standardThreshold",
+                    kind: "manual-entry",
+                    observedAt: "2026-06-03T00:00:00.000Z",
+                    locatorScheme: "structured-field",
+                },
+                locator: {
+                    scheme: "structured-field",
+                    locator: "managed-rules:path=standardThreshold",
+                    excerpt: "Current managed rule value.",
+                },
+                extraction: {
+                    extractionId: "regulated-rule-conflict-standard-threshold:extraction:current",
+                    target: "standardThreshold",
+                    confidence: 1,
+                    extractor: "example-rule-manager",
+                    extractedAt: "2026-06-03T00:00:00.000Z",
+                },
+                claimTarget: {
+                    claimId: "regulated-rule.example-jurisdiction.2026.standard-threshold.current",
+                    subjectType: "regulated-rule-source",
+                    subjectId: "example-jurisdiction:2026:standardThreshold",
+                    surface: "regulated.rules",
+                    claimType: "regulated.rule-source-value",
+                    fieldOrBehavior: "standardThreshold",
+                    impactLevel: "high",
+                    evidenceType: "human_attestation",
+                    evidenceMethod: "attestation",
+                    collectedBy: "example-rule-manager",
+                },
+                projection: {
+                    rawSourceId: "regulated-rule-conflict-standard-threshold:source:current",
+                    extractionId: "regulated-rule-conflict-standard-threshold:extraction:current",
+                    candidateSetId: "regulated-rule-conflict-standard-threshold:candidate-set",
+                    candidateId: "regulated-rule-conflict-standard-threshold:projection:current",
+                    claimId: "regulated-rule.example-jurisdiction.2026.standard-threshold.current",
+                },
+                producer: {
+                    status: "current-managed-value",
+                },
+            },
+            {
+                id: "regulated-rule-conflict-standard-threshold:candidate:proposed",
+                role: "proposed",
+                value: 16000,
+                confidence: 0.95,
+                sourceRank: 1,
+                source: {
+                    sourceId: "regulated-rule-conflict-standard-threshold:source:proposed",
+                    sourceRef: "https://example.test/regulatory-bulletins/2026-thresholds.pdf",
+                    kind: "uploaded-document",
+                    observedAt: "2026-06-03T00:30:00.000Z",
+                    locatorScheme: "pdf",
+                },
+                locator: {
+                    scheme: "pdf",
+                    locator: "pdf:page=12;section=Standard%20Threshold;path=standardThreshold",
+                    excerpt: "Example Individual Standard Threshold $16,000",
+                },
+                extraction: {
+                    extractionId: "regulated-rule-conflict-standard-threshold:extraction:proposed",
+                    target: "standardThreshold",
+                    confidence: 0.95,
+                    extractor: "example-rule-source-parser",
+                    extractedAt: "2026-06-03T00:30:00.000Z",
+                },
+                claimTarget: {
+                    claimId: "regulated-rule.example-jurisdiction.2026.standard-threshold.proposed",
+                    subjectType: "regulated-rule-source",
+                    subjectId: "example-jurisdiction:2026:standardThreshold",
+                    surface: "regulated.rules",
+                    claimType: "regulated.rule-source-value",
+                    fieldOrBehavior: "standardThreshold",
+                    impactLevel: "high",
+                    evidenceType: "policy_rule",
+                    evidenceMethod: "extraction",
+                    collectedBy: "example-rule-source-parser",
+                },
+                projection: {
+                    rawSourceId: "regulated-rule-conflict-standard-threshold:source:proposed",
+                    extractionId: "regulated-rule-conflict-standard-threshold:extraction:proposed",
+                    candidateSetId: "regulated-rule-conflict-standard-threshold:candidate-set",
+                    candidateId: "regulated-rule-conflict-standard-threshold:projection:proposed",
+                    claimId: "regulated-rule.example-jurisdiction.2026.standard-threshold.proposed",
+                },
+                producer: {
+                    sourceSection: "Standard Threshold",
+                    sourcePage: 12,
+                    sourceAuthority: {
+                        authorityClass: "official_publication",
+                        declaredBy: "Example regulatory source registry",
+                        scope: "standardThreshold rule value for example-jurisdiction 2026",
+                    },
+                },
+            },
+        ],
+    },
+    status: {
+        observedCandidateCount: 2,
+        selectedCandidateId: "regulated-rule-conflict-standard-threshold:candidate:current",
+    },
+};
 function queueFixture(name, target, currentValue, proposedValue, candidateSetStatus, feedbackTags) {
     return {
         ...publicDirectoryReviewItemFixture,
@@ -196,4 +332,5 @@ export const reviewWorkbenchQueueFixtures = [
     publicDirectoryReviewItemFixture,
     queueFixture("public-directory-address", "streetAddress", "100 Main Street", "102 Main Street", "needs-review", ["address-change", "producer-escalation-candidate"]),
     queueFixture("public-directory-license", "licenseStatus", "ACTIVE", "EXPIRED", "escalated", ["licensing", "manual-review-required"]),
+    regulatedRuleConflictReviewItemFixture,
 ];