@unson/brainbase-mcp 0.39.0 → 0.41.0

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),
+    ),
   });
 }
 
@@ -834,6 +839,11 @@ export function buildCorrectionRequest(form) {
     const name = String(form.draft.name ?? '').trim();
     if (!name) return { ok: false, message: GRAPH_CORRECTION_ERROR_MESSAGES.correction_name_required };
     const entity = { type, name };
+    if (form.projects.length > 0) {
+      const projectCode = String(form.draft.projectCode ?? '');
+      if (!form.projects.some((project) => project.code === projectCode)) return { ok: false, message: '人を加えるプロジェクトを選んでください。' };
+      entity.projectCode = projectCode;
+    }
     const aliases = splitAliases(form.draft.aliases ?? '').filter((alias) => alias !== name);
     const summary = String(form.draft.summary ?? '').trim();
     if (aliases.length > 0) entity.aliases = aliases;
@@ -894,7 +904,11 @@ function readBackFields(form, payload) {
 
 /** What a new record is, as rows shown before its values. */
 function createdEntityRows(form, record) {
-  return [['種類', form.typeNames[record?.type] ?? typeLabel(record?.type)]];
+  const project = form.projects.find((candidate) => candidate.code === form.draft.projectCode);
+  return [
+    ['種類', form.typeNames[record?.type] ?? typeLabel(record?.type)],
+    ...(project ? [['関わるプロジェクト', project.name ?? project.code]] : []),
+  ];
 }
 
 /** What a new relation connects, as rows shown before its values. */
@@ -1059,10 +1073,36 @@ function renderCreateEntityFields(doc, form, callbacks) {
       onChange: (value) => callbacks.onInput('type', value),
     }));
   }
+  if (form.projects.length > 0) {
+    group.append(selectControl(doc, {
+      id: `${form.formId}-project`,
+      name: 'projectCode',
+      label: '関わるプロジェクト',
+      value: String(form.draft.projectCode ?? ''),
+      options: [
+        { value: '', label: 'プロジェクトを選んでください' },
+        ...form.projects.map((project) => ({ value: project.code, label: project.name ?? project.code })),
+      ],
+      onChange: (value) => callbacks.onInput('projectCode', value),
+    }));
+    group.append(notice(doc, 'muted', '人はこのプロジェクトの関係者として記録されます。会社への所属は、作った後に加えてください。'));
+  }
   for (const field of form.fields) group.append(fieldControl(doc, form, field, callbacks));
   return group;
 }
 
+/** The projects a host offers for a new person, as `{ code, name }`, without duplicates. */
+function creationProjects(projects) {
+  const seen = new Set();
+  return (Array.isArray(projects) ? projects : []).flatMap((project) => {
+    const code = typeof project?.code === 'string' ? project.code.trim() : '';
+    if (!code || seen.has(code)) return [];
+    seen.add(code);
+    const name = typeof project.name === 'string' && project.name.trim() ? project.name.trim() : null;
+    return [{ code, name }];
+  });
+}
+
 /**
  * The correction panel.  `form` is the state held by `createGraphCorrection`;
  * callbacks are the controller's handlers.
@@ -1360,7 +1400,7 @@ export function createGraphCorrection({ client, rerender, onSaved, onConflict, n
      * `person` and `org` are created; others are dropped), `typeNames` their
      * labels.  Null outside the scope.
      */
-    openCreateEntity({ types = ['person', 'org'], type, typeNames = {}, title = '記録を加える', subject } = {}) {
+    openCreateEntity({ types = ['person', 'org'], type, typeNames = {}, title = '記録を加える', subject, projects = [] } = {}) {
       const entityTypes = allowed.createEntities
         ? types.filter((candidate) => (candidate === 'person' || candidate === 'org') && allowed.entity(candidate))
         : [];
@@ -1372,8 +1412,9 @@ export function createGraphCorrection({ client, rerender, onSaved, onConflict, n
         entityTypes,
         typeNames,
         fields,
+        projects: entityTypes.length === 1 && entityTypes[0] === 'person' ? creationProjects(projects) : [],
         original: Object.fromEntries(fields.map((field) => [field, ''])),
-        draft: { type: entityTypes.includes(type) ? type : entityTypes[0], name: '', aliases: '', summary: '', validFrom: '' },
+        draft: { type: entityTypes.includes(type) ? type : entityTypes[0], name: '', aliases: '', summary: '', validFrom: '', projectCode: '' },
       });
       redraw();
       return form;

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.js

@@ -233,7 +233,10 @@ export function createMeetingMinutesUI({
   );
   const status = makeElement(doc, 'p', { className: 'bb-minutes-status', attrs: { role: 'status', 'aria-live': 'polite' } });
   const columns = makeElement(doc, 'div', { className: 'bb-minutes-columns' });
-  const listPane = makeElement(doc, 'section', { className: 'bb-minutes-list-pane', attrs: { 'aria-label': '会議一覧' } });
+  const listPane = makeElement(doc, 'section', {
+    className: 'bb-minutes-list-pane',
+    attrs: { 'aria-label': '会議一覧', tabindex: '-1' },
+  });
   const detailPane = makeElement(doc, 'section', { className: 'bb-minutes-detail-pane', attrs: { 'aria-label': '会議詳細' } });
   columns.append(listPane, detailPane);
   screen.append(heading, status, columns);
@@ -288,7 +291,7 @@ export function createMeetingMinutesUI({
     head.append(button(doc, '会議を作成', () => renderCreateForm(), { className: 'bb-minutes-button is-primary' }));
     listPane.append(head);
     if (state.listError) {
-      appendLoadError(listPane, `会議一覧を読み込めませんでした。理由: ${state.listError}`, loadMeetings);
+      appendLoadError(listPane, `会議一覧を読み込めませんでした。理由: ${state.listError}`, () => loadMeetings({ restoreFocus: true }));
     }
     if (state.meetings.length === 0) {
       if (state.listError) return;
@@ -538,7 +541,7 @@ export function createMeetingMinutesUI({
     detailPane.append(form);
   }
 
-  async function loadMeetings() {
+  async function loadMeetings({ restoreFocus = false } = {}) {
     state.loading = true;
     setStatus('会議一覧を読み込んでいます。');
     try {
@@ -562,6 +565,7 @@ export function createMeetingMinutesUI({
       renderList();
       if (state.detailError && state.detail === null) renderDetail(null);
       setStatus(state.meetings.length ? `${state.meetings.length}件の会議を読み込みました。` : '保存された会議はありません。');
+      if (restoreFocus && typeof listPane.focus === 'function') listPane.focus({ preventScroll: true });
     } catch (error) {
       state.listError = loadErrorMessage(error, '会議一覧を読み込めませんでした。');
       const preserve = preserveLoadedStateOnFailure(error);

package/ui/objective-editor-http-port.js

@@ -10,6 +10,8 @@
  * Constraint links are only read here; there is no replace method.
  */
 
+import { normalizeObjectiveReadback } from './objective-readback-contract.js';
+
 export const OBJECTIVE_EDITOR_HTTP_PORT_VERSION = 'brainbase.objective-editor-http-port.v1';
 
 /** Top-level fields the Foundation route rejects with `authority_field_in_body`. */
@@ -93,7 +95,7 @@ export function createObjectiveEditorHttpPort({
     : typeof globalThis.fetch === 'function' ? (path, init) => globalThis.fetch(path, init) : null;
   const base = String(basePath).replace(/\/+$/u, '');
 
-  async function call(path, init) {
+  async function call(path, init, { allowObjectiveReadback = false, expected } = {}) {
     if (!request) throw new ObjectiveEditorHttpError({ code: 'network_error', status: 0, message: ERROR_MESSAGES.network_error });
     let response;
     try {
@@ -107,7 +109,14 @@ export function createObjectiveEditorHttpPort({
     } catch {
       payload = null;
     }
-    if (!response.ok) throw errorFromResponse(response.status, payload);
+    // Detail GETs use a typed envelope for both a canonical record and a
+    // confirmed miss/read failure.  Accept that envelope even when its HTTP
+    // status is 404/5xx; every other non-2xx response remains an error.
+    if (!response.ok) {
+      const readback = allowObjectiveReadback ? normalizeObjectiveReadback(payload, expected) : null;
+      if (readback) return readback;
+      throw errorFromResponse(response.status, payload);
+    }
     if (payload === null) throw new ObjectiveEditorHttpError({ code: 'invalid_response', status: response.status, message: ERROR_MESSAGES.invalid_response });
     return payload;
   }
@@ -128,13 +137,17 @@ export function createObjectiveEditorHttpPort({
       return payload;
     },
     async readObjective(id, _context, revision) {
-      try {
-        return await call(withRevision(objectivePath(id), revision));
-      } catch (error) {
-        // A missing Objective is a readback miss, not a failure of the request.
-        if (error instanceof ObjectiveEditorHttpError && error.status === 404 && error.code === 'not_found') return null;
-        throw error;
+      const expected = { id, revision };
+      const payload = await call(withRevision(objectivePath(id), revision), undefined, { allowObjectiveReadback: true, expected });
+      const readback = normalizeObjectiveReadback(payload, expected);
+      if (!readback) {
+        throw new ObjectiveEditorHttpError({
+          code: 'invalid_response',
+          status: 200,
+          message: ERROR_MESSAGES.invalid_response,
+        });
       }
+      return readback;
     },
     checkObjectiveReadiness(id, _context, revision) {
       return call(withRevision(objectivePath(id, '/readiness'), revision));