@unson/brainbase-mcp 0.21.1 → 0.22.0

package/dist/world-extension.js

@@ -347,7 +347,7 @@ export function createWorldExtension(options = {}) {
     return {
         id: WORLD_EXTENSION_ID,
         uiDir: fileURLToPath(new URL('../ui/world/', import.meta.url)),
-        uiFiles: ['world-view.js', 'world-view.css', 'world-vendor.js', 'world-placement.js', 'world-work-rail.js', 'world-district.js'],
+        uiFiles: ['world-view.js', 'world-view.css', 'world-vendor.js', 'world-placement.js', 'world-work-rail.js', 'world-district.js', 'world-scenery.js'],
         screenEntry: 'world-view.js',
         // P17: the world sits above the home and opens first.
         navPosition: 'first',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.21.1",
+  "version": "0.22.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",
@@ -115,6 +115,22 @@
       "types": "./dist/company-os-learning-adoption.d.ts",
       "import": "./dist/company-os-learning-adoption.js"
     },
+    "./meeting-minutes-lineage": {
+      "types": "./dist/meeting-minutes-lineage.d.ts",
+      "import": "./dist/meeting-minutes-lineage.js"
+    },
+    "./meeting-minutes-lineage-adapters": {
+      "types": "./dist/meeting-minutes-lineage-adapters.d.ts",
+      "import": "./dist/meeting-minutes-lineage-adapters.js"
+    },
+    "./meeting-minutes-lineage-http": {
+      "types": "./dist/meeting-minutes-lineage-http.d.ts",
+      "import": "./dist/meeting-minutes-lineage-http.js"
+    },
+    "./meeting-minutes-lineage-lifecycle": {
+      "types": "./dist/meeting-minutes-lineage-lifecycle.d.ts",
+      "import": "./dist/meeting-minutes-lineage-lifecycle.js"
+    },
     "./constraint-resolution": {
       "types": "./dist/constraint-resolution.d.ts",
       "import": "./dist/constraint-resolution.js"
@@ -211,6 +227,22 @@
       "types": "./dist/streamable-http.d.ts",
       "import": "./dist/streamable-http.js"
     },
+    "./meeting-minutes": {
+      "types": "./dist/meeting-minutes.d.ts",
+      "import": "./dist/meeting-minutes.js"
+    },
+    "./meeting-minutes-http": {
+      "types": "./dist/meeting-minutes-http.d.ts",
+      "import": "./dist/meeting-minutes-http.js"
+    },
+    "./meeting-minutes-storage": {
+      "types": "./dist/meeting-minutes-storage.d.ts",
+      "import": "./dist/meeting-minutes-storage.js"
+    },
+    "./meeting-minutes-storage-controller": {
+      "types": "./dist/meeting-minutes-storage-controller.d.ts",
+      "import": "./dist/meeting-minutes-storage-controller.js"
+    },
     "./ui/outcome-knowledge": "./ui/outcome-knowledge.js",
     "./ui/outcome-knowledge.css": "./ui/outcome-knowledge.css",
     "./ui/judgment-view": "./ui/judgment-view.js",
@@ -221,6 +253,8 @@
     "./ui/value-proof-review.css": "./ui/value-proof-review.css",
     "./ui/judgment-history": "./ui/judgment-history.js",
     "./ui/judgment-history.css": "./ui/judgment-history.css",
+    "./ui/meeting-minutes": "./ui/meeting-minutes.js",
+    "./ui/meeting-minutes.css": "./ui/meeting-minutes.css",
     "./ui/objective-editor-http-port": "./ui/objective-editor-http-port.js",
     "./ui/world-model-view": "./ui/world-model-view.js",
     "./ui/world-model-view.css": "./ui/world-model-view.css",
@@ -238,7 +272,12 @@
     "./ui/graph-projects-view.css": "./ui/graph-projects-view.css",
     "./ui/graph-registry-view": "./ui/graph-registry-view.js",
     "./ui/graph-registry-view.css": "./ui/graph-registry-view.css",
+    "./ui/meeting-minutes-storage": "./ui/meeting-minutes-storage.js",
+    "./ui/meeting-minutes-storage.css": "./ui/meeting-minutes-storage.css",
     "./ui/brainbase-tokens.css": "./ui/brainbase-tokens.css",
+    "./ui/meeting-minutes-lineage": "./ui/meeting-minutes-lineage.js",
+    "./ui/meeting-minutes-lineage.css": "./ui/meeting-minutes-lineage.css",
+    "./ui/meeting-minutes-lineage-http": "./ui/meeting-minutes-lineage-http.js",
     "./dist/*": "./dist/*",
     "./contracts/judgment-dag/schema.json": "./contracts/judgment-dag/schema.json",
     "./contracts/judgment-dag/fixture.json": "./contracts/judgment-dag/fixture.json",
@@ -292,7 +331,11 @@
     "./ui/project-overview": "./ui/project-overview.js",
     "./ui/project-graph": "./ui/project-graph.js",
     "./ui/project-workspace.css": "./ui/project-workspace.css",
-    "./ui/project-graph-vendor.js": "./ui/project-graph-vendor.js"
+    "./ui/project-graph-vendor.js": "./ui/project-graph-vendor.js",
+    "./meeting-minutes-storage-http": {
+      "types": "./dist/meeting-minutes-storage-http.d.ts",
+      "import": "./dist/meeting-minutes-storage-http.js"
+    }
   },
   "bin": {
     "brainbase-mcp": "dist/index.js",
@@ -364,5 +407,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "5bbdd5ef6feb5b037f1f1d79c38818db2c3e23a6"
+  "gitHead": "4933fdd273d050d9fa76f46b5d3696c1657613eb"
 }

package/ui/brainbase-tokens.css

@@ -7,47 +7,47 @@
  * truth for every Brainbase Web surface.
  */
 :root {
-  --bb-color-ink: #1e2822;
-  --bb-color-muted: #69746d;
-  --bb-color-quiet: #929b95;
-  --bb-color-border: #dce3dd;
-  --bb-color-border-strong: #b7c3ba;
-  --bb-color-control-border: #cbd8d0;
-  --bb-color-paper: #fbfcfa;
-  --bb-color-canvas: #f1f3f0;
+  --bb-color-ink: #202124;
+  --bb-color-muted: #6b6b73;
+  --bb-color-quiet: #76767f;
+  --bb-color-border: #e5e5e9;
+  --bb-color-border-strong: #c9c9d1;
+  --bb-color-control-border: #d7d7de;
+  --bb-color-paper: #ffffff;
+  --bb-color-canvas: #f6f6f8;
   --bb-color-panel: #ffffff;
-  --bb-color-surface: #f5f8f5;
-  --bb-color-header-start: #f7faf8;
-  --bb-color-header-end: #eef5f0;
-  --bb-color-eyebrow: #47715a;
-  --bb-color-accent: #087d62;
-  --bb-color-accent-soft: #e6f2ec;
-  --bb-color-accent-strong: #176448;
-  --bb-color-action: #35684c;
-  --bb-color-action-hover: #2a5540;
+  --bb-color-surface: #f6f6f8;
+  --bb-color-header-start: #ffffff;
+  --bb-color-header-end: #f6f6f8;
+  --bb-color-eyebrow: #5b4bd8;
+  --bb-color-accent: #5b4bd8;
+  --bb-color-accent-soft: #efedff;
+  --bb-color-accent-strong: #4939b8;
+  --bb-color-action: #5b4bd8;
+  --bb-color-action-hover: #4939b8;
   --bb-color-action-text: #ffffff;
-  --bb-color-focus: #20a37e;
-  --bb-color-project-ink: #172d4f;
-  --bb-color-project-muted: #566b87;
-  --bb-color-project-border: #dce4ee;
-  --bb-color-project-border-strong: #c8d4e2;
-  --bb-color-project-accent: #1261ad;
-  --bb-color-project-accent-strong: #194f8a;
-  --bb-color-success: #087d62;
-  --bb-color-success-soft: #e6f2ec;
+  --bb-color-focus: #5b4bd8;
+  --bb-color-project-ink: #202124;
+  --bb-color-project-muted: #6b6b73;
+  --bb-color-project-border: #e5e5e9;
+  --bb-color-project-border-strong: #c9c9d1;
+  --bb-color-project-accent: #5b4bd8;
+  --bb-color-project-accent-strong: #4939b8;
+  --bb-color-success: #18794e;
+  --bb-color-success-soft: #e4f5eb;
   --bb-color-warning: #8a631d;
   --bb-color-warning-soft: #fff0c7;
   --bb-color-danger: #d92335;
   --bb-color-danger-soft: #fde9eb;
-  --bb-color-rail: #171c19;
-  --bb-color-rail-border: #2c332e;
-  --bb-color-rail-text: #d5ded8;
-  --bb-color-rail-muted: #89938c;
-  --bb-color-rail-hover: #232c26;
-  --bb-color-rail-active: #203e33;
-  --bb-color-rail-strong: #ffffff;
-  --bb-color-overlay: rgb(8 15 11 / 40%);
-  --bb-shadow: 0 16px 42px rgb(13 24 17 / 12%);
+  --bb-color-rail: #ffffff;
+  --bb-color-rail-border: #e5e5e9;
+  --bb-color-rail-text: #202124;
+  --bb-color-rail-muted: #6b6b73;
+  --bb-color-rail-hover: #f6f6f8;
+  --bb-color-rail-active: #efedff;
+  --bb-color-rail-strong: #202124;
+  --bb-color-overlay: rgb(32 33 36 / 40%);
+  --bb-shadow: 0 16px 42px rgb(32 33 36 / 10%);
   --bb-font-sans: Geist, "Noto Sans JP", "Hiragino Sans", system-ui, sans-serif;
   --bb-font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
   --bb-radius-sm: 7px;

package/ui/local-web-shell.css

@@ -1,5 +1,5 @@
 /*
- * Shell of the local Web host, in the organization edition's layout: a dark
+ * Shell of the local Web host, in the organization edition's layout: a white
  * left rail (brand, navigation, source) and a paper workspace. Uses only the
  * shared tokens in brainbase-tokens.css.
  */
@@ -51,15 +51,15 @@ body {
   flex-direction: column;
   overflow: auto;
   border-right: 1px solid var(--bb-color-rail-border);
-  padding: 28px 12px 12px;
+  padding: 18px 12px 14px;
   background: var(--bb-color-rail);
   color: var(--bb-color-rail-text);
 }
 
 .bb-shell-brand {
-  padding: 0 12px 28px;
+  padding: 0 10px 22px;
   color: var(--bb-color-rail-strong);
-  font-size: 24px;
+  font-size: 19px;
   font-weight: 780;
   line-height: 1;
   letter-spacing: -.035em;
@@ -67,17 +67,17 @@ body {
 
 .bb-shell-nav {
   display: grid;
-  gap: 4px;
+  gap: 2px;
 }
 
 .bb-shell-nav-link {
-  min-height: 42px;
+  min-height: 38px;
   display: flex;
   align-items: center;
-  gap: 12px;
-  border-radius: 8px;
-  padding: 0 12px;
-  color: var(--bb-color-rail-text);
+  gap: 11px;
+  border-radius: 7px;
+  padding: 0 10px;
+  color: var(--bb-color-rail-muted);
   font-size: 13px;
   font-weight: 620;
   text-decoration: none;
@@ -90,8 +90,8 @@ body {
 
 .bb-shell-nav-link[aria-current="page"] {
   background: var(--bb-color-rail-active);
-  color: var(--bb-color-rail-strong);
-  box-shadow: inset 3px 0 var(--bb-color-accent);
+  color: var(--bb-color-accent);
+  box-shadow: none;
 }
 
 .bb-shell-icon {
@@ -137,9 +137,12 @@ body {
   font-size: 11px;
 }
 
-.bb-shell-fact.is-warning .bb-shell-fact-value,
+.bb-shell-fact.is-warning .bb-shell-fact-value {
+  color: var(--bb-color-warning);
+}
+
 .bb-shell-source .is-danger {
-  color: var(--bb-color-warning-soft);
+  color: var(--bb-color-danger);
 }
 
 .bb-shell-source .bb-shell-link-button {
@@ -150,7 +153,7 @@ body {
 
 /* Right detail rail (the organization edition's decision rail) */
 .bb-shell.has-rail {
-  grid-template-columns: 240px minmax(0, 1fr) 380px;
+  grid-template-columns: 240px minmax(0, 1fr) 360px;
 }
 
 .bb-shell-rail {
@@ -160,7 +163,7 @@ body {
   min-width: 0;
   overflow: auto;
   border-left: 1px solid var(--bb-color-border);
-  padding: 44px 30px 48px;
+  padding: 28px 22px 36px;
   background: var(--bb-color-surface);
 }
 
@@ -194,7 +197,7 @@ body {
   max-width: 1440px;
   min-width: 0;
   margin: 0 auto;
-  padding: 40px 48px 72px;
+  padding: 20px 24px 52px;
 }
 
 .bb-shell-objectives,

package/ui/local-web-shell.js

@@ -20,6 +20,9 @@ import { createGraphRegistryView } from './graph-registry-view.js';
 import { createObjectiveEditorController } from './objective-editor.js';
 import { createObjectiveEditorHttpPort } from './objective-editor-http-port.js';
 import { createJudgmentHistoryUI } from './judgment-history.js';
+import { createMeetingMinutesUI } from './meeting-minutes.js';
+import { createMeetingMinutesStorageExtension } from './meeting-minutes-storage.js';
+import { createMeetingMinutesLineageExtension } from './meeting-minutes-lineage-http.js';
 import { createWorldModelView } from './world-model-view.js';
 import { createGraphClient } from './graph-view-shared.js';
 
@@ -43,6 +46,7 @@ const NAV_ICON_PATHS = Object.freeze({
   objectives: ['M12 4 3 20h18z', 'M12 9v5m0 3h.01'],
   projects: ['M3 6.5h7l2 2h9v10H3z', 'M3 6.5v-2h7l2 2'],
   graph: ['M10 13a5 5 0 0 0 7.5.5l2-2a5 5 0 0 0-7-7l-1.2 1.2', 'M14 11a5 5 0 0 0-7.5-.5l-2 2a5 5 0 0 0 7 7l1.2-1.2'],
+  minutes: ['M6 3.5h9l3 3V20.5H6z', 'M15 3.5v4h3', 'M9 12h6m-6 3h6'],
   // World view (extension id `world`, ledger P17).
   world: ['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18z', 'M3 12h18', 'M12 3c2.5 2.6 3.8 5.6 3.8 9s-1.3 6.4-3.8 9c-2.5-2.6-3.8-5.6-3.8-9S9.5 5.6 12 3z'],
 });
@@ -156,6 +160,32 @@ function mountToday(container, context) {
   });
 }
 
+function mountMeetingMinutes(container, context) {
+  const versionActionExtensions = [];
+  if (context.meetingMinutesStorage) versionActionExtensions.push(createMeetingMinutesStorageExtension({
+      fetcher: context.fetcher,
+      token: context.token,
+      basePath: '/api/meeting-minutes',
+      defaultExternal: context.meetingMinutesStorage.defaultExternal,
+    }));
+  if (context.meetingMinutesLineage) versionActionExtensions.push(createMeetingMinutesLineageExtension({
+    fetcher: context.fetcher,
+    token: context.token,
+    basePath: '/api/meeting-minutes-lineage',
+    candidateDefaults: context.meetingMinutesLineage.candidateDefaults,
+  }));
+  return createMeetingMinutesUI({
+    root: makePage(container, context),
+    rail: context.rail,
+    page: context.page,
+    document: context.document,
+    fetcher: context.fetcher,
+    token: context.token,
+    basePath: '/api/meeting-minutes',
+    versionActionExtensions,
+  });
+}
+
 function renderUnreadableObjectives(doc, slot, payload) {
   slot.replaceChildren();
   const count = Number.isInteger(payload?.unreadable?.count) ? payload.unreadable.count : 0;
@@ -221,6 +251,7 @@ function mountGraphScreen(screenId, createView) {
 
 export const LOCAL_WEB_SCREENS = Object.freeze([
   Object.freeze({ id: 'today', label: '今日', usesGraph: false, rail: true, source: '判断の記録', mount: mountToday }),
+  Object.freeze({ id: 'minutes', label: '議事録', usesGraph: false, rail: true, source: '正本の議事録', mount: mountMeetingMinutes }),
   Object.freeze({ id: 'objectives', label: '目的と現状', usesGraph: true, rail: true, source: '手元のGraph', mount: mountObjectives }),
   Object.freeze({ id: 'projects', label: 'プロジェクトと関係者', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen('projects', createGraphProjectsView) }),
   Object.freeze({ id: 'graph', label: '情報と関係', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen('graph', createGraphRegistryView) }),
@@ -305,6 +336,8 @@ export function createLocalWebShell({
   statusPath = '/api/local/status',
   screens = LOCAL_WEB_SCREENS,
   initialScreen,
+  meetingMinutesStorage = null,
+  meetingMinutesLineage = null,
 } = {}) {
   if (!root) throw new TypeError('root is required');
   const doc = explicitDocument ?? (typeof document === 'undefined' ? null : document);
@@ -312,7 +345,7 @@ export function createLocalWebShell({
   const request = typeof fetcher === 'function'
     ? fetcher
     : typeof globalThis.fetch === 'function' ? (path, init) => globalThis.fetch(path, init) : null;
-  const context = Object.freeze({ document: doc, fetcher: request, token });
+  const context = Object.freeze({ document: doc, fetcher: request, token, meetingMinutesStorage, meetingMinutesLineage });
 
   const status = { phase: 'loading', data: null, error: null };
   const mounted = new Map();

package/ui/meeting-minutes-lineage-http.js

@@ -0,0 +1,247 @@
+import { createMeetingMinutesLineageView } from './meeting-minutes-lineage.js';
+
+/** Browser-side transport and host action-slot bridge for the lineage screen. */
+export const MEETING_MINUTES_LINEAGE_HTTP_UI_CONTRACT_VERSION = 'brainbase.meeting-minutes-lineage-http-ui.v1';
+
+export function createMeetingMinutesLineageHttpActions({
+  reference,
+  basePath = '/api/meeting-minutes-lineage',
+  fetcher = globalThis.fetch,
+  token,
+  actorFor,
+  idFor,
+  idempotencyKeyFor,
+} = {}) {
+  if (!reference || typeof reference !== 'object') throw new TypeError('reference is required');
+  if (typeof fetcher !== 'function') throw new TypeError('fetcher is required');
+  const auditActorFor = typeof actorFor === 'function' ? actorFor : () => ({ type: 'person', id: 'browser-ui' });
+  const operationIds = new Map();
+  const operationId = (candidate, action) => {
+    const stable = candidate && typeof candidate === 'object'
+      ? (candidate.draftId ?? candidate.id ?? candidate.candidateId ?? candidate.candidate?.id)
+      : null;
+    const key = `${action}:${typeof stable === 'string' && stable ? stable : 'operation'}`;
+    let id = operationIds.get(key);
+    if (!id) {
+      id = typeof globalThis.crypto?.randomUUID === 'function'
+        ? globalThis.crypto.randomUUID()
+        : `lineage-${Date.now()}-${Math.random().toString(36).slice(2)}`;
+      operationIds.set(key, id);
+    }
+    return id;
+  };
+  const operationIdFor = typeof idFor === 'function'
+    ? ({ candidate, action }) => {
+      const key = `${action}:${operationId(candidate, action)}`;
+      if (!operationIds.has(`id:${key}`)) operationIds.set(`id:${key}`, idFor({ candidate, action }));
+      return operationIds.get(`id:${key}`);
+    }
+    : ({ candidate, action }) => operationId(candidate, action);
+  const operationKeyFor = typeof idempotencyKeyFor === 'function'
+    ? ({ candidate, action }) => {
+      const key = `${action}:${operationId(candidate, action)}`;
+      if (!operationIds.has(`key:${key}`)) operationIds.set(`key:${key}`, idempotencyKeyFor({ candidate, action }));
+      return operationIds.get(`key:${key}`);
+    }
+    : ({ candidate, action }) => `meeting-minutes-lineage:${operationId(candidate, action)}`;
+  const prefix = String(basePath).replace(/\/+$/u, '');
+  const requestJson = async (path, body) => {
+    const headers = { 'Content-Type': 'application/json', Accept: 'application/json' };
+    if (token) headers['X-Brainbase-Review-Token'] = token;
+    const response = await fetcher(`${prefix}${path}`, {
+      method: 'POST',
+      headers,
+      body: JSON.stringify(body),
+    });
+    // The local shell's request helper returns parsed JSON, while a direct
+    // fetcher returns a Response. Support both so the extension remains a
+    // usable host action slot outside the default shell.
+    if (!response || typeof response.json !== 'function') {
+      if (response?.ok === false) {
+        const failure = new Error(`Lineage request failed (${response.status ?? 'unknown'})`);
+        failure.code = 'lineage_unavailable';
+        failure.status = response.status;
+        throw failure;
+      }
+      return response;
+    }
+    let payload = null;
+    try {
+      payload = await response.json();
+    } catch {
+      payload = null;
+    }
+    if (!response.ok) {
+      const error = payload?.error;
+      const failure = new Error(typeof error?.message === 'string' ? error.message : `Lineage request failed (${response.status})`);
+      failure.code = typeof error?.code === 'string' ? error.code : 'lineage_unavailable';
+      failure.status = response.status;
+      throw failure;
+    }
+    return payload;
+  };
+  const requestMutation = (candidate, action, path, extra = {}) => requestJson(path, {
+    id: operationIdFor({ candidate, action }),
+    idempotencyKey: operationKeyFor({ candidate, action }),
+    // This is retained as an audit hint only. The host resolves the actor
+    // from its verified context and ignores this field for authority.
+    actor: auditActorFor({ candidate, action }),
+    ...extra,
+  });
+  return {
+    load: () => requestJson('/by-version', { reference }),
+    actions: {
+      createCandidate: (input) => {
+        if (!input || (input.kind !== 'judgment' && input.kind !== 'task')) {
+          return Promise.reject(Object.assign(new Error('候補の種類を選んでください。'), { code: 'invalid_input' }));
+        }
+        const candidate = { ...input, draftId: input.draftId ?? operationId(input, 'create') };
+        return requestMutation(candidate, 'create', '/candidates', {
+          evidence: reference,
+          kind: candidate.kind,
+          proposal: candidate.proposal,
+          epistemicStatus: candidate.epistemicStatus ?? 'inferred',
+        });
+      },
+      confirmCandidate: (candidate) => requestMutation(candidate, 'confirm', `/candidates/${encodeURIComponent(candidate.id)}/confirm`, {
+        evidenceDigest: candidate.evidenceDigest,
+      }),
+      adoptJudgment: (candidate) => requestMutation(candidate, 'adopt_judgment', `/candidates/${encodeURIComponent(candidate.id)}/adopt/judgment`),
+      adoptTask: (candidate) => requestMutation(candidate, 'adopt_task', `/candidates/${encodeURIComponent(candidate.id)}/adopt/task`),
+      // Corrections are intentionally host-owned because they require an
+      // explicit replacement version and a human supplied reason.
+    },
+  };
+}
+
+/**
+ * Connect a host-owned shared UI action slot to the real HTTP loader/actions.
+ * The slot must mount the returned view; an absent slot is a wiring error,
+ * never a successful no-op.
+ */
+export function connectMeetingMinutesLineageActionSlot({
+  slot,
+  root,
+  reference,
+  basePath,
+  fetcher,
+  token,
+  actorFor,
+  idFor,
+  idempotencyKeyFor,
+  candidateDefaults,
+  documentRef = globalThis.document,
+} = {}) {
+  if (!slot || typeof slot.mount !== 'function') throw new TypeError('a host action slot with mount(view) is required');
+  const transport = createMeetingMinutesLineageHttpActions({
+    reference,
+    basePath,
+    fetcher,
+    token,
+    actorFor,
+    idFor,
+    idempotencyKeyFor,
+  });
+  const view = createMeetingMinutesLineageView({
+    root,
+    load: transport.load,
+    actions: transport.actions,
+    candidateDefaults,
+    documentRef,
+  });
+  slot.mount(view);
+  return view;
+}
+
+function text(value) {
+  return typeof value === 'string' && value.trim() ? value.trim() : null;
+}
+
+function exactVersionReference(version, detail, documentRecord) {
+  if (!version || !detail?.meeting?.meeting_id || !documentRecord?.minutes_id || !version.version_id) return null;
+  const source = version.source_ref;
+  if (source && text(source.provider) && text(source.locator) && text(source.revision) && text(source.digest)) {
+    return {
+      meetingId: detail.meeting.meeting_id,
+      minutesId: documentRecord.minutes_id,
+      versionId: version.version_id,
+      contentDigest: source.digest,
+      locator: source.locator,
+      provenance: {
+        providerKind: source.provider,
+        providerId: source.locator,
+        revision: source.revision,
+        digest: source.digest,
+      },
+    };
+  }
+  return {
+    meetingId: detail.meeting.meeting_id,
+    minutesId: documentRecord.minutes_id,
+    versionId: version.version_id,
+    contentDigest: text(version.body_digest),
+    locator: `${detail.meeting.meeting_id}/${documentRecord.minutes_id}/${version.version_id}`,
+    provenance: {
+      providerKind: 'brainbase.native',
+      providerId: `${detail.meeting.meeting_id}/${documentRecord.minutes_id}`,
+      revision: version.version_id,
+      ...(text(version.body_digest) ? { digest: text(version.body_digest) } : {}),
+    },
+  };
+}
+
+/** Add the real lineage transport/view to the same selected-version action slot. */
+export function createMeetingMinutesLineageExtension({
+  basePath = '/api/meeting-minutes-lineage',
+  fetcher,
+  token,
+  actorFor,
+  idFor,
+  idempotencyKeyFor,
+  candidateDefaults = null,
+} = {}) {
+  return Object.freeze({
+    id: 'meeting-minutes-lineage',
+    mount({ root, document: documentRef, detail, documentRecord, version, request, setStatus }) {
+      const reference = exactVersionReference(version, detail, documentRecord);
+      if (!reference) {
+        root.replaceChildren();
+        const notice = documentRef.createElement('p');
+        notice.className = 'bb-mml-notice';
+        notice.textContent = '選択した議事録版の根拠を確認できないため、判断・Taskを操作できません。';
+        root.appendChild(notice);
+        return null;
+      }
+      let view;
+      const slot = { mount(next) { view = next; } };
+      connectMeetingMinutesLineageActionSlot({
+        slot,
+        root,
+        reference,
+        basePath,
+        fetcher: fetcher ?? request,
+        token,
+        actorFor,
+        idFor,
+        idempotencyKeyFor,
+        documentRef,
+        candidateDefaults,
+      });
+      // `connect...` owns the view, while this extension owns the initial
+      // refresh and shares the core's status line for transport failures.
+      if (view) {
+        const originalRefresh = view.refresh;
+        view.refresh = async (...args) => {
+          try {
+            return await originalRefresh(...args);
+          } catch (error) {
+            setStatus?.(error instanceof Error ? error.message : '判断履歴を読み取れません。', 'error');
+            throw error;
+          }
+        };
+        void view.refresh();
+      }
+      return view;
+    },
+  });
+}