@unson/brainbase-mcp 0.15.0 → 0.15.2

package/ui/local-web-shell.js

@@ -43,6 +43,8 @@ const NAV_ICON_PATHS = Object.freeze({
   objectives: ['M12 4 3 20h18z', 'M12 9v5m0 3h.01'],
   projects: ['M3 6.5h7l2 2h9v10H3z', 'M3 6.5v-2h7l2 2'],
   graph: ['M10 13a5 5 0 0 0 7.5.5l2-2a5 5 0 0 0-7-7l-1.2 1.2', 'M14 11a5 5 0 0 0-7.5-.5l-2 2a5 5 0 0 0 7 7l1.2-1.2'],
+  // World view (extension id `world`, ledger P17).
+  world: ['M12 3a9 9 0 1 0 0 18 9 9 0 0 0 0-18z', 'M3 12h18', 'M12 3c2.5 2.6 3.8 5.6 3.8 9s-1.3 6.4-3.8 9c-2.5-2.6-3.8-5.6-3.8-9S9.5 5.6 12 3z'],
 });
 const SVG_NS = 'http://www.w3.org/2000/svg';
 
@@ -88,9 +90,15 @@ export function parseLocalWebTarget(target) {
   if (!screenId) return { screenId: null, entityId: null };
   const query = separator < 0 ? '' : raw.slice(separator + 1);
   const params = new URLSearchParams(query);
+  // 今日 accepts one judgment to open (`decision` = decision_attempt_id) and
+  // プロジェクトと関係者 one project (`project` = Graph project id); other screens ignore them.
+  const decisionId = screenId === 'today' ? params.get('decision')?.trim() || null : null;
+  const projectId = screenId === 'projects' ? params.get('project')?.trim() || null : null;
   return {
     screenId,
     entityId: screenId === 'graph' ? params.get('entity_id')?.trim() || null : null,
+    ...(decisionId ? { decisionId } : {}),
+    ...(projectId ? { projectId } : {}),
   };
 }
 
@@ -195,11 +203,67 @@ function mountObjectives(container, context) {
   return { editor, worldModel };
 }
 
-function mountGraphScreen(createView) {
+const ORGANIZATION_READ_ONLY_NOTE = '組織のGraphを読み取り専用で表示しています。登録の訂正は組織版で行ってください。';
+// What the owner needs before leaving for the organization web (Inspector UX-20261004-01): a link to this
+// very record there, who may correct it, and what happens after saving.  The organization web opens
+// 情報と関係 by record id and プロジェクトと関係者 by project code, and keeps that record across sign-in.
+const ORGANIZATION_RECORD_ID = /^[A-Za-z0-9_.:-]{1,200}$/u;
+export function organizationRecordLink(origin, screenId, record) {
+  const id = typeof record?.id === 'string' && ORGANIZATION_RECORD_ID.test(record.id) ? record.id : null;
+  // The organization web picks a project by its own code.  Only that code is used: a sub-project's scope
+  // code is its parent's and would open the parent, so without its own code the record opens by id.
+  const own = typeof record?.metadata?.code === 'string' ? record.metadata.code.trim() : '';
+  const code = own && ORGANIZATION_RECORD_ID.test(own) ? own : null;
+  if (screenId === 'projects' && record?.type === 'project' && code) {
+    return { href: `${origin}/?screen=projects&project=${encodeURIComponent(code)}`, label: '「プロジェクトと関係者」' };
+  }
+  return id ? { href: `${origin}/?screen=graph&entity_id=${encodeURIComponent(id)}`, label: '「情報と関係」' } : null;
+}
+const organizationReadOnlyNoteLinked = (doc, origin, screenId) => (record) => {
+  const target = organizationRecordLink(origin, screenId, record);
+  if (!target) return ORGANIZATION_READ_ONLY_NOTE;
+  const note = makeElement(doc, 'span');
+  note.append(
+    makeElement(doc, 'span', { text: [
+      '組織のGraphを読み取り専用で表示しています。ここでは直せません。訂正の手順：',
+      `① 下のリンクから、組織版の${target.label}でこの記録を開きます。ログインしていなければSlackでログインすると、そのままこの記録に戻ります。`,
+      '② 直せるのは、組織版での役割がgmかceoで、このプロジェクトとその上の事業の両方を許可されている人です。直せるのはプロジェクトの記録（名前・別名・要約・期間・目的・状態）だけで、人物の記録と、関係者の追加・終了は組織版でもまだ直せません。',
+      '③ 保存すると、理由といっしょに組織のGraphへ書き込まれ、組織版がその場で読み戻して表示します。この画面には、1分ほどたってから再読み込みすると反映されます。',
+      '',
+    ].join('\n') }),
+    makeElement(doc, 'a', { text: '組織版でこの記録を開く', attrs: { href: target.href, target: '_blank', rel: 'noopener noreferrer' } }),
+  );
+  return note;
+};
+
+/** The organization's web for this screen, or null when the host was not told where it is. */
+function organizationWebLink(doc, organizationGraph, screenId) {
+  const origin = typeof organizationGraph?.web_url === 'string' && /^https:\/\/[^/?#@\s]+$/u.test(organizationGraph.web_url)
+    ? organizationGraph.web_url
+    : null;
+  if (!origin) return null;
+  return makeElement(doc, 'a', {
+    text: '組織版で開いて訂正する',
+    attrs: { href: `${origin}/?screen=${encodeURIComponent(screenId)}`, target: '_blank', rel: 'noopener noreferrer' },
+  });
+}
+
+function mountGraphScreen(screenId, createView) {
   return (container, context) => {
     const viewRoot = makeElement(context.document, 'div');
     makePage(container, context).append(viewRoot);
+    // Ledger C1: when the host reads the organization Graph, nothing here can be corrected.
+    const readOnly = context.organizationGraph?.status === 'connected';
+    const link = readOnly ? organizationWebLink(context.document, context.organizationGraph, screenId) : null;
+    const sourceText = `組織のGraph（${context.organizationGraph?.server ?? '接続先不明'}）を読み取り専用で表示しています。このMacのGraphではありません。`;
+    const source = link ? makeElement(context.document, 'span') : null;
+    source?.append(makeElement(context.document, 'span', { text: `${sourceText} ` }), link);
     return createView({
+      ...(readOnly ? {
+        canCorrect: false,
+        readOnlyNote: link ? organizationReadOnlyNoteLinked(context.document, context.organizationGraph.web_url, screenId) : ORGANIZATION_READ_ONLY_NOTE,
+        sourceNotice: { label: '出典', text: source ?? sourceText },
+      } : {}),
       root: viewRoot,
       rail: context.rail,
       page: context.page,
@@ -214,8 +278,8 @@ function mountGraphScreen(createView) {
 export const LOCAL_WEB_SCREENS = Object.freeze([
   Object.freeze({ id: 'today', label: '今日', usesGraph: false, rail: true, source: '判断journal', mount: mountToday }),
   Object.freeze({ id: 'objectives', label: '目的と現状', usesGraph: true, rail: true, source: '手元のGraph', mount: mountObjectives }),
-  Object.freeze({ id: 'projects', label: 'プロジェクトと関係者', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen(createGraphProjectsView) }),
-  Object.freeze({ id: 'graph', label: '情報と関係', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen(createGraphRegistryView) }),
+  Object.freeze({ id: 'projects', label: 'プロジェクトと関係者', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen('projects', createGraphProjectsView) }),
+  Object.freeze({ id: 'graph', label: '情報と関係', usesGraph: true, rail: true, source: '手元のGraph', mount: mountGraphScreen('graph', createGraphRegistryView) }),
 ]);
 
 function renderGraphGate(doc, slot, status, onRecheck, label) {
@@ -279,7 +343,7 @@ function renderSource(doc, bar, status, onRecheck) {
   bar.append(
     fact('データ', data.data_dir),
     fact('Graph', graphLabel, data.graph.status === 'ready' ? '' : 'is-warning'),
-    fact('組織のGraph', data.organization_graph?.status === 'connected' ? '読んでいます' : '読んでいません'),
+    fact('組織のGraph', data.organization_graph?.status === 'connected' ? '読んでいます（読み取りのみ）' : '読んでいません'),
   );
 }
 
@@ -377,10 +441,10 @@ export function createLocalWebShell({
 
   function ensureMounted(screen, entityId = pendingEntityIds.get(screen.id) ?? null) {
     if (mounted.has(screen.id)) {
-      if (entityId && screen.id === 'graph') {
-        const view = mounted.get(screen.id);
-        if (typeof view?.openEntity === 'function') void view.openEntity(entityId);
-      }
+      const view = mounted.get(screen.id);
+      if (entityId && screen.id === 'graph' && typeof view?.openEntity === 'function') void view.openEntity(entityId);
+      if (entityId && screen.id === 'today' && typeof view?.openDecision === 'function') view.openDecision(entityId);
+      if (entityId && screen.id === 'projects' && typeof view?.openProject === 'function') void view.openProject(entityId);
       return;
     }
     const slot = slots.get(screen.id);
@@ -391,8 +455,13 @@ export function createLocalWebShell({
     slot.replaceChildren();
     const rail = rails.get(screen.id) ?? null;
     rail?.replaceChildren();
-    const page = Object.freeze({ crumbs: Object.freeze(['あなたのBrainbase', screen.label]), source: screen.source ?? null });
-    mounted.set(screen.id, screen.mount(slot, Object.freeze({ ...context, rail, page, initialEntityId: entityId })) ?? true);
+    const organizationGraph = status.phase === 'ready' ? status.data.organization_graph ?? null : null;
+    const readsOrganization = organizationGraph?.status === 'connected' && (screen.id === 'projects' || screen.id === 'graph');
+    const page = Object.freeze({ crumbs: Object.freeze(['あなたのBrainbase', screen.label]), source: readsOrganization ? '組織のGraph（読み取りのみ）' : screen.source ?? null });
+    const view = screen.mount(slot, Object.freeze({ ...context, rail, page, initialEntityId: entityId, organizationGraph })) ?? true;
+    mounted.set(screen.id, view);
+    if (entityId && screen.id === 'today' && typeof view?.openDecision === 'function') view.openDecision(entityId);
+    if (entityId && screen.id === 'projects' && typeof view?.openProject === 'function') void view.openProject(entityId);
     updateRail();
   }
 
@@ -403,7 +472,9 @@ export function createLocalWebShell({
     show(target) {
       const parsed = parseLocalWebTarget(target);
       const screen = screens.find((candidate) => candidate.id === parsed.screenId) ?? screens[0];
-      pendingEntityIds.set(screen.id, screen.id === 'graph' ? parsed.entityId : null);
+      pendingEntityIds.set(screen.id, screen.id === 'graph' ? parsed.entityId
+        : screen.id === 'today' ? parsed.decisionId ?? null
+          : screen.id === 'projects' ? parsed.projectId ?? null : null);
       active = screen.id;
       for (const [screenId, slot] of slots) slot.hidden = screenId !== screen.id;
       for (const [screenId, link] of links) {

package/ui/value-proof-review.css

@@ -503,6 +503,30 @@ body:has(#brainbase-value-proof-review) {
   outline-offset: 2px;
 }
 
+/* The answer area of a judgment returned to the owner, and its confirmation. */
+.bb-vpr-answer {
+  display: grid;
+  gap: var(--bb-space-2);
+  margin-top: var(--bb-space-3);
+  padding: var(--bb-space-3);
+  border: 1px solid var(--vpr-border-strong);
+  border-radius: var(--bb-radius-sm, 7px);
+}
+
+.bb-vpr-answer h4,
+.bb-vpr-answer .bb-vpr-hint {
+  margin: 0;
+}
+
+.bb-vpr-answer-confirm {
+  margin: 0;
+  padding: 11px 12px;
+  border-radius: var(--bb-radius-sm, 7px);
+  color: var(--vpr-ink);
+  background: var(--vpr-warning-soft);
+  font-size: 13px;
+}
+
 /* Messages under the form and the consult button. */
 .vpr-notice {
   margin: 0;

package/ui/value-proof-review.js

@@ -29,7 +29,7 @@ import {
   workspaceSectionTitle,
 } from './workspace-kit.js';
 
-export const VALUE_PROOF_REVIEW_UI_CONTRACT_VERSION = 'value-proof-review-ui.v2';
+export const VALUE_PROOF_REVIEW_UI_CONTRACT_VERSION = 'value-proof-review-ui.v3';
 
 const SECTION_ORDER = Object.freeze(['needs_human', 'blocked', 'continued']);
 const SECTION_LABELS = Object.freeze({
@@ -80,6 +80,16 @@ const FEEDBACK_LAYER_LABELS = Object.freeze({
   philosophy: '大切にすること',
   other: 'その他',
 });
+/** Shown when the host does not offer recording answers (no `capabilities.answer` in the home). */
+const HUMAN_DECISION_BOUNDARY_NOTE = 'この画面では、人に戻した判断への回答や作業の再開はできません。';
+const ANSWER_HINT = 'この画面で、選択肢を選んで回答を記録できます。記録しても、止まった作業は自動では再開しません。';
+const ANSWER_FINAL_NOTE = '記録した回答は、この画面では変更・取り消しできません。';
+const ANSWER_RESUME_NOTE = '止まった作業は自動では再開しません。続きを進めるときは、AIにこの回答を伝えて頼み直してください。';
+const ANSWER_REJECT_LABEL = 'どれも選ばない';
+const ANSWER_KINDS = Object.freeze(['select', 'reject']);
+const MOVED_ON_LABEL = '会話で先に進んだ';
+const FEEDBACK_PURPOSE_NOTE = '評価は、実行後の振り返りとして記録します。人に戻した判断への回答や承認ではありません。';
+const CONSULT_COPY_NOTE = '相談文をコピーするだけで、この画面からCodexへは送信しません。';
 /** Layers the owner can pick for a correction. `delegation` comes from 「次回は聞く」. */
 export const VALUE_PROOF_CORRECTION_LAYERS = Object.freeze(['method', 'objective', 'world_model', 'philosophy', 'other']);
 export const VALUE_PROOF_FEEDBACK_OPTIONS = Object.freeze([
@@ -138,6 +148,40 @@ function isProof(value) {
     && isRecord(value.feedback);
 }
 
+/** The recorded answer, or null. A malformed answer is treated as absent, never as answered. */
+function normalizeAnswer(answer) {
+  if (!isRecord(answer) || !ANSWER_KINDS.includes(answer.kind) || !text(answer.recorded_at)) return null;
+  if (answer.kind === 'select' && !text(answer.selected_option_id)) return null;
+  return {
+    kind: answer.kind,
+    optionId: answer.kind === 'select' ? text(answer.selected_option_id) : null,
+    optionLabel: answer.kind === 'select' ? text(answer.selected_option_label) : null,
+    recordedAt: text(answer.recorded_at),
+  };
+}
+
+/** When the conversation moved on after the question, or null. */
+function normalizeMovedOnAt(value) {
+  const at = text(value);
+  return at && !Number.isNaN(Date.parse(at)) ? at : null;
+}
+
+/** A judgment returned to the owner that still has no recorded answer and whose conversation is still at the question. */
+function awaitsOwner(item) {
+  return item.section === 'needs_human' && !item.answer && !item.conversationMovedOnAt;
+}
+
+/** The section label, or how the owner's side of a returned judgment ended. */
+function itemStateLabel(item) {
+  if (item.answer) return '回答済み';
+  return item.conversationMovedOnAt ? MOVED_ON_LABEL : SECTION_LABELS[item.section];
+}
+
+/** Shown instead of the answer controls: the owner answered in that conversation or it moved on. */
+function movedOnNote(at) {
+  return `この問いのあと、同じ会話で次のやり取りがありました（${formatDate(at)}）。会話の中で答えたか、話が先に進んだと考えられるので、この画面では回答を受け付けません。続きが必要なら、元の会話で頼んでください。`;
+}
+
 /** Normalize the host response. Anything unexpected becomes `invalid`, never an empty success. */
 export function normalizeValueProofReviewHome(payload) {
   if (!isRecord(payload)) return { status: 'invalid', reason: '応答の形式が不正です' };
@@ -157,6 +201,8 @@ export function normalizeValueProofReviewHome(payload) {
       section,
       proof: item.proof,
       feedbackHistory: Array.isArray(item.feedback_history) ? item.feedback_history.filter(isRecord) : [],
+      answer: normalizeAnswer(item.answer),
+      conversationMovedOnAt: normalizeMovedOnAt(item.conversation_moved_on_at),
     }));
   }
   const itemsByKey = new Map(SECTION_ORDER.flatMap((section) => sections[section].map((item) => [itemKey(item.proof), item])));
@@ -175,6 +221,8 @@ export function normalizeValueProofReviewHome(payload) {
     itemsByKey,
     delegationMap,
     rejected: Array.isArray(payload.rejected) ? payload.rejected.filter(isRecord) : [],
+    // Only a host that records answers says so; elsewhere the screen keeps the 回答できません note.
+    answersRecordable: isRecord(payload.capabilities) && payload.capabilities.answer === 'record_only',
   };
 }
 
@@ -251,7 +299,7 @@ function isUnrated(proof) {
 function itemVisible(state, item) {
   if (!item) return false;
   if (state.unratedOnly && !isUnrated(item.proof)) return false;
-  if (state.needsHumanOnly && item.section !== 'needs_human') return false;
+  if (state.needsHumanOnly && !awaitsOwner(item)) return false;
   return true;
 }
 
@@ -268,6 +316,15 @@ function rowOfItem(state, key) {
   return state.home?.delegationMap?.rows.find((row) => row.itemKeys.includes(key)) ?? null;
 }
 
+function findItemByDecision(state, decisionAttemptId) {
+  if (state.home?.status !== 'available' || !decisionAttemptId) return null;
+  for (const section of [...SECTION_ORDER, 'other']) {
+    const found = state.home.sections[section].find((item) => item.proof.decision_attempt_id === decisionAttemptId);
+    if (found) return found;
+  }
+  return null;
+}
+
 function findItem(state, key) {
   if (state.home?.status !== 'available' || !key) return null;
   for (const section of [...SECTION_ORDER, 'other']) {
@@ -370,7 +427,7 @@ function toggleButton(doc, { label, pressed, disabled = false, onClick }) {
 }
 
 function renderFilters(doc, home, state, callbacks) {
-  const needsHuman = home.sections.needs_human.length;
+  const needsHuman = home.sections.needs_human.filter(awaitsOwner).length;
   const actions = workspaceActions(doc, [
     toggleButton(doc, {
       label: state.needsHumanOnly ? `あなたの判断が必要 ${needsHuman}件（絞り込み中・解除）` : `あなたの判断が必要 ${needsHuman}件`,
@@ -391,9 +448,17 @@ function renderFilters(doc, home, state, callbacks) {
 
 function renderMetrics(doc, home) {
   const map = home.delegationMap;
+  const excluded = [
+    home.answersRecordable && '回答済み',
+    home.sections.needs_human.some((item) => item.conversationMovedOnAt) && '会話で先に進んだもの',
+  ].filter(Boolean);
   return workspaceMetrics(doc, [
     { label: '保存済み', value: home.coverage.saved, note: '判断journalの記録' },
-    { label: 'あなたの判断が必要', value: home.sections.needs_human.length, note: 'あなたに戻した判断' },
+    {
+      label: 'あなたの判断が必要',
+      value: home.sections.needs_human.filter(awaitsOwner).length,
+      note: excluded.length > 0 ? `あなたに戻した判断（${excluded.join('と、')}を除く）` : 'あなたに戻した判断',
+    },
     { label: '聞かずに進めた', value: home.sections.continued.length, note: '聞かずに続行した判断' },
     { label: '評価済み', value: map.rated, note: `判断 ${map.judged}件のうち` },
   ], { ariaLabel: '判断の集計' });
@@ -668,7 +733,7 @@ function renderItemButton(doc, state, item, callbacks) {
     makeElement(doc, 'span', {
       className: 'bb-vpr-item-meta',
       text: [
-        SECTION_LABELS[item.section],
+        itemStateLabel(item),
         formatDate(item.proof.recorded_at),
         OUTCOME_LABELS[item.proof.outcome.status] ?? '成果不明',
         FEEDBACK_LABELS[item.proof.feedback.status] ?? '評価不明',
@@ -772,6 +837,65 @@ function renderFeedbackForm(doc, item, state, callbacks) {
   return form;
 }
 
+function answerChoiceText(kind, optionLabel, optionId) {
+  return kind === 'reject' ? ANSWER_REJECT_LABEL : optionLabel ?? optionId ?? '選択肢';
+}
+
+/** The answer area of a judgment returned to the owner: the recorded answer, or the choices and the confirmation. */
+function renderAnswer(doc, item, state, callbacks) {
+  const key = itemKey(item.proof);
+  const save = state.answerSave?.key === key ? state.answerSave : null;
+  const box = makeElement(doc, 'div', {
+    className: `bb-vpr-answer${item.answer ? ' is-answered' : ''}`,
+    attrs: { role: 'group', 'aria-label': item.answer ? '記録した回答' : 'この問いに回答する' },
+  });
+  if (item.answer) {
+    box.append(
+      makeElement(doc, 'h4', { text: '回答済み' }),
+      makeElement(doc, 'p', {
+        text: `「${answerChoiceText(item.answer.kind, item.answer.optionLabel, item.answer.optionId)}」と回答しました（${formatDate(item.answer.recordedAt)}）。`,
+      }),
+      makeElement(doc, 'p', { className: 'bb-vpr-hint', text: `${ANSWER_RESUME_NOTE}${ANSWER_FINAL_NOTE}` }),
+    );
+    if (save?.state === 'saved') box.append(notice(doc, 'is-success', save.message));
+    if (save?.state === 'error') box.append(notice(doc, 'is-danger', save.message, 'alert'));
+    return box;
+  }
+  box.append(makeElement(doc, 'h4', { text: 'この問いに回答する' }), makeElement(doc, 'p', { className: 'bb-vpr-hint', text: ANSWER_HINT }));
+  const draft = state.answerDraft?.key === key ? state.answerDraft : null;
+  if (draft) {
+    box.append(makeElement(doc, 'p', {
+      className: 'bb-vpr-answer-confirm',
+      text: `「${answerChoiceText(draft.kind, draft.optionLabel, draft.optionId)}」で回答を記録します。${ANSWER_FINAL_NOTE}止まった作業は自動では再開しません。`,
+    }));
+    const saving = save?.state === 'saving';
+    box.append(workspaceActions(doc, [
+      workspaceButton(doc, {
+        text: saving ? '記録中…' : '回答を記録する',
+        variant: 'primary',
+        disabled: saving,
+        onClick: () => callbacks.onAnswerConfirm?.(item),
+      }),
+      workspaceButton(doc, { text: 'やめる', variant: 'quiet', disabled: saving, onClick: () => callbacks.onAnswerCancel?.() }),
+    ]));
+  } else {
+    const options = Array.isArray(item.proof.human_decision?.options) ? item.proof.human_decision.options : [];
+    box.append(workspaceActions(doc, [
+      ...options.map((option) => workspaceButton(doc, {
+        text: `「${text(option.label) ?? option.id}」で回答する`,
+        onClick: () => callbacks.onAnswerDraft?.({ key, kind: 'select', optionId: option.id, optionLabel: text(option.label) }),
+      })),
+      workspaceButton(doc, {
+        text: ANSWER_REJECT_LABEL,
+        variant: 'quiet',
+        onClick: () => callbacks.onAnswerDraft?.({ key, kind: 'reject', optionId: null, optionLabel: null }),
+      }),
+    ]));
+  }
+  if (save?.state === 'error') box.append(notice(doc, 'is-danger', save.message, 'alert'));
+  return box;
+}
+
 function consultText(proof) {
   return [
     'Brainbaseのこの判断について相談したい。',
@@ -798,7 +922,7 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
     detail.push(back);
   }
   const head = workspaceRailHead(doc, {
-    kicker: SECTION_LABELS[item.section],
+    kicker: itemStateLabel(item),
     title: itemTitle(proof),
     sub: kindLabel(proof) ? `判断の種類: ${kindLabel(proof)}` : row ? rowName(row) : null,
   });
@@ -851,10 +975,16 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
       for (const option of options) list.append(makeElement(doc, 'li', { text: `${text(option.label) ?? option.id}: ${text(option.impact) ?? '影響の記録なし'}` }));
       content.push(makeElement(doc, 'h4', { text: '選択肢と影響' }), list);
     }
+    if (item.conversationMovedOnAt && !item.answer) content.push(notice(doc, 'is-muted', movedOnNote(item.conversationMovedOnAt)));
+    else if (state.home?.answersRecordable && item.section === 'needs_human') content.push(renderAnswer(doc, item, state, callbacks));
+    else content.push(makeElement(doc, 'p', { className: 'bb-vpr-hint', text: HUMAN_DECISION_BOUNDARY_NOTE }));
     detail.push(workspaceRailBlock(doc, { title: 'あなたに戻した理由', className: 'bb-vpr-human-decision', content }));
   }
 
-  const feedback = [renderFeedbackForm(doc, item, state, callbacks)];
+  const feedback = [
+    makeElement(doc, 'p', { className: 'bb-vpr-hint', text: FEEDBACK_PURPOSE_NOTE }),
+    renderFeedbackForm(doc, item, state, callbacks),
+  ];
   if (item.feedbackHistory.length > 1) {
     const history = makeElement(doc, 'details', { className: 'bb-vpr-history' });
     history.append(makeElement(doc, 'summary', { text: `評価の履歴 ${item.feedbackHistory.length}件` }));
@@ -867,7 +997,10 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
   }
   detail.push(workspaceRailBlock(doc, { title: '評価', className: 'bb-vpr-feedback-block', content: feedback }));
 
-  const consult = [workspaceButton(doc, { text: 'Codexで相談する（依頼文をコピー）', onClick: () => callbacks.onConsult?.(consultText(proof)) })];
+  const consult = [
+    makeElement(doc, 'p', { className: 'bb-vpr-hint', text: CONSULT_COPY_NOTE }),
+    workspaceButton(doc, { text: 'Codexで相談する（依頼文をコピー）', onClick: () => callbacks.onConsult?.(consultText(proof)) }),
+  ];
   if (state.consultMessage) consult.push(notice(doc, 'is-muted', state.consultMessage));
   detail.push(workspaceRailBlock(doc, { title: 'Codexで相談', content: consult }));
 
@@ -1052,6 +1185,9 @@ export function createValueProofReviewUI({
     needsHumanOnly: false,
     draft: { status: '', summary: '', targetLayer: '' },
     save: { state: 'idle', message: '' },
+    /** The answer the owner picked and is about to confirm: `{ key, kind, optionId, optionLabel }`. */
+    answerDraft: null,
+    answerSave: { state: 'idle', message: '', key: null },
     focusCard: false,
     consultMessage: '',
     sourceReads: new Map(),
@@ -1083,9 +1219,18 @@ export function createValueProofReviewUI({
   const resetJudgmentInput = () => {
     state.draft = { status: '', summary: '', targetLayer: '' };
     state.save = { state: 'idle', message: '' };
+    state.answerDraft = null;
+    state.answerSave = { state: 'idle', message: '', key: null };
     state.consultMessage = '';
   };
 
+  /** Keep the detail on this judgment, even when a filter now hides it from the lists. */
+  const showJudgment = (key) => {
+    state.selectedKey = key;
+    state.selectedRowKey = rowOfItem(state, key)?.key ?? state.selectedRowKey;
+    state.railView = 'judgment';
+  };
+
   const applyFilter = () => {
     const previous = state.selectedKey;
     revealSelection(state);
@@ -1167,10 +1312,7 @@ export function createValueProofReviewUI({
         const key = itemKey(item.proof);
         const saved = findItem(state, key);
         if (saved?.proof.feedback.status !== option.value) throw new Error('保存後の読み戻しで評価を確認できません');
-        // Keep the read-back on the judgment just rated, even when a filter now hides it from the lists.
-        state.selectedKey = key;
-        state.selectedRowKey = rowOfItem(state, key)?.key ?? state.selectedRowKey;
-        state.railView = 'judgment';
+        showJudgment(key);
         state.draft = { status: '', summary: '', targetLayer: '' };
         state.save = { state: 'saved', message: `「${option.label}」を保存しました（読み戻し済み）。` };
       } catch (error) {
@@ -1178,6 +1320,71 @@ export function createValueProofReviewUI({
       }
       controller.render();
     },
+    onAnswerDraft(draft) {
+      state.answerDraft = draft;
+      state.answerSave = { state: 'idle', message: '', key: null };
+      controller.render();
+    },
+    onAnswerCancel() {
+      state.answerDraft = null;
+      controller.render();
+    },
+    async onAnswerConfirm(item) {
+      const key = itemKey(item.proof);
+      const draft = state.answerDraft;
+      if (!draft || draft.key !== key) return;
+      if (!request) {
+        state.answerSave = { state: 'error', key, message: '記録先のAPIが未設定です。回答はまだ記録されていません。' };
+        controller.render();
+        return;
+      }
+      state.answerSave = { state: 'saving', key, message: '' };
+      controller.render();
+      let accepted = false;
+      try {
+        const response = await request(joinPath(basePath, '/answers'), {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json', 'X-Brainbase-Review-Token': token ?? '' },
+          body: JSON.stringify({
+            intent_id: item.proof.intent_id,
+            decision_attempt_id: item.proof.decision_attempt_id,
+            kind: draft.kind,
+            selected_option_id: draft.kind === 'select' ? draft.optionId : null,
+            confirmed: true,
+          }),
+        });
+        if (response.status === 409) {
+          // Another answer was recorded first; show that one instead of the one just picked.
+          await controller.load();
+          showJudgment(key);
+          state.answerDraft = null;
+          state.answerSave = { state: 'error', key, message: 'この問いには、すでに別の回答が記録されています。記録済みの回答を表示しています。' };
+          controller.render();
+          return;
+        }
+        if (!response.ok) throw new Error(await readErrorMessage(response));
+        accepted = true;
+        await controller.load();
+        const answer = findItem(state, key)?.answer;
+        if (!answer || answer.kind !== draft.kind || (draft.kind === 'select' && answer.optionId !== draft.optionId)) {
+          throw new Error('読み戻しで回答を確認できません');
+        }
+        showJudgment(key);
+        state.answerDraft = null;
+        state.answerSave = { state: 'saved', key, message: '回答を記録しました（読み戻し済み）。' };
+      } catch (error) {
+        const reason = error instanceof Error ? error.message : 'request_failed';
+        state.answerSave = {
+          state: 'error',
+          key,
+          // Once the host accepted the answer, a failed read-back does not mean that nothing was recorded.
+          message: accepted
+            ? `回答は送信しましたが、記録を確かめられませんでした: ${reason}。画面を読み込み直して、記録された回答を確かめてください。`
+            : `記録できませんでした: ${reason}。回答はまだ記録されていません。`,
+        };
+      }
+      controller.render();
+    },
     async onConsult(value) {
       if (!writeClipboard) {
         state.consultMessage = `コピーできない環境です。次の文をCodexへ貼ってください。\n${value}`;
@@ -1193,8 +1400,25 @@ export function createValueProofReviewUI({
     },
   };
 
+  /** Selects a judgment by decision_attempt_id; false when the loaded home does not have it. */
+  const selectDecision = (decisionAttemptId) => {
+    const item = findItemByDecision(state, decisionAttemptId);
+    if (!item) return false;
+    callbacks.onSelect(itemKey(item.proof));
+    return true;
+  };
+
   const controller = {
     get state() { return state; },
+    /**
+     * Opens one judgment, as a link from another screen does. Before the home
+     * has loaded, the request waits for the load; an unknown id selects nothing.
+     */
+    openDecision(decisionAttemptId) {
+      if (state.phase === 'ready') return selectDecision(decisionAttemptId);
+      state.pendingDecisionId = decisionAttemptId;
+      return false;
+    },
     render() {
       renderValueProofReview(root, state, callbacks, { document: doc, unavailableNotice, rail, page });
       return controller;
@@ -1219,6 +1443,11 @@ export function createValueProofReviewUI({
         state.error = error instanceof Error ? error.message : 'request_failed';
       }
       controller.render();
+      if (state.phase === 'ready' && state.pendingDecisionId) {
+        const pending = state.pendingDecisionId;
+        state.pendingDecisionId = null;
+        selectDecision(pending);
+      }
       return state.home;
     },
     callbacks,

package/ui/world/world-placement.js

@@ -0,0 +1,45 @@
+/*
+ * Where a judgment stands in the world (ledger D6 placement).
+ *
+ * The judgment Host records the repository a turn worked in (`project_code`,
+ * the session's repository name).  A judgment is placed in a business only by
+ * a relation the organization Graph already states:
+ *   1. the business registers that repository in `repository_roots`, or
+ *   2. the business code equals the repository name.
+ * Anything else stays in the plaza with the reason.  The place is where the
+ * work happened, which is not always what the judgment was about.
+ */
+
+export const WORLD_PLACEMENT_CONTRACT_VERSION = 'brainbase.world-placement.v0';
+
+export const UNPLACED_REASON_TEXT = Object.freeze({
+  workspace_unrecorded: '作業した場所の記録が無い',
+  workspace_unregistered: '作業した場所が、どの事業にも登録されていない',
+});
+
+/** @returns {{ business: object, basis: 'repository' | 'code' } | { business: null, reason: keyof UNPLACED_REASON_TEXT }} */
+export function placeJudgment(workspace, businesses) {
+  if (typeof workspace !== 'string' || !workspace.trim()) return { business: null, reason: 'workspace_unrecorded' };
+  const name = workspace.trim();
+  const byRepository = businesses.find((business) => Array.isArray(business.repositories) && business.repositories.includes(name));
+  if (byRepository) return { business: byRepository, basis: 'repository' };
+  const byCode = businesses.find((business) => business.code === name);
+  if (byCode) return { business: byCode, basis: 'code' };
+  return { business: null, reason: 'workspace_unregistered' };
+}
+
+/** Groups judgment places by business code; unplaced ones are listed with their reason. */
+export function groupJudgmentPlaces(places, businesses) {
+  const byBusiness = new Map();
+  const unplaced = [];
+  for (const place of places) {
+    const result = placeJudgment(place.workspace, businesses);
+    if (result.business) {
+      if (!byBusiness.has(result.business.code)) byBusiness.set(result.business.code, []);
+      byBusiness.get(result.business.code).push({ ...place, basis: result.basis });
+    } else {
+      unplaced.push({ ...place, reason: result.reason });
+    }
+  }
+  return { byBusiness, unplaced };
+}

package/ui/world/world-vendor.LICENSE.txt

@@ -0,0 +1,23 @@
+three 0.186.1
+
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.