@unson/brainbase-mcp 0.41.6 → 0.41.8

package/dist/graph-foundation-reader.d.ts

@@ -78,9 +78,13 @@ export interface FoundationObjectiveDetails {
     readonly evaluator_note?: unknown;
     readonly current_state?: unknown;
 }
-/** Runtime shape used by the overview contract for Objective records. */
+/** The words a World Model record gives for where it applies. */
+export interface FoundationModelDetails {
+    readonly applicability_text?: unknown;
+}
+/** Runtime shape used by the overview contract for Objective and World Model records. */
 export interface FoundationOverviewObjectiveRecord extends FoundationCatalogRecord {
-    readonly details?: FoundationObjectiveDetails;
+    readonly details?: FoundationObjectiveDetails | FoundationModelDetails;
 }
 export interface GraphFoundationReaders {
     readonly store: Pick<FoundationRevisionStore, 'read' | 'readLatest' | 'list'>;

package/dist/graph-foundation-reader.js

@@ -525,12 +525,10 @@ function validateFoundationRecord(row, reference, context, selectedProjectCode,
         definition: cloneFoundationDefinition(history.definition),
         digest: digestFoundationDefinition(history.definition)
     };
-    if (reference.type === 'objective') {
-        const details = projectObjectiveDetails(history.payload);
-        if (details !== undefined)
-            return { ...record, details };
-    }
-    return record;
+    const details = reference.type === 'objective'
+        ? projectDetails(history.payload, OBJECTIVE_DETAIL_KEYS)
+        : reference.type === 'model' ? projectDetails(history.payload, MODEL_DETAIL_KEYS) : undefined;
+    return details === undefined ? record : { ...record, details };
 }
 const OBJECTIVE_DETAIL_KEYS = [
     'title',
@@ -540,15 +538,18 @@ const OBJECTIVE_DETAIL_KEYS = [
     'evaluator_note',
     'current_state'
 ];
-function projectObjectiveDetails(payload) {
+// A model's foundation scope carries ids and a registration time; its own words for where it
+// applies live beside the definition.
+const MODEL_DETAIL_KEYS = ['applicability_text'];
+function projectDetails(payload, keys) {
     const nestedDetails = isPlainRecord(payload.details) ? payload.details : undefined;
     const foundation = isPlainRecord(payload.foundation) ? payload.foundation : undefined;
     // Graphify payloads historically carried these descriptive fields at the
     // payload root. Keep the two known nested forms compatible while exposing
-    // only the six fields in the overview contract.
+    // only the listed fields in the overview contract.
     const candidates = [payload, nestedDetails, foundation].filter((candidate) => candidate !== undefined);
     const projected = {};
-    for (const key of OBJECTIVE_DETAIL_KEYS) {
+    for (const key of keys) {
         const source = candidates.find((candidate) => Object.prototype.hasOwnProperty.call(candidate, key));
         if (source !== undefined && source[key] !== undefined)
             projected[key] = source[key];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.41.6",
+  "version": "0.41.8",
   "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",
@@ -483,5 +483,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "0c67baf7d7c57f4f671c966c8053705af65ba4d0"
+  "gitHead": "b061e1b0a7ccb22155c6e22459ad735dc5e7adb1"
 }

package/ui/brainbase-tokens.css

@@ -26,6 +26,8 @@
   --bb-color-accent: #5b4bd8;
   --bb-color-accent-soft: #efedff;
   --bb-color-accent-strong: #4939b8;
+  /* Minutes screen remaps its accent to this indigo. Shared accent stays purple. */
+  --bb-color-brand-indigo: #0F2A43;
   --bb-color-action: #5b4bd8;
   --bb-color-action-hover: #4939b8;
   --bb-color-action-text: #ffffff;

package/ui/foundation-overview.css

@@ -151,14 +151,6 @@
   line-height: 1.55;
 }
 
-.bb-fov-record-id {
-  display: block;
-  margin-top: 7px;
-  color: var(--bb-color-quiet);
-  font-family: var(--bb-font-mono);
-  font-size: 10px;
-  overflow-wrap: anywhere;
-}
 
 .bb-fov-ref-list {
   display: grid;
@@ -254,4 +246,5 @@
 @media (max-width: 760px) { .bb-fov-objective-ledger { overflow-x: auto; } .bb-fov-objective-ledger .bb-ws-ledger-row { min-width: 760px; } }
 @media (max-width: 480px) { .bb-fov-reading .bb-ws-definition { grid-template-columns: 1fr; gap: 4px; } .bb-fov-reading dd { margin-bottom: 12px; } }
 .bb-fov-philosophy-card .bb-fov-original { border-top: 0; padding-top: 0; }
+.bb-fov-model-card .bb-fov-original { margin-top: 12px; padding-top: 10px; overflow-wrap: anywhere; }
 .bb-fov-objective-ledger .bb-ws-ledger-row:focus-visible { outline: 2px solid var(--bb-color-focus); outline-offset: 2px; }

package/ui/foundation-overview.js

@@ -55,6 +55,16 @@ const PHILOSOPHY_STATUS_LABELS = Object.freeze({
   archived: '終了',
 });
 const OPERATOR_LABELS = Object.freeze({ at_least: '以上', at_most: '以下', equals: '一致' });
+const SOURCE_KIND_LABELS = Object.freeze({
+  candidate: '候補からの登録',
+  document: '文書',
+  observation: '観察',
+  decision: '決定',
+  import: '取り込み',
+});
+// A record without a name is said to have none; its id stays in the record details (P9).
+const UNNAMED_RECORD = '名前の記録なし';
+const UNNAMED_VARIABLE = '名前の記録がない変数';
 
 export class FoundationOverviewError extends Error {
   constructor(code, message) {
@@ -225,12 +235,52 @@ const SCOPE_LABELS = Object.freeze({
   company: '組織',
 });
 
+function formatValidity(from, until) {
+  if (!from && !until) return null;
+  if (!from) return `${formatDate(until)} まで`;
+  return `${formatDate(from)} から ${until ? `${formatDate(until)} まで` : '（終了日の記録なし）'}`;
+}
+
+/**
+ * A scope in words: `{ type, id }` names the project or organization, and a validity scope
+ * (`subjectIds`, `validFrom`, `validUntil`) becomes its period and the number of subjects.  The
+ * subject ids themselves belong to the record details.
+ */
 function formatScope(value) {
   if (!isObject(value)) return formatStructuredValue(value);
   const type = formatAny(value.type);
   const id = formatAny(value.id);
   if (type && id) return `${SCOPE_LABELS[type] ?? type}: ${id}`;
-  return formatStructuredValue(value);
+  const subjects = firstValue(value, 'subjectIds', 'subject_ids');
+  const period = formatValidity(firstValue(value, 'validFrom', 'valid_from'), firstValue(value, 'validUntil', 'valid_until'));
+  const parts = [
+    Array.isArray(subjects) && subjects.length > 0 ? `対象 ${subjects.length}件` : null,
+    period ? `適用期間: ${period}` : null,
+  ].filter(Boolean);
+  if (parts.length > 0) return parts.join(' ／ ');
+  return formatAny(firstValue(value, 'text', 'description', 'statement', 'label', 'name'))
+    ?? '読める形の記録がありません（記録の詳細を参照）';
+}
+
+/** Where a definition came from, as kinds of source; the source and evidence ids stay in the details. */
+function formatProvenance(provenance) {
+  if (!Array.isArray(provenance) || provenance.length === 0) return null;
+  return provenance.map((item) => {
+    const kind = SOURCE_KIND_LABELS[item?.sourceKind] ?? '種類の記録なし';
+    const evidence = Array.isArray(item?.evidenceIds) ? item.evidenceIds.length : 0;
+    return evidence > 0 ? `${kind}（証拠${evidence}件）` : kind;
+  }).join('、');
+}
+
+/** Ids, revisions and digests of one record, for the "記録の詳細" disclosure only. */
+function recordDetailsElement(doc, rows, summary = '記録の詳細') {
+  const details = makeElement(doc, 'details', { className: 'bb-fov-original' });
+  details.append(makeElement(doc, 'summary', { text: summary }), workspaceDefinition(doc, rows));
+  return details;
+}
+
+function referenceLabels(refs) {
+  return Array.isArray(refs) && refs.length > 0 ? refs.map(referenceLabel).join('、') : null;
 }
 
 function recordDefinition(record) { return isObject(record?.definition) ? record.definition : {}; }
@@ -265,6 +315,15 @@ function statusElement(doc, definition, className = '') {
   return makeElement(doc, 'p', { className: `bb-fov-status${className ? ` ${className}` : ''}`, text: statusText(definition) });
 }
 
+/**
+ * The one state a reader needs in front of a model: whether it is held as verified or as a
+ * hypothesis.  Adoption, validation and authorized uses stay in the record details.
+ */
+function certaintyText(definition) {
+  const label = EPISTEMIC_LABELS[definition.epistemicState] ?? VALIDATION_LABELS[definition.validationState];
+  return `確からしさ: ${label ?? '記録なし'}`;
+}
+
 function detailsFor(record) {
   return isObject(record?.details) ? record.details : {};
 }
@@ -310,9 +369,7 @@ function criteriaList(doc, definition, variableMap) {
     const ref = criterion?.variableRef;
     const exact = variableMap.get(foundationKey(ref));
     const exactDefinition = exact ? recordDefinition(exact) : null;
-    const name = exactDefinition
-      ? (formatAny(exactDefinition.meaning) ?? referenceLabel(ref))
-      : referenceLabel(ref);
+    const name = (exactDefinition ? formatAny(exactDefinition.meaning) : null) ?? UNNAMED_VARIABLE;
     const variableDetails = exactDefinition
       ? [
         ['定義', exactDefinition.definition],
@@ -328,7 +385,7 @@ function criteriaList(doc, definition, variableMap) {
     const status = exact ? '参照確認済み' : '参照未確認（基準変数の版が一致しません）';
     list.append(makeElement(doc, 'li', {
       className: exact ? '' : 'is-unrecorded',
-      text: `${name}${variableDetails.length > 0 ? `（${variableDetails.join(' ／ ')}）` : ''}（${referenceLabel(ref)}） ${operator}${target === null ? '' : ` ${target}`} — ${status}`,
+      text: `${name}${variableDetails.length > 0 ? `（${variableDetails.join(' ／ ')}）` : ''} ${operator}${target === null ? '' : ` ${target}`} — ${status}`,
     }));
   }
   return list;
@@ -395,7 +452,7 @@ function recordedStateElement(doc, record) {
 function objectiveCard(doc, record, variableMap) {
   const definition = recordDefinition(record);
   const details = detailsFor(record);
-  const title = formatAny(firstValue(details, 'title')) ?? formatAny(definition.meaning) ?? definition.id;
+  const title = formatAny(firstValue(details, 'title')) ?? formatAny(definition.meaning) ?? UNNAMED_RECORD;
   const gaps = missingObjectiveFields(record);
   const current = currentStateFor(record);
   const evaluationPeriod = formatAny(firstValue(details, 'evaluation_period_note', 'evaluationPeriodNote'))
@@ -446,11 +503,16 @@ function objectiveReading(doc, record, variableMap, recordContexts) {
   const provenance = Array.isArray(definition.provenance) ? definition.provenance : [];
   section('出典', workspaceDefinition(doc, [
     ['記録元', recordContexts?.get(record)?.label ?? formatAny(record.source) ?? '未記録'],
-    ['根拠', provenance.length ? formatStructuredValue(provenance) : '未記録'],
+    ['根拠', formatProvenance(provenance) ?? '未記録'],
   ]));
+  const criteriaRefs = Array.isArray(definition.criteria) ? definition.criteria.map((criterion) => criterion?.variableRef) : [];
   const original = makeElement(doc, 'details', { className: 'bb-fov-original' });
   original.append(makeElement(doc, 'summary', { text: '記録の詳細・参照・原文' }), objectiveCard(doc, record, variableMap),
-    workspaceDefinition(doc, [['目的ID', definition.id], ['版', definition.revision], ['digest', record.digest]]));
+    workspaceDefinition(doc, [
+      ['目的ID', definition.id], ['版', definition.revision], ['digest', record.digest],
+      ['基準変数の参照', referenceLabels(criteriaRefs)],
+      ['根拠の記録', provenance.length ? formatStructuredValue(provenance) : null],
+    ]));
   body.append(original); return body;
 }
 
@@ -477,12 +539,12 @@ function renderObjectives(doc, catalog, viewState, callbacks, recordContexts) {
         const opener = doc.activeElement;
         viewState.dialog?.close();
         viewState.dialog = workspaceDialog(doc, {
-          title: formatAny(details.title) ?? formatAny(definition.meaning) ?? definition.id, opener,
+          title: formatAny(details.title) ?? formatAny(definition.meaning) ?? UNNAMED_RECORD, opener,
           content: objectiveReading(doc, record, recordContexts?.get(record)?.variableMap ?? variableMap, recordContexts),
         });
       },
       cells: [
-        { primary: formatAny(details.title) ?? formatAny(definition.meaning) ?? definition.id },
+        { primary: formatAny(details.title) ?? formatAny(definition.meaning) ?? UNNAMED_RECORD },
         current.text ?? current.status ?? '未記録',
         { text: current.missing.length ? current.missing.join('・') : missingObjectiveFields(record).join('・') || '記録なし', className: 'bb-fov-missing' },
         formatDate(current.asOf),
@@ -506,13 +568,13 @@ function philosophyApplicability(payload) {
   const period = validFrom
     ? `${formatDate(validFrom)}から${validUntil ? ` ${formatDate(validUntil)}まで` : ''}`
     : null;
-  return [scope, period ? `適用期間: ${period}` : null].filter(Boolean).join(' ／ ') || formatStructuredValue(legacy);
+  return [scope, period ? `適用期間: ${period}` : null].filter(Boolean).join(' ／ ') || formatScope(legacy);
 }
 
 function philosophyCard(doc, record) {
   const payload = record.payload;
   const card = makeElement(doc, 'article', { className: 'bb-fov-philosophy-card' });
-  const title = formatAny(payload.title) ?? record.id;
+  const title = formatAny(payload.title) ?? UNNAMED_RECORD;
   card.append(makeElement(doc, 'h3', { text: title }));
 
   if (formatAny(payload.statement)) card.append(makeElement(doc, 'p', { className: 'bb-fov-philosophy-statement', text: formatAny(payload.statement) }));
@@ -569,10 +631,10 @@ function renderReferenceList(doc, refs, variableMap, label) {
   }
   for (const ref of refs) {
     const exact = variableMap.get(foundationKey(ref));
-    const name = exact ? formatAny(recordDefinition(exact).meaning) ?? referenceLabel(ref) : referenceLabel(ref);
+    const name = (exact ? formatAny(recordDefinition(exact).meaning) : null) ?? UNNAMED_VARIABLE;
     list.append(makeElement(doc, 'li', {
       className: exact ? '' : 'is-unrecorded',
-      text: exact ? `${name}（${referenceLabel(ref)}）` : `${referenceLabel(ref)} — 未接続（変数の版が一致しません）`,
+      text: exact ? name : `${name} — 未接続（変数の版が一致しません）`,
     }));
   }
   return list;
@@ -581,16 +643,32 @@ function renderReferenceList(doc, refs, variableMap, label) {
 function modelCard(doc, record, variableMap) {
   const definition = recordDefinition(record);
   const card = makeElement(doc, 'article', { className: 'bb-fov-model-card' });
-  card.append(makeElement(doc, 'h3', { text: formatAny(definition.meaning) ?? definition.id }));
-  card.append(makeElement(doc, 'code', { className: 'bb-fov-record-id', text: `${definition.id}@${definition.revision}` }));
-  card.append(statusElement(doc, definition));
+  // The stored scope is ids and a registration time, not the reader's "where it applies"; the
+  // record's own words go in front, and the stored scope waits in the details.
+  const applicability = definition.applicability ?? definition.scope;
+  const registered = isObject(applicability) ? applicability : {};
+  const subjects = firstValue(registered, 'subjectIds', 'subject_ids');
+  const applicabilityText = formatAny(firstValue(detailsFor(record), 'applicability_text', 'applicabilityText'))
+    ?? (isObject(applicability) ? null : formatAny(applicability));
+  card.append(makeElement(doc, 'h3', { text: formatAny(definition.meaning) ?? UNNAMED_RECORD }));
+  card.append(makeElement(doc, 'p', { className: 'bb-fov-status', text: certaintyText(definition) }));
   card.append(workspaceDefinition(doc, [
     ['関係', formatAny(definition.relationship)],
-    ['適用範囲', formatAny(definition.applicability ?? definition.scope)],
+    ['適用範囲', applicabilityText ?? { text: '範囲の説明は記録されていません', className: 'is-unrecorded' }],
     ['不確かさ', formatAny(definition.uncertainty)],
     ['入力変数', renderReferenceList(doc, definition.inputVariableRefs, variableMap, '入力変数')],
     ['出力変数', renderReferenceList(doc, definition.outputVariableRefs, variableMap, '出力変数')],
   ]));
+  card.append(recordDetailsElement(doc, [
+    ['状態の内訳', statusText(definition)],
+    ['記録ID', definition.id],
+    ['版', definition.revision],
+    ['digest', record.digest],
+    ['登録上の対象', Array.isArray(subjects) && subjects.length > 0 ? subjects.join('、') : null],
+    ['登録上の開始日時', formatValidity(firstValue(registered, 'validFrom', 'valid_from'), firstValue(registered, 'validUntil', 'valid_until'))],
+    ['入力変数の参照', referenceLabels(definition.inputVariableRefs)],
+    ['出力変数の参照', referenceLabels(definition.outputVariableRefs)],
+  ]));
   return card;
 }
 
@@ -712,7 +790,7 @@ export function renderFoundationOverview(root, state, {
     surface.append(workspacePageHeader(doc, {
       crumbs: ['Brainbase', '目的と現状'],
       title: '目的と現状',
-      lead: '選択したプロジェクトの目的、哲学、世界モデルを、登録状態と未確認の点を分けて読みます。',
+      lead: '選択したプロジェクトの目的、哲学、世界モデルを、記録された内容と未確認の点を分けて読みます。',
       source: `正本: ${scopeId}`,
     }));
   }
@@ -734,7 +812,7 @@ export function renderFoundationOverview(root, state, {
     return workspaceDisclosure(doc, { title, help, content, open: viewState[key] ?? initialOpen, onToggle: open => { viewState[key] = open; } });
   };
   surface.append(fold('哲学', '判断の前提となる考え方です。登録された本文と、判断への適用範囲を分けて表示します。', renderPhilosophies(doc, catalog, recordContexts), true));
-  surface.append(fold('世界モデル', '何をすると結果が変わるか、という仮説。未検証・許可用途を分けて確認します。', renderModels(doc, catalog, viewState, callbacks, recordContexts), false));
+  surface.append(fold('世界モデル', '何をすると結果が変わるか、という仮説。検証済みか仮説かを先に示し、ほかの状態や記録の番号は各モデルの「記録の詳細」で確認できます。', renderModels(doc, catalog, viewState, callbacks, recordContexts), false));
   root.append(surface);
   renderLoadingState(doc, root, viewState, false, onLoading);
   return surface;

package/ui/graph-own-share.js

@@ -76,12 +76,25 @@ export function graphOwnShareSource(option, { fetcher } = {}) {
   });
 }
 
-/** What the owner sent: the snapshot ID, where it is kept and when it was sent. */
+/** What the owner sent, in words: when it was sent.  The snapshot ID and digest are in ownShareHandoverRows. */
 export function ownShareHandoverText(handover) {
   if (!isRecord(handover) || !textOrNull(handover.graphId)) return null;
-  const where = textOrNull(handover.projectCode);
-  const digest = textOrNull(handover.digest) ?? '未確認';
-  return `束 ${handover.graphId}（${where ? `置き場所 ${where}、` : ''}digest ${digest}、${formatDateTime(handover.createdAt)} に送信）`;
+  return `${formatDateTime(handover.createdAt)} に手元のOSSから送った束`;
+}
+
+/** The snapshot ID, where it is kept and its digest, for the record details only. */
+export function ownShareHandoverRows(handover) {
+  if (!isRecord(handover) || !textOrNull(handover.graphId)) return null;
+  return [
+    ['束ID', handover.graphId],
+    ['置き場所', textOrNull(handover.projectCode)],
+    ['digest', textOrNull(handover.digest) ?? '未確認'],
+  ];
+}
+
+function handoverDetails(doc, handover) {
+  const rows = ownShareHandoverRows(handover);
+  return rows ? recordDetails(doc, rows) : null;
 }
 
 /**
@@ -113,6 +126,8 @@ export function ownShareSection(doc, { label, lead = OWN_LEAD, handover, childre
   const sent = ownShareHandoverText(handover);
   if (sent) facts.append(makeElement(doc, 'span', { text: sent }));
   section.append(facts);
+  const sentDetails = handoverDetails(doc, handover);
+  if (sentDetails) section.append(sentDetails);
   for (const child of children) if (child) section.append(child);
   return section;
 }
@@ -250,7 +265,7 @@ function personText(person) {
 }
 
 function criterionText(criterion) {
-  const variable = textOrNull(criterion.variable?.meaning) ?? criterion.variable?.id ?? '変数';
+  const variable = textOrNull(criterion.variable?.meaning) ?? '名前の記録がない変数';
   if (criterion.target === null || criterion.target === undefined) return `${variable}（目標値なし）`;
   const value = `${String(criterion.target)}${textOrNull(criterion.variable?.unit) ? ` ${criterion.variable.unit}` : ''}`;
   if (criterion.operator === 'at_least') return `${variable}: ${value}以上`;
@@ -295,7 +310,7 @@ export function createOwnObjectivesView({
   function detail(objective) {
     const wrap = makeElement(doc, 'div', { className: 'bb-graph-own-detail', attrs: { 'aria-label': '選んだ目的（引き継いだ自分の分）' } });
     wrap.append(
-      workspaceRailHead(doc, { kicker: '目的（引き継いだ自分の分）', title: objective.meaning, sub: objective.id }),
+      workspaceRailHead(doc, { kicker: '目的（引き継いだ自分の分）', title: objective.meaning }),
       closeButton(doc, () => controller.select(null)),
     );
     const criteria = makeElement(doc, 'ul', { className: 'bb-graph-plain-list' });
@@ -312,7 +327,11 @@ export function createOwnObjectivesView({
           ['状態', ownLabel(ADOPTION_LABELS, objective.adoptionState) ?? textOrNull(objective.adoptionState)],
           ['公開範囲（手元での設定）', ownLabel(VISIBILITY_LABELS, objective.visibility) ?? textOrNull(objective.visibility)],
         ]),
-        recordDetails(doc, [['目的ID', objective.id], ['版', objective.revision]]),
+        recordDetails(doc, [
+          ['目的ID', objective.id],
+          ['版', objective.revision],
+          ['基準変数のID', objective.criteria.map((criterion) => textOrNull(criterion.variable?.id)).filter(Boolean).join('、') || null],
+        ]),
       ],
     }));
     return wrap;
@@ -344,7 +363,7 @@ export function createOwnObjectivesView({
         selected: objective.id === state.selectedId,
         onSelect: (id) => controller.select(id),
         cells: [
-          { primary: objective.meaning, secondary: objective.id },
+          { primary: objective.meaning },
           ownLabel(ADOPTION_LABELS, objective.adoptionState) ?? String(objective.adoptionState ?? ''),
           periodText(objective.evaluationPeriod),
           personText(objective.accountable) ?? { text: '未登録', className: 'is-unresolved' },
@@ -365,7 +384,7 @@ export function createOwnObjectivesView({
       if (compact) {
         const facts = makeElement(doc, 'p', { className: 'bb-graph-own-facts', text: '読み取りのみ' });
         const refs = makeElement(doc, 'details');
-        refs.append(makeElement(doc, 'summary', { text: '出典' }), makeElement(doc, 'p', { text: ownShareHandoverText(handover) ?? (state.list.state === 'not_handed_over' ? 'まだ引き継いでいません。' : '出典は確認できません。') }));
+        refs.append(makeElement(doc, 'summary', { text: '出典' }), makeElement(doc, 'p', { text: ownShareHandoverText(handover) ?? (state.list.state === 'not_handed_over' ? 'まだ引き継いでいません。' : '出典は確認できません。') }), handoverDetails(doc, handover));
         root.replaceChildren(facts, ...body(), refs);
       }
       else root.replaceChildren(ownShareSection(doc, { label: source.label, lead: OBJECTIVES_LEAD, handover, children: body(), className: 'bb-graph-own-objectives' }));