@unson/brainbase-mcp 0.43.0 → 0.44.1

package/ui/meeting-minutes.js

@@ -208,6 +208,52 @@ function normalizeConnections(value) {
   ]));
 }
 
+// 参加者の行 (story-meeting-participants-row-v1). The host decides who is linked,
+// unconfirmed or not a person; anything malformed is unreadable, never a person (P9).
+const PARTICIPANT_STATES = new Set(['linked', 'unconfirmed', 'not_person']);
+
+function normalizeParticipant(value) {
+  if (!isRecord(value) || !PARTICIPANT_STATES.has(value.state)) return null;
+  const displayName = text(value.display_name);
+  if (!displayName) return null;
+  const others = Number(value.other_meetings);
+  const participant = {
+    displayName,
+    state: value.state,
+    removable: value.removable === true,
+    otherMeetings: Number.isInteger(others) && others > 0 ? others : 0,
+  };
+  if (value.state === 'linked') {
+    const name = text(value.name);
+    const entityId = text(value.entity_id);
+    if (!name || !entityId) return null;
+    participant.name = name;
+    participant.entityId = entityId;
+    participant.href = connectionHref(value.href);
+  }
+  return participant;
+}
+
+function normalizeParticipants(value) {
+  if (!isRecord(value) || !['recorded', 'none', 'unavailable'].includes(value.status)) return { status: 'unavailable' };
+  if (value.status !== 'recorded') return { status: value.status };
+  const participants = Array.isArray(value.participants) ? value.participants.map(normalizeParticipant) : [];
+  if (participants.some((participant) => participant === null)) return { status: 'unavailable' };
+  if (!participants.length) return { status: 'none' };
+  return { status: 'recorded', participants, redrafting: value.redrafting === true };
+}
+
+function normalizeCandidateList(values, idField) {
+  if (!Array.isArray(values)) return [];
+  return values.flatMap((value) => {
+    const id = text(value?.[idField]);
+    const name = text(value?.name);
+    if (!id || !name) return [];
+    const evidence = Array.isArray(value.evidence) ? value.evidence.map((item) => text(item)).filter(Boolean) : [];
+    return [{ id, name, company: text(value.company), evidence }];
+  });
+}
+
 function firstDate(values) {
   for (const value of values) {
     const date = parseDate(value);
@@ -636,6 +682,7 @@ export function createMeetingMinutesUI({
   versionActionExtensions = [],
   meetingLabel,
   meetingConnections,
+  meetingParticipants,
   canCreateMeeting,
   createUnavailableReason,
   canEditMinutes,
@@ -666,11 +713,14 @@ export function createMeetingMinutesUI({
     withdrawingMinutesId: null,
     // { meetingId, rows } where rows is null while the host is answering.
     connections: null,
+    // { meetingId, value, openName } for the 参加者 row (story-meeting-participants-row-v1).
+    participants: null,
   };
   let listRequestGeneration = 0;
   let detailRequestGeneration = 0;
   let createReasonSequence = 0;
   let connectionsSlot = null;
+  let participantsSlot = null;
   let railProjectSlot = null;
   let railProjectMeeting = null;
 
@@ -1052,6 +1102,260 @@ export function createMeetingMinutesUI({
     if (railProjectSlot && railProjectMeeting?.meeting_id === meetingId) fillRailProject(railProjectSlot, railProjectMeeting);
   }
 
+  function hasParticipants() {
+    return isRecord(meetingParticipants) && typeof meetingParticipants.read === 'function';
+  }
+
+  function currentParticipants(meeting) {
+    const value = state.participants;
+    return value && value.meetingId === meeting?.meeting_id ? value : null;
+  }
+
+  function participantError(error, fallback) {
+    const reason = text(error?.message);
+    return reason && !/^[a-z_]+$/u.test(reason) ? reason : fallback;
+  }
+
+  function fillParticipants(slot, meeting) {
+    const current = currentParticipants(meeting);
+    const value = current?.value ?? null;
+    slot.hidden = value?.status === 'none';
+    if (value?.status === 'none') {
+      slot.replaceChildren();
+      return;
+    }
+    const row = makeElement(doc, 'div', { className: 'bb-minutes-participants-row' });
+    row.append(makeElement(doc, 'span', { className: 'bb-minutes-connection-label', textContent: '参加者' }));
+    if (!value) {
+      row.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note', textContent: '読み込んでいます' }));
+      slot.replaceChildren(row);
+      return;
+    }
+    if (value.status !== 'recorded') {
+      row.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note is-unavailable', textContent: '参加者を読み込めませんでした' }));
+      slot.replaceChildren(row);
+      return;
+    }
+    const list = makeElement(doc, 'ul', { className: 'bb-minutes-participant-items' });
+    for (const participant of value.participants) {
+      const entry = makeElement(doc, 'li', { attrs: { 'data-participant-state': participant.state } });
+      if (participant.state === 'linked') {
+        entry.append(connectionLink({ label: participant.name, href: participant.href }, 'bb-minutes-connection-link'));
+        if (participant.name !== participant.displayName) {
+          entry.append(makeElement(doc, 'span', { className: 'bb-minutes-connection-detail', textContent: `（${participant.displayName}）` }));
+        }
+      } else if (participant.state === 'unconfirmed') {
+        const open = current.openName === participant.displayName;
+        const badge = button(doc, `${participant.displayName}（未確認）`, () => toggleParticipantPanel(meeting, participant.displayName), {
+          className: 'bb-minutes-participant-badge',
+          attrs: { 'aria-expanded': open ? 'true' : 'false' },
+        });
+        entry.append(badge);
+      } else {
+        entry.append(makeElement(doc, 'span', { textContent: participant.displayName }));
+        entry.append(makeElement(doc, 'span', { className: 'bb-minutes-connection-detail', textContent: '（人ではない）' }));
+      }
+      if (participant.removable && typeof meetingParticipants.unlink === 'function') {
+        entry.append(button(doc, '取り消す', () => void unlinkParticipant(meeting, participant), { className: 'bb-minutes-participant-undo' }));
+      }
+      list.append(entry);
+    }
+    row.append(list);
+    const children = [row];
+    if (value.redrafting) {
+      children.push(makeElement(doc, 'p', { className: 'bb-minutes-connection-note', textContent: '名前を結んだので、この議事録を作り直しています。' }));
+    }
+    if (current.notice) {
+      children.push(makeElement(doc, 'p', { className: 'bb-minutes-participant-notice', textContent: current.notice, attrs: { role: 'status' } }));
+    }
+    if (current.openName && value.participants.some((participant) => participant.state === 'unconfirmed' && participant.displayName === current.openName)) {
+      children.push(renderParticipantPanel(meeting, current));
+    }
+    slot.replaceChildren(...children);
+  }
+
+  function refreshParticipants(meeting) {
+    if (participantsSlot && state.detail?.meeting?.meeting_id === meeting.meeting_id) fillParticipants(participantsSlot, meeting);
+  }
+
+  async function loadParticipants(detail, isCurrentRequest, { notice = '' } = {}) {
+    const meetingId = detail.meeting.meeting_id;
+    const previous = currentParticipants(detail.meeting);
+    state.participants = { meetingId, value: previous?.value ?? null, openName: null, notice };
+    let value;
+    try {
+      value = normalizeParticipants(await meetingParticipants.read({
+        meeting: detail.meeting,
+        minutes: detail.minutes,
+        versions: detail.versions,
+      }));
+    } catch {
+      value = { status: 'unavailable' };
+    }
+    if (!isCurrentRequest() || state.participants?.meetingId !== meetingId) return;
+    state.participants = { ...state.participants, value };
+    refreshParticipants(detail.meeting);
+  }
+
+  function reloadParticipants(meeting, notice) {
+    const detail = state.detail;
+    if (!detail || detail.meeting?.meeting_id !== meeting.meeting_id) return Promise.resolve();
+    return loadParticipants(detail, () => state.detail?.meeting?.meeting_id === meeting.meeting_id, { notice });
+  }
+
+  function toggleParticipantPanel(meeting, displayName) {
+    const current = currentParticipants(meeting);
+    if (!current) return;
+    const closing = current.openName === displayName;
+    state.participants = { ...current, openName: closing ? null : displayName, panel: closing ? null : { status: 'loading' }, notice: '' };
+    refreshParticipants(meeting);
+    if (!closing) void loadCandidates(meeting, displayName);
+  }
+
+  async function loadCandidates(meeting, displayName) {
+    let panel;
+    try {
+      if (typeof meetingParticipants.candidates !== 'function') throw new Error('候補を読み込めませんでした');
+      const value = await meetingParticipants.candidates({ meeting }, displayName);
+      if (!isRecord(value)) throw new Error('候補を読み込めませんでした');
+      const others = Number(value.other_meetings);
+      panel = {
+        status: 'ready',
+        people: normalizeCandidateList(value.people, 'entity_id'),
+        contacts: normalizeCandidateList(value.contacts, 'contact_id'),
+        companies: normalizeCandidateList(value.companies, 'entity_id'),
+        otherMeetings: Number.isInteger(others) && others > 0 ? others : 0,
+      };
+    } catch (error) {
+      panel = { status: 'error', message: participantError(error, '候補を読み込めませんでした') };
+    }
+    const current = currentParticipants(meeting);
+    if (!current || current.openName !== displayName) return;
+    state.participants = { ...current, panel: { ...panel, name: current.panel?.name ?? displayName } };
+    refreshParticipants(meeting);
+  }
+
+  function candidateRow(name, evidence, actionLabel, onClick, busy) {
+    const item = makeElement(doc, 'li', { className: 'bb-minutes-participant-candidate' });
+    const body = makeElement(doc, 'div');
+    body.append(makeElement(doc, 'strong', { textContent: name }));
+    if (evidence.length) body.append(makeElement(doc, 'span', { className: 'bb-minutes-connection-detail', textContent: evidence.join('・') }));
+    item.append(body, button(doc, actionLabel, onClick, { disabled: busy }));
+    return item;
+  }
+
+  function renderParticipantPanel(meeting, current) {
+    const displayName = current.openName;
+    const panelState = current.panel ?? { status: 'loading' };
+    const busy = panelState.busy === true;
+    const panel = makeElement(doc, 'div', {
+      className: 'bb-minutes-participant-panel',
+      attrs: { role: 'group', 'aria-label': `${displayName}を人物に結ぶ` },
+    });
+    panel.append(makeElement(doc, 'p', { className: 'bb-minutes-participant-panel-title', textContent: `「${displayName}」は誰ですか` }));
+    if (panelState.status === 'loading') {
+      panel.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note', textContent: '候補を読み込んでいます' }));
+    } else if (panelState.status === 'error' && !panelState.people) {
+      panel.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note is-unavailable', textContent: panelState.message, attrs: { role: 'alert' } }));
+    }
+    if (panelState.people) {
+      if (panelState.otherMeetings > 0) {
+        panel.append(makeElement(doc, 'p', {
+          className: 'bb-minutes-participant-others',
+          textContent: `同じ表示名の議事録があと${panelState.otherMeetings}件あります。結ぶとそれらも作り直します。`,
+        }));
+      }
+      const list = makeElement(doc, 'ul', { className: 'bb-minutes-participant-candidates' });
+      for (const person of panelState.people) {
+        list.append(candidateRow(person.name, person.evidence, 'この人', () => void linkParticipant(meeting, displayName, { action: 'person', entity_id: person.id }), busy));
+      }
+      for (const contact of panelState.contacts) {
+        const evidence = contact.evidence.length ? contact.evidence : contact.company ? [`名刺：${contact.company}`] : ['名刺'];
+        list.append(candidateRow(contact.name, evidence, 'この名刺の名前で登録', () => void linkParticipant(meeting, displayName, { action: 'new_person', name: contact.name, contact_id: contact.id }), busy));
+      }
+      if (!panelState.people.length && !panelState.contacts.length) {
+        panel.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note', textContent: '人物と名刺に、それらしい候補はありませんでした。' }));
+      } else {
+        panel.append(list);
+      }
+      const form = makeElement(doc, 'div', { className: 'bb-minutes-participant-new' });
+      const field = labelInput(doc, '新しい人として登録する名前', { value: panelState.name ?? displayName, name: 'participant_name' });
+      field.input.addEventListener('input', () => {
+        const latest = currentParticipants(meeting);
+        if (latest?.panel) latest.panel.name = field.input.value;
+      });
+      form.append(field.wrapper, button(doc, '新しい人として登録', () => void linkParticipant(meeting, displayName, {
+        action: 'new_person',
+        name: text(field.input.value, displayName),
+      }), { disabled: busy, className: 'bb-minutes-button is-primary' }));
+      panel.append(form);
+      const notPerson = makeElement(doc, 'div', { className: 'bb-minutes-participant-not-person' });
+      notPerson.append(makeElement(doc, 'span', { className: 'bb-minutes-connection-label', textContent: '人ではない' }));
+      for (const company of panelState.companies) {
+        notPerson.append(button(doc, `${company.name}（会社）に結ぶ`, () => void linkParticipant(meeting, displayName, { action: 'company', entity_id: company.id }), { disabled: busy }));
+      }
+      notPerson.append(button(doc, '結ばない', () => void linkParticipant(meeting, displayName, { action: 'not_person' }), { disabled: busy }));
+      panel.append(notPerson);
+      if (panelState.message) {
+        panel.append(makeElement(doc, 'p', { className: 'bb-minutes-connection-note is-unavailable', textContent: panelState.message, attrs: { role: 'alert' } }));
+      }
+      if (panelState.existing) {
+        panel.append(candidateRow(panelState.existing.name, ['同じ名前の人がいます'], 'この人', () => void linkParticipant(meeting, displayName, { action: 'person', entity_id: panelState.existing.id }), busy));
+      }
+    }
+    panel.append(button(doc, 'あとで', () => toggleParticipantPanel(meeting, displayName), { className: 'bb-minutes-button is-quiet' }));
+    return panel;
+  }
+
+  function setPanel(meeting, displayName, patch) {
+    const current = currentParticipants(meeting);
+    if (!current || current.openName !== displayName) return false;
+    state.participants = { ...current, panel: { ...current.panel, ...patch } };
+    refreshParticipants(meeting);
+    return true;
+  }
+
+  function redraftNotice(result, done) {
+    const count = Number(result?.redraft?.meetings);
+    return Number.isInteger(count) && count > 0
+      ? `${done}議事録${count}件を作り直します（数分かかります）。`
+      : `${done}`;
+  }
+
+  async function linkParticipant(meeting, displayName, input) {
+    if (typeof meetingParticipants.link !== 'function') return;
+    if (!setPanel(meeting, displayName, { busy: true, message: '', existing: null })) return;
+    try {
+      const result = await meetingParticipants.link({ meeting }, { display_name: displayName, ...input });
+      const linkedName = text(result?.linked?.name);
+      await reloadParticipants(meeting, redraftNotice(result, linkedName ? `「${displayName}」を${linkedName}に結びました。` : `「${displayName}」を記録しました。`));
+    } catch (error) {
+      const existing = isRecord(error?.candidate) && text(error.candidate.entity_id) && text(error.candidate.name)
+        ? { id: text(error.candidate.entity_id), name: text(error.candidate.name) }
+        : null;
+      setPanel(meeting, displayName, {
+        busy: false,
+        existing,
+        message: existing ? '同じ名前の人がいます。この人で良ければ選んでください。' : participantError(error, '結べませんでした。もう一度試してください。'),
+      });
+    }
+  }
+
+  async function unlinkParticipant(meeting, participant) {
+    try {
+      const result = await meetingParticipants.unlink({ meeting }, {
+        display_name: participant.displayName,
+        ...(participant.entityId ? { entity_id: participant.entityId } : {}),
+      });
+      await reloadParticipants(meeting, redraftNotice(result, `「${participant.displayName}」の結び付きを取り消しました。`));
+    } catch (error) {
+      const current = currentParticipants(meeting);
+      if (!current) return;
+      state.participants = { ...current, notice: participantError(error, '取り消せませんでした。') };
+      refreshParticipants(meeting);
+    }
+  }
+
   function appendLoadError(parent, message, retry) {
     const notice = makeElement(doc, 'div', {
       className: 'bb-minutes-load-error',
@@ -1448,6 +1752,7 @@ export function createMeetingMinutesUI({
   function renderDetail(detail, documentRecord = null, selectedVersion = null) {
     clear(detailPane);
     connectionsSlot = null;
+    participantsSlot = null;
     if (state.detailError) {
       const retry = state.meetingId === null ? loadMeetings : () => loadDetail(state.meetingId);
       appendLoadError(detailPane, state.detailError.startsWith('会議詳細を読み込めませんでした。')
@@ -1480,6 +1785,15 @@ export function createMeetingMinutesUI({
       textContent: participants ? `${when} / ${participants}` : when,
     }));
     detailPane.append(header);
+    participantsSlot = null;
+    if (hasParticipants()) {
+      participantsSlot = makeElement(doc, 'section', {
+        className: 'bb-minutes-participants',
+        attrs: { 'aria-label': '参加者' },
+      });
+      fillParticipants(participantsSlot, meeting);
+      detailPane.append(participantsSlot);
+    }
     if (hasConnections()) {
       connectionsSlot = makeElement(doc, 'section', {
         className: 'bb-minutes-connections',
@@ -1631,9 +1945,11 @@ export function createMeetingMinutesUI({
       state.detail = detail;
       state.detailError = null;
       if (hasConnections()) state.connections = { meetingId, rows: null };
+      if (hasParticipants() && state.participants?.meetingId !== meetingId) state.participants = null;
       renderDetail(detail);
       setStatus('会議詳細を読み込みました。');
       if (hasConnections()) void loadConnections(detail, isCurrentRequest);
+      if (hasParticipants()) void loadParticipants(detail, isCurrentRequest);
     } catch (error) {
       if (!isCurrentRequest()) return state.detail;
       const preserved = preserveLoadedStateOnFailure(error) && state.detail?.meeting?.meeting_id === meetingId

package/ui/objective-editor.js

@@ -260,6 +260,18 @@ function definitionForSave(definition) {
 
 function normalizeReadiness(value) {
   const object = objectValue(value);
+  const explicitState = normalizeState(firstValue(object, 'state'));
+  if (['permission_denied', 'api_unavailable', 'missing', 'conflict', 'error_retryable'].includes(explicitState)) {
+    return {
+      state: explicitState,
+      ready: null,
+      issues: null,
+      code: nonEmptyText(firstValue(object, 'code')) ?? explicitState,
+      currentRevision: nonEmptyText(firstValue(object, 'currentRevision', 'current_revision')),
+      message: nonEmptyText(firstValue(object, 'message')) ?? STATUS_LABELS[explicitState],
+      error: firstValue(object, 'error'),
+    };
+  }
   if (!object || typeof object.ready !== 'boolean') return { state: 'unknown', ready: null, issues: null };
   const issues = asArray(object.issues);
   const messageValue = firstValue(object, 'message', 'reason');
@@ -708,11 +720,17 @@ function renderCorrectionGuidance(guidance) {
   return section;
 }
 
-function renderReadiness(root, readiness) {
+function renderReadiness(root, readiness, callbacks = {}) {
   const section = makeElement('section', { className: 'objective-editor-readiness', attrs: { 'aria-label': '判断利用可能性' } });
   const normalized = normalizeReadiness(readiness);
   section.append(makeElement('div', { className: 'objective-editor-subheading', text: '判断への利用' }));
   if (normalized.state !== 'ready') {
+    if (normalized.state !== 'unknown') {
+      section.append(statusNotice(normalized, {
+        onRetry: ['error_retryable', 'api_unavailable'].includes(normalized.state) ? callbacks.onRetryReadiness : null,
+      }));
+      return section;
+    }
     section.append(statusBadge('judgment_unknown'), makeElement('p', { className: 'objective-editor-muted', text: '判断に使える状態かどうかを、保存先から確認できていません。' }));
     return section;
   }
@@ -897,7 +915,7 @@ function buildObjectiveForm(state, callbacks, { workspace = false } = {}) {
     onAddCriterion: () => { captureDraft(); callbacks.onAddCriterion?.(); },
     onRemoveCriterion: (index) => { captureDraft(); callbacks.onRemoveCriterion?.(index); },
   }));
-  form.append(renderReadiness(form, state.readiness));
+  form.append(renderReadiness(form, state.readiness, callbacks));
   form.append(renderConstraintRefs(form, state, callbacks));
   const actions = makeElement('div', { className: 'objective-editor-actions' });
   actions.append(makeElement('span', { className: 'objective-editor-muted', text: callbacks.canEdit ? '保存後に同じID・新版を再取得して確認します。' : '読み取り専用です。書込み権限はホストから提供してください。' }));
@@ -1199,9 +1217,16 @@ function constraintContent(doc, state, callbacks) {
   return content;
 }
 
-function readinessContent(doc, readiness) {
+function readinessContent(doc, readiness, callbacks = {}) {
   const normalized = normalizeReadiness(readiness);
   if (normalized.state !== 'ready') {
+    if (normalized.state !== 'unknown') {
+      return [workspaceStatusNotice(doc, normalized, {
+        label: '判断',
+        onRetry: ['error_retryable', 'api_unavailable'].includes(normalized.state) ? callbacks.onRetryReadiness : null,
+        retryLabel: '再読込',
+      })];
+    }
     return [statusBadge('judgment_unknown'), makeElement('p', { text: '判断に使える状態かどうかを、保存先から確認できていません。' })];
   }
   if (normalized.ready) {
@@ -1242,7 +1267,7 @@ function renderObjectiveDetail(doc, state, callbacks) {
   }));
   parts.push(workspaceRailBlock(doc, { title: `評価基準${objective.criteria ? ` ${objective.criteria.length}件` : ''}`, className: 'bb-objective-criteria-block', content: criteriaContent(doc, objective.criteria) }));
   parts.push(workspaceRailBlock(doc, { title: '制約の参照', className: 'bb-objective-constraints-block', content: constraintContent(doc, state, callbacks) }));
-  parts.push(workspaceRailBlock(doc, { title: '判断に使えるか', className: 'bb-objective-readiness-block', content: readinessContent(doc, state.readiness) }));
+  parts.push(workspaceRailBlock(doc, { title: '判断に使えるか', className: 'bb-objective-readiness-block', content: readinessContent(doc, state.readiness, callbacks) }));
   if (callbacks.canEdit) {
     parts.push(makeElement('p', { className: 'objective-editor-muted bb-objective-revision-note', text: '直して保存すると同じ目的の新しい版を作ります。保存結果を読み戻して確認し、確認できない場合はその状態を表示します。' }));
     parts.push(workspaceActions(doc, [{ text: '目的を直す', variant: 'primary', onClick: callbacks.onEdit }]));
@@ -1416,6 +1441,7 @@ export function createObjectiveEditorController(options = {}) {
       onAddConstraintRef: addConstraintRef,
       onRemoveConstraintRef: removeConstraintRef,
       onReloadConstraints: () => loadConstraintRefs(state.selected),
+      onRetryReadiness: () => loadReadiness(state.selected),
       onLoadStoryLinks: loadStoryLinks,
       onRetryStory: () => loadStoryLinks(state.story.storyId),
       onEdit: beginEdit,
@@ -1513,24 +1539,34 @@ export function createObjectiveEditorController(options = {}) {
     const request = ++readinessRequest;
     const current = () => version === selectionVersion && request === readinessRequest
       && state.selected?.id === objective.id && state.selected?.revision === objective.revision;
+    const apply = (readiness) => {
+      if (!current()) return false;
+      state.readiness = readiness;
+      if (state.selected) state.selected.readiness = readiness;
+      if (Array.isArray(state.objectives.records)) {
+        state.objectives.records = state.objectives.records.map((record) => (
+          record?.id === objective.id && record?.revision === objective.revision
+            ? { ...record, readiness }
+            : record
+        ));
+      }
+      render();
+      return true;
+    };
     const method = portMethod(port, 'checkObjectiveReadiness');
     if (!method) {
-      state.readiness = { state: 'unknown', ready: null, issues: null, message: '判断に使える状態を確かめる経路がありません。' };
-      render();
+      apply({ state: 'unknown', ready: null, issues: null, message: '判断に使える状態を確かめる経路がありません。' });
       return state.readiness;
     }
     try {
       const payload = await method(objective.id, context, objective.revision);
-      if (!current()) return state.readiness;
-      state.readiness = normalizeReadiness(payload);
+      if (!apply(normalizeReadiness(payload))) return state.readiness;
     } catch (error) {
       if (!current()) return state.readiness;
       const normalized = normalizeObjectiveError(error);
       state.permissionDenied ||= normalized.state === 'permission_denied';
-      state.readiness = { state: normalized.state, ready: null, issues: null, ...normalized };
+      if (!apply({ state: normalized.state, ready: null, issues: null, ...normalized })) return state.readiness;
     }
-    if (state.selected) state.selected.readiness = state.readiness;
-    render();
     return state.readiness;
   }
 

package/ui/world/world-district.js

@@ -20,7 +20,7 @@
  */
 
 import { THREE, MapControls } from './world-vendor.js';
-import { DISTRICT_STREETS, districtGroundPlan, districtStage, districtStreetLots, skyAt } from './world-placement.js';
+import { DISTRICT_STREETS, districtTaskActors, districtGroundPlan, districtStage, districtStreetLots, skyAt } from './world-placement.js';
 import { canvasTexture, drawFacade, FACADE_SIZES, FACADE_UNITS, gableRoof, hashUnit, paintVertices, roundedPlate, valueNoise } from './world-scenery.js';
 import { makeWorkspaceElement as el } from '../../workspace-kit.js';
 import { attentionSignText } from './world-exits.js';
@@ -46,7 +46,7 @@ export const DISTRICT_LEGEND = Object.freeze([
   ['is-stakes', '杭と縄の空き地＝未着手（記録上）'],
   ['is-house', '明かりのついた家＝完了して、出典・成果の記録がある（本設の建物）'],
   ['is-prefab', 'プレハブ＝完了したが、出典・成果の記録が無い'],
-  ['is-worker', 'ヘルメットの人＝担当欄の担当'],
+  ['is-worker', 'ヘルメットの人＝記録された担当。緑はAI担当、動きは進行中Taskと現在の稼働証跡が一致したときだけ'],
   ['is-empty', '誰もいない現場＝担当の記録なし'],
   ['is-outside', '柵の外の人（破線の輪）＝本文にだけ名前がある'],
   ['is-nopath', '通りへの道が無い＝出典リンクなし'],
@@ -397,6 +397,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
   }
 
   // --- people (records: worker, person named in the text; atmosphere: walkers) ---------------------
+  const taskActors = [];
   function person(clothes, { helmet = false } = {}) {
     const group = new THREE.Group();
     group.add(mesh(new THREE.CapsuleGeometry(0.2, 0.46, 4, 10), material(clothes), { y: 0.5 }));
@@ -527,6 +528,12 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
       worker.position.set(0.55, 0.06, 0.55);
       group.add(worker);
     }
+    districtTaskActors(site).forEach((actor, index) => {
+      const worker = person(0x2f9c8b, { helmet: true });
+      worker.position.set(-0.5 + index * 0.55, 0.06, 0.35);
+      group.add(worker);
+      taskActors.push({ worker, x: worker.position.x, moving: actor.moving, heartbeatAt: actor.activity?.heartbeat_at, phase: hash(actor.id + site.task_id) });
+    });
     if (named && status !== 'completed') {
       const outside = person(0x6b5b95);
       outside.position.set(-0.95, 0, half + 0.65);
@@ -682,6 +689,7 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     scene.add(root);
     root.add(selectionRing);
     const readable = work?.status === 'ok' && (work.reads.tasks.state === 'complete' || work.reads.tasks.state === 'partial');
+    taskActors.length = 0;
     const shown = readable ? work.sites.filter((site) => site.work.status !== 'cancelled') : [];
     const layout = districtStreetLots(shown.map((site) => ({ task_id: site.task_id, created_at: site.work.created_at, purpose_label: site.purpose_label })));
     const L = layout.length;
@@ -850,7 +858,8 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
       root.add(group);
       lots.set(site.task_id, group);
       const title = site.title.length > 15 ? `${site.title.slice(0, 14)}…` : site.title;
-      addLabel(title, new THREE.Vector3(lot.x, 2.6, lot.z), `is-site${site.gaps.length ? ' is-check' : ''}`, { owner: group, near: 15, priority: 6 });
+      const actorNames = districtTaskActors(site).map(actor => actor.name).join('・');
+      addLabel(actorNames ? `${title} / ${actorNames}` : title, new THREE.Vector3(lot.x, 2.6, lot.z), `is-site${site.gaps.length ? ' is-check' : ''}`, { owner: group, near: 15, priority: 6 });
     }
     // Atmosphere: walkers on the sidewalks and back streets, smoke from chimneys (no record behind them).
     const routes = [-1.55, 1.55, -DISTRICT_STREETS.backStreet + 0.6, DISTRICT_STREETS.backStreet - 0.6];
@@ -1074,6 +1083,12 @@ export function createDistrictView({ doc, stage, reducedMotion = false, focusSel
     }
     if (!reducedMotion) {
       const seconds = time / 1000;
+      for (const actor of taskActors) {
+        const age = Date.now() - Date.parse(actor.heartbeatAt ?? '');
+        if (!actor.moving || !Number.isFinite(age) || age < 0 || age > 300000) continue;
+        actor.worker.position.set(actor.x + Math.sin(seconds * 1.4 + actor.phase) * 0.12, 0.06 + Math.abs(Math.sin(seconds * 3 + actor.phase)) * 0.025, 0.35);
+        actor.worker.rotation.y = Math.sin(seconds * 1.4 + actor.phase) * 0.3;
+      }
       for (const walker of walkers) {
         const { x, from, to, speed, phase } = walker.userData;
         const span = to - from;

package/ui/world/world-placement.js

@@ -313,3 +313,16 @@ export function districtStage(sites) {
     next: following ? { label: following.label, needed: following.min - permanent } : null,
   };
 }
+
+/** Optional host-supplied actors. Movement needs current host-confirmed runtime evidence and an in-progress Task. */
+export function districtTaskActors(site, now = Date.now()) {
+  if (site?.actors_state !== 'confirmed' || !Array.isArray(site.actors)) return [];
+  const seen = new Set();
+  return site.actors.filter(actor => {
+    if (!actor || typeof actor.id !== 'string' || !actor.id || typeof actor.name !== 'string' || !actor.name || actor.task_id !== site.task_id || actor.state !== site.work?.status || seen.has(actor.id)) return false;
+    seen.add(actor.id); return true;
+  }).map(actor => {
+    const age = now - Date.parse(actor.activity?.heartbeat_at ?? '');
+    return { ...actor, moving: site.work.status === 'in_progress' && actor.activity?.moving === true && actor.activity?.state === 'running' && Number.isFinite(age) && age >= 0 && age <= 300000 };
+  });
+}

package/ui/world/world-work-rail.js

@@ -8,6 +8,8 @@
  * different marks.  Nothing here writes; corrections go to the host's own task screen.
  */
 
+import { districtTaskActors } from './world-placement.js';
+
 import {
   makeWorkspaceElement as el,
   workspaceRailBlock,
@@ -417,10 +419,14 @@ export function workSiteBlocks(doc, { business, site, readAt, taskHref }) {
     const how = person.link === 'recorded' ? '担当欄' : `${person.stated_as_assignee ? '本文が担当として記載' : '本文に記載'}（${person.basis === 'text_person_id' ? '人物IDつき' : '氏名の一致'}）・担当欄には未接続`;
     people.append(linkLine(doc, person.link, person.name, how));
   }
+  for (const actor of districtTaskActors(site)) {
+    people.append(linkLine(doc, 'recorded', actor.name, `${actor.kind === 'agent' ? 'AI担当' : '担当'}・Taskの記録上の状態: ${site.work.label ?? site.work.status}・実行: ${actor.moving ? '稼働証跡確認済み' : '未確認または停止'}`));
+  }
+  if (site.actors_state === 'unconfirmed') people.append(linkLine(doc, 'unreadable', 'AI担当未確認', '現在の登録とTask委任を確認できませんでした'));
   for (const mention of site.ambiguous_mentions ?? []) {
     people.append(linkLine(doc, 'inferred', `「${mention.text}」`, `組織のGraphの${mention.candidates.map((candidate) => candidate.name).join('・')}のどれか一意に決まりません`));
   }
-  blocks.push(workspaceRailBlock(doc, { title: '担当・関係者', content: site.people.length || site.ambiguous_mentions?.length ? people : { text: '担当欄も本文も、登録された人物を挙げていません。' } }));
+  blocks.push(workspaceRailBlock(doc, { title: '担当・関係者', content: site.people.length || site.ambiguous_mentions?.length || districtTaskActors(site).length || site.actors_state === 'unconfirmed' ? people : { text: '担当欄も本文も、登録された人物を挙げていません。' } }));
   const refs = el(doc, 'ul', { className: 'bb-world-rail-list' });
   for (const ref of site.source_refs) {
     const li = el(doc, 'li');