@skill-harness/adapters 0.15.0 → 0.17.0

package/dist/learning-workspace.d.ts

@@ -0,0 +1,1084 @@
+import { type HypothesisProposal, type Hypothesis, type AdoptionBinding, type AdoptionAuthority, type AdoptionFacts, type RollbackRequest, type ProductionObservation, type BlindQualityChoice } from '@skill-harness/core';
+import { type WorkCaseReviewRequest } from './work-case-review.js';
+import { type LearningCaseReference } from './learning-case.js';
+import { type TrustLifecycleInput } from './trust-lifecycle.js';
+/** Creates only explicitly selected private local directories; never follows a symlink. */
+export declare function prepareLearningDirectory(directory: string): void;
+export interface LearningWorkspaceInput {
+    archiveRoot: string;
+    scopeDigest: string;
+    population: string;
+    author: string;
+}
+export interface LearningCaseBinding {
+    name: string;
+    title: string;
+    version: 2 | 3;
+    batchId: string;
+}
+export interface LearningComparisonBinding {
+    name: string;
+    title: string;
+    scopeStatement: string;
+    comparisonManifestId: string;
+    caseReference: LearningCaseReference | null;
+    hypothesisManifestId: string | null;
+    priorFeedbackManifestIds: string[];
+    adoptionBinding: AdoptionBinding | null;
+}
+export interface LearningQualityReview {
+    scope: 'full-artifacts';
+    note: string;
+    reviewedArtifactDigests: string[];
+}
+export interface LearningDecisionRequest {
+    disposition: 'adopt' | 'reject' | 'defer';
+    note: string;
+    priorDecisionId: string | null;
+}
+export interface LearningRegistryReceipt {
+    version: 'learning-registry-receipt-v1';
+    operation: 'activate' | 'rollback';
+    requestId: string;
+    adoptionId: string;
+    scopeDigest: string;
+    candidateDigest: string;
+    revision: number;
+    /** Exact original registry inspect()/activate()/rollback() response retained by its owner. */
+    registryManifestId: string;
+}
+/** Composition over the existing archive and CAS journals. No worker callbacks, model calls,
+ * exposure, registry mutation, authentication or hostile-same-UID protection. */
+export declare function createLearningWorkspace(directory: string, input: LearningWorkspaceInput): {
+    configuration: () => LearningWorkspaceInput;
+    bindSession(raw: {
+        name: string;
+        title: string;
+        manifestId: string;
+    }): {
+        name: string;
+        title: string;
+        manifestId: string;
+    };
+    noteSession(name: string, raw: {
+        kind: "finding" | "proposal" | "acceptance" | "context";
+        note: string;
+        item: number;
+        line: number;
+    }): {
+        author: string;
+        kind: "finding" | "proposal" | "acceptance" | "context";
+        note: string;
+        item: number;
+        line: number;
+    };
+    sessions(): ({
+        state: string;
+        sessionId: string;
+        reason: string;
+        name: string;
+        title: string;
+        manifestId: string;
+    } | {
+        state: string;
+        sessionId: null;
+        reason: string;
+        name: string;
+        title: string;
+        manifestId: string;
+    })[];
+    session(name: string): {
+        annotations: {
+            kind: string;
+            note: string;
+            item: number;
+            line: number;
+            author: string;
+        }[];
+        acceptance: "not-assessed";
+        parent: import("./session-observation.js").SessionObservation;
+        children: {
+            source: number;
+            executionId: string | null;
+            session: import("./session-observation.js").SessionObservation;
+        }[];
+        attempts: import("./session-observation.js").SessionAttempt[];
+        gaps: string[];
+        version: "retrospective-session-v1";
+        manifestId: string;
+        selectionDigest: string;
+        sources: (import("./session-retention.js").Source & {
+            manifestId: string;
+        })[];
+        name: string;
+        title: string;
+    };
+    dashboardBinding(): {
+        trustDirectory: string | null;
+        trustPolicyId: string | null;
+    };
+    preparedAdoption(name: string): Readonly<{
+        id: string;
+        version: "adoption-receipt-v1";
+        bindingId: string;
+        authorityId: string;
+        hypothesisDigest: string;
+        experimentDigest: string;
+        candidateDigest: string;
+        scopeDigest: string;
+        assessmentPolicyDigest: string;
+        rollbackCandidateDigest: string;
+        activationBoundary: "next-orders";
+        grantExpansion: false;
+        expiresAt: number;
+    }> | null;
+    adoptionStatus(name: string): {
+        binding: AdoptionBinding | null;
+        receipt: Readonly<{
+            id: string;
+            version: "adoption-receipt-v1";
+            bindingId: string;
+            authorityId: string;
+            hypothesisDigest: string;
+            experimentDigest: string;
+            candidateDigest: string;
+            scopeDigest: string;
+            assessmentPolicyDigest: string;
+            rollbackCandidateDigest: string;
+            activationBoundary: "next-orders";
+            grantExpansion: false;
+            expiresAt: number;
+        }> | null;
+        activationManifestId: string | null;
+        rollbackManifestId: string | null;
+    };
+    bindCases(raw: LearningCaseBinding): LearningCaseBinding;
+    bindComparison(raw: LearningComparisonBinding): {
+        name: string;
+        comparisonManifestId: string;
+    };
+    linkComparisonContext(name: string, context: Pick<LearningComparisonBinding, "caseReference" | "hypothesisManifestId" | "adoptionBinding">): {
+        name: string;
+        linked: boolean;
+    };
+    comparisonContext(name: string): {
+        caseReference: LearningCaseReference | null;
+        hypothesisManifestId: string | null;
+        adoptionBinding: AdoptionBinding | null;
+    };
+    bindTrust(trustDirectory: string): void;
+    configureTrust(raw: TrustLifecycleInput, authorizedPolicyDigests: readonly string[]): {
+        policyId: string;
+        component: import("@skill-harness/core").CalibrationComponent;
+        calibration: {
+            version: "factory-calibration-v1";
+            reports: import("@skill-harness/core").CalibrationReport[];
+            excludedTuning: number;
+            referenceBasis: "independently-supplied-host-context";
+            advisoryOnly: true;
+        };
+        sampledIncidentIds: string[];
+        unflagged: {
+            sampled: number;
+            resolved: number;
+            misses: number;
+            unresolved: number;
+            conflicted: number;
+        };
+        attentionUsed: number;
+        retired: boolean;
+        exposures: {
+            mode: "ask" | "silent" | "retire";
+            reason: string;
+            id: string;
+        }[];
+        tip: string;
+        grantExpansion: false;
+    };
+    trust(): {
+        inspect: (now: number) => {
+            policyId: string;
+            component: import("@skill-harness/core").CalibrationComponent;
+            calibration: {
+                version: "factory-calibration-v1";
+                reports: import("@skill-harness/core").CalibrationReport[];
+                excludedTuning: number;
+                referenceBasis: "independently-supplied-host-context";
+                advisoryOnly: true;
+            };
+            sampledIncidentIds: string[];
+            unflagged: {
+                sampled: number;
+                resolved: number;
+                misses: number;
+                unresolved: number;
+                conflicted: number;
+            };
+            attentionUsed: number;
+            retired: boolean;
+            exposures: {
+                mode: "ask" | "silent" | "retire";
+                reason: string;
+                id: string;
+            }[];
+            tip: string;
+            grantExpansion: false;
+        };
+        configuration: () => TrustLifecycleInput;
+        previewExposure: (now: number) => {
+            mode: "silent" | "ask" | "retire";
+            reason: string;
+            advisoryOnly: true;
+        } | {
+            mode: "retire";
+            reason: string;
+        } | {
+            mode: "silent";
+            reason: string;
+        };
+        history: () => import("./learning-journal.js").LearningEvent[];
+        previewCaseOutcome: (predictionId: string, reference: LearningCaseReference) => {
+            outcome: import("./trust-lifecycle.js").TrustReferenceOutcome;
+            caseReference: LearningCaseReference;
+            digest: string;
+            tip: string;
+        };
+        linkCaseOutcome(predictionId: string, reference: LearningCaseReference, authorizedDigests: readonly string[], referenceAuthor?: string): void;
+        predict(p: import("@skill-harness/core").CalibrationPrediction): void;
+        correct(prior: string, p: import("@skill-harness/core").CalibrationPrediction, reason: string): void;
+        outcome(value: import("./trust-lifecycle.js").TrustReferenceOutcome, authorizedReferenceDigests: readonly string[], referenceAuthor?: string): void;
+        expose(id: string, now: number): {
+            replayed: boolean;
+            mode: "ask" | "silent" | "retire";
+            reason: string;
+        } | {
+            replayed: boolean;
+            mode: "silent" | "ask" | "retire";
+            reason: string;
+            advisoryOnly: true;
+        };
+    };
+    addUnflagged(raw: {
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    }): {
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    };
+    unflagged(): {
+        incidentId: string;
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    }[];
+    cases(name: string, offset?: number): {
+        batchId: string;
+        version: 2 | 3;
+        observationId: string;
+        issues: string[];
+        total: number;
+        offset: number;
+        items: {
+            caseManifestId: string;
+            candidate: import("@skill-harness/core").WorkCaptureCaseV2 | import("@skill-harness/core").WorkCaptureCaseV3;
+            priorDecisionId: string | null;
+            disposition: string;
+        }[];
+    } | {
+        batchId: string;
+        version: 2 | 3;
+        total: number;
+        offset: number;
+        items: {
+            caseManifestId: string;
+            candidate: import("@skill-harness/core").WorkCaptureCaseV2;
+            priorDecisionId: string | null;
+            disposition: string;
+        }[];
+    };
+    caseEvidence(name: string, caseManifestId: string): ({
+        status: "missing";
+        reason: "manifest" | "content" | "not-retained";
+        manifestId: string;
+        role: string;
+    } | {
+        status: "error";
+        reason: string;
+        manifestId: string;
+        role: string;
+    } | {
+        status: "available";
+        reference: import("./evidence-archive.js").ArchiveSourceReference;
+        manifestId: string;
+        role: string;
+    })[];
+    readCaseEvidence(name: string, caseManifestId: string, manifestId: string): import("./evidence-archive.js").ArchiveRead;
+    decideCase(name: string, request: WorkCaseReviewRequest): {
+        current: import("@skill-harness/core").WorkCaseDecision;
+        replayed: boolean;
+    };
+    hypotheses(): {
+        hypothesis: Hypothesis;
+        name: string;
+        manifestId: string;
+    }[];
+    propose(name: string, proposal: HypothesisProposal, hypothesisName?: string): {
+        hypothesis: Hypothesis;
+        manifestId: string;
+    };
+    comparison(name: string): {
+        name: string;
+        title: string;
+        scopeStatement: string;
+        mode: "deliberate-review";
+        cards: {
+            displayLabel: string;
+            label: string;
+            artifactDigests: string[];
+        }[];
+        choice: BlindQualityChoice | null;
+        qualityScope: string | null;
+        priorFeedback: {
+            manifestId: string;
+            scope: "prior-feedback-only";
+        }[];
+        decision: {
+            disposition: "adopt" | "reject" | "defer";
+            note: string;
+            priorDecisionId: string | null;
+            id: string;
+        } | null;
+        activation: string;
+        rollback: string;
+        outcomes: {
+            manifestId: unknown;
+            classification: Readonly<{
+                state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+                adoptionId: string;
+                hypothesisDigest: string;
+                experimentDigest: string;
+                observationId: string;
+                acceptanceDigest: string | null;
+                acceptedArtifactDigest: string | null;
+                observedArtifactDigest: string;
+                automaticRollback: false;
+            }>;
+        }[];
+        adoptionReadiness: {
+            state: string;
+            reason: string;
+        };
+        laterOutcomeReadiness: string;
+        revealReady: boolean;
+        adoptionConfigured: boolean;
+        limitations: string[];
+    };
+    artifact(name: string, label: string, digest: string): Buffer<ArrayBuffer>;
+    choose(name: string, raw: BlindQualityChoice, rawReview: LearningQualityReview): Record<string, unknown>;
+    reveal(name: string): {
+        manifestId: string;
+        choice: BlindQualityChoice;
+        arms: {
+            label: string;
+            armId: string;
+            configuration: Record<import("@skill-harness/core").InterventionAxis, string>;
+            cost: number | null;
+            costUnit: string;
+        }[];
+        routingDefault: null;
+    };
+    decisionStatus(name: string): {
+        name: string;
+        title: string;
+        scopeStatement: string;
+        current: {
+            disposition: "adopt" | "reject" | "defer";
+            note: string;
+            priorDecisionId: string | null;
+            id: string;
+        } | null;
+    };
+    decide(name: string, raw: LearningDecisionRequest): {
+        disposition: "adopt" | "reject" | "defer";
+        note: string;
+        priorDecisionId: string | null;
+        id: string;
+    };
+    prepareAdoption(name: string, authority: AdoptionAuthority | null, facts: AdoptionFacts, now: number): Readonly<{
+        id: string;
+        version: "adoption-receipt-v1";
+        bindingId: string;
+        authorityId: string;
+        hypothesisDigest: string;
+        experimentDigest: string;
+        candidateDigest: string;
+        scopeDigest: string;
+        assessmentPolicyDigest: string;
+        rollbackCandidateDigest: string;
+        activationBoundary: "next-orders";
+        grantExpansion: false;
+        expiresAt: number;
+    }>;
+    linkActivation(name: string, manifestId: string, authorizedManifestIds: readonly string[]): LearningRegistryReceipt;
+    previewRollback(name: string, reason: RollbackRequest["reason"], evidence: string[], expiresAt?: number): RollbackRequest;
+    prepareRollback(name: string, request: RollbackRequest, authority: AdoptionAuthority | null, now: number, current: {
+        adoptionId: string;
+        candidateDigest: string;
+        scopeDigest: string;
+    }): Readonly<{
+        requestId: string;
+        adoptionId: string;
+        restoreCandidateDigest: string;
+        scopeDigest: string;
+        grantExpansion: false;
+        application: "not-performed";
+    }>;
+    linkRollback(name: string, manifestId: string, authorizedManifestIds: readonly string[]): LearningRegistryReceipt;
+    previewObservation(name: string, raw: ProductionObservation): {
+        observation: ProductionObservation;
+        classification: Readonly<{
+            state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+            adoptionId: string;
+            hypothesisDigest: string;
+            experimentDigest: string;
+            observationId: string;
+            acceptanceDigest: string | null;
+            acceptedArtifactDigest: string | null;
+            observedArtifactDigest: string;
+            automaticRollback: false;
+        }>;
+        digest: string;
+    };
+    observe(name: string, raw: ProductionObservation, authorizedDigests: readonly string[], referenceAuthor?: string): Record<string, unknown>;
+    lifecycle(name: string): {
+        state: string;
+        manifestId: null;
+    } | {
+        state: string;
+        manifestId: string;
+    };
+    inspect(now: number): {
+        version: "learning-workspace-view-v1";
+        configuration: LearningWorkspaceInput;
+        mode: "deliberate-review";
+        sessions: ({
+            state: string;
+            sessionId: string;
+            reason: string;
+            name: string;
+            title: string;
+            manifestId: string;
+        } | {
+            state: string;
+            sessionId: null;
+            reason: string;
+            name: string;
+            title: string;
+            manifestId: string;
+        })[];
+        cases: ({
+            name: string;
+            title: string;
+            state: string;
+            total: number;
+            reason: string;
+        } | {
+            name: string;
+            title: string;
+            state: string;
+            total: null;
+            reason: string;
+        })[];
+        comparisons: ({
+            name: string;
+            title: string;
+            scopeStatement: string;
+            mode: "deliberate-review";
+            cards: {
+                displayLabel: string;
+                label: string;
+                artifactDigests: string[];
+            }[];
+            choice: BlindQualityChoice | null;
+            qualityScope: string | null;
+            priorFeedback: {
+                manifestId: string;
+                scope: "prior-feedback-only";
+            }[];
+            decision: {
+                disposition: "adopt" | "reject" | "defer";
+                note: string;
+                priorDecisionId: string | null;
+                id: string;
+            } | null;
+            activation: string;
+            rollback: string;
+            outcomes: {
+                manifestId: unknown;
+                classification: Readonly<{
+                    state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+                    adoptionId: string;
+                    hypothesisDigest: string;
+                    experimentDigest: string;
+                    observationId: string;
+                    acceptanceDigest: string | null;
+                    acceptedArtifactDigest: string | null;
+                    observedArtifactDigest: string;
+                    automaticRollback: false;
+                }>;
+            }[];
+            adoptionReadiness: {
+                state: string;
+                reason: string;
+            };
+            laterOutcomeReadiness: string;
+            revealReady: boolean;
+            adoptionConfigured: boolean;
+            limitations: string[];
+            state: string;
+            reason: string;
+        } | {
+            name: string;
+            title: string;
+            state: string;
+            reason: string;
+            decision: {
+                disposition: "adopt" | "reject" | "defer";
+                note: string;
+                priorDecisionId: string | null;
+                id: string;
+            } | null;
+        })[];
+        trust: Record<string, unknown>;
+        automaticExposureReserved: boolean;
+        delegationStarted: boolean;
+        acceptance: "not-assessed";
+    };
+};
+export declare function openLearningWorkspace(directory: string): {
+    configuration: () => LearningWorkspaceInput;
+    bindSession(raw: {
+        name: string;
+        title: string;
+        manifestId: string;
+    }): {
+        name: string;
+        title: string;
+        manifestId: string;
+    };
+    noteSession(name: string, raw: {
+        kind: "finding" | "proposal" | "acceptance" | "context";
+        note: string;
+        item: number;
+        line: number;
+    }): {
+        author: string;
+        kind: "finding" | "proposal" | "acceptance" | "context";
+        note: string;
+        item: number;
+        line: number;
+    };
+    sessions(): ({
+        state: string;
+        sessionId: string;
+        reason: string;
+        name: string;
+        title: string;
+        manifestId: string;
+    } | {
+        state: string;
+        sessionId: null;
+        reason: string;
+        name: string;
+        title: string;
+        manifestId: string;
+    })[];
+    session(name: string): {
+        annotations: {
+            kind: string;
+            note: string;
+            item: number;
+            line: number;
+            author: string;
+        }[];
+        acceptance: "not-assessed";
+        parent: import("./session-observation.js").SessionObservation;
+        children: {
+            source: number;
+            executionId: string | null;
+            session: import("./session-observation.js").SessionObservation;
+        }[];
+        attempts: import("./session-observation.js").SessionAttempt[];
+        gaps: string[];
+        version: "retrospective-session-v1";
+        manifestId: string;
+        selectionDigest: string;
+        sources: (import("./session-retention.js").Source & {
+            manifestId: string;
+        })[];
+        name: string;
+        title: string;
+    };
+    dashboardBinding(): {
+        trustDirectory: string | null;
+        trustPolicyId: string | null;
+    };
+    preparedAdoption(name: string): Readonly<{
+        id: string;
+        version: "adoption-receipt-v1";
+        bindingId: string;
+        authorityId: string;
+        hypothesisDigest: string;
+        experimentDigest: string;
+        candidateDigest: string;
+        scopeDigest: string;
+        assessmentPolicyDigest: string;
+        rollbackCandidateDigest: string;
+        activationBoundary: "next-orders";
+        grantExpansion: false;
+        expiresAt: number;
+    }> | null;
+    adoptionStatus(name: string): {
+        binding: AdoptionBinding | null;
+        receipt: Readonly<{
+            id: string;
+            version: "adoption-receipt-v1";
+            bindingId: string;
+            authorityId: string;
+            hypothesisDigest: string;
+            experimentDigest: string;
+            candidateDigest: string;
+            scopeDigest: string;
+            assessmentPolicyDigest: string;
+            rollbackCandidateDigest: string;
+            activationBoundary: "next-orders";
+            grantExpansion: false;
+            expiresAt: number;
+        }> | null;
+        activationManifestId: string | null;
+        rollbackManifestId: string | null;
+    };
+    bindCases(raw: LearningCaseBinding): LearningCaseBinding;
+    bindComparison(raw: LearningComparisonBinding): {
+        name: string;
+        comparisonManifestId: string;
+    };
+    linkComparisonContext(name: string, context: Pick<LearningComparisonBinding, "caseReference" | "hypothesisManifestId" | "adoptionBinding">): {
+        name: string;
+        linked: boolean;
+    };
+    comparisonContext(name: string): {
+        caseReference: LearningCaseReference | null;
+        hypothesisManifestId: string | null;
+        adoptionBinding: AdoptionBinding | null;
+    };
+    bindTrust(trustDirectory: string): void;
+    configureTrust(raw: TrustLifecycleInput, authorizedPolicyDigests: readonly string[]): {
+        policyId: string;
+        component: import("@skill-harness/core").CalibrationComponent;
+        calibration: {
+            version: "factory-calibration-v1";
+            reports: import("@skill-harness/core").CalibrationReport[];
+            excludedTuning: number;
+            referenceBasis: "independently-supplied-host-context";
+            advisoryOnly: true;
+        };
+        sampledIncidentIds: string[];
+        unflagged: {
+            sampled: number;
+            resolved: number;
+            misses: number;
+            unresolved: number;
+            conflicted: number;
+        };
+        attentionUsed: number;
+        retired: boolean;
+        exposures: {
+            mode: "ask" | "silent" | "retire";
+            reason: string;
+            id: string;
+        }[];
+        tip: string;
+        grantExpansion: false;
+    };
+    trust(): {
+        inspect: (now: number) => {
+            policyId: string;
+            component: import("@skill-harness/core").CalibrationComponent;
+            calibration: {
+                version: "factory-calibration-v1";
+                reports: import("@skill-harness/core").CalibrationReport[];
+                excludedTuning: number;
+                referenceBasis: "independently-supplied-host-context";
+                advisoryOnly: true;
+            };
+            sampledIncidentIds: string[];
+            unflagged: {
+                sampled: number;
+                resolved: number;
+                misses: number;
+                unresolved: number;
+                conflicted: number;
+            };
+            attentionUsed: number;
+            retired: boolean;
+            exposures: {
+                mode: "ask" | "silent" | "retire";
+                reason: string;
+                id: string;
+            }[];
+            tip: string;
+            grantExpansion: false;
+        };
+        configuration: () => TrustLifecycleInput;
+        previewExposure: (now: number) => {
+            mode: "silent" | "ask" | "retire";
+            reason: string;
+            advisoryOnly: true;
+        } | {
+            mode: "retire";
+            reason: string;
+        } | {
+            mode: "silent";
+            reason: string;
+        };
+        history: () => import("./learning-journal.js").LearningEvent[];
+        previewCaseOutcome: (predictionId: string, reference: LearningCaseReference) => {
+            outcome: import("./trust-lifecycle.js").TrustReferenceOutcome;
+            caseReference: LearningCaseReference;
+            digest: string;
+            tip: string;
+        };
+        linkCaseOutcome(predictionId: string, reference: LearningCaseReference, authorizedDigests: readonly string[], referenceAuthor?: string): void;
+        predict(p: import("@skill-harness/core").CalibrationPrediction): void;
+        correct(prior: string, p: import("@skill-harness/core").CalibrationPrediction, reason: string): void;
+        outcome(value: import("./trust-lifecycle.js").TrustReferenceOutcome, authorizedReferenceDigests: readonly string[], referenceAuthor?: string): void;
+        expose(id: string, now: number): {
+            replayed: boolean;
+            mode: "ask" | "silent" | "retire";
+            reason: string;
+        } | {
+            replayed: boolean;
+            mode: "silent" | "ask" | "retire";
+            reason: string;
+            advisoryOnly: true;
+        };
+    };
+    addUnflagged(raw: {
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    }): {
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    };
+    unflagged(): {
+        incidentId: string;
+        name: string;
+        title: string;
+        manifestId: string;
+        split: "calibration" | "heldout" | "tuning";
+    }[];
+    cases(name: string, offset?: number): {
+        batchId: string;
+        version: 2 | 3;
+        observationId: string;
+        issues: string[];
+        total: number;
+        offset: number;
+        items: {
+            caseManifestId: string;
+            candidate: import("@skill-harness/core").WorkCaptureCaseV2 | import("@skill-harness/core").WorkCaptureCaseV3;
+            priorDecisionId: string | null;
+            disposition: string;
+        }[];
+    } | {
+        batchId: string;
+        version: 2 | 3;
+        total: number;
+        offset: number;
+        items: {
+            caseManifestId: string;
+            candidate: import("@skill-harness/core").WorkCaptureCaseV2;
+            priorDecisionId: string | null;
+            disposition: string;
+        }[];
+    };
+    caseEvidence(name: string, caseManifestId: string): ({
+        status: "missing";
+        reason: "manifest" | "content" | "not-retained";
+        manifestId: string;
+        role: string;
+    } | {
+        status: "error";
+        reason: string;
+        manifestId: string;
+        role: string;
+    } | {
+        status: "available";
+        reference: import("./evidence-archive.js").ArchiveSourceReference;
+        manifestId: string;
+        role: string;
+    })[];
+    readCaseEvidence(name: string, caseManifestId: string, manifestId: string): import("./evidence-archive.js").ArchiveRead;
+    decideCase(name: string, request: WorkCaseReviewRequest): {
+        current: import("@skill-harness/core").WorkCaseDecision;
+        replayed: boolean;
+    };
+    hypotheses(): {
+        hypothesis: Hypothesis;
+        name: string;
+        manifestId: string;
+    }[];
+    propose(name: string, proposal: HypothesisProposal, hypothesisName?: string): {
+        hypothesis: Hypothesis;
+        manifestId: string;
+    };
+    comparison(name: string): {
+        name: string;
+        title: string;
+        scopeStatement: string;
+        mode: "deliberate-review";
+        cards: {
+            displayLabel: string;
+            label: string;
+            artifactDigests: string[];
+        }[];
+        choice: BlindQualityChoice | null;
+        qualityScope: string | null;
+        priorFeedback: {
+            manifestId: string;
+            scope: "prior-feedback-only";
+        }[];
+        decision: {
+            disposition: "adopt" | "reject" | "defer";
+            note: string;
+            priorDecisionId: string | null;
+            id: string;
+        } | null;
+        activation: string;
+        rollback: string;
+        outcomes: {
+            manifestId: unknown;
+            classification: Readonly<{
+                state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+                adoptionId: string;
+                hypothesisDigest: string;
+                experimentDigest: string;
+                observationId: string;
+                acceptanceDigest: string | null;
+                acceptedArtifactDigest: string | null;
+                observedArtifactDigest: string;
+                automaticRollback: false;
+            }>;
+        }[];
+        adoptionReadiness: {
+            state: string;
+            reason: string;
+        };
+        laterOutcomeReadiness: string;
+        revealReady: boolean;
+        adoptionConfigured: boolean;
+        limitations: string[];
+    };
+    artifact(name: string, label: string, digest: string): Buffer<ArrayBuffer>;
+    choose(name: string, raw: BlindQualityChoice, rawReview: LearningQualityReview): Record<string, unknown>;
+    reveal(name: string): {
+        manifestId: string;
+        choice: BlindQualityChoice;
+        arms: {
+            label: string;
+            armId: string;
+            configuration: Record<import("@skill-harness/core").InterventionAxis, string>;
+            cost: number | null;
+            costUnit: string;
+        }[];
+        routingDefault: null;
+    };
+    decisionStatus(name: string): {
+        name: string;
+        title: string;
+        scopeStatement: string;
+        current: {
+            disposition: "adopt" | "reject" | "defer";
+            note: string;
+            priorDecisionId: string | null;
+            id: string;
+        } | null;
+    };
+    decide(name: string, raw: LearningDecisionRequest): {
+        disposition: "adopt" | "reject" | "defer";
+        note: string;
+        priorDecisionId: string | null;
+        id: string;
+    };
+    prepareAdoption(name: string, authority: AdoptionAuthority | null, facts: AdoptionFacts, now: number): Readonly<{
+        id: string;
+        version: "adoption-receipt-v1";
+        bindingId: string;
+        authorityId: string;
+        hypothesisDigest: string;
+        experimentDigest: string;
+        candidateDigest: string;
+        scopeDigest: string;
+        assessmentPolicyDigest: string;
+        rollbackCandidateDigest: string;
+        activationBoundary: "next-orders";
+        grantExpansion: false;
+        expiresAt: number;
+    }>;
+    linkActivation(name: string, manifestId: string, authorizedManifestIds: readonly string[]): LearningRegistryReceipt;
+    previewRollback(name: string, reason: RollbackRequest["reason"], evidence: string[], expiresAt?: number): RollbackRequest;
+    prepareRollback(name: string, request: RollbackRequest, authority: AdoptionAuthority | null, now: number, current: {
+        adoptionId: string;
+        candidateDigest: string;
+        scopeDigest: string;
+    }): Readonly<{
+        requestId: string;
+        adoptionId: string;
+        restoreCandidateDigest: string;
+        scopeDigest: string;
+        grantExpansion: false;
+        application: "not-performed";
+    }>;
+    linkRollback(name: string, manifestId: string, authorizedManifestIds: readonly string[]): LearningRegistryReceipt;
+    previewObservation(name: string, raw: ProductionObservation): {
+        observation: ProductionObservation;
+        classification: Readonly<{
+            state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+            adoptionId: string;
+            hypothesisDigest: string;
+            experimentDigest: string;
+            observationId: string;
+            acceptanceDigest: string | null;
+            acceptedArtifactDigest: string | null;
+            observedArtifactDigest: string;
+            automaticRollback: false;
+        }>;
+        digest: string;
+    };
+    observe(name: string, raw: ProductionObservation, authorizedDigests: readonly string[], referenceAuthor?: string): Record<string, unknown>;
+    lifecycle(name: string): {
+        state: string;
+        manifestId: null;
+    } | {
+        state: string;
+        manifestId: string;
+    };
+    inspect(now: number): {
+        version: "learning-workspace-view-v1";
+        configuration: LearningWorkspaceInput;
+        mode: "deliberate-review";
+        sessions: ({
+            state: string;
+            sessionId: string;
+            reason: string;
+            name: string;
+            title: string;
+            manifestId: string;
+        } | {
+            state: string;
+            sessionId: null;
+            reason: string;
+            name: string;
+            title: string;
+            manifestId: string;
+        })[];
+        cases: ({
+            name: string;
+            title: string;
+            state: string;
+            total: number;
+            reason: string;
+        } | {
+            name: string;
+            title: string;
+            state: string;
+            total: null;
+            reason: string;
+        })[];
+        comparisons: ({
+            name: string;
+            title: string;
+            scopeStatement: string;
+            mode: "deliberate-review";
+            cards: {
+                displayLabel: string;
+                label: string;
+                artifactDigests: string[];
+            }[];
+            choice: BlindQualityChoice | null;
+            qualityScope: string | null;
+            priorFeedback: {
+                manifestId: string;
+                scope: "prior-feedback-only";
+            }[];
+            decision: {
+                disposition: "adopt" | "reject" | "defer";
+                note: string;
+                priorDecisionId: string | null;
+                id: string;
+            } | null;
+            activation: string;
+            rollback: string;
+            outcomes: {
+                manifestId: unknown;
+                classification: Readonly<{
+                    state: "unknown" | "success" | "out-of-scope" | "changed-requirements" | "changed-artifact" | "caught-defect" | "escape";
+                    adoptionId: string;
+                    hypothesisDigest: string;
+                    experimentDigest: string;
+                    observationId: string;
+                    acceptanceDigest: string | null;
+                    acceptedArtifactDigest: string | null;
+                    observedArtifactDigest: string;
+                    automaticRollback: false;
+                }>;
+            }[];
+            adoptionReadiness: {
+                state: string;
+                reason: string;
+            };
+            laterOutcomeReadiness: string;
+            revealReady: boolean;
+            adoptionConfigured: boolean;
+            limitations: string[];
+            state: string;
+            reason: string;
+        } | {
+            name: string;
+            title: string;
+            state: string;
+            reason: string;
+            decision: {
+                disposition: "adopt" | "reject" | "defer";
+                note: string;
+                priorDecisionId: string | null;
+                id: string;
+            } | null;
+        })[];
+        trust: Record<string, unknown>;
+        automaticExposureReserved: boolean;
+        delegationStarted: boolean;
+        acceptance: "not-assessed";
+    };
+};
+/** Explicit operator-selected archive inventory, not discovery of private sessions. Names/indices
+ * are presentation only; callers bind the full immutable manifest before any decision. */
+export interface LearningCatalogItem {
+    kind: 'cases' | 'comparison';
+    manifestId: string;
+    version: 1 | 2 | 3;
+    description: string;
+    scopeDigest?: string;
+    population?: string;
+}
+export declare function catalogLearningArchive(root: string, author: string): LearningCatalogItem[];