@unson/brainbase-mcp 0.21.2 → 0.22.1

package/dist/meeting-minutes-lineage.d.ts

@@ -0,0 +1,307 @@
+/**
+ * The minutes lineage ledger stores references and lifecycle events only.
+ * Meeting body content, judgment state, Task state, and execution receipts
+ * remain owned by their existing providers.
+ */
+export declare const MEETING_MINUTES_LINEAGE_CONTRACT_VERSION: "0.1.0";
+export declare const MEETING_MINUTES_LINEAGE_CATALOG_VERSION: 1;
+export declare const MEETING_MINUTES_LINEAGE_SIDECAR: "evidence/meeting-minutes-lineage.json";
+export type MinutesLineageCandidateKind = 'judgment' | 'task';
+export type MinutesLineageEpistemicStatus = 'confirmed' | 'inferred';
+export type MinutesLineageConfirmationStatus = 'unconfirmed' | 'confirmed';
+export type MinutesLineageAdoptionStatus = 'not_adopted' | 'adopted';
+export type MinutesLineageExecutionStatus = 'unrecorded' | 'actual';
+export type MinutesLineageResultStatus = 'unrecorded' | 'accepted';
+export type MinutesLineageReviewStatus = 'clear' | 'review_required';
+export interface MinutesLineageAccess {
+    readonly principal: string;
+    readonly [key: string]: unknown;
+}
+export interface MinutesLineageActor {
+    readonly type: 'person' | 'agent' | 'service' | 'system';
+    readonly id: string;
+}
+/**
+ * A source-owned, exact minutes reference. `contentDigest: null` preserves a
+ * source that did not record a digest; the lineage layer never calculates a
+ * replacement digest and labels it as source evidence.
+ */
+export interface MinutesVersionReference {
+    readonly meetingId: string;
+    readonly minutesId: string;
+    readonly versionId: string;
+    readonly contentDigest: string | null;
+    readonly locator: unknown;
+    readonly provenance: MinutesProvenance;
+}
+export interface MinutesProvenance {
+    readonly providerKind: string;
+    readonly providerId: string;
+    readonly revision?: string;
+    readonly digest?: string;
+}
+export interface MinutesVersionRead {
+    readonly reference: MinutesVersionReference;
+}
+/** The native minutes owner must enforce its current ACL before returning. */
+export interface MinutesVersionPort {
+    readExact(reference: MinutesVersionReference, access: MinutesLineageAccess): Promise<MinutesVersionRead | null>;
+}
+export interface JudgmentTargetReference {
+    readonly kind: 'judgment';
+    readonly id: string;
+    readonly revision: string;
+    readonly digest: string;
+}
+export interface TaskTargetReference {
+    readonly kind: 'task';
+    readonly id: string;
+    readonly version: number;
+    readonly digest?: string;
+}
+export type MinutesLineageTargetReference = JudgmentTargetReference | TaskTargetReference;
+export interface AdoptionReference {
+    readonly kind: 'judgment_adoption' | 'task_adoption';
+    readonly id: string;
+    readonly revision: string;
+    readonly digest: string;
+}
+export interface JudgmentAdoptionResult {
+    readonly target: JudgmentTargetReference;
+    readonly adoption: AdoptionReference;
+}
+export interface TaskAdoptionResult {
+    readonly target: TaskTargetReference;
+    readonly adoption: AdoptionReference;
+}
+export interface JudgmentLineagePort {
+    /** Adapt the existing Knowledge promotion or learning adoption service. */
+    adopt(input: {
+        readonly candidate: MinutesLineageCandidate;
+        readonly idempotencyKey: string;
+        readonly actor: MinutesLineageActor;
+        readonly access: MinutesLineageAccess;
+    }): Promise<JudgmentAdoptionResult>;
+    /** Re-read the exact target with the provider's current ACL. */
+    readExact(target: JudgmentTargetReference, access: MinutesLineageAccess): Promise<unknown | null>;
+}
+export interface TaskLineagePort {
+    /** Adapt the existing Canonical Task service. */
+    create(input: {
+        readonly candidate: MinutesLineageCandidate;
+        readonly idempotencyKey: string;
+        readonly actor: MinutesLineageActor;
+        readonly access: MinutesLineageAccess;
+    }): Promise<TaskAdoptionResult>;
+    /** Re-read the exact Task version with the provider's current ACL. */
+    readExact(target: TaskTargetReference, access: MinutesLineageAccess): Promise<unknown | null>;
+}
+export interface ExecutionReceiptReference {
+    readonly id: string;
+    readonly digest: string;
+}
+export interface ExecutionReceiptRead {
+    readonly reference: ExecutionReceiptReference;
+    readonly runId: string;
+    readonly target: MinutesLineageTargetReference;
+}
+export interface ExecutionReceiptPort {
+    read(reference: ExecutionReceiptReference, access: MinutesLineageAccess): Promise<ExecutionReceiptRead | null>;
+}
+export interface ResultReference {
+    readonly id: string;
+    readonly digest: string;
+}
+export interface ResultRead {
+    readonly reference: ResultReference;
+    readonly target: MinutesLineageTargetReference;
+}
+export interface ResultPort {
+    read(reference: ResultReference, access: MinutesLineageAccess): Promise<ResultRead | null>;
+}
+export interface MinutesLineageStoreOptions {
+    readonly dataDir: string;
+    readonly minutes: MinutesVersionPort;
+    readonly judgment?: JudgmentLineagePort;
+    readonly task?: TaskLineagePort;
+    readonly receipt?: ExecutionReceiptPort;
+    readonly result?: ResultPort;
+    readonly now?: () => string;
+}
+export interface CreateMinutesLineageCandidateRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly actor: MinutesLineageActor;
+    readonly evidence: MinutesVersionReference;
+    readonly kind: MinutesLineageCandidateKind;
+    readonly proposal: unknown;
+    readonly epistemicStatus: MinutesLineageEpistemicStatus;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageCandidate {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly actor: MinutesLineageActor;
+    readonly evidence: MinutesVersionReference;
+    readonly evidenceDigest: string;
+    readonly kind: MinutesLineageCandidateKind;
+    readonly proposal: unknown;
+    readonly proposalDigest: string;
+    readonly epistemicStatus: MinutesLineageEpistemicStatus;
+    readonly createdAt: string;
+    readonly digest: string;
+}
+export interface ConfirmMinutesLineageCandidateRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly candidateId: string;
+    readonly actor: MinutesLineageActor;
+    readonly evidenceDigest: string;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageConfirmation {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly candidateId: string;
+    readonly candidateDigest: string;
+    readonly actor: MinutesLineageActor;
+    readonly evidenceDigest: string;
+    readonly confirmedAt: string;
+    readonly digest: string;
+}
+export interface AdoptMinutesLineageRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly candidateId: string;
+    readonly actor: MinutesLineageActor;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageAdoption {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly candidateId: string;
+    readonly candidateDigest: string;
+    readonly kind: MinutesLineageCandidateKind;
+    readonly target: MinutesLineageTargetReference;
+    readonly adoption: AdoptionReference;
+    readonly actor: MinutesLineageActor;
+    readonly adoptedAt: string;
+    readonly digest: string;
+}
+export interface RecordMinutesLineageExecutionRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly candidateId: string;
+    readonly receiptRef: ExecutionReceiptReference;
+    readonly actor: MinutesLineageActor;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageExecution {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly candidateId: string;
+    readonly adoptionId: string;
+    readonly target: MinutesLineageTargetReference;
+    readonly receiptRef: ExecutionReceiptReference;
+    readonly runId: string;
+    readonly actor: MinutesLineageActor;
+    readonly executedAt: string;
+    readonly digest: string;
+}
+export interface AcceptMinutesLineageResultRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly executionId: string;
+    readonly resultRef: ResultReference;
+    readonly actor: MinutesLineageActor;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageResult {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly executionId: string;
+    readonly resultRef: ResultReference;
+    readonly target: MinutesLineageTargetReference;
+    readonly actor: MinutesLineageActor;
+    readonly acceptedAt: string;
+    readonly digest: string;
+}
+export interface MarkMinutesLineageCorrectionRequest {
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly previousVersion: MinutesVersionReference;
+    readonly replacementVersion: MinutesVersionReference;
+    readonly actor: MinutesLineageActor;
+    readonly reason: string;
+    readonly access: MinutesLineageAccess;
+}
+export interface MinutesLineageCorrection {
+    readonly version: typeof MEETING_MINUTES_LINEAGE_CATALOG_VERSION;
+    readonly id: string;
+    readonly idempotencyKey: string;
+    readonly requestDigest: string;
+    readonly previousVersion: MinutesVersionReference;
+    readonly replacementVersion: MinutesVersionReference;
+    readonly affectedCandidateIds: readonly string[];
+    readonly actor: MinutesLineageActor;
+    readonly reason: string;
+    readonly correctedAt: string;
+    readonly digest: string;
+}
+export interface MinutesLineageCandidateView {
+    readonly candidate: MinutesLineageCandidate;
+    readonly confirmation?: MinutesLineageConfirmation;
+    readonly adoption?: MinutesLineageAdoption;
+    readonly execution?: MinutesLineageExecution;
+    readonly result?: MinutesLineageResult;
+    readonly confirmationStatus: MinutesLineageConfirmationStatus;
+    readonly adoptionStatus: MinutesLineageAdoptionStatus;
+    readonly executionStatus: MinutesLineageExecutionStatus;
+    readonly resultStatus: MinutesLineageResultStatus;
+    readonly reviewStatus: MinutesLineageReviewStatus;
+    readonly targetStatus?: LineageTargetStatus;
+}
+export interface LineageTargetStatus {
+    readonly status: 'available' | 'unavailable' | 'denied';
+    readonly reason?: string;
+}
+export interface MinutesLineageByMinutesVersionView {
+    readonly evidence: MinutesVersionReference;
+    readonly candidates: readonly MinutesLineageCandidateView[];
+    readonly corrections: readonly MinutesLineageCorrection[];
+}
+export interface MinutesLineageByTargetView {
+    readonly target: MinutesLineageTargetReference;
+    readonly adoptions: readonly MinutesLineageAdoption[];
+    readonly candidates: readonly MinutesLineageCandidateView[];
+    readonly sourceStatuses: Readonly<Record<string, LineageTargetStatus>>;
+}
+export interface MinutesLineageStore {
+    createCandidate(request: CreateMinutesLineageCandidateRequest): Promise<MinutesLineageCandidate>;
+    readCandidate(id: string, access: MinutesLineageAccess): Promise<MinutesLineageCandidate | null>;
+    confirmCandidate(request: ConfirmMinutesLineageCandidateRequest): Promise<MinutesLineageConfirmation>;
+    adoptJudgment(request: AdoptMinutesLineageRequest): Promise<MinutesLineageAdoption>;
+    adoptTask(request: AdoptMinutesLineageRequest): Promise<MinutesLineageAdoption>;
+    recordExecution(request: RecordMinutesLineageExecutionRequest): Promise<MinutesLineageExecution>;
+    acceptResult(request: AcceptMinutesLineageResultRequest): Promise<MinutesLineageResult>;
+    markCorrection(request: MarkMinutesLineageCorrectionRequest): Promise<MinutesLineageCorrection>;
+    readByMinutesVersion(reference: MinutesVersionReference, access: MinutesLineageAccess): Promise<MinutesLineageByMinutesVersionView>;
+    readByTarget(target: MinutesLineageTargetReference, access: MinutesLineageAccess): Promise<MinutesLineageByTargetView>;
+}
+export type MeetingMinutesLineageErrorCode = 'invalid_input' | 'not_found' | 'authorization_denied' | 'source_unavailable' | 'source_not_found' | 'target_unavailable' | 'provider_unavailable' | 'integrity_mismatch' | 'revision_conflict' | 'corrupt_record' | 'readback_mismatch';
+export declare class MeetingMinutesLineageError extends Error {
+    readonly code: MeetingMinutesLineageErrorCode;
+    constructor(code: MeetingMinutesLineageErrorCode, message: string);
+}
+export declare function createMeetingMinutesLineageStore(options: MinutesLineageStoreOptions): MinutesLineageStore;
+export declare function initializeMeetingMinutesLineageStore(dataDir: string): Promise<void>;