@unson/brainbase-mcp 0.35.0 → 0.36.0

package/dist/meeting-minutes.d.ts

@@ -66,6 +66,12 @@ export interface MinutesDocumentRecord {
     readonly created_actor_id: string;
     readonly updated_at: string;
     readonly revision: number;
+    /** Set when the document was taken back from its readers.  Versions and bodies are kept. */
+    readonly withdrawal?: MinutesWithdrawalReceipt;
+}
+export interface MinutesWithdrawalReceipt {
+    readonly actor_id: string;
+    readonly withdrawn_at: string;
 }
 export interface MeetingMinutesSnapshot {
     readonly schema_version: typeof MEETING_MINUTES_SNAPSHOT_VERSION;
@@ -76,7 +82,7 @@ export interface MeetingMinutesSnapshot {
     readonly versions: readonly MinutesVersionRecord[];
     readonly idempotency: readonly MeetingMinutesIdempotencyRecord[];
 }
-export type MeetingMinutesIdempotencyOperation = 'create_meeting' | 'create_minutes' | 'save_version' | 'confirm_version';
+export type MeetingMinutesIdempotencyOperation = 'create_meeting' | 'create_minutes' | 'save_version' | 'confirm_version' | 'withdraw_minutes';
 /** Durable write receipt.  It lets a retried mutation find its exact target after restart. */
 export interface MeetingMinutesIdempotencyRecord {
     readonly key: string;
@@ -144,6 +150,12 @@ export interface ConfirmMinutesVersionInput {
     readonly idempotency_key?: string;
     readonly idempotency_fingerprint?: string;
 }
+export interface WithdrawMinutesInput {
+    readonly minutes_id: MinutesId;
+    readonly expected_revision: number;
+    readonly idempotency_key?: string;
+    readonly idempotency_fingerprint?: string;
+}
 export interface MeetingMinutesSummary {
     readonly meeting: MeetingRecord;
     readonly minutes: readonly MinutesDocumentRecord[];
@@ -186,6 +198,8 @@ export interface MeetingMinutesStore {
     get_version(meeting_id: MeetingId, minutes_id: MinutesId, version_id: MinutesVersionId, context: MeetingMinutesRequestContext): Promise<MinutesVersionRecord>;
     save_version(input: SaveMinutesVersionInput, context: MeetingMinutesRequestContext): Promise<MeetingMinutesDetail>;
     confirm_version(input: ConfirmMinutesVersionInput, context: MeetingMinutesRequestContext): Promise<MeetingMinutesDetail>;
+    /** Takes a document back from its readers (story-meeting-minutes-withdraw-v1).  Nothing is deleted. */
+    withdraw_minutes(input: WithdrawMinutesInput, context: MeetingMinutesRequestContext): Promise<MeetingMinutesDetail>;
 }
 /**
  * Provider-neutral exact-version seam used by lineage and other read-only

package/dist/meeting-minutes.js

@@ -289,6 +289,12 @@ function assertSnapshotShape(value) {
         checkDate(raw.updated_at, `Minutes document ${minutesId}.updated_at`);
         if (typeof raw.created_actor_id !== 'string' || !raw.created_actor_id.trim())
             throw new MeetingMinutesError('corrupt_record', `Minutes document ${minutesId}.created_actor_id is invalid`);
+        if (raw.withdrawal !== undefined) {
+            if (!isRecord(raw.withdrawal) || typeof raw.withdrawal.actor_id !== 'string' || !raw.withdrawal.actor_id.trim()) {
+                throw new MeetingMinutesError('corrupt_record', `Minutes document ${minutesId}.withdrawal is invalid`);
+            }
+            checkDate(raw.withdrawal.withdrawn_at, `Minutes document ${minutesId}.withdrawal.withdrawn_at`);
+        }
     }
     const versionIds = new Set();
     const versionById = new Map();
@@ -401,7 +407,8 @@ function assertSnapshotShape(value) {
         if (typeof key !== 'string' || key.trim() === '' || key.length > 200
             || typeof principalId !== 'string' || principalId.trim() === ''
             || typeof fingerprint !== 'string' || fingerprint.trim() === '' || fingerprint.length > 512
-            || (operation !== 'create_meeting' && operation !== 'create_minutes' && operation !== 'save_version' && operation !== 'confirm_version')
+            || (operation !== 'create_meeting' && operation !== 'create_minutes' && operation !== 'save_version' && operation !== 'confirm_version'
+                && operation !== 'withdraw_minutes')
             || typeof meetingId !== 'string' || !meetingIds.has(meetingId)) {
             throw new MeetingMinutesError('corrupt_record', 'Idempotency record is invalid');
         }
@@ -421,9 +428,9 @@ function assertSnapshotShape(value) {
             || documentById.get(minutesId)?.meeting_id !== meetingId) {
             throw new MeetingMinutesError('corrupt_record', 'Idempotency record minutes_id is invalid');
         }
-        if (operation === 'create_minutes') {
+        if (operation === 'create_minutes' || operation === 'withdraw_minutes') {
             if (versionId !== undefined)
-                throw new MeetingMinutesError('corrupt_record', 'create_minutes idempotency record has an unexpected version_id');
+                throw new MeetingMinutesError('corrupt_record', `${operation} idempotency record has an unexpected version_id`);
             continue;
         }
         if (typeof versionId !== 'string' || !versionIds.has(versionId)
@@ -601,7 +608,15 @@ function detail(snapshot, meeting) {
     return freezeClone({ meeting, minutes, versions, snapshot_revision: snapshot.revision });
 }
 function summary(snapshot, meeting) {
-    return freezeClone({ meeting, minutes: snapshot.documents.filter((candidate) => candidate.meeting_id === meeting.meeting_id) });
+    // A withdrawn document is taken back from listings; its detail stays readable for history.
+    return freezeClone({
+        meeting,
+        minutes: snapshot.documents.filter((candidate) => candidate.meeting_id === meeting.meeting_id && !candidate.withdrawal)
+    });
+}
+function assertNotWithdrawn(document) {
+    if (document.withdrawal)
+        throw invalid(`Minutes document ${document.minutes_id} was withdrawn`);
 }
 function ensureRevision(actual, expected) {
     if (!Number.isInteger(expected) || expected < 1)
@@ -974,6 +989,7 @@ export function createMeetingMinutesStore(options) {
         const meeting = findMeeting(snapshot, document.meeting_id);
         await authorized(authorizer, 'write', meeting, context);
         await authorized(authorizer, 'write', document, context);
+        assertNotWithdrawn(document);
         ensureRevision(document.revision, input.expected_revision);
         const predecessor = input.predecessor_version_id === undefined ? document.current_version_id : nonEmptyString(input.predecessor_version_id, 'predecessor_version_id');
         if (predecessor !== document.current_version_id)
@@ -1046,6 +1062,7 @@ export function createMeetingMinutesStore(options) {
         const version = snapshot.versions.find((candidate) => candidate.version_id === versionId && candidate.minutes_id === minutesId);
         if (!version)
             throw new MeetingMinutesError('not_found', `Minutes version ${versionId} was not found`);
+        assertNotWithdrawn(document);
         ensureRevision(document.revision, input.expected_revision);
         if (version.confirmation) {
             if (!idempotency.token)
@@ -1102,7 +1119,52 @@ export function createMeetingMinutesStore(options) {
             throw new MeetingMinutesError('readback_mismatch', 'Confirmation did not read back');
         return detailForCaller(readback, savedMeeting, context);
     }
-    return { list_meetings, create_meeting, create_minutes, get_meeting, get_version, save_version, confirm_version };
+    async function withdraw_minutes(input, context) {
+        const principal = assertPrincipal(context);
+        if (!isRecord(input))
+            throw invalid('withdrawal input must be an object');
+        const minutesId = nonEmptyString(input.minutes_id, 'minutes_id');
+        const snapshot = await readSnapshot();
+        const idempotency = await resolveIdempotency(snapshot, principal, input, 'withdraw_minutes', context, { minutes_id: minutesId });
+        if (idempotency.replay)
+            return idempotency.replay;
+        const document = findDocument(snapshot, minutesId);
+        const meeting = findMeeting(snapshot, document.meeting_id);
+        await authorized(authorizer, 'write', meeting, context);
+        await authorized(authorizer, 'write', document, context);
+        // Withdrawing twice keeps the first record; a retry is not a second withdrawal.
+        if (document.withdrawal && !idempotency.token)
+            return detailForCaller(snapshot, meeting, context);
+        if (!document.withdrawal)
+            ensureRevision(document.revision, input.expected_revision);
+        const timestamp = isoNow(now);
+        const next = snapshotMutable(snapshot);
+        next.revision += 1;
+        if (!document.withdrawal) {
+            next.documents = next.documents.map((candidate) => candidate.minutes_id === minutesId
+                ? { ...candidate, withdrawal: { actor_id: principal, withdrawn_at: timestamp }, updated_at: timestamp, revision: candidate.revision + 1 }
+                : candidate);
+        }
+        addIdempotencyRecord(next, idempotency.token, 'withdraw_minutes', {
+            meeting_id: meeting.meeting_id,
+            minutes_id: minutesId
+        }, principal);
+        let readback;
+        try {
+            readback = await writeSnapshot(next, snapshot.revision);
+        }
+        catch (error) {
+            const replay = await replayAfterConflict(error, idempotency.token, principal, 'withdraw_minutes', context, { minutes_id: minutesId });
+            if (replay)
+                return replay;
+            throw error;
+        }
+        const saved = findDocument(readback, minutesId);
+        if (!saved.withdrawal)
+            throw new MeetingMinutesError('readback_mismatch', 'Withdrawal did not read back');
+        return detailForCaller(readback, findMeeting(readback, meeting.meeting_id), context);
+    }
+    return { list_meetings, create_meeting, create_minutes, get_meeting, get_version, save_version, confirm_version, withdraw_minutes };
 }
 function participantIdsInput(value) {
     return participantIds(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.35.0",
+  "version": "0.36.0",
   "description": "Local-first Brainbase judgment OS that lets supported AI agents reuse a user's approved goals, priorities, decisions, and judgment criteria.",
   "type": "module",
   "license": "MIT",
@@ -479,5 +479,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "e343d28419451fde27b9d35b1c226fc769e68420"
+  "gitHead": "f7389b6d15e12a3fb7312d305be6f6f9660e8c79"
 }