@unson/brainbase-mcp 0.11.0 → 0.12.0

package/ui/local-web-shell.js

@@ -21,6 +21,7 @@ import { createObjectiveEditorController } from './objective-editor.js';
 import { createObjectiveEditorHttpPort } from './objective-editor-http-port.js';
 import { createValueProofReviewUI } from './value-proof-review.js';
 import { createWorldModelView } from './world-model-view.js';
+import { createGraphClient } from './graph-view-shared.js';
 
 export const LOCAL_WEB_SHELL_CONTRACT_VERSION = 'brainbase.local-web-shell.v1';
 
@@ -75,6 +76,60 @@ function isRecord(value) {
   return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
 
+/**
+ * Parses the local shell's hash target without treating query data as a
+ * screen id.  Only the Graph screen accepts an entity target; all other
+ * screens deliberately discard query parameters.
+ */
+export function parseLocalWebTarget(target) {
+  const raw = typeof target === 'string' ? target.replace(/^#/, '') : '';
+  const separator = raw.indexOf('?');
+  const screenId = separator < 0 ? raw : raw.slice(0, separator);
+  if (!screenId) return { screenId: null, entityId: null };
+  const query = separator < 0 ? '' : raw.slice(separator + 1);
+  const params = new URLSearchParams(query);
+  return {
+    screenId,
+    entityId: screenId === 'graph' ? params.get('entity_id')?.trim() || null : null,
+  };
+}
+
+function graphSourceReader(context) {
+  const client = createGraphClient({ fetcher: context.fetcher, basePath: '/api/graph', token: context.token });
+  return async (source) => {
+    if (!isRecord(source) || source.kind !== 'local_graph'
+      || typeof source.entity_id !== 'string' || !source.entity_id.trim()
+      || typeof source.entity_type !== 'string' || !source.entity_type.trim()) {
+      return { state: 'unavailable', reason: 'source_contract_invalid' };
+    }
+    const result = await client.read(`/entities/${encodeURIComponent(source.entity_id)}`);
+    if (result.state === 'error') {
+      if (result.status === 404 || result.code === 'entity_not_found') return { state: 'not_found' };
+      if (result.status === 403 || result.code === 'authorization_denied' || result.code === 'scope_violation') return { state: 'forbidden' };
+      if (result.code === 'entity_id_ambiguous') return { state: 'ambiguous' };
+      return { state: 'unavailable', reason: result.code };
+    }
+    if (result.state !== 'ok' || !isRecord(result.payload?.entity)) return { state: 'unavailable', reason: 'source_response_invalid' };
+    const entity = result.payload.entity;
+    if (entity.id !== source.entity_id || entity.type !== source.entity_type) {
+      return { state: 'unavailable', reason: 'source_target_mismatch' };
+    }
+    if (source.digest && entity.digest !== source.digest) {
+      return { state: 'unavailable', reason: 'source_digest_mismatch' };
+    }
+    // The local Graph response currently exposes a content digest, not a
+    // revision number.  A requested version is therefore linkable only when
+    // the provider returns the same explicit version field.
+    if (source.version) {
+      const currentVersion = entity.version ?? entity.revision ?? null;
+      if (!currentVersion || currentVersion !== source.version) {
+        return { state: 'unavailable', reason: 'source_version_mismatch' };
+      }
+    }
+    return { state: 'available' };
+  };
+}
+
 function makePage(container, context) {
   const page = makeElement(context.document, 'div', { className: 'bb-shell-page' });
   container.append(page);
@@ -89,6 +144,7 @@ function mountToday(container, context) {
     document: context.document,
     fetcher: context.fetcher,
     token: context.token,
+    sourceReader: graphSourceReader(context),
   });
 }
 
@@ -129,7 +185,13 @@ function mountObjectives(container, context) {
     constraintsEditable: false,
     storyLinks: false,
   });
-  const worldModel = createWorldModelView({ root: worldRoot, rail: context.rail, document: doc, fetcher: context.fetcher });
+  const worldModel = createWorldModelView({
+    root: worldRoot,
+    rail: context.rail,
+    document: doc,
+    fetcher: context.fetcher,
+    token: context.token,
+  });
   return { editor, worldModel };
 }
 
@@ -144,6 +206,7 @@ function mountGraphScreen(createView) {
       document: context.document,
       fetcher: context.fetcher,
       token: context.token,
+      initialEntityId: context.initialEntityId,
     });
   };
 }
@@ -248,6 +311,7 @@ export function createLocalWebShell({
   const mounted = new Map();
   const slots = new Map();
   const links = new Map();
+  const pendingEntityIds = new Map();
   let active = null;
 
   const shell = makeElement(doc, 'div', { className: 'bb-shell', attrs: { 'data-contract-version': LOCAL_WEB_SHELL_CONTRACT_VERSION } });
@@ -311,8 +375,14 @@ export function createLocalWebShell({
     for (const [screenId, railSlot] of rails) railSlot.hidden = !(showRail && screenId === active);
   }
 
-  function ensureMounted(screen) {
-    if (mounted.has(screen.id)) return;
+  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);
+      }
+      return;
+    }
     const slot = slots.get(screen.id);
     if (screen.usesGraph && !(status.phase === 'ready' && status.data.graph.status === 'ready')) {
       renderGraphGate(doc, slot, status, controller.refreshStatus, screen.label);
@@ -322,7 +392,7 @@ export function createLocalWebShell({
     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 })) ?? true);
+    mounted.set(screen.id, screen.mount(slot, Object.freeze({ ...context, rail, page, initialEntityId: entityId })) ?? true);
     updateRail();
   }
 
@@ -330,15 +400,17 @@ export function createLocalWebShell({
     get state() {
       return { active, status, mounted: [...mounted.keys()] };
     },
-    show(id) {
-      const screen = screens.find((candidate) => candidate.id === id) ?? screens[0];
+    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);
       active = screen.id;
       for (const [screenId, slot] of slots) slot.hidden = screenId !== screen.id;
       for (const [screenId, link] of links) {
         if (screenId === screen.id) link.setAttribute('aria-current', 'page');
         else link.removeAttribute('aria-current');
       }
-      ensureMounted(screen);
+      ensureMounted(screen, pendingEntityIds.get(screen.id));
       updateRail();
       return controller;
     },
@@ -362,7 +434,7 @@ export function createLocalWebShell({
       renderSource(doc, source, status, controller.refreshStatus);
       // Re-evaluate Graph-backed screens that are waiting behind the gate.
       for (const screen of screens) {
-        if (screen.usesGraph && !mounted.has(screen.id) && (screen.id === active)) ensureMounted(screen);
+        if (screen.usesGraph && !mounted.has(screen.id) && (screen.id === active)) ensureMounted(screen, pendingEntityIds.get(screen.id));
       }
       return status;
     },

package/ui/project-workspace.js

@@ -667,7 +667,7 @@ function renderDenseOverview(doc, detail, context, entities, actions = {}) {
   todayHead.append(makeElement(doc, 'h4', { text: '今日判断・対応すること' }));
   if (typeof actions.openWorkList === 'function') todayHead.append(denseButton(doc, 'すべて見る', 'bb-pkw-dense-action', actions.openWorkList));
   today.append(todayHead);
-  const todayNotice = denseContextStateNotice(doc, taskSection ?? (context?.state !== 'ok' ? context : null), 'タスクを読み取れませんでした。');
+  const todayNotice = denseContextStateNotice(doc, taskSection ?? (context?.state && context.state !== 'ok' ? context : { state: 'unknown' }), 'タスクを読み取れませんでした。');
   if (todayNotice) today.append(todayNotice);
   if (!todayNotice && due.length === 0) today.append(makeElement(doc, 'p', { className: 'bb-pkw-muted', text: '表示できる仕事はありません。' }));
   if (!todayNotice && due.length > 0) {

package/ui/value-proof-review.css

@@ -93,6 +93,28 @@ body:has(#brainbase-value-proof-review) {
   font-weight: 700;
 }
 
+.bb-vpr-setup-guide {
+  display: grid;
+  gap: var(--bb-space-1);
+  padding: var(--bb-space-2) var(--bb-space-3);
+  border: 1px solid var(--bb-color-border, #d8dee9);
+  background: var(--bb-color-panel, #ffffff);
+}
+
+.bb-vpr-setup-guide p,
+.bb-vpr-setup-guide ol {
+  margin: 0;
+}
+
+.bb-vpr-setup-guide ol {
+  padding-left: var(--bb-space-5);
+}
+
+.bb-vpr-setup-guide code {
+  overflow-wrap: anywhere;
+  font-size: .92em;
+}
+
 .bb-vpr-rejected summary {
   cursor: pointer;
 }
@@ -225,6 +247,38 @@ body:has(#brainbase-value-proof-review) {
   font-size: 13px;
 }
 
+/* A source-bearing target is still trace metadata until the host has read the
+ * exact Graph record.  Only the same-origin link is styled as an action. */
+.bb-vpr-source-target {
+  display: inline-flex;
+  flex-wrap: wrap;
+  gap: var(--bb-space-1, 4px);
+  align-items: baseline;
+}
+
+.bb-vpr-source-link {
+  color: var(--vpr-action);
+  font-weight: 680;
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+.bb-vpr-source-status {
+  color: var(--vpr-muted);
+  font-size: 12px;
+}
+
+.bb-vpr-source-status.is-loading {
+  color: var(--vpr-muted);
+}
+
+.bb-vpr-source-status.is-not_found,
+.bb-vpr-source-status.is-ambiguous,
+.bb-vpr-source-status.is-forbidden,
+.bb-vpr-source-status.is-unavailable {
+  color: var(--vpr-warning);
+}
+
 /* Detail: in the rail, or after the workspace when the host has none. */
 .bb-vpr-inline-detail {
   max-width: 760px;

package/ui/value-proof-review.js

@@ -4,8 +4,9 @@
  * The host supplies a same-origin request function and a review token. A host
  * that cannot read a local journal may replace the unavailable notice. This
  * module owns presentation only: it never treats an unavailable journal as an
- * empty list, never edits the judgment journal, and keeps internal IDs inside
- * the audit details.
+ * empty list and never edits the judgment journal. Recorded basis target IDs
+ * are shown as trace metadata; no source URL is invented when the payload has
+ * no source-read contract.
  *
  * The screen follows the organization edition's pattern (workspace-kit): page
  * head, the 記録の範囲 notice, filters, metrics, and the 委任の地図 as a ledger
@@ -547,11 +548,98 @@ function renderDelegationMap(doc, state, callbacks) {
 }
 
 function basisText(entry) {
-  const application = text(entry.application) ?? '適用内容なし';
-  const layer = BASIS_LAYER_LABELS[entry.layer];
+  const application = text(entry?.application) ?? '適用内容なし';
+  const layer = BASIS_LAYER_LABELS[entry?.layer];
   return layer ? `[${layer}] ${application}` : application;
 }
 
+function basisTargetText(entry) {
+  const entityId = text(entry?.entity_id);
+  if (!entityId) return '対象の記録なし';
+  const version = text(entry?.version);
+  return version ? `${entityId}（版 ${version}）` : entityId;
+}
+
+const SOURCE_READ_STATES = Object.freeze(['loading', 'available', 'not_found', 'ambiguous', 'forbidden', 'unavailable']);
+const SOURCE_READ_LABELS = Object.freeze({
+  loading: '出典を確認中…',
+  not_found: '出典が見つかりません（未確認）',
+  ambiguous: '同じIDの出典が複数あります（未確認）',
+  forbidden: '出典を読む権限がありません（未確認）',
+  unavailable: '出典を確認できません（未確認）',
+});
+
+function sourceContract(entry) {
+  const source = entry?.source;
+  if (!isRecord(source) || source.kind !== 'local_graph') return null;
+  const entityId = text(source.entity_id);
+  const entityType = text(source.entity_type);
+  if (!entityId || !entityType || entityId !== text(entry?.entity_id)) return null;
+  return source;
+}
+
+function sourceKey(source) {
+  return [source.kind, source.entity_id, source.entity_type, source.version ?? '', source.digest ?? ''].join('\u0000');
+}
+
+function sourceReadState(value) {
+  const state = text(value?.state);
+  return SOURCE_READ_STATES.includes(state) ? state : 'unavailable';
+}
+
+function renderBasisTarget(doc, entry, state) {
+  const target = makeElement(doc, 'span', { className: 'bb-vpr-source-target' });
+  target.append(makeElement(doc, 'span', { text: basisTargetText(entry) }));
+  const source = sourceContract(entry);
+  if (!source) return target;
+  const key = sourceKey(source);
+  const read = state.sourceReads instanceof Map ? state.sourceReads.get(key) : null;
+  if (!read) {
+    target.append(makeElement(doc, 'span', {
+      className: 'bb-vpr-source-status is-unavailable',
+      text: '出典の読み取り先を確認できません（未確認）',
+    }));
+    return target;
+  }
+  const readState = sourceReadState(read);
+  if (readState === 'available') {
+    const link = makeElement(doc, 'a', {
+      className: 'bb-vpr-source-link',
+      text: '出典を開く',
+      attrs: { href: `#graph?entity_id=${encodeURIComponent(source.entity_id)}` },
+    });
+    target.append(link);
+    return target;
+  }
+  target.append(makeElement(doc, 'span', {
+    className: `bb-vpr-source-status is-${readState}`,
+    text: SOURCE_READ_LABELS[readState] ?? SOURCE_READ_LABELS.unavailable,
+  }));
+  return target;
+}
+
+function journalSetupGuide(doc) {
+  const guide = makeElement(doc, 'div', { className: 'bb-vpr-setup-guide' });
+  guide.append(makeElement(doc, 'strong', { text: '接続を直す' }));
+  guide.append(makeElement(doc, 'p', { text: '判断journalの場所を指定して画面を起動し直したあと、「再試行」を押してください。' }));
+  const list = makeElement(doc, 'ol');
+  const journalOption = makeElement(doc, 'li');
+  journalOption.append(
+    makeElement(doc, 'span', { text: '起動時に ' }),
+    makeElement(doc, 'code', { text: 'brainbase review:serve --journal <判断journalの場所>' }),
+    makeElement(doc, 'span', { text: ' を指定する' }),
+  );
+  const journalEnv = makeElement(doc, 'li');
+  journalEnv.append(
+    makeElement(doc, 'span', { text: 'または環境変数 ' }),
+    makeElement(doc, 'code', { text: 'BRAINBASE_JUDGMENT_JOURNAL_DIR=<判断journalの場所>' }),
+    makeElement(doc, 'span', { text: ' を設定する' }),
+  );
+  list.append(journalOption, journalEnv);
+  guide.append(list);
+  return guide;
+}
+
 function inheritanceText(inheritance) {
   const sources = Array.isArray(inheritance?.sources) ? inheritance.sources : [];
   if (sources.length === 0) return '引き継ぎの記録なし';
@@ -733,6 +821,7 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
     title: '根拠と引き継ぎ',
     content: facts(doc, [
       ['根拠', basis.length > 0 ? basis.map(basisText).join(' / ') : '根拠の記録なし'],
+      ['根拠の対象', basis.length > 0 ? basis.map((entry) => renderBasisTarget(doc, entry, state)) : '対象の記録なし'],
       ['過去の学習の再利用', reuse === true ? 'あり' : reuse === false ? 'なし' : '未確認'],
       ['引き継ぎ', inheritanceText(proof.decision.inheritance)],
     ]),
@@ -861,13 +950,18 @@ export function renderValueProofReview(root, state, callbacks = {}, options = {}
   if (home.status === 'unavailable') {
     const hostNotice = options.unavailableNotice;
     const title = makeElement(doc, 'p', { className: 'bb-vpr-notice-title', text: text(hostNotice?.title) ?? '判断journalに接続できません' });
+    const retry = workspaceButton(doc, { text: '再試行', variant: 'primary', onClick: () => void callbacks.onReload?.() });
+    const defaultGuide = hostNotice ? null : journalSetupGuide(doc);
     surface.append(workspaceNotice(doc, {
       label: '記録の範囲',
       tone: 'danger',
       text: noticeBody(doc,
         title,
         home.root ? `場所: ${home.root}（${home.reason}）` : `理由: ${home.reason}`,
-        `${text(hostNotice?.guidance) ?? '記録の場所は、起動時の --journal か環境変数 BRAINBASE_JUDGMENT_JOURNAL_DIR で指定できます。'}0件としては扱いません。`),
+        text(hostNotice?.guidance) ?? (defaultGuide ? null : '接続元の案内に従って記録を読める状態にしてください。'),
+        defaultGuide,
+        retry,
+        '接続できる状態にしたら「再試行」を押してください。0件としては扱いません。'),
     }));
     return finish(null, unreadable);
   }
@@ -934,6 +1028,8 @@ export function createValueProofReviewUI({
   clipboard,
   /** Optional `{ title, guidance }` for hosts where the local journal hint does not apply. */
   unavailableNotice,
+  /** Optional host-owned reader for typed basis sources. It must not invent a URL. */
+  sourceReader,
   autoLoad = true,
 } = {}) {
   if (!root) throw new TypeError('root is required');
@@ -958,6 +1054,30 @@ export function createValueProofReviewUI({
     save: { state: 'idle', message: '' },
     focusCard: false,
     consultMessage: '',
+    sourceReads: new Map(),
+  };
+
+  const readSelectedSources = async (item) => {
+    if (typeof sourceReader !== 'function' || !item?.proof?.decision?.basis) return;
+    const sources = item.proof.decision.basis.map(sourceContract).filter(Boolean);
+    for (const source of sources) {
+      const key = sourceKey(source);
+      state.sourceReads.set(key, { state: 'loading' });
+    }
+    if (sources.length > 0) controller.render();
+    await Promise.all(sources.map(async (source) => {
+      const key = sourceKey(source);
+      let result;
+      try {
+        result = await sourceReader(source);
+      } catch {
+        result = { state: 'unavailable' };
+      }
+      if (state.selectedKey !== itemKey(item.proof)) return;
+      const normalized = isRecord(result) ? result : {};
+      state.sourceReads.set(key, { ...normalized, state: sourceReadState(normalized) });
+    }));
+    if (state.selectedKey === itemKey(item.proof)) controller.render();
   };
 
   const resetJudgmentInput = () => {
@@ -1000,6 +1120,8 @@ export function createValueProofReviewUI({
       state.focusCard = true;
       controller.render();
       state.focusCard = false;
+      const item = findItem(state, key);
+      if (item) void readSelectedSources(item);
     },
     onDraft(patch) {
       state.draft = { ...state.draft, ...patch };

package/ui/world-model-view.css

@@ -60,6 +60,59 @@
   justify-self: start;
 }
 
+/* First-user registration stays in the empty-state notice, beside the fact it affects. */
+.bb-wm-registration-form {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: var(--bb-space-3);
+  margin-top: var(--bb-space-2);
+  max-width: 680px;
+}
+
+.bb-wm-registration-field {
+  display: grid;
+  gap: 5px;
+  min-width: 0;
+}
+
+.bb-wm-registration-field > label {
+  color: var(--bb-color-ink);
+  font-size: 12px;
+  font-weight: 680;
+}
+
+.bb-wm-registration-input {
+  width: 100%;
+  min-height: 34px;
+  padding: 7px 9px;
+  border: 1px solid var(--bb-color-border-strong);
+  border-radius: var(--bb-radius-sm);
+  background: var(--bb-color-paper);
+  color: var(--bb-color-ink);
+  font: inherit;
+  font-size: 13px;
+}
+
+.bb-wm-registration-input:focus {
+  outline: 2px solid var(--bb-color-accent);
+  outline-offset: 1px;
+}
+
+.bb-wm-registration-status {
+  grid-column: 1 / -1;
+  color: var(--bb-color-muted);
+  font-size: 12px;
+}
+
+.bb-wm-registration-form .bb-ws-button {
+  justify-self: start;
+}
+
+.bb-wm-registration-boundary {
+  color: var(--bb-color-muted);
+  font-size: 12px;
+}
+
 /* The local shell resets `.bb-shell button { font: inherit }`, which outranks the kit's button type. */
 .bb-wm .bb-ws-button {
   font-size: 12px;
@@ -159,6 +212,14 @@
 }
 
 @media (max-width: 760px) {
+  .bb-wm-registration-form {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
+  .bb-wm-registration-status {
+    grid-column: auto;
+  }
+
   .bb-wm-view-ledger .bb-ws-ledger-row {
     grid-template-columns: minmax(0, 1fr) 72px;
   }