@unson/brainbase-mcp 0.34.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.34.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": "9275d1ad54f053c85229a44b1c4cba811969cd29"
+  "gitHead": "f7389b6d15e12a3fb7312d305be6f6f9660e8c79"
 }

package/ui/world/world-view.js

@@ -1514,6 +1514,47 @@ function memoryLines(answer) {
   return lines;
 }
 
+/**
+ * @param {() => (WaitingQueuesAnswer | Promise<WaitingQueuesAnswer>)} [options.waitingQueues] Other queues of things
+ *   the owner decides, listed next to the waiting judgments (story-world-waiting-queues-v1, ledger P17 / D9).  The
+ *   world knows nothing about them beyond `{ status: 'available', queues: [{ id, label, count, href, link_label? }] }`.
+ *   A queue with zero is not shown; an unreadable one is never shown as zero.  `href` must be `https:` or a link
+ *   inside the host (`/…`, `?…`); others get no link.  Without it the world is drawn exactly as before.
+ * @typedef {{ status: string, reason?: string, queues?: object[] }} WaitingQueuesAnswer
+ */
+async function readWaitingQueues(waitingQueues) {
+  if (typeof waitingQueues !== 'function') return null;
+  try {
+    const answer = await waitingQueues();
+    return answer && typeof answer === 'object' ? answer : { status: 'failed', reason: 'invalid_answer' };
+  } catch (error) {
+    return { status: 'failed', reason: error instanceof Error ? error.message : 'request_failed' };
+  }
+}
+
+/** The waiting queues as world notes.  Zero is quiet; unknown is said out loud and never counted as zero. */
+function waitingQueueLines(answer) {
+  if (!answer) return [];
+  if (answer.status !== 'available' || !Array.isArray(answer.queues)) {
+    return [{ text: `ほかの待っているもの：読めない（${answer.reason ?? answer.status ?? '理由不明'}）。件数は0件とは確認できません。`, tone: 'warning', summary: 'ほかの待っているもの：読めない', link: null }];
+  }
+  const lines = [];
+  for (const queue of answer.queues) {
+    const label = typeof queue?.label === 'string' && queue.label.trim() ? queue.label.trim() : null;
+    if (!label) continue;
+    const count = queue.count;
+    if (!Number.isInteger(count) || count < 0) {
+      lines.push({ text: `${label}：読めない（${queue.reason ?? '理由不明'}）。件数は0件とは確認できません。`, tone: 'warning', summary: `${label}：読めない`, link: null });
+      continue;
+    }
+    if (count === 0) continue;
+    const href = exitHrefKind(queue.href) ? queue.href : null;
+    const linkLabel = typeof queue.link_label === 'string' && queue.link_label.trim() ? queue.link_label.trim() : `${label}を開く`;
+    lines.push({ text: `${label} ${count}件。`, tone: 'attention', summary: `${label} ${count}件`, link: href ? { href, label: linkLabel, className: 'bb-world-waiting-queue-link' } : null });
+  }
+  return lines;
+}
+
 /** At most this many waiting judgments are listed in the world; the rest are counted, never hidden. */
 const WAITING_LIST_LIMIT = 3;
 
@@ -1540,7 +1581,7 @@ function defaultJudgmentHref(decisionAttemptId) {
   return decisionAttemptId ? `#value-proofs?decision=${encodeURIComponent(decisionAttemptId)}` : '#value-proofs';
 }
 
-export function createWorldView({ root, rail, page, presentation = 'standard', document: explicitDocument, fetcher, projectHref = (project) => `#projects?project=${encodeURIComponent(project.id)}`, taskHref = null, judgmentHref = defaultJudgmentHref, selection = addressSelection(), businessExits = null, memoryStatus = null }) {
+export function createWorldView({ root, rail, page, presentation = 'standard', document: explicitDocument, fetcher, projectHref = (project) => `#projects?project=${encodeURIComponent(project.id)}`, taskHref = null, judgmentHref = defaultJudgmentHref, selection = addressSelection(), businessExits = null, memoryStatus = null, waitingQueues = null }) {
   const exitsEnabled = typeof businessExits === 'function';
   const doc = explicitDocument ?? globalThis.document;
   const reducedMotion = Boolean(globalThis.matchMedia?.('(prefers-reduced-motion: reduce)').matches);
@@ -2384,6 +2425,7 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
 
   async function load() {
     const memoryRead = readMemoryStatus(memoryStatus);
+    const queuesRead = readWaitingQueues(waitingQueues);
     const businessesResult = await readJson(fetcher, '/api/extensions/world/businesses');
     if (disposed) return;
     // A world drawn from an organization's Graph shows only that organization's judgments: the host keeps
@@ -2463,6 +2505,9 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
     if (judgmentsConnected) {
       for (const line of waitingLines(proofs, judgmentHref)) note('待っている判断', line.text, 'attention', line.summary, line.link);
     }
+    const queues = await queuesRead;
+    if (disposed) return;
+    for (const line of waitingQueueLines(queues)) note('待っている', line.text, line.tone, line.summary, line.link);
     const rowItems = new Map(rows.map((row) => [row.key, Array.isArray(row.items) ? row.items : []]));
     const memory = await memoryRead;
     if (disposed) return;