harnery 0.35.0 → 0.36.0

package/dist/core/semantic/review.d.ts

@@ -0,0 +1,144 @@
+import type { SemanticAcceptedReadModelV2, SemanticConfiguredModel, SemanticEvidenceV1, SemanticExpressionCue, SemanticHarness, SemanticPhase, SemanticTag } from "./contract.js";
+export declare const SEMANTIC_REVIEW_SCHEMA_VERSION: 1;
+export declare const SEMANTIC_REVIEW_OVERALL_VERDICTS: readonly ["correct", "close", "wrong", "unsure"];
+export declare const SEMANTIC_REVIEW_FIELD_VERDICTS: readonly ["correct", "wrong", "unsure"];
+export declare const SEMANTIC_REVIEW_PORTRAIT_VERDICTS: readonly ["helpful", "neutral", "misleading"];
+export declare const SEMANTIC_REVIEW_TRANSITION_VERDICTS: readonly ["real-change", "flicker", "unsure"];
+export declare const SEMANTIC_REVIEW_CONFIDENCE: readonly ["low", "medium", "high"];
+export declare const SEMANTIC_REVIEW_NO_EXPRESSION: "none";
+export type SemanticReviewOverallVerdict = (typeof SEMANTIC_REVIEW_OVERALL_VERDICTS)[number];
+export type SemanticReviewFieldVerdict = (typeof SEMANTIC_REVIEW_FIELD_VERDICTS)[number];
+export type SemanticReviewPortraitVerdict = (typeof SEMANTIC_REVIEW_PORTRAIT_VERDICTS)[number];
+export type SemanticReviewTransitionVerdict = (typeof SEMANTIC_REVIEW_TRANSITION_VERDICTS)[number];
+export type SemanticReviewConfidence = (typeof SEMANTIC_REVIEW_CONFIDENCE)[number];
+export type SemanticReviewExpression = SemanticExpressionCue | typeof SEMANTIC_REVIEW_NO_EXPRESSION;
+export interface SemanticReviewObservationV1 {
+    kind: string;
+    observed_at: string;
+    label?: string;
+    outcome?: string;
+    error_class?: string;
+}
+export interface SemanticReviewEvidenceSnapshotV1 {
+    observed_through_ts: string;
+    task?: string;
+    lifecycle?: string;
+    intent?: string;
+    operation?: {
+        category: string;
+        label: string;
+    };
+    waits: Array<{
+        kind: string;
+        started_at: string;
+    }>;
+    recent: SemanticReviewObservationV1[];
+    attention?: SemanticReviewObservationV1;
+}
+export interface SemanticReviewProposalFieldV1<T> {
+    value: T;
+    confidence: "high" | "medium" | "low";
+}
+export interface SemanticReviewProposalV1 {
+    headline: SemanticReviewProposalFieldV1<string>;
+    summary: SemanticReviewProposalFieldV1<string>;
+    phase: SemanticReviewProposalFieldV1<SemanticPhase>;
+    expression_cue?: SemanticReviewProposalFieldV1<SemanticExpressionCue>;
+    purpose?: SemanticReviewProposalFieldV1<string>;
+    recent_result?: SemanticReviewProposalFieldV1<string>;
+    attention?: SemanticReviewProposalFieldV1<string>;
+    next_step?: SemanticReviewProposalFieldV1<string>;
+    tags?: SemanticReviewProposalFieldV1<SemanticTag[]>;
+}
+export interface SemanticReviewCandidateV1 {
+    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
+    candidate_id: string;
+    subject_id: string;
+    captured_at: string;
+    source: {
+        evidence_digest: `sha256:${string}`;
+        observed_through_ts: string;
+        generated_at: string;
+        harness: SemanticHarness;
+        configured_model: SemanticConfiguredModel;
+        resolved_model_id: string;
+        model_attestation: "verified" | "requested-only";
+    };
+    evidence: SemanticReviewEvidenceSnapshotV1;
+    proposal: SemanticReviewProposalV1;
+}
+export interface SemanticReviewStudyCandidateV1 {
+    candidate: SemanticReviewCandidateV1;
+    previous?: SemanticReviewCandidateV1;
+    transition_required: boolean;
+}
+export interface SemanticReviewStudyV1 {
+    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
+    study_id: string;
+    prepared_at: string;
+    total_candidate_count: number;
+    reviewed_candidate_count: number;
+    pending_candidate_count: number;
+    candidates: SemanticReviewStudyCandidateV1[];
+}
+export interface SemanticReviewResponseV1 {
+    candidate_id: string;
+    overall: SemanticReviewOverallVerdict;
+    phase: SemanticReviewFieldVerdict;
+    expected_phase?: SemanticPhase;
+    expression: SemanticReviewFieldVerdict;
+    expected_expression?: SemanticReviewExpression;
+    portrait_usefulness: SemanticReviewPortraitVerdict;
+    transition?: SemanticReviewTransitionVerdict;
+    confidence: SemanticReviewConfidence;
+    response_ms: number;
+}
+export interface SemanticReviewSubmissionV1 {
+    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
+    study_id: string;
+    total_duration_ms: number;
+    responses: SemanticReviewResponseV1[];
+}
+export interface SemanticReviewReceiptRowV1 extends SemanticReviewResponseV1 {
+    subject_id: string;
+    candidate_generated_at: string;
+    source_harness: SemanticHarness;
+    configured_model: SemanticConfiguredModel;
+    resolved_model_id: string;
+    model_attestation: "verified" | "requested-only";
+    proposed_phase: SemanticPhase;
+    proposed_expression: SemanticReviewExpression;
+}
+export interface SemanticReviewReceiptV1 {
+    schema_version: typeof SEMANTIC_REVIEW_SCHEMA_VERSION;
+    receipt_id: string;
+    study_id: string;
+    completed_at: string;
+    total_duration_ms: number;
+    responses: SemanticReviewReceiptRowV1[];
+    summary: {
+        reviewed: number;
+        overall: Record<SemanticReviewOverallVerdict, number>;
+        phase: Record<SemanticReviewFieldVerdict, number>;
+        expression: Record<SemanticReviewFieldVerdict, number>;
+        portrait_usefulness: Record<SemanticReviewPortraitVerdict, number>;
+        transitions: Record<SemanticReviewTransitionVerdict, number>;
+    };
+}
+export declare function semanticReviewPaths(coordRootRaw: string): {
+    root: string;
+    candidates: string;
+    receipts: string;
+};
+export declare function captureSemanticReviewCandidate(coordRootRaw: string, evidence: SemanticEvidenceV1, document: SemanticAcceptedReadModelV2): SemanticReviewCandidateV1;
+export declare function backfillSemanticReviewCandidates(coordRootRaw: string, now?: number): SemanticReviewCandidateV1[];
+export declare function listSemanticReviewCandidates(coordRootRaw: string): SemanticReviewCandidateV1[];
+export declare function listSemanticReviewReceipts(coordRootRaw: string): SemanticReviewReceiptV1[];
+export declare function prepareSemanticReviewStudy(coordRootRaw: string, options?: {
+    limit?: number;
+    now?: Date;
+    backfill?: boolean;
+}): SemanticReviewStudyV1;
+export declare function storeSemanticReviewSubmission(coordRootRaw: string, value: unknown, now?: Date): SemanticReviewReceiptV1;
+export declare function pruneSemanticReviewStorage(coordRootRaw: string, now?: number): void;
+//# sourceMappingURL=review.d.ts.map

package/dist/core/semantic/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/core/semantic/review.ts"],"names":[],"mappings":"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"}