@unson/brainbase-mcp 0.40.0 → 0.41.1

package/ui/graph-projects-view.js

@@ -88,6 +88,82 @@ export const GRAPH_PROJECT_LEDGER_COLUMNS = Object.freeze(['プロジェクト',
 
 const INVALID = Object.freeze({ state: 'invalid', reason: '応答の形式が不正です' });
 
+const PARTICIPANT_STATUS_VALUES = new Set(['available', 'empty', 'partial', 'unavailable', 'unknown', 'stale', 'failed']);
+const PARTICIPANT_FRESHNESS_VALUES = new Set(['fresh', 'stale', 'unknown']);
+
+/**
+ * Detail adapters may expose either wire-style snake_case or JS-style camelCase.
+ * `ready` is the existing host spelling for an available read.  Conflicting
+ * aliases and unknown values are invalid instead of silently becoming empty.
+ */
+function normalizeParticipantStatus(payload) {
+  const raw = [payload?.participants_status, payload?.participantsStatus].filter((value) => value !== undefined);
+  if (raw.length === 0) return { value: null, explicit: false };
+  const values = raw.map((value) => value === 'ready' ? 'available' : value);
+  if (values.some((value) => typeof value !== 'string' || !PARTICIPANT_STATUS_VALUES.has(value)) || new Set(values).size !== 1) {
+    return { invalid: true };
+  }
+  return { value: values[0], explicit: true };
+}
+
+function normalizeParticipantFreshness(payload) {
+  const raw = [payload?.participants_freshness, payload?.participantsFreshness].filter((value) => value !== undefined);
+  if (raw.length === 0) return { value: null, explicit: false };
+  if (raw.some((value) => typeof value !== 'string' || !PARTICIPANT_FRESHNESS_VALUES.has(value)) || new Set(raw).size !== 1) {
+    return { invalid: true };
+  }
+  return { value: raw[0], explicit: true };
+}
+
+function normalizeParticipantAbsence(payload) {
+  const raw = [payload?.participants_absence_confirmed, payload?.participantsAbsenceConfirmed]
+    .filter((value) => value !== undefined);
+  if (raw.length === 0) return { confirmed: false, explicit: false };
+  if (raw.some((value) => typeof value !== 'boolean') || new Set(raw).size !== 1) return { invalid: true };
+  return { confirmed: raw[0] === true, explicit: true };
+}
+
+function confirmsParticipantAbsence(payload) {
+  // `absenceConfirmed` describes a project-list miss, not participant absence;
+  // `participants_status=empty` is only a label. The native server owns the
+  // same-Graph strict-validation gate before setting this dedicated flag.
+  return payload.participantAbsenceConfirmed === true;
+}
+
+function participantReason(payload) {
+  const explicit = textOrNull(payload.participants_unavailable_reason)
+    ?? textOrNull(payload.participantsUnavailableReason);
+  if (explicit) return explicit;
+  if (Array.isArray(payload.warnings)) {
+    const warning = payload.warnings
+      .map((item) => textOrNull(item) ?? textOrNull(item?.reason) ?? textOrNull(item?.message))
+      .find(Boolean);
+    if (warning) return warning;
+  }
+  if (payload.participantStatus === 'partial') return '一部の関係者だけを読み取っています。';
+  return '関係者の有無を確認できません。登録なしとは判断できません。';
+}
+
+function participantCountConflict(payload) {
+  const project = payload.project;
+  const declared = [project.participantCount, project.accountableCount]
+    .some((value) => Number.isInteger(value) && value > 0);
+  const named = Array.isArray(project.people) && project.people.length > 0;
+  return payload.participants.length === 0 && (declared || named);
+}
+
+function participantCountSummary(payload) {
+  const { participantCount, accountableCount } = payload.project;
+  const known = [];
+  if (Number.isInteger(participantCount) && participantCount > 0) known.push(`関係者${participantCount}人`);
+  if (Number.isInteger(accountableCount) && accountableCount > 0) known.push(`責任者${accountableCount}人`);
+  return known.length > 0 ? `確認済みの件数: ${known.join('、')}。` : '';
+}
+
+function projectCorrectionSubject(name, fields) {
+  return `プロジェクト「${name}」の${fields.map((field) => GRAPH_CORRECTION_FIELDS[field].label).join('・')}`;
+}
+
 function isProjectPerson(value) {
   return isRecord(value) && typeof value.id === 'string' && typeof value.name === 'string' && typeof value.accountable === 'boolean';
 }
@@ -118,7 +194,24 @@ export function normalizeProjectDetail(result) {
   if (!isEntityView(project) || project.type !== 'project') return INVALID;
   if (!Array.isArray(payload.participants) || !payload.participants.every(isEdgeView)) return INVALID;
   if (payload.relations !== undefined && (!Array.isArray(payload.relations) || !payload.relations.every(isEdgeView))) return INVALID;
-  return { state: 'ok', payload };
+  const participantStatus = normalizeParticipantStatus(payload);
+  if (participantStatus.invalid) return INVALID;
+  const participantFreshness = normalizeParticipantFreshness(payload);
+  if (participantFreshness.invalid) return INVALID;
+  const participantAbsence = normalizeParticipantAbsence({ ...payload, project });
+  if (participantAbsence.invalid) return INVALID;
+  return {
+    state: 'ok',
+    payload: {
+      ...payload,
+      participantStatus: participantStatus.value,
+      participantStatusExplicit: participantStatus.explicit,
+      participantFreshness: participantFreshness.value,
+      participantFreshnessExplicit: participantFreshness.explicit,
+      participantAbsenceConfirmed: participantAbsence.confirmed,
+      participantAbsenceExplicit: participantAbsence.explicit,
+    },
+  };
 }
 
 /**
@@ -308,7 +401,19 @@ export function createGraphProjectsView({
     now,
     scope: correctionScope,
     rerender: () => controller.render(),
-    onSaved: async () => {
+    onSaved: async (payload, form) => {
+      // The save response is the authoritative read-back.  A project name
+      // may have changed, so refresh the sentence above the saved form before
+      // the list/detail reloads redraw the rail.  Otherwise the old name
+      // remains visible while the read-back values already show the new one.
+      if (form?.kind === 'update_entity'
+        && form.recordType === 'project'
+        && payload?.record?.id === form.targetId
+        && typeof payload.record.name === 'string'
+        && Array.isArray(form.fields)) {
+        form.subject = projectCorrectionSubject(payload.record.name, form.fields);
+        controller.render();
+      }
       await Promise.all([
         state.detail ? controller.loadDetail(state.detail.id, { keep: true }) : null,
         controller.load({ keep: true }),
@@ -591,11 +696,16 @@ export function createGraphProjectsView({
         mountGraph: projectGraphMount,
         readEntity: (id) => graphClient.read(`/entities/${encodeURIComponent(id)}`),
         onTabChange: setKnowledgeTabChrome,
+        onRetryProject: (projectId) => controller.loadDetail(projectId),
       });
       children.push(knowledgeWorkspace.element);
     } else if (state.selectedId) {
-      children.push(renderProjectKnowledgeLoading(state.selectedId, state.detail ?? { state: 'loading' }, {
-        onRetry: () => controller.loadDetail(state.selectedId),
+      const projectId = state.selectedId;
+      children.push(renderProjectKnowledgeLoading(projectId, state.detail ?? { state: 'loading' }, {
+        onRetry: () => {
+          if (state.selectedId !== projectId) return state.detail;
+          return controller.loadDetail(projectId);
+        },
       }));
     }
 
@@ -679,16 +789,52 @@ export function createGraphProjectsView({
     return item;
   }
 
-  function renderParticipants(payload) {
+  function renderParticipants(payload, { onRetry } = {}) {
     const { project } = payload;
     const content = [makeElement(doc, 'p', { className: 'bb-graph-block-lead', text: '参加している人と、責任を持つ人です。終わった関わりも、終了日つきで残ります。' })];
-    if (payload.participants.length === 0) {
+    const hasParticipants = payload.participants.length > 0;
+    const state = payload.participantStatus;
+    const unavailable = ['partial', 'unavailable', 'unknown'].includes(state);
+    const contradictory = participantCountConflict(payload)
+      || (state === 'empty' && hasParticipants)
+      || (confirmsParticipantAbsence(payload) && hasParticipants);
+    // Retrieval uncertainty has precedence over the empty/contradictory
+    // branch so the host's reason is never discarded.  A contradiction may
+    // still be shown below and known rows are always retained.
+    if (unavailable) {
+      content.push(workspaceNotice(doc, {
+        label: state === 'partial' ? '一部取得' : '未確認',
+        tone: 'warning',
+        role: 'status',
+        text: participantReason(payload),
+      }));
+    }
+    if (contradictory) {
+      content.push(workspaceNotice(doc, {
+        label: '関係者を確認できません',
+        tone: 'warning',
+        role: 'status',
+        text: `${participantCountSummary(payload)}取得した関係者と件数が一致しません。登録なしとは判断せず、読み直してください。`,
+      }));
+    }
+    if (!hasParticipants && !unavailable && !contradictory && confirmsParticipantAbsence(payload)) {
       content.push(makeElement(doc, 'p', { className: 'bb-graph-empty', text: 'このプロジェクトには、まだ関係者の登録がありません。' }));
-    } else {
+    } else if (!hasParticipants && !unavailable && !contradictory) {
+      content.push(workspaceNotice(doc, {
+        label: '関係者を確認できません',
+        tone: 'warning',
+        role: 'status',
+        text: participantReason(payload),
+      }));
+    }
+    if (hasParticipants) {
       const list = makeElement(doc, 'ul', { className: 'bb-graph-compact-list' });
       for (const edge of payload.participants) list.append(participantItem(edge, project, payload.asOf));
       content.push(list);
     }
+    if (onRetry && (contradictory || unavailable || (!hasParticipants && !confirmsParticipantAbsence(payload)))) {
+      content.push(workspaceActions(doc, [workspaceButton(doc, { text: '再試行', variant: 'quiet', onClick: onRetry })]));
+    }
     return workspaceRailBlock(doc, { title: '関係者', content });
   }
 
@@ -736,14 +882,18 @@ export function createGraphProjectsView({
     const noteSubject = { id: project.id, type: 'project', metadata: loaded?.project?.metadata ?? {} };
     const children = [workspaceRailHead(doc, { kicker: 'プロジェクト', title: project.name, sub: project.id, leading: renderProjectIcon(doc, project.icon, project.name) })];
     if (!loaded) {
+      const projectId = state.selectedId;
       const readState = detail?.id === state.selectedId
         ? detail
         : state.list.state === 'ok' ? { state: 'loading' } : state.list;
       children.push(graphStateNotice(doc, readState, {
-        onRetry: () => controller.loadDetail(state.selectedId),
+        onRetry: () => {
+          if (state.selectedId !== projectId) return state.detail;
+          return controller.loadDetail(projectId);
+        },
         loadingText: 'このプロジェクトの関係者を読み込んでいます。',
       }));
-      children.push(...railExtensions(state.selectedId, null));
+      children.push(...railExtensions(projectId, null));
       return children;
     }
     const principles = Array.isArray(project.decisionPrinciples) ? project.decisionPrinciples.filter((item) => typeof item === 'string' && item.trim()) : [];
@@ -766,7 +916,13 @@ export function createGraphProjectsView({
         recordDetails(doc, [['プロジェクトID', project.id], ['digest', project.digest], ['読み取った時点', loaded.asOf]]),
       ],
     }));
-    children.push(renderParticipants(loaded));
+    const projectId = state.selectedId;
+    children.push(renderParticipants(loaded, {
+      onRetry: () => {
+        if (state.selectedId !== projectId) return state.detail;
+        return controller.loadDetail(projectId);
+      },
+    }));
     if (writable) {
       const canAdd = scope.createEdges;
       const projectFields = scope.entity('project') ? scope.fields(['name', 'goal', 'status', 'icon']) : [];
@@ -787,7 +943,7 @@ export function createGraphProjectsView({
           onClick: () => openCorrection('project', () => correction.openEntity(project, {
             fields: projectFields,
             title: 'プロジェクトを直す',
-            subject: `プロジェクト「${project.name}」の${projectFields.map((field) => GRAPH_CORRECTION_FIELDS[field].label).join('・')}`,
+            subject: projectCorrectionSubject(project.name, projectFields),
           })),
         }) : null,
       ].filter(Boolean);

package/ui/graph-registry-view.js

@@ -119,6 +119,114 @@ export function normalizeEntityDetail(result) {
   return { state: 'ok', payload };
 }
 
+const RELATION_UNAVAILABLE_STATES = new Set(['failed', 'incomplete', 'partial', 'stale', 'unknown', 'unavailable']);
+const RELATION_EMPTY_STATES = new Set(['confirmed_empty', 'empty', 'none']);
+
+function normalizedRelationState(value) {
+  if (typeof value !== 'string') return null;
+  const state = value.trim().toLowerCase().replace(/[- ]/gu, '_');
+  if (RELATION_UNAVAILABLE_STATES.has(state)) return 'unknown';
+  if (RELATION_EMPTY_STATES.has(state)) return 'confirmed_empty';
+  if (['available', 'complete', 'ready'].includes(state)) return 'available';
+  return null;
+}
+
+function firstText(...values) {
+  for (const value of values) {
+    const text = textOrNull(value);
+    if (text) return text;
+  }
+  return null;
+}
+
+function relationStatusFrom(payload, direction) {
+  const direct = [
+    payload[`${direction}_status`],
+    payload[`${direction}Status`],
+    payload[`${direction}_availability`],
+    payload[`${direction}Availability`],
+  ].map(normalizedRelationState).find(Boolean);
+  if (direct) return direct;
+  return [
+    payload.relations_status,
+    payload.relationsStatus,
+    payload.relation_status,
+    payload.relationStatus,
+    payload.edges_status,
+    payload.edgesStatus,
+  ].map(normalizedRelationState).find(Boolean) ?? null;
+}
+
+function participantStatusFrom(payload) {
+  return [
+    payload.participants_status,
+    payload.participantsStatus,
+    payload.participant_status,
+    payload.participantStatus,
+  ].map(normalizedRelationState).find(Boolean) ?? null;
+}
+
+function knownParticipantCount(payload) {
+  const entity = payload.entity ?? {};
+  const count = [
+    entity.participantCount,
+    entity.participant_count,
+    entity.accountableCount,
+    entity.accountable_count,
+    payload.actual_known_count,
+    payload.actualKnownCount,
+  ].find((value) => Number.isInteger(value) && value > 0);
+  if (count) return count;
+  if (Array.isArray(entity.people) && entity.people.length > 0) return entity.people.length;
+  if (Array.isArray(payload.people) && payload.people.length > 0) return payload.people.length;
+  return null;
+}
+
+function relationUnavailableReason(payload) {
+  const explicit = firstText(
+    payload.relations_reason,
+    payload.relationsReason,
+    payload.relation_reason,
+    payload.relationReason,
+    payload.edges_reason,
+    payload.edgesReason,
+    payload.participants_reason,
+    payload.participantsReason,
+    payload.participants_unavailable_reason,
+    payload.participantsUnavailableReason,
+    payload.reason,
+    payload.source?.reason,
+    payload.source?.message,
+  );
+  if (explicit) return `${explicit} 関係の有無は確認できません。登録なしとは判断できません。`;
+  const count = knownParticipantCount(payload);
+  const known = count ? `関係者の件数（${count}人）は確認できていますが、` : '';
+  return `${known}関係の有無を確認できません。関係の詳細が未取得のため、登録なしとは判断できません。`;
+}
+
+/**
+ * Empty edge arrays are a confirmed empty result only when the host says so.
+ * A project can carry a known participant count while its relation edges are
+ * unavailable; rendering the empty copy in that case turns unknown data into
+ * a product assertion.
+ */
+function relationAvailability(payload, direction) {
+  if (payload[direction].length > 0) return { state: 'available' };
+  const direct = relationStatusFrom(payload, direction);
+  if (direct === 'unknown') return { state: 'unknown', reason: relationUnavailableReason(payload) };
+  // A host may accidentally include a stale confirmed-empty status alongside
+  // an incomplete relation payload. Completeness signals take precedence so
+  // the UI cannot turn a known participant count into a false "none" claim.
+  const edgesNotProvided = payload.source?.edges_not_provided === true || payload.source?.edgesNotProvided === true;
+  const participantsUnknown = participantStatusFrom(payload) === 'unknown';
+  const knownCount = knownParticipantCount(payload);
+  if (edgesNotProvided || participantsUnknown || knownCount) {
+    return { state: 'unknown', reason: relationUnavailableReason(payload) };
+  }
+  if (direct === 'confirmed_empty') return { state: 'confirmed_empty' };
+  return { state: 'confirmed_empty' };
+}
+
 // A host that could not finish counting sends null (with countStatus
 // 'unknown', or 'at_least' plus atLeast) rather than a number it cannot vouch for.
 function isCount(value) {
@@ -396,11 +504,14 @@ export function createGraphRegistryView({
     }
     const { payload } = state.ontology;
     const ontology = payload.ontology;
+    const version = textOrNull(ontology.version);
+    const currentVersion = textOrNull(ontology.currentVersion);
+    const freshness = ontology.upToDate === false && currentVersion
+      ? `最新ではありません。最新は ${currentVersion}`
+      : ontology.upToDate === true && version ? '最新' : '最新性は未確認';
     section.append(makeElement(doc, 'p', {
       className: 'bb-gr-caption',
-      text: `定義の版 ${ontology.upToDate === false
-        ? `${String(ontology.version)}（最新ではありません。最新は ${String(ontology.currentVersion)}）`
-        : `${String(ontology.version)}（最新）`}`,
+      text: `定義の版 ${version ?? '未確認'}（${freshness}）`,
     }));
     section.append(makeElement(doc, 'h3', { className: 'bb-gr-subheading', text: 'つながり方' }));
     section.append(workspaceLedger(doc, {
@@ -441,7 +552,11 @@ export function createGraphRegistryView({
       );
       section.append(list);
     }
-    section.append(recordDetails(doc, [['定義ID', ontology.id], ['定義の版', ontology.version], ['release digest', ontology.releaseDigest]]));
+    section.append(recordDetails(doc, [
+      ['定義ID', textOrNull(ontology.id) ?? '未確認'],
+      ['定義の版', version ?? '未確認'],
+      ['release digest', textOrNull(ontology.releaseDigest) ?? '未確認'],
+    ]));
     return section;
   }
 
@@ -573,7 +688,22 @@ export function createGraphRegistryView({
     })];
     const edges = payload[direction];
     if (edges.length === 0) {
-      content.push(makeElement(doc, 'p', { className: 'bb-graph-empty', text: outgoing ? 'この記録から出る関係はありません。' : 'この記録へ入る関係はありません。' }));
+      const availability = relationAvailability(payload, direction);
+      if (availability.state === 'unknown') {
+        content.push(workspaceNotice(doc, {
+          label: '未確認',
+          tone: 'warning',
+          role: 'status',
+          text: availability.reason,
+        }));
+        content.push(workspaceActions(doc, [workspaceButton(doc, {
+          text: '再試行',
+          variant: 'quiet',
+          onClick: () => controller.loadEntity(entity.id, { keep: true }),
+        })]));
+      } else {
+        content.push(makeElement(doc, 'p', { className: 'bb-graph-empty', text: outgoing ? 'この記録から出る関係はありません。' : 'この記録へ入る関係はありません。' }));
+      }
     } else {
       const list = makeElement(doc, 'ul', { className: 'bb-graph-compact-list' });
       for (const edge of edges) list.append(relationItem(edge, entity, payload.asOf));

package/ui/graph-view-shared.js

@@ -584,7 +584,12 @@ export function graphStateNotice(doc, readState, { onRetry, loadingText = '読
   return workspaceNotice(doc, {
     label: '読み取り失敗',
     tone: 'danger',
-    text: noticeBody(doc, makeElement(doc, 'p', { text: `読み取れませんでした（${readState.reason ?? '理由不明'}）。0件ではありません。` }), retryButton(doc, onRetry)),
+    text: noticeBody(
+      doc,
+      makeElement(doc, 'p', { className: 'bb-graph-error-primary', text: '記録を取得できませんでした。' }),
+      makeElement(doc, 'small', { className: 'bb-graph-error-detail', text: `読み取れませんでした。詳細: ${readState.reason ?? '理由不明'}。0件ではありません。` }),
+      retryButton(doc, onRetry),
+    ),
   });
 }
 

package/ui/judgment-history.js

@@ -1194,7 +1194,11 @@ function statusNotice(doc, phase, error, home, onRetry) {
   if (phase === 'loading') return workspaceNotice(doc, { label: '読み込み中', text: '判断履歴を確認しています。', tone: 'info' });
   if (phase === 'error') return workspaceNotice(doc, {
     label: '取得できません',
-    text: [`判断の記録を確認できません。${error ? `理由: ${error}` : ''} `, workspaceButton(doc, { text: '再読み込み', variant: 'quiet', onClick: onRetry })],
+    text: [
+      { className: 'bb-jh-error-primary', text: '判断履歴を取得できませんでした。' },
+      error ? { className: 'bb-jh-error-detail', text: `詳細: ${error}` } : null,
+      workspaceButton(doc, { text: '再読み込み', variant: 'quiet', onClick: onRetry }),
+    ],
     tone: 'danger',
     role: 'alert',
   });

package/ui/meeting-minutes.css

@@ -16,12 +16,31 @@
 .bb-minutes-eyebrow,
 .bb-minutes-label,
 .bb-minutes-item-meta,
+.bb-minutes-meeting-label,
 .bb-minutes-rail-title,
 .bb-minutes-revision {
   color: var(--bb-color-muted);
   font-size: 0.82rem;
 }
 
+.bb-minutes-meeting-label {
+  margin: 0;
+  overflow-wrap: anywhere;
+}
+
+.bb-minutes-create-guard {
+  flex-basis: 100%;
+  margin: 0;
+  color: var(--bb-color-danger, var(--bb-color-ink));
+}
+
+.bb-minutes-edit-guard {
+  display: grid;
+  gap: var(--bb-space-2);
+  margin: 0;
+  color: var(--bb-color-danger, var(--bb-color-ink));
+}
+
 .bb-minutes-heading h1,
 .bb-minutes-heading p,
 .bb-minutes-pane-head h2,