@unson/brainbase-mcp 0.10.0 → 0.10.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Local-first Brainbase judgment OS that lets supported AI agents reuse a user's approved goals, priorities, decisions, and judgment criteria.",
   "type": "module",
   "license": "MIT",
@@ -336,5 +336,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "56a13a2c780fb0390c804bddfb55f00c2d5a06ed"
+  "gitHead": "d8334b5e94cdc643f5de90ccfc883a5e67fdd9af"
 }

package/ui/graph-projects-view.js

@@ -148,6 +148,19 @@ function failureText(error) {
   return textOrNull(error instanceof Error ? error.message : typeof error === 'string' ? error : null) ?? '理由不明';
 }
 
+/**
+ * A host may know the selected project's identity before its Graph list is
+ * available.  Keep this boundary deliberately small: the early shell only
+ * accepts an id and display name, and never treats a host summary as Graph
+ * data such as goal, status or participant counts.
+ */
+function normalizeProjectSummary(value) {
+  if (!isRecord(value)) return null;
+  const id = textOrNull(value.id ?? value.code);
+  if (!id) return null;
+  return { id, name: textOrNull(value.name) ?? id };
+}
+
 /**
  * Mounts 「プロジェクトと関係者」.
  *
@@ -201,6 +214,9 @@ function failureText(error) {
  * @param {(projectId: string) => Promise<object>} [options.loadProjectContext]
  *   Optional read-only supplementary sections (tasks/knowledge).  A failed
  *   context read is kept separate from the Graph detail read.
+ * @param {Array<{ id: string, name?: string }> | (() => Array<{ id: string, name?: string }>)} [options.projectSummaries]
+ *   Optional host-known project identities.  These are used only to draw the
+ *   selected project's early loading shell before the Graph list is read.
  * @param {(container: Element, options: object) => { destroy?: Function }} [options.mountProjectGraph]
  *   Host-injected Sigma.js graph mount. When omitted, the shared browser
  *   entry is used. The workspace keeps an accessible relation list when
@@ -232,6 +248,7 @@ export function createGraphProjectsView({
   onSelect,
   ownShare,
   loadProjectContext,
+  projectSummaries,
   mountProjectGraph,
 } = {}) {
   if (!root) throw new TypeError('root is required');
@@ -267,6 +284,7 @@ export function createGraphProjectsView({
   let knowledgeWorkspace = null;
   let contextRequest = 0;
   let detailRequest = 0;
+  let hostListRequest = 0;
   let viewDestroyed = false;
 
   const correction = createGraphCorrection({
@@ -289,6 +307,46 @@ export function createGraphProjectsView({
     return state.list.state === 'ok' ? state.list.payload.projects.find((project) => project.id === id) ?? null : null;
   }
 
+  function projectSummaryFor(id) {
+    const target = textOrNull(id);
+    if (!target) return null;
+    let summaries = projectSummaries;
+    try {
+      if (typeof summaries === 'function') summaries = summaries();
+    } catch {
+      summaries = null;
+    }
+    if (Array.isArray(summaries)) {
+      const summary = summaries.map(normalizeProjectSummary).find((item) => item?.id === target);
+      if (summary) return summary;
+    }
+    const listed = listItem(target);
+    return listed ? { id: listed.id, name: listed.name } : { id: target, name: target };
+  }
+
+  function renderProjectKnowledgeLoading(id, readState, { onRetry } = {}) {
+    const target = textOrNull(id);
+    if (!target) return null;
+    const project = projectSummaryFor(target);
+    const loading = makeElement(doc, 'section', {
+      className: 'bb-pkw bb-pkw-loading',
+      attrs: { 'aria-label': 'プロジェクトの知識', 'data-project-id': target },
+    });
+    loading.append(makeElement(doc, 'div', { className: 'bb-pkw-kicker', text: 'プロジェクトの記録' }));
+    const header = makeElement(doc, 'header', { className: 'bb-pkw-header' });
+    header.append(
+      makeElement(doc, 'h2', { text: project.name }),
+      makeElement(doc, 'p', { className: 'bb-pkw-lead', text: '目的・関係・判断の根拠を、実際に記録された情報からたどれます。' }),
+    );
+    loading.append(header);
+    const notice = graphStateNotice(doc, readState, {
+      onRetry,
+      loadingText: 'プロジェクトの記録を読み込んでいます。',
+    });
+    if (notice) loading.append(notice);
+    return loading;
+  }
+
   function openCorrection(at, open) {
     state.panelAt = at;
     open();
@@ -456,6 +514,9 @@ export function createGraphProjectsView({
     const stateNotice = graphStateNotice(doc, state.list, { onRetry: () => controller.load(), loadingText: 'プロジェクトを読み込んでいます。' });
     if (stateNotice) {
       children.push(stateNotice);
+      if (state.selectedId) {
+        children.push(renderProjectKnowledgeLoading(state.selectedId, state.list, { onRetry: () => controller.load() }));
+      }
       return children;
     }
     const { payload } = state.list;
@@ -486,6 +547,10 @@ export function createGraphProjectsView({
         onTabChange: setKnowledgeTabChrome,
       });
       children.push(knowledgeWorkspace.element);
+    } else if (state.selectedId) {
+      children.push(renderProjectKnowledgeLoading(state.selectedId, state.detail ?? { state: 'loading' }, {
+        onRetry: () => controller.loadDetail(state.selectedId),
+      }));
     }
 
     if (payload.projects.length === 0) {
@@ -623,7 +688,10 @@ export function createGraphProjectsView({
     const project = loaded?.project ?? listItem(state.selectedId) ?? { id: state.selectedId, name: state.selectedId };
     const children = [workspaceRailHead(doc, { kicker: 'プロジェクト', title: project.name, sub: project.id })];
     if (!loaded) {
-      children.push(graphStateNotice(doc, detail?.id === state.selectedId ? detail : { state: 'loading' }, {
+      const readState = detail?.id === state.selectedId
+        ? detail
+        : state.list.state === 'ok' ? { state: 'loading' } : state.list;
+      children.push(graphStateNotice(doc, readState, {
         onRetry: () => controller.loadDetail(state.selectedId),
         loadingText: 'このプロジェクトの関係者を読み込んでいます。',
       }));
@@ -692,13 +760,16 @@ export function createGraphProjectsView({
 
   /** Reads the host's project list (see `load`). */
   async function loadHostList({ keep = false } = {}) {
+    const request = ++hostListRequest;
+    if (viewDestroyed) return state.list;
     if (!(keep && state.list.state === 'ok')) {
       state.list = { state: 'loading' };
       controller.render();
     }
-    state.list = normalizeProjectList(await client.read('/projects'));
+    const result = await client.read('/projects');
+    if (viewDestroyed || request !== hostListRequest) return state.list;
+    state.list = normalizeProjectList(result);
     if (state.list.state !== 'ok') {
-      if (!keep) state.selectedId = null;
       controller.render();
       return state.list;
     }
@@ -711,16 +782,21 @@ export function createGraphProjectsView({
       contextRequest += 1;
       state.selectedId = projects[0]?.id ?? null;
       if (state.selectedId) {
+        if (viewDestroyed || request !== hostListRequest) return state.list;
         const reading = controller.loadDetail(state.selectedId);
         notifySelect(state.selectedId);
         await reading;
+        if (viewDestroyed || request !== hostListRequest) return state.list;
         return state.list;
       }
     } else if (state.detail?.id !== state.selectedId) {
       // The project the host asked for is listed; read it for the rail.
+      if (viewDestroyed || request !== hostListRequest) return state.list;
       await controller.loadDetail(state.selectedId);
+      if (viewDestroyed || request !== hostListRequest) return state.list;
       return state.list;
     }
+    if (viewDestroyed || request !== hostListRequest) return state.list;
     controller.render();
     return state.list;
   }
@@ -744,6 +820,7 @@ export function createGraphProjectsView({
     destroy() {
       if (viewDestroyed) return;
       viewDestroyed = true;
+      hostListRequest += 1;
       detailRequest += 1;
       contextRequest += 1;
       knowledgeWorkspace?.destroy();

package/ui/project-graph-entry.js

@@ -10,7 +10,9 @@ import { MultiDirectedGraph, Sigma } from './project-graph-vendor.js';
 import {
   PROJECT_GRAPH_TYPE_COLORS,
   createProjectGraphModel,
+  projectGraphEdgePresentation,
   projectGraphNeighborIds,
+  projectGraphNodePresentation,
 } from './project-graph.js';
 
 const DEFAULT_EDGE_COLOR = '#cbd5e1';
@@ -85,12 +87,6 @@ function makeGraph(model) {
   return graph;
 }
 
-function edgeTouches(edge, nodeId, neighborIds) {
-  if (!nodeId) return false;
-  return edge.source === nodeId || edge.target === nodeId ||
-    (neighborIds.has(edge.source) && neighborIds.has(edge.target));
-}
-
 /**
  * Mounts one project graph and returns an idempotent resource handle.
  *
@@ -153,46 +149,53 @@ export function mountProjectGraph(container, options = {}) {
     const base = { ...data };
     const neighbors = getNeighbors();
     if (!selectedId) return base;
-    if (nodeId === selectedId) {
-      return {
-        ...base,
-        color: SELECTED_COLOR,
-        size: Math.max(11, (base.size || 9) + 4),
-        highlighted: true,
-        forceLabel: true,
-      };
-    }
-    if (neighbors.has(nodeId)) {
-      return {
-        ...base,
-        color: base.baseColor || PROJECT_GRAPH_TYPE_COLORS.unknown,
-        size: Math.max(9, (base.size || 9) + 1),
-        highlighted: true,
-        forceLabel: true,
-      };
-    }
+    const presentation = projectGraphNodePresentation(
+      { id: nodeId, size: base.size },
+      { selectedId, neighborIds: neighbors },
+    );
+    const { state, ...visuals } = presentation;
+    if (state === 'selected') return { ...base, ...visuals, color: SELECTED_COLOR };
+    if (state === 'neighbor') return {
+      ...base,
+      ...visuals,
+      color: base.baseColor || PROJECT_GRAPH_TYPE_COLORS.unknown,
+    };
     return {
       ...base,
+      ...visuals,
       color: UNRELATED_COLOR,
-      size: Math.max(5, (base.size || 9) * 0.72),
-      label: null,
-      forceLabel: false,
-      highlighted: false,
     };
   };
 
   const edgeReducer = (edgeId, data) => {
     const edge = edgeById.get(edgeId);
     const base = { ...data };
-    if (!selectedId || !edge) return { ...base, label: null, color: base.baseColor || DEFAULT_EDGE_COLOR };
+    if (!selectedId || !edge) {
+      return {
+        ...base,
+        label: null,
+        forceLabel: false,
+        color: base.baseColor || DEFAULT_EDGE_COLOR,
+      };
+    }
     const neighbors = getNeighbors();
-    if (!edgeTouches(edge, selectedId, neighbors)) {
-      return { ...base, label: null, color: UNRELATED_EDGE_COLOR, size: 0.5 };
+    const presentation = projectGraphEdgePresentation(edge, {
+      selectedId,
+      neighborIds: neighbors,
+    });
+    if (!presentation.relevant) {
+      return {
+        ...base,
+        label: null,
+        forceLabel: false,
+        color: UNRELATED_EDGE_COLOR,
+        size: 0.5,
+      };
     }
     return {
       ...base,
-      label: edge.label || null,
-      forceLabel: Boolean(edge.label),
+      label: presentation.showLabel ? edge.label : null,
+      forceLabel: presentation.forceLabel,
       color: edge.color || DEFAULT_EDGE_COLOR,
       size: 1.5,
     };

package/ui/project-graph.js

@@ -24,6 +24,9 @@ export const PROJECT_GRAPH_TYPE_COLORS = Object.freeze({
 });
 
 const EMPTY_ARRAY = Object.freeze([]);
+const MAX_SELECTED_NODE_SIZE = 18;
+const MAX_NEIGHBOR_NODE_SIZE = 12;
+const MAX_UNRELATED_NODE_SIZE = 10;
 
 function isRecord(value) {
   return value !== null && typeof value === 'object' && !Array.isArray(value);
@@ -168,6 +171,81 @@ export function projectGraphNeighborIds(nodes, edges, selectedId) {
   return neighbors;
 }
 
+function toIdSet(value) {
+  return value instanceof Set
+    ? value
+    : new Set(Array.isArray(value) ? value.filter(Boolean) : EMPTY_ARRAY);
+}
+
+/**
+ * Returns the visual state for one node in a selected graph neighborhood.
+ *
+ * A selected node is the only node that bypasses Sigma's label collision
+ * avoidance.  Neighbors keep their labels available to Sigma's normal label
+ * grid, while their size and hover state stay bounded in dense neighborhoods.
+ */
+export function projectGraphNodePresentation(node, { selectedId = null, neighborIds = EMPTY_ARRAY } = {}) {
+  const id = stringValue(node?.id);
+  const neighbors = toIdSet(neighborIds);
+  const state = id && id === selectedId
+    ? 'selected'
+    : id && neighbors.has(id)
+      ? 'neighbor'
+      : 'unrelated';
+  const baseSize = Math.min(finitePositive(node?.size, 9), MAX_SELECTED_NODE_SIZE);
+
+  if (state === 'selected') {
+    return {
+      state,
+      size: Math.min(MAX_SELECTED_NODE_SIZE, Math.max(10, baseSize + 3)),
+      forceLabel: true,
+      highlighted: true,
+    };
+  }
+
+  if (state === 'neighbor') {
+    return {
+      state,
+      size: Math.min(MAX_NEIGHBOR_NODE_SIZE, Math.max(6, baseSize)),
+      forceLabel: false,
+      highlighted: false,
+    };
+  }
+
+  return {
+    state,
+    size: Math.min(MAX_UNRELATED_NODE_SIZE, Math.max(4, baseSize * 0.72)),
+    label: null,
+    forceLabel: false,
+    highlighted: false,
+  };
+}
+
+/**
+ * Returns the label policy for one edge in a selected graph neighborhood.
+ * Dense neighborhoods omit edge labels; relation details remain available
+ * in the selected record panel. Small neighborhoods show relevant labels.
+ */
+export function projectGraphEdgePresentation(edge, { selectedId = null, neighborIds = EMPTY_ARRAY } = {}) {
+  const neighbors = toIdSet(neighborIds);
+  const relevant = Boolean(
+    selectedId && edge && (
+      edge.source === selectedId ||
+      edge.target === selectedId ||
+      (neighbors.has(edge.source) && neighbors.has(edge.target))
+    ),
+  );
+  // Sigma's edge-label renderer does not apply the same collision grid as
+  // node labels. Hide labels for a dense neighborhood and leave the relation
+  // available through selection/details instead of painting a radial stack.
+  const denseNeighborhood = neighbors.size > 12;
+  return {
+    relevant,
+    showLabel: relevant && !denseNeighborhood && Boolean(stringValue(edge?.label)),
+    forceLabel: false,
+  };
+}
+
 /**
  * Computes a stable clustered layout.  The selected node is the anchor when
  * it exists; its direct neighbours form the first ring and the remaining
@@ -188,11 +266,28 @@ export function computeProjectGraphLayout(nodes, edges = EMPTY_ARRAY, { selected
   const neighbors = list
     .filter((node) => neighborIds.has(node.id))
     .sort(compareNodes);
-  const neighborRadius = Math.max(1.5, 0.5 + neighbors.length * 0.38);
-  neighbors.forEach((node, index) => {
-    const angle = -Math.PI / 2 + (2 * Math.PI * index) / Math.max(1, neighbors.length);
-    positions[node.id] = { x: Math.cos(angle) * neighborRadius, y: Math.sin(angle) * neighborRadius };
-  });
+  // Keep high-degree selections readable by spreading neighbors over stable
+  // concentric rings. A single ring turns a person with dozens of relations
+  // into a dense necklace even when Sigma's label grid is working correctly.
+  const neighborRingCount = neighbors.length ? Math.ceil(neighbors.length / 24) : 0;
+  const neighborRingRadius = 2.6;
+  const neighborRingGap = 1.8;
+  let neighborOffset = 0;
+  for (let ringIndex = 0; ringIndex < neighborRingCount; ringIndex += 1) {
+    const remaining = neighbors.length - neighborOffset;
+    const ringsLeft = neighborRingCount - ringIndex;
+    const ringSize = Math.ceil(remaining / ringsLeft);
+    const radius = neighborRingRadius + ringIndex * neighborRingGap;
+    for (let index = 0; index < ringSize; index += 1) {
+      const angle = -Math.PI / 2 + (2 * Math.PI * index) / Math.max(1, ringSize) + ringIndex * 0.19;
+      const node = neighbors[neighborOffset + index];
+      positions[node.id] = { x: Math.cos(angle) * radius, y: Math.sin(angle) * radius };
+    }
+    neighborOffset += ringSize;
+  }
+  const neighborRadius = neighborRingCount
+    ? neighborRingRadius + (neighborRingCount - 1) * neighborRingGap
+    : 1.5;
 
   const remaining = list.filter((node) => !positions[node.id]);
   const groups = new Map();

package/ui/project-workspace.js

@@ -445,8 +445,13 @@ export function createProjectKnowledgeWorkspace({
   const payload = projectDetailPayload(detail);
   const project = payload?.project;
   if (!project) throw new TypeError('project detail is required');
-  const entities = graphEntityMap(payload);
-  const edges = graphEvidenceEdges(payload);
+  // Keep the project-bound projection separate from the mutable exploration
+  // graph.  Reading a related entity may reveal arbitrary neighboring records,
+  // but those records are not evidence that they belong to this project.
+  const overviewEntities = graphEntityMap(payload);
+  const overviewEdges = graphEvidenceEdges(payload);
+  const entities = new Map(overviewEntities);
+  const edges = [...overviewEdges];
   let destroyed = false;
   let selectedId = project.id;
   let activeTab = 'overview';
@@ -576,7 +581,7 @@ export function createProjectKnowledgeWorkspace({
       ['目的', textOrNull(selectedEntity.goal)],
       ['有効期間', validityText(selectedEntity.validFrom, selectedEntity.validTo)],
     ]));
-    panel.append(makeElement(doc, 'h4', { text: 'このプロジェクトとの関係' }), relationEvidence(doc, edges, selectedId, entities, payload.asOf, selectAndExplore));
+    panel.append(makeElement(doc, 'h4', { text: 'このプロジェクトとの関係' }), relationEvidence(doc, overviewEdges, selectedId, overviewEntities, payload.asOf, selectAndExplore));
     if (selectedId !== project.id && !fetched) {
       const failed = read?.state === 'failed';
       panel.append(workspaceNotice(doc, {
@@ -699,7 +704,7 @@ export function createProjectKnowledgeWorkspace({
     teardownGraph();
     tabs.replaceChildren(tabButton('概要', 'overview'), tabButton('情報を探す', 'graph'));
     panels.replaceChildren();
-    const overview = renderOverview(doc, payload, context, edges, entities, selectAndExplore);
+    const overview = renderOverview(doc, payload, context, overviewEdges, overviewEntities, selectAndExplore);
     overview.id = 'bb-pkw-panel-overview';
     overview.hidden = activeTab !== 'overview';
     panels.append(overview);