@unson/brainbase-mcp 0.41.11 → 0.41.13

package/ui/world/world-view.js

@@ -32,7 +32,7 @@ import { createDistrictView, DISTRICT_LEGEND } from './world-district.js';
 import { createWorldCanvasUI } from './world-canvas-ui.js';
 import { workCanvasNotes } from './world-canvas-notes.js';
 import { canvasTexture, drawFacade, FACADE_SIZES, FACADE_UNITS, gableRoof, hashUnit, muted, paintVertices, roundedPlate, valueNoise } from './world-scenery.js';
-import { WORK_STATES, workCityBlocks, workGrowthBlock, workPickBlock, workSign, workSiteBlocks } from './world-work-rail.js';
+import { WORK_STATES, readReasonShort, workCityBlocks, workGrowthBlock, workPickBlock, workSign, workSignBlocks, workSigns, workSiteBlocks } from './world-work-rail.js';
 import { exitHrefKind, exitLegend, exitsRailBlock, normalizeBusinessExits } from './world-exits.js';
 import {
   makeWorkspaceElement as el,
@@ -197,7 +197,7 @@ const GAP_SHORT_TEXT = Object.freeze({
   review_overdue: '見直し超過',
 });
 
-function createScene({ doc, stage, labelsLayer, reducedMotion, onPick, onClear, onEscape }) {
+function createScene({ doc, stage, labelsLayer, reducedMotion, onPick, onClear, onEscape, onSign }) {
   const renderer = new THREE.WebGLRenderer({ antialias: true });
   renderer.setPixelRatio(Math.min(globalThis.devicePixelRatio ?? 1, 2));
   renderer.shadowMap.enabled = true;
@@ -1113,18 +1113,30 @@ function createScene({ doc, stage, labelsLayer, reducedMotion, onPick, onClear,
     for (const post of citySigns.splice(0)) scene.remove(post);
     for (const [code, entry] of cityIndex) {
       const summary = summaries?.[code];
-      entry.label?.node.querySelector('.bb-world-badge')?.remove();
       if (entry.label) entry.label.size = null;
+      entry.label?.node.querySelectorAll('.bb-world-badge').forEach((badge) => badge.remove());
       const signal = workSign(summary);
       if (!signal) continue;
-      const { text } = signal;
       const unreadable = signal.kind === 'unreadable';
       const { city } = entry;
       const post = sign(unreadable ? 'unreadable' : 'check', 2.2, 0.9);
       post.position.set(city.x - city.size / 2 + 0.6, 0.45, city.z + city.size / 2 - 0.6);
       scene.add(post);
       citySigns.push(post);
-      if (entry.label) entry.label.node.append(el(doc, 'span', { className: `bb-world-badge ${unreadable ? 'is-unreadable' : 'is-check'}`, text }));
+      if (!entry.label) continue;
+      // Each sign says what it means in a few words; pressing one opens why and what to do next
+      // (story-world-sign-meaning-v1). The rail's entrances are the keyboard way to the same blocks.
+      for (const item of workSigns(summary)) {
+        const badge = el(doc, 'span', { className: `bb-world-badge ${item.kind === 'unreadable' ? 'is-unreadable' : 'is-check'}${onSign ? ' is-pressable' : ''}`, text: item.text });
+        if (onSign) {
+          badge.title = 'この札の意味と、次にすることを見る';
+          badge.addEventListener('click', (event) => {
+            event.stopPropagation();
+            onSign(entry.label.business ?? null, code);
+          });
+        }
+        entry.label.node.append(badge);
+      }
     }
   }
 
@@ -1748,9 +1760,9 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
       if (!summary) return { text: workConnected === false ? '' : '仕事は区画で読みます', count: -1 };
       if (summary.state !== 'complete' && summary.state !== 'partial') return { text: '仕事を読めない（0件とは確認できません）', count: -1, muted: true };
       const needs = summary.needs_check?.length ?? 0;
-      const parts = [needs ? `要確認 ${needs}` : Number.isInteger(summary.open) ? `未完了 ${summary.open}` : '未完了の件数は未確認'];
-      if (summary.state === 'partial') parts.push('一部だけ読めた');
-      return { text: parts.join('・'), count: needs };
+      const signs = workSigns(summary);
+      const parts = [...(needs ? [] : [Number.isInteger(summary.open) ? `未完了 ${summary.open}` : '未完了の件数は未確認']), ...signs.map((sign) => sign.text)];
+      return { text: parts.join('・'), count: needs, signs: signs.length > 0 };
     };
     const rows = knownBusinesses
       .map((business) => ({ business, note: noteOf(business) }))
@@ -1761,6 +1773,7 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
       const button = workspaceButton(doc, { text: `${business.name}の区画に入る ›`, onClick: () => enterFromRail(business) });
       item.append(button);
       if (note.text) item.append(el(doc, 'span', { className: `bb-world-entrance-note${note.count > 0 ? ' is-check' : ''}${note.muted ? ' is-muted' : ''}`, text: note.text }));
+      if (note.signs) item.append(workspaceButton(doc, { text: '札の意味 ›', variant: 'quiet', onClick: () => showSignMeaning(business) }));
       list.append(item);
     }
     showRail([
@@ -1771,6 +1784,32 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
   // The businesses are not known yet here (the list is drawn again once the world is built).
   showRail([workspaceDetailEmpty(doc, { mark: '◇', title: '都市や建物を選ぶと、ここに出ます', text: 'ドラッグで移動、ホイールで寄る・離れる、右ドラッグで回転します。Escで全体に戻ります。' })]);
 
+  /**
+   * What a city's signs mean (story-world-sign-meaning-v1): pressing 要確認 or 一部だけ読めた over a city
+   * opens, without entering it, which gaps the open work shows and how to correct them, and why the
+   * work was read only in part.  From there the district opens on one kind of gap.
+   */
+  function showSignMeaning(business) {
+    if (!business) return;
+    const summary = workSummaries[business.code];
+    const blocks = workSignBlocks(doc, {
+      summary,
+      onEnter: () => enterFromRail(business),
+      onSelectGap: (kind) => {
+        enterFromRail(business);
+        showFocus(business, { kind });
+      },
+    });
+    if (!blocks.length) return;
+    clearAll();
+    showRail([
+      workspaceRailHead(doc, { kicker: `${business.name}の札`, title: '札の意味と、次にすること', lead: '地図の札は、タスクの記録と、その読み込みの状態から出しています。' }),
+      ...blocks,
+      workspaceRailBlock(doc, { title: '', content: workspaceButton(doc, { text: '← 区画の入口に戻る', variant: 'quiet', onClick: () => showEntrances() }) }),
+    ]);
+    canvasUI?.openRail();
+  }
+
   /** The entrances of the districts, the ones with the most work to check first, in the opened rail. */
   function showEntrances() {
     if (current.level !== 'world') goToWorld();
@@ -2396,7 +2435,10 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
       if (!needsKnown) note('記録の確認件数', '仕事の要約に記録の要確認件数がありません。確認事項が0件とは確認できません。', 'warning', '記録の要確認件数：未確認');
       if (!openKnown) note('仕事の件数', '読めた仕事の要約に未完了件数の記録がありません。0件とは確認できません。', 'warning', '未完了の件数：未確認');
       if (unreadable) note('仕事の読込', `仕事を読めなかった事業${unreadable}件。0件とは確認できません。`, 'warning', `仕事が読めない事業 ${unreadable}件`);
-      if (partial) note('仕事の範囲', `一部だけ読めた事業${partial}件。件数は読めた範囲です。`, 'warning', `仕事が一部だけ読めた事業 ${partial}件`);
+      if (partial) {
+        const reasons = [...new Set(readable.filter((entry) => entry.state === 'partial').map((entry) => readReasonShort(entry.reason) ?? '理由の記録なし'))].join('・');
+        note('仕事の範囲', `一部だけ読めた事業${partial}件（${reasons}）。件数は読めた範囲です。区画の入口で、事業ごとの理由と次にすることを見られます。`, 'warning', `仕事が一部だけ読めた事業 ${partial}件（${reasons}）`, null, { action: { label: '理由を見る', onClick: showEntrances } });
+      }
       if (needs) note('仕事の記録', `読めた未完了の仕事${needs}件（${cities}事業）に、記録から把握できていないことがあります。仕事の失敗や停止を意味しません。`, 'attention', `記録の要確認 ${needs}件・${cities}事業`, null, { action: { label: '区画を選ぶ', onClick: showEntrances } });
     }
   }
@@ -2627,7 +2669,7 @@ export function createWorldView({ root, rail, page, presentation = 'standard', d
       for (const business of exitsEnabled ? businesses : []) loadExits(business);
       return;
     }
-    scene = createScene({ doc, stage, labelsLayer, reducedMotion, onPick, onClear: clearAll, onEscape: goUp });
+    scene = createScene({ doc, stage, labelsLayer, reducedMotion, onPick, onClear: clearAll, onEscape: goUp, onSign: (business, code) => showSignMeaning(business ?? knownBusinesses.find((entry) => entry.code === code) ?? null) });
     scene.setSky(SKY_MODES[skyIndex][0]);
     scene.buildPlaza(rows, rowItems, (row) => (rowItems.get(row.key) ?? []).filter((ref) => isWaiting(proofs.get(ref.decision_attempt_id))).length, Date.now(), { state: judgmentsUnavailable ? judgmentsUnavailable.title.replace('判断の記録：', '') : null });
     scene.buildCities(layoutWorld(businesses), placement.byBusiness);

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

@@ -54,6 +54,47 @@ export function readReasonText(reason) {
   return String(reason).split(',').map((part) => READ_REASON_TEXT[part] ?? part).join('。');
 }
 
+/** The same reasons in a few words, for a sign over a city. A reason not listed here gets no words (none is guessed). */
+const READ_REASON_SHORT = Object.freeze({
+  codes_not_permitted: '権限外の案件あり',
+  page_limit_reached: '件数が上限',
+  limit_reached: '件数が上限',
+  upstream_timeout: '応答なし',
+  upstream_request_failed: '接続できない',
+});
+
+export function readReasonShort(reason) {
+  if (!reason) return null;
+  const words = [...new Set(String(reason).split(',').map((part) => READ_REASON_SHORT[part]).filter(Boolean))];
+  return words.length ? words.join('・') : null;
+}
+
+/** What makes a read whole again, for each reason: where to go, or that nothing needs doing. */
+const READ_REASON_NEXT = Object.freeze({
+  codes_not_permitted: '読むには、その案件のタスクを見る権限が要ります。権限は組織の管理者が付けます。',
+  page_limit_reached: '直す操作はありません。件数と区画の中の仕事は、読めた範囲だけです。',
+  limit_reached: '直す操作はありません。件数と区画の中の仕事は、読めた範囲だけです。',
+  upstream_timeout: '時間をおいて画面を開き直すと、もう一度読みます。',
+  upstream_request_failed: '時間をおいて画面を開き直すと、もう一度読みます。',
+});
+
+/** What to correct in the task record for each kind of gap (the same words as the task screen). */
+const GAP_FIX_TEXT = Object.freeze({
+  assignee_unlinked_mentioned: '本文に書かれた人を、タスクの担当欄に登録する',
+  assignee_unrecorded: 'タスクの担当欄に、担当する人を登録する',
+  outcome_unlinked: '完了条件にある成果物の場所を、タスクの出典リンクに足す',
+  source_unlinked: '元になった議事録・Slack・資料のリンクを、タスクに足す',
+  review_overdue: '今の状態を確かめて、タスクの状態か見直し予定を更新する',
+});
+
+const GAP_TEXT = Object.freeze({
+  assignee_unlinked_mentioned: '担当欄に未接続（本文に人物あり）',
+  assignee_unrecorded: '担当の記録なし',
+  outcome_unlinked: '成果物の記録が未接続',
+  source_unlinked: '出典リンクなし',
+  review_overdue: '見直し予定を過ぎた',
+});
+
 const WORK_UNAVAILABLE_TEXT = Object.freeze({
   task_store_not_connected: 'この画面はタスクの正本に接続していないため、都市の中の仕事は描いていません。仕事の件数は未確認です。0件とは確認できません。',
 });
@@ -82,24 +123,88 @@ export function shortTime(value) {
 }
 
 /**
- * What a city's sign says, and its kind: amber when open work shows a gap, grey when the work could not
- * be read or was read only in part (an unknown city is never shown as one without problems).
+ * The signs over a city, each with its meaning in a few words: amber when open work shows a gap in its
+ * record, grey when the work could not be read or was read only in part, with the recorded reason (an
+ * unknown city is never shown as one without problems).
  */
-export function workSign(summary) {
-  if (!summary || summary.state === 'not_connected') return null;
+export function workSigns(summary) {
+  if (!summary || summary.state === 'not_connected') return [];
+  const reason = readReasonShort(summary.reason);
   if (summary.state === 'complete' || summary.state === 'partial') {
+    const signs = [];
     const count = summary.needs_check?.length ?? 0;
-    const part = summary.state === 'partial' ? '（一部だけ読めた）' : '';
-    if (count > 0) return { kind: 'check', text: `要確認 ${count}${part}` };
-    return summary.state === 'partial' ? { kind: 'unreadable', text: '一部だけ読めた' } : null;
+    if (count > 0) signs.push({ kind: 'check', text: `要確認 ${count}：記録に抜け` });
+    if (summary.state === 'partial') signs.push({ kind: 'unreadable', text: `一部だけ読めた${reason ? `：${reason}` : ''}` });
+    return signs;
   }
-  return { kind: 'unreadable', text: '仕事を読めない' };
+  return [{ kind: 'unreadable', text: `仕事を読めない${summary.state === 'forbidden' ? '：権限がない' : reason ? `：${reason}` : ''}` }];
+}
+
+/** The pole over a city: amber when any open work shows a gap, else grey; its text is all its signs. */
+export function workSign(summary) {
+  const signs = workSigns(summary);
+  if (!signs.length) return null;
+  return { kind: signs.some((sign) => sign.kind === 'check') ? 'check' : 'unreadable', text: signs.map((sign) => sign.text).join('・') };
 }
 
 export function workSignText(summary) {
   return workSign(summary)?.text ?? null;
 }
 
+/**
+ * What a city's signs mean, opened by pressing one (story-world-sign-meaning-v1): for 要確認, how many
+ * open tasks show which gap and what to correct in the task record; for 一部だけ読めた or 仕事を読めない,
+ * the reason the host recorded and what would make the read whole.  Every sentence is drawn from the
+ * summary; a reason the host did not give is said to be unrecorded, not guessed.
+ */
+export function workSignBlocks(doc, { summary, onSelectGap, onEnter }) {
+  const blocks = [];
+  if (!summary) return blocks;
+  const readable = summary.state === 'complete' || summary.state === 'partial';
+  const needs = readable ? summary.needs_check?.length ?? 0 : 0;
+  if (needs > 0) {
+    const list = el(doc, 'ul', { className: 'bb-world-rail-list is-plain bb-world-sign-gaps' });
+    const kinds = Object.entries(summary.gaps ?? {}).filter(([, ids]) => ids?.length).sort((a, b) => b[1].length - a[1].length);
+    for (const [kind, ids] of kinds) {
+      const li = el(doc, 'li');
+      const button = el(doc, 'button', { className: 'bb-world-rail-pick is-gap', text: `${GAP_TEXT[kind] ?? kind} ${ids.length}件 ›`, attrs: { type: 'button', disabled: !onSelectGap } });
+      button.addEventListener('click', () => onSelectGap?.(kind));
+      li.append(button);
+      if (GAP_FIX_TEXT[kind]) li.append(el(doc, 'small', { className: 'bb-world-rail-note', text: `直し方：${GAP_FIX_TEXT[kind]}` }));
+      list.append(li);
+    }
+    blocks.push(workspaceRailBlock(doc, {
+      title: `要確認 ${needs}件：記録に抜けがある仕事`,
+      className: 'bb-world-sign-meaning',
+      content: [
+        { text: `読めた未完了の仕事${Number.isInteger(summary.open) ? `${summary.open}件` : ''}のうち${needs}件に、タスクの記録から分からないことがあります。仕事が止まっている・遅れているという意味ではありません。` },
+        kinds.length ? list : null,
+        { text: '直すのはタスクの記録です。種類を選ぶと区画に入り、該当する仕事が並びます。1件ずつ開くと、確かめることと、タスク画面への行き先が出ます。直すと、次に読んだときに札が減ります。', className: 'bb-world-rail-caveat is-quiet' },
+      ],
+    }));
+  }
+  if (summary.state !== 'complete') {
+    const reason = readReasonText(summary.reason);
+    const parts = String(summary.reason ?? '').split(',').filter(Boolean);
+    const next = [...new Set(parts.map((part) => READ_REASON_NEXT[part]).filter(Boolean))];
+    const what = { partial: '一部だけ読めました', failed: '読めませんでした', forbidden: '権限が無く読めませんでした' }[summary.state] ?? `読めませんでした（${summary.state}）`;
+    const at = shortTime(summary.read_at);
+    const short = readReasonShort(summary.reason) ?? (summary.state === 'forbidden' ? '権限がない' : null);
+    blocks.push(workspaceRailBlock(doc, {
+      title: `${summary.state === 'partial' ? '一部だけ読めた' : '仕事を読めない'}${short ? `：${short}` : ''}`,
+      className: 'bb-world-sign-meaning',
+      content: workspaceDefinition(doc, [
+        ['読み込み', `この事業の仕事を${what}${at ? `（${at}）` : ''}`],
+        ['理由', reason ?? { text: '理由は記録されていません', className: 'is-unrecorded' }],
+        ['件数', summary.state === 'partial' ? '読めた範囲です。読めていない仕事は0件とは限りません。' : '未確認です。0件とは確認できません。'],
+        ['次にすること', next.length ? next.join('') : { text: '記録された理由からは分かりません', className: 'is-unrecorded' }],
+      ]),
+    }));
+  }
+  if (blocks.length && onEnter) blocks.push(workspaceRailBlock(doc, { title: '', content: workspaceButton(doc, { text: '区画に入って仕事を見る ›', onClick: onEnter }) }));
+  return blocks;
+}
+
 function linkLine(doc, link, label, extra) {
   const li = el(doc, 'li', { className: `bb-world-link is-${link}` });
   li.append(el(doc, 'span', { className: 'bb-world-link-mark', text: LINK_MARKS[link]?.mark ?? '・', attrs: { 'aria-label': LINK_MARKS[link]?.text ?? link } }));
@@ -176,6 +281,7 @@ function workStateBlocks(doc, { work, summary, onSelectGap, onSelectStatus }) {
     const button = el(doc, 'button', { className: 'bb-world-rail-pick is-gap', text: `${label} ${taskIds.length}件`, attrs: { type: 'button', disabled: !onSelectGap } });
     button.addEventListener('click', () => onSelectGap?.(kind));
     li.append(button);
+    if (GAP_FIX_TEXT[kind]) li.append(el(doc, 'small', { className: 'bb-world-rail-note', text: `直し方：${GAP_FIX_TEXT[kind]}` }));
     gapList.append(li);
   }
   blocks.push(workspaceRailBlock(doc, {