@unson/brainbase-mcp 0.15.2 → 0.15.3

package/dist/local-web-host.d.ts

@@ -94,6 +94,19 @@ export interface LocalWebOrganizationGraph {
     read(): Promise<InMemoryGraphReader<GraphWebAnySource>>;
     /** The same Graph as plain records (the world reads project metadata from it). */
     readGraphFile?(): Promise<GraphFileV2>;
+    /**
+     * The organization's words for field values (glossary terms with `payload.vocabulary`), or null when
+     * they could not be read.  The rest of the Graph is read even when these are not.
+     */
+    readVocabularyTerms?(): Promise<readonly GraphVocabularyTerm[] | null>;
+}
+/** One organization term that names a field value, e.g. project.kind = product → プロダクト. */
+export interface GraphVocabularyTerm {
+    readonly id: string;
+    readonly field: string;
+    readonly value: string;
+    readonly label: string;
+    readonly definition: string | null;
 }
 export interface LocalWebHost {
     readonly server: Server;

package/dist/organization-graph-web.d.ts

@@ -1,4 +1,4 @@
-import type { LocalWebOrganizationGraph } from './local-web-host.js';
+import type { GraphVocabularyTerm, LocalWebOrganizationGraph } from './local-web-host.js';
 import type { CanonicalEntityKind, GraphFileV2 } from './types.js';
 /**
  * Ledger C1 (adopted 2026-09-24): while the owner validates the Web, the host
@@ -44,6 +44,12 @@ export interface OrganizationGraphProjection {
         readonly danglingRelations: number;
     };
 }
+/**
+ * The organization's words for field values: active glossary terms that carry
+ * `payload.vocabulary = { field, value }`.  The name is the term's label, else
+ * its term, else the value itself (pure; tested).
+ */
+export declare function projectVocabularyTerms(records: readonly unknown[]): GraphVocabularyTerm[];
 /** Projects organization Graph records into a canonical Graph v2 (pure; tested). */
 export declare function projectOrganizationGraph(records: OrganizationGraphRecords, owner?: {
     id: string;

package/dist/organization-graph-web.js

@@ -42,6 +42,33 @@ function isCatalogProject(record, payload) {
     const scope = text(record.project_code);
     return scope !== null && (text(payload.code) ?? record.id) === scope;
 }
+/**
+ * The organization's words for field values: active glossary terms that carry
+ * `payload.vocabulary = { field, value }`.  The name is the term's label, else
+ * its term, else the value itself (pure; tested).
+ */
+export function projectVocabularyTerms(records) {
+    const terms = [];
+    for (const record of records) {
+        if (!isRecord(record) || typeof record.id !== 'string' || !isRecord(record.payload))
+            continue;
+        if (record.lifecycle_status && record.lifecycle_status !== 'active')
+            continue;
+        const vocabulary = record.payload.vocabulary;
+        const field = isRecord(vocabulary) ? text(vocabulary.field) : null;
+        const value = isRecord(vocabulary) ? text(vocabulary.value) : null;
+        if (!field || !value)
+            continue;
+        terms.push({
+            id: record.id,
+            field,
+            value,
+            label: text(record.payload.label) ?? text(record.payload.term) ?? value,
+            definition: text(record.payload.definition)
+        });
+    }
+    return terms.sort((a, b) => a.id.localeCompare(b.id));
+}
 /** A project's code, parent and repositories as the organization Graph states them. */
 function projectPlacement(record, payload, catalogByCode) {
     const scope = text(record.project_code);
@@ -228,6 +255,10 @@ export async function createOrganizationGraphSource(options = {}) {
         const access = await readOrganizationAccess(home);
         if ('reason' in access)
             throw new GraphWebError('unavailable', 'organization_graph_not_connected', `The organization Graph cannot be read (${access.reason})`);
+        // The organization's words are read alongside; failing to read them never fails the Graph.
+        const termsRead = getRecords(request, access, 'entities?type=glossary_term&limit=500')
+            .then((records) => projectVocabularyTerms(records))
+            .catch(() => null);
         const [project, person, org, decision, raci, memberOf, assignedTo] = await Promise.all([
             getRecords(request, access, 'entities?type=project&limit=500'),
             getRecords(request, access, 'entities?type=person&limit=500'),
@@ -249,7 +280,7 @@ export async function createOrganizationGraphSource(options = {}) {
             assignedTo: assignedTo
         });
         const source = { dataDir: null, graphFormat: 2, authority: 'organization_graph', server: access.server, readAt: now().toISOString() };
-        return { reader: openInMemoryGraph(projection.graph, source), graph: projection.graph };
+        return { reader: openInMemoryGraph(projection.graph, source), graph: projection.graph, terms: await termsRead };
     }
     async function current() {
         const at = now().getTime();
@@ -270,6 +301,9 @@ export async function createOrganizationGraphSource(options = {}) {
         },
         async readGraphFile() {
             return (await current()).graph;
+        },
+        async readVocabularyTerms() {
+            return (await current()).terms;
         }
     };
 }

package/dist/value-proof-review-http.d.ts

@@ -1,5 +1,5 @@
 import { type IncomingMessage, type Server, type ServerResponse } from 'node:http';
-import { JudgmentValueProofJournalCache } from './judgment-value-proof-review.js';
+import { JudgmentValueProofJournalCache, type JudgmentValueProofReviewHome } from './judgment-value-proof-review.js';
 export declare const VALUE_PROOF_REVIEW_HTTP_VERSION: "value-proof-review-http.v1";
 export declare const VALUE_PROOF_REVIEW_TOKEN_HEADER = "x-brainbase-review-token";
 export interface ValueProofReviewHttpOptions {
@@ -15,6 +15,8 @@ export interface ValueProofReviewHttpOptions {
     readonly journalCache?: JudgmentValueProofJournalCache;
 }
 export type ValueProofReviewHttpHandler = (request: IncomingMessage, response: ServerResponse) => Promise<boolean>;
+/** The home as the browser receives it: no local paths beyond the journal root. */
+export declare function publicHome(home: JudgmentValueProofReviewHome): unknown;
 export declare function createValueProofReviewHttpHandler(options: ValueProofReviewHttpOptions): ValueProofReviewHttpHandler;
 export interface ValueProofReviewHostOptions extends Omit<ValueProofReviewHttpOptions, 'token'> {
     readonly token?: string;

package/dist/value-proof-review-http.js

@@ -17,7 +17,8 @@ const UI_FILES = Object.freeze({
     '/ui/value-proof-review.js': { file: 'value-proof-review.js', type: 'text/javascript; charset=utf-8' },
     '/ui/value-proof-review.css': { file: 'value-proof-review.css', type: 'text/css; charset=utf-8' }
 });
-function publicHome(home) {
+/** The home as the browser receives it: no local paths beyond the journal root. */
+export function publicHome(home) {
     if (home.status === 'unavailable')
         return home;
     const strip = (items) => Object.fromEntries(Object.entries(items).map(([section, list]) => [

package/dist/world-extension.d.ts

@@ -1,5 +1,5 @@
 import { JudgmentValueProofJournalCache } from './judgment-value-proof-review.js';
-import { type LocalWebExtension, type LocalWebModuleContext } from './local-web-host.js';
+import { type GraphVocabularyTerm, type LocalWebExtension, type LocalWebModuleContext } from './local-web-host.js';
 import type { GraphFileV2 } from './types.js';
 /**
  * World view (ledger P17, adopted 2026-10-04): the home's upper layer.
@@ -39,10 +39,15 @@ export interface WorldVocabulary {
     readonly kinds: readonly {
         readonly key: string | null;
         readonly label: string;
+        /** Where the label came from: the organization's term, the host's vocabulary file, or the value itself. */
+        readonly label_source: 'graph' | 'config' | 'value';
+        readonly definition: string | null;
         readonly form: WorldBuildingForm;
         readonly color: string;
         readonly configured: boolean;
     }[];
+    /** Whether the organization's terms were read: `unavailable` when they could not be, `none` without an organization Graph. */
+    readonly terms: 'read' | 'unavailable' | 'none';
     readonly statuses: readonly {
         readonly key: string;
         readonly label: string;
@@ -51,6 +56,8 @@ export interface WorldVocabulary {
 }
 export interface WorldEngagement {
     readonly id: string;
+    /** The project's own code in its Graph (`metadata.code`), or null when it has none. */
+    readonly code: string | null;
     readonly name: string;
     readonly summary: string | null;
     readonly status: string | null;
@@ -109,7 +116,7 @@ export declare function projectWorldFromGraph(graph: Pick<GraphFileV2, 'entities
  * then unclassified projects; statuses are the common lifecycle words with the
  * host's on top.
  */
-export declare function resolveWorldVocabulary(config: WorldVocabularyConfig | undefined, businesses: readonly WorldBusiness[]): WorldVocabulary;
+export declare function resolveWorldVocabulary(config: WorldVocabularyConfig | undefined, businesses: readonly WorldBusiness[], terms?: readonly GraphVocabularyTerm[] | null | undefined): WorldVocabulary;
 /** Reads and checks a vocabulary file; an invalid file is an error, never silently ignored. */
 export declare function readWorldVocabulary(path: string): Promise<WorldVocabularyConfig>;
 /**
@@ -121,6 +128,19 @@ export declare function readWorldBusinesses(context: Pick<LocalWebModuleContext,
     readonly vocabulary?: WorldVocabularyConfig;
     readonly now?: () => Date;
 }): Promise<WorldBusinessesResponse>;
+/**
+ * The world of an organization from the project and glossary-term records its Graph API returns, for an
+ * organization web that hosts the same world screen (P16).  Pure: the caller reads the records with the
+ * member's own grants, so the world shows only what that member may read.
+ */
+export declare function projectOrganizationWorld(records: {
+    readonly projects: readonly unknown[];
+    readonly glossaryTerms?: readonly unknown[];
+}, options: {
+    readonly server: string;
+    readonly vocabulary?: WorldVocabularyConfig;
+    readonly now?: Date;
+}): WorldBusinessesResponse;
 export interface WorldJudgmentPlace {
     readonly decision_attempt_id: string;
     /** Repository the judgment Host recorded for the turn (`turn-input.json` project_code); null when unrecorded. */
@@ -142,6 +162,21 @@ export declare function readJudgmentPlaces(journalRoot: string, options?: {
     readonly places: readonly WorldJudgmentPlace[];
     readonly reason?: string;
 }>;
+/**
+ * The judgments of one organization, for a world drawn from that organization's Graph.  A judgment
+ * belongs to the organization only when the repository it was worked in is one of the organization's
+ * businesses (a registered repository or the business code, the same rule as the world's placement).
+ * Every other judgment (another company's work, or one whose repository was not recorded) is withheld:
+ * only their count leaves the host, never their questions or repositories.
+ */
+export declare function readOrganizationJudgments(context: Pick<LocalWebModuleContext, 'journalRoot' | 'journalCache' | 'dataDir' | 'now'>, businesses: readonly Pick<WorldBusiness, 'code' | 'repositories'>[], workspaces?: Map<string, string | null>): Promise<{
+    readonly status: 'available' | 'unavailable';
+    readonly scope: 'organization';
+    readonly withheld: number;
+    readonly places: readonly WorldJudgmentPlace[];
+    readonly home: unknown;
+    readonly reason?: string;
+}>;
 export declare function createWorldExtension(options?: {
     readonly vocabulary?: WorldVocabularyConfig;
 }): LocalWebExtension;

package/dist/world-extension.js

@@ -1,6 +1,8 @@
 import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
-import { readJudgmentValueProofJournal } from './judgment-value-proof-review.js';
+import { buildJudgmentValueProofReviewHome, readJudgmentValueProofAnswers, readJudgmentValueProofFeedback, readJudgmentValueProofJournal, } from './judgment-value-proof-review.js';
+import { publicHome } from './value-proof-review-http.js';
+import { projectOrganizationGraph, projectVocabularyTerms } from './organization-graph-web.js';
 import { readLocalGraphState } from './local-web-host.js';
 import { loadPersonalOs } from './ssot.js';
 import { requestUrl, writeJson } from './local-web-security.js';
@@ -38,6 +40,7 @@ function text(value) {
 function engagementOf(entity) {
     return {
         id: entity.id,
+        code: text(entity.metadata?.code),
         name: entity.name,
         summary: text(entity.summary) ?? text(entity.metadata?.goal),
         status: text(entity.metadata?.status),
@@ -114,22 +117,31 @@ export function projectWorldFromGraph(graph, now = new Date()) {
  * then unclassified projects; statuses are the common lifecycle words with the
  * host's on top.
  */
-export function resolveWorldVocabulary(config, businesses) {
+export function resolveWorldVocabulary(config, businesses, terms = undefined) {
+    // The organization names its kinds in the Graph; the host's file only adds a look (form, colour).
+    const graphTerms = new Map((terms ?? []).filter((term) => term.field === 'project.kind').map((term) => [term.value, term]));
+    const named = (key, configLabel) => {
+        const term = graphTerms.get(key);
+        if (term)
+            return { label: term.label, label_source: 'graph', definition: term.definition };
+        const label = text(configLabel);
+        return label ? { label, label_source: 'config', definition: null } : { label: key, label_source: 'value', definition: null };
+    };
     const configured = Object.entries(config?.kinds ?? {});
     const used = new Set(businesses.map((business) => business.kind));
     const kinds = configured.map(([key, entry], index) => ({
         key,
-        label: text(entry.label) ?? key,
+        ...named(key, entry.label),
         form: entry.form && BUILDING_FORMS.includes(entry.form) ? entry.form : 'office',
         color: entry.color && HEX_COLOR.test(entry.color) ? entry.color : KIND_PALETTE[index % KIND_PALETTE.length],
         configured: true,
     }));
-    const named = new Set(configured.map(([key]) => key));
-    [...used].filter((key) => key !== null && !named.has(key)).sort().forEach((key) => {
-        kinds.push({ key, label: key, form: 'office', color: KIND_PALETTE[kinds.length % KIND_PALETTE.length], configured: false });
+    const configuredKeys = new Set(configured.map(([key]) => key));
+    [...used].filter((key) => key !== null && !configuredKeys.has(key)).sort().forEach((key) => {
+        kinds.push({ key, ...named(key, undefined), form: 'office', color: KIND_PALETTE[kinds.length % KIND_PALETTE.length], configured: false });
     });
     if (used.has(null))
-        kinds.push({ key: null, label: '分類なし', form: 'office', color: UNCLASSIFIED_COLOR, configured: false });
+        kinds.push({ key: null, label: '分類なし', label_source: 'value', definition: null, form: 'office', color: UNCLASSIFIED_COLOR, configured: false });
     const statuses = new Map(Object.entries(DEFAULT_STATUSES));
     for (const [key, entry] of Object.entries(config?.statuses ?? {})) {
         const base = statuses.get(key);
@@ -138,7 +150,7 @@ export function resolveWorldVocabulary(config, businesses) {
             phase: entry.phase && LIFECYCLE_PHASES.includes(entry.phase) ? entry.phase : base?.phase ?? 'active',
         });
     }
-    return { kinds, statuses: [...statuses].map(([key, entry]) => ({ key, ...entry })) };
+    return { kinds, statuses: [...statuses].map(([key, entry]) => ({ key, ...entry })), terms: terms === undefined ? 'none' : terms === null ? 'unavailable' : 'read' };
 }
 /** Reads and checks a vocabulary file; an invalid file is an error, never silently ignored. */
 export async function readWorldVocabulary(path) {
@@ -174,6 +186,7 @@ export async function readWorldBusinesses(context, options = {}) {
     const now = (options.now ?? (() => new Date()))();
     let graph;
     let source;
+    let terms;
     try {
         if (context.organizationGraph) {
             if (!context.organizationGraph.readGraphFile) {
@@ -181,6 +194,7 @@ export async function readWorldBusinesses(context, options = {}) {
             }
             graph = await context.organizationGraph.readGraphFile();
             source = { authority: 'organization_graph', server: context.organizationGraph.server };
+            terms = context.organizationGraph.readVocabularyTerms ? await context.organizationGraph.readVocabularyTerms().catch(() => null) : null;
         }
         else {
             const state = await readLocalGraphState(context.dataDir);
@@ -205,7 +219,29 @@ export async function readWorldBusinesses(context, options = {}) {
         version: WORLD_EXTENSION_VERSION,
         source,
         as_of: now.toISOString(),
-        vocabulary: resolveWorldVocabulary(options.vocabulary, projection.businesses),
+        vocabulary: resolveWorldVocabulary(options.vocabulary, projection.businesses, terms),
+        ...projection,
+    };
+}
+/**
+ * The world of an organization from the project and glossary-term records its Graph API returns, for an
+ * organization web that hosts the same world screen (P16).  Pure: the caller reads the records with the
+ * member's own grants, so the world shows only what that member may read.
+ */
+export function projectOrganizationWorld(records, options) {
+    const now = options.now ?? new Date();
+    const { graph } = projectOrganizationGraph({
+        entities: { person: [], org: [], project: records.projects, decision: [], raci_assignment: [] },
+        memberOf: [],
+        assignedTo: [],
+    });
+    const projection = projectWorldFromGraph(graph, now);
+    return {
+        status: 'ok',
+        version: WORLD_EXTENSION_VERSION,
+        source: { authority: 'organization_graph', server: options.server },
+        as_of: now.toISOString(),
+        vocabulary: resolveWorldVocabulary(options.vocabulary, projection.businesses, projectVocabularyTerms(records.glossaryTerms ?? [])),
         ...projection,
     };
 }
@@ -233,6 +269,44 @@ export async function readJudgmentPlaces(journalRoot, options = {}) {
     }));
     return { status: 'available', places };
 }
+/**
+ * The judgments of one organization, for a world drawn from that organization's Graph.  A judgment
+ * belongs to the organization only when the repository it was worked in is one of the organization's
+ * businesses (a registered repository or the business code, the same rule as the world's placement).
+ * Every other judgment (another company's work, or one whose repository was not recorded) is withheld:
+ * only their count leaves the host, never their questions or repositories.
+ */
+export async function readOrganizationJudgments(context, businesses, workspaces = new Map()) {
+    const journal = await readJudgmentValueProofJournal({ root: context.journalRoot, cache: context.journalCache });
+    if (journal.status !== 'available')
+        return { status: 'unavailable', scope: 'organization', withheld: 0, places: [], home: null, reason: 'journal_unreadable' };
+    const belongs = (workspace) => workspace !== null
+        && businesses.some((business) => business.repositories.includes(workspace) || business.code === workspace);
+    const kept = [];
+    const places = [];
+    for (const entry of journal.entries) {
+        const workspace = await entryWorkspace(entry.file, workspaces);
+        if (!belongs(workspace))
+            continue;
+        kept.push(entry);
+        places.push({ decision_attempt_id: entry.proof.decision_attempt_id, workspace });
+    }
+    const [feedback, answers] = await Promise.all([
+        readJudgmentValueProofFeedback({ dataDir: context.dataDir }),
+        readJudgmentValueProofAnswers({ dataDir: context.dataDir }),
+    ]);
+    // Rejected files are left out too: their names would say nothing about the organization they belong to.
+    const home = buildJudgmentValueProofReviewHome({ ...journal, entries: kept, rejected: [] }, feedback, { now: context.now(), answers });
+    return { status: 'available', scope: 'organization', withheld: journal.entries.length - kept.length, places, home: publicHome(home) };
+}
+async function entryWorkspace(valueProofFile, workspaces) {
+    const turnInputFile = `${valueProofFile.slice(0, -VALUE_PROOF_SUFFIX.length)}.turn-input.json`;
+    if (!workspaces.has(turnInputFile)) {
+        const turnInput = await readJsonFile(turnInputFile);
+        workspaces.set(turnInputFile, isRecord(turnInput) ? text(turnInput.project_code) : null);
+    }
+    return workspaces.get(turnInputFile) ?? null;
+}
 async function readJsonFile(path) {
     try {
         return JSON.parse(await readFile(path, 'utf8'));
@@ -255,6 +329,16 @@ function createWorldModule(context, read) {
                 writeJson(response, 200, await read());
                 return true;
             }
+            if (path === `/api/extensions/${WORLD_EXTENSION_ID}/organization-judgments`) {
+                response.setHeader('Cache-Control', 'no-store');
+                const world = await read();
+                if (world.status !== 'ok' || world.source.authority !== 'organization_graph') {
+                    writeJson(response, 200, { version: WORLD_EXTENSION_VERSION, status: 'unavailable', scope: 'organization', withheld: 0, places: [], home: null, reason: 'not_reading_organization_graph' });
+                    return true;
+                }
+                writeJson(response, 200, { version: WORLD_EXTENSION_VERSION, ...(await readOrganizationJudgments(context, world.businesses, workspaces)) });
+                return true;
+            }
             if (path === `/api/extensions/${WORLD_EXTENSION_ID}/judgment-places`) {
                 response.setHeader('Cache-Control', 'no-store');
                 writeJson(response, 200, { version: WORLD_EXTENSION_VERSION, ...(await readJudgmentPlaces(context.journalRoot, { cache: context.journalCache, workspaces })) });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.15.2",
+  "version": "0.15.3",
   "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",
@@ -147,6 +147,10 @@
       "types": "./dist/world-model.d.ts",
       "import": "./dist/world-model.js"
     },
+    "./world": {
+      "types": "./dist/world-extension.d.ts",
+      "import": "./dist/world-extension.js"
+    },
     "./problem-selection": {
       "types": "./dist/problem-selection.d.ts",
       "import": "./dist/problem-selection.js"
@@ -354,5 +358,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "ae251c43b4f42eddbeb18297e67710582a42af1f"
+  "gitHead": "bbcd694ef8e7231d88c1522d95c701421c9c5afa"
 }

package/ui/graph-projects-view.js

@@ -34,6 +34,7 @@ import {
   graphPageContext,
   graphStateNotice,
   hostReadOnlyNote,
+  hostSourceNotice,
   isEdgeView,
   isEntityView,
   isRecord,
@@ -507,7 +508,10 @@ export function createGraphProjectsView({
     const legacyChrome = [pageHeader];
     const children = [pageHeader];
     const dir = state.list.state === 'ok' ? textOrNull(state.list.payload.source?.dataDir) : null;
-    const sourceBlock = workspaceHostNotice(doc, sourceNotice) ?? workspaceNotice(doc, {
+    // The record a host's 出典 notice may point at: the selected project once its detail is read.
+    const sourceDetail = state.detail?.id === state.selectedId && state.detail.state === 'ok' ? state.detail.payload.project : null;
+    const sourceSubject = sourceDetail ? { id: sourceDetail.id, type: 'project', metadata: sourceDetail.metadata ?? {} } : null;
+    const sourceBlock = workspaceHostNotice(doc, hostSourceNotice(sourceNotice, sourceSubject)) ?? workspaceNotice(doc, {
       label: '出典',
       text: `このMacのGraph${dir ? `（${dir}）` : ''}から読み、ここで直した内容もそこへ保存します。関係者は、プロジェクトに参加している人や責任を持つ人の記録で、ログインや共有の設定ではありません。`,
     });

package/ui/graph-registry-view.js

@@ -35,6 +35,7 @@ import {
   graphPageContext,
   graphStateNotice,
   hostReadOnlyNote,
+  hostSourceNotice,
   isEdgeView,
   isEntityView,
   isRecord,
@@ -444,6 +445,12 @@ export function createGraphRegistryView({
     return section;
   }
 
+  /** The record a host's 出典 notice may point at: the selected record once it is read. */
+  function sourceSubject() {
+    const entity = state.detail?.state === 'ok' ? state.detail.payload.entity : null;
+    return entity ? { id: entity.id, type: entity.type, metadata: entity.metadata ?? {} } : null;
+  }
+
   function renderWorkspace() {
     const dir = state.search.state === 'ok' ? textOrNull(state.search.payload.source?.dataDir) : null;
     return [
@@ -453,7 +460,7 @@ export function createGraphRegistryView({
         lead: writable ? 'Graphに何がどう登録されているかを確かめ、誤りを直します。' : 'Graphに何がどう登録されているかを確かめます。',
         source: context.source,
       }),
-      workspaceHostNotice(doc, sourceNotice) ?? workspaceNotice(doc, {
+      workspaceHostNotice(doc, hostSourceNotice(sourceNotice, sourceSubject())) ?? workspaceNotice(doc, {
         label: '出典',
         text: `このMacのGraph${dir ? `（${dir}）` : ''}だけを表示します。ここで直した内容は、同じGraphを読むMCPの search・get_context・resolve_entity で次から使われます。`,
       }),

package/ui/graph-view-shared.js

@@ -459,6 +459,55 @@ function withinCorrectionScope(scope, body, recordType) {
   return scope.entity(recordType) && scope.fields(changed).length === changed.length;
 }
 
+/**
+ * A host's 出典 notice with its text resolved for the selected record: the host may pass `text` as a
+ * function of that record (`{ id, type, metadata }`, or null before one is read), for a notice that points
+ * at it.  Returns the notice for `workspaceHostNotice`, or the value it was given.
+ */
+export function hostSourceNotice(sourceNotice, subject) {
+  if (!sourceNotice || typeof sourceNotice.text !== 'function') return sourceNotice;
+  return { ...sourceNotice, text: sourceNotice.text(subject ?? null) };
+}
+
+// ---------------------------------------------------------------------------
+// The organization's web (Inspector UX-20261004-01)
+
+const ORGANIZATION_RECORD_ID = /^[A-Za-z0-9_.:-]{1,200}$/u;
+
+/** The organization web's origin the host was told about, or null. */
+export function organizationWebOrigin(organizationGraph) {
+  if (organizationGraph?.status !== 'connected') return null;
+  const origin = organizationGraph.web_url;
+  return typeof origin === 'string' && /^https:\/\/[^/?#@\s]+$/u.test(origin) ? origin : null;
+}
+
+/**
+ * Where a record opens in the organization web, `{ href, label }`, or null when it has no usable id.  The
+ * organization web opens 情報と関係 by record id and プロジェクトと関係者 by project code, and keeps that record
+ * across sign-in.  A project opens by its own code only: 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.
+ */
+export function organizationRecordLink(origin, screenId, record) {
+  const id = typeof record?.id === 'string' && ORGANIZATION_RECORD_ID.test(record.id) ? record.id : null;
+  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;
+}
+
+export const ORGANIZATION_RECORD_LINK_TEXT = '組織版でこの記録を開く';
+
+/** A link that opens `target` from organizationRecordLink in a new tab. */
+export function organizationRecordAnchor(doc, target, className) {
+  return makeElement(doc, 'a', {
+    ...(className ? { className } : {}),
+    text: ORGANIZATION_RECORD_LINK_TEXT,
+    attrs: { href: target.href, target: '_blank', rel: 'noopener noreferrer' },
+  });
+}
+
 /**
  * A host's note that corrections are not available here, or null when it passed none.  The host may
  * pass a function of the selected record (`{ id, type, metadata }`) returning a string or an element,

package/ui/local-web-shell.js

@@ -21,7 +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';
+import { createGraphClient, organizationRecordAnchor, organizationRecordLink, organizationWebOrigin } from './graph-view-shared.js';
 
 export const LOCAL_WEB_SHELL_CONTRACT_VERSION = 'brainbase.local-web-shell.v1';
 
@@ -205,20 +205,8 @@ function mountObjectives(container, context) {
 
 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;
-}
+// very record there, who may correct it, and what happens after saving.
+export { organizationRecordLink };
 const organizationReadOnlyNoteLinked = (doc, origin, screenId) => (record) => {
   const target = organizationRecordLink(origin, screenId, record);
   if (!target) return ORGANIZATION_READ_ONLY_NOTE;
@@ -226,27 +214,32 @@ const organizationReadOnlyNoteLinked = (doc, origin, screenId) => (record) => {
   note.append(
     makeElement(doc, 'span', { text: [
       '組織のGraphを読み取り専用で表示しています。ここでは直せません。訂正の手順：',
-      `① 下のリンクから、組織版の${target.label}でこの記録を開きます。ログインしていなければSlackでログインすると、そのままこの記録に戻ります。`,
-      '② 直せるのは、組織版での役割がgmかceoで、このプロジェクトとその上の事業の両方を許可されている人です。直せるのはプロジェクトの記録（名前・別名・要約・期間・目的・状態）だけで、人物の記録と、関係者の追加・終了は組織版でもまだ直せません。',
+      `① 下のリンク（上の「出典」にも同じリンクがあります）から、組織版の${target.label}でこの記録を開きます。ログインしていなければSlackでログインすると、そのままこの記録に戻ります。`,
+      '② 直せるのは、組織版での役割がgmかceoで、このプロジェクトが属する事業（事業そのものなら、その事業）を許可されている人です。直せるのはプロジェクトの記録（名前・別名・要約・期間・目的・状態）だけで、人物の記録と、関係者の追加・終了は組織版でもまだ直せません。',
       '③ 保存すると、理由といっしょに組織のGraphへ書き込まれ、組織版がその場で読み戻して表示します。この画面には、1分ほどたってから再読み込みすると反映されます。',
       '',
     ].join('\n') }),
-    makeElement(doc, 'a', { text: '組織版でこの記録を開く', attrs: { href: target.href, target: '_blank', rel: 'noopener noreferrer' } }),
+    organizationRecordAnchor(doc, target),
   );
   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' },
-  });
-}
+/**
+ * The 出典 notice of a screen reading the organization Graph.  Once a record is selected its link opens
+ * that record in the organization web; before that, the screen there.
+ */
+const organizationSourceText = (doc, origin, screenId, sourceText) => (record) => {
+  const target = record ? organizationRecordLink(origin, screenId, record) : null;
+  const link = target
+    ? organizationRecordAnchor(doc, target)
+    : makeElement(doc, 'a', {
+      text: '組織版で開いて訂正する',
+      attrs: { href: `${origin}/?screen=${encodeURIComponent(screenId)}`, target: '_blank', rel: 'noopener noreferrer' },
+    });
+  const source = makeElement(doc, 'span');
+  source.append(makeElement(doc, 'span', { text: `${sourceText} ` }), link);
+  return source;
+};
 
 function mountGraphScreen(screenId, createView) {
   return (container, context) => {
@@ -254,15 +247,13 @@ function mountGraphScreen(screenId, createView) {
     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 origin = readOnly ? organizationWebOrigin(context.organizationGraph) : 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 },
+        readOnlyNote: origin ? organizationReadOnlyNoteLinked(context.document, origin, screenId) : ORGANIZATION_READ_ONLY_NOTE,
+        sourceNotice: { label: '出典', text: origin ? organizationSourceText(context.document, origin, screenId, sourceText) : sourceText },
       } : {}),
       root: viewRoot,
       rail: context.rail,

package/ui/value-proof-review.js

@@ -916,6 +916,11 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
   const { proof } = item;
   const detail = [];
   const row = rowOfItem(state, itemKey(proof));
+  const proofKind = kindLabel(proof);
+  // Keep a judgment-kind detail aligned with the row that groups it.
+  const displayedKind = row?.source === 'judgment_kind'
+    ? rowName(row)
+    : proofKind ? proofKind : row ? rowName(row) : null;
   if (row) {
     const back = workspaceButton(doc, { text: `← ${rowName(row)}`, variant: 'quiet', onClick: () => callbacks.onShowRow?.() });
     back.className = `${back.className} bb-vpr-back`;
@@ -924,7 +929,7 @@ function renderJudgmentDetail(doc, state, item, callbacks) {
   const head = workspaceRailHead(doc, {
     kicker: itemStateLabel(item),
     title: itemTitle(proof),
-    sub: kindLabel(proof) ? `判断の種類: ${kindLabel(proof)}` : row ? rowName(row) : null,
+    sub: displayedKind ? `判断の種類: ${displayedKind}` : null,
   });
   const heading = Array.from(head.children ?? []).find((child) => child.tagName === 'H2');
   heading?.setAttribute('tabindex', '-1');

package/ui/world/world-view.js

@@ -25,6 +25,7 @@ import {
   workspaceDetailEmpty,
   workspaceButton,
 } from '../../workspace-kit.js';
+import { organizationRecordAnchor, organizationRecordLink, organizationWebOrigin } from '../../graph-view-shared.js';
 
 export const WORLD_VIEW_CONTRACT_VERSION = 'brainbase.world-view.v0';
 
@@ -52,7 +53,7 @@ const BUSINESS_STATE_TEXT = Object.freeze({
  */
 let worldVocabulary = { kinds: [], statuses: [] };
 const kindEntry = (key) => worldVocabulary.kinds.find((entry) => entry.key === (key ?? null))
-  ?? { key: key ?? null, label: key ?? '分類なし', form: 'office', color: '#69746d' };
+  ?? { key: key ?? null, label: key ?? '分類なし', definition: null, form: 'office', color: '#69746d' };
 const kindColor = (key) => Number.parseInt(kindEntry(key).color.slice(1), 16);
 const statusEntry = (status) => worldVocabulary.statuses.find((entry) => entry.key === status) ?? null;
 const statusPhase = (status) => statusEntry(status)?.phase ?? 'active';
@@ -785,7 +786,18 @@ function renderFallbackList(doc, root, businesses, rows) {
   root.append(list);
 }
 
-export function createWorldView({ root, rail, page, document: explicitDocument, fetcher }) {
+/** Why the host has no judgments to give, in the words the screen shows. */
+const JUDGMENT_UNAVAILABLE_TEXT = Object.freeze({
+  judgment_journal_not_connected: '判断の記録は各メンバーのMacにあり、組織版には送らないため未接続です',
+});
+
+/**
+ * @param {object} options
+ * @param {(project: { id: string, code?: string | null }) => string} [options.projectHref] Where a business or
+ *   engagement opens in the host's プロジェクトと関係者.  The local web opens `#projects?project=<id>`; an
+ *   organization web passes its own route.
+ */
+export function createWorldView({ root, rail, page, document: explicitDocument, fetcher, organizationGraph = null, projectHref = (project) => `#projects?project=${encodeURIComponent(project.id)}` }) {
   const doc = explicitDocument ?? globalThis.document;
   const reducedMotion = Boolean(globalThis.matchMedia?.('(prefers-reduced-motion: reduce)').matches);
   const wrap = el(doc, 'div', { className: 'bb-world' });
@@ -820,6 +832,8 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
 
   let proofs = new Map();
   let placement = { byBusiness: new Map(), unplaced: [] };
+  /** Judgments the host kept back because they are not this organization's (organization mode only). */
+  let withheld = 0;
 
   function judgmentText(item, fallback) {
     const textValue = item?.proof?.interruption?.question_display_text ?? item?.proof?.decision?.summary ?? fallback;
@@ -834,8 +848,27 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
   }
 
   /** Descends to the same project in プロジェクトと関係者 (the shell opens `#projects?project=`). */
-  function projectLink(projectId, label) {
-    return el(doc, 'a', { className: 'bb-world-rail-link', text: label, attrs: { href: `#projects?project=${encodeURIComponent(projectId)}` } });
+  function projectLink(project, label) {
+    return el(doc, 'a', { className: 'bb-world-rail-link', text: label, attrs: { href: projectHref(project) } });
+  }
+
+  /**
+   * The same project in the organization web, where it is corrected (Inspector UX-20261004-01).  Only when
+   * the host reads the organization Graph and was told where its web is.
+   */
+  function organizationLink(project) {
+    const origin = organizationWebOrigin(organizationGraph);
+    if (!origin) return null;
+    // A business without its own code carries its id as its code; that is not a code the organization web knows.
+    const code = project.code && project.code !== project.id ? project.code : null;
+    const target = organizationRecordLink(origin, 'projects', { id: project.id, type: 'project', metadata: { code } });
+    return target ? organizationRecordAnchor(doc, target, 'bb-world-rail-link') : null;
+  }
+
+  /** 詳しく見る: プロジェクトと関係者 here, and the organization web when there is one. */
+  function detailBlock(project, label) {
+    const content = [projectLink(project, label), organizationLink(project)].filter(Boolean);
+    return workspaceRailBlock(doc, { title: '詳しく見る', content });
   }
 
   function judgmentList(entries, describe) {
@@ -876,18 +909,20 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
       })];
       if (data.kind === 'engagement') {
         blocks.push(workspaceRailBlock(doc, { title: '登録', content: workspaceDefinition(doc, [['状態', statusText(data.engagement.status)], ['Graph ID', data.engagement.id]]) }));
-        blocks.push(workspaceRailBlock(doc, { title: '詳しく見る', content: projectLink(data.engagement.id, '「プロジェクトと関係者」でこの案件を開く') }));
+        blocks.push(detailBlock(data.engagement, '「プロジェクトと関係者」でこの案件を開く'));
       } else {
         const open = business.engagements.filter((engagement) => !isFinished(engagement.status)).length;
-        blocks.push(workspaceRailBlock(doc, { title: '登録', content: workspaceDefinition(doc, [['状態', statusText(business.status)], ['コード', business.code], ['案件', `${business.engagements.length}件（動いている${open}件）`]]) }));
+        const kind = kindEntry(business.kind);
+        const kindText = kind.definition ? `${kind.label}（${kind.definition}）` : kind.label;
+        blocks.push(workspaceRailBlock(doc, { title: '登録', content: workspaceDefinition(doc, [['分類', kindText], ['状態', statusText(business.status)], ['コード', business.code], ['案件', `${business.engagements.length}件（動いている${open}件）`]]) }));
         const ul = el(doc, 'ul', { className: 'bb-world-rail-list' });
         for (const engagement of business.engagements) {
           const li = el(doc, 'li', { text: `${engagement.name}（${statusText(engagement.status)}）` });
-          li.append(projectLink(engagement.id, '開く'));
+          li.append(projectLink(engagement, '開く'));
           ul.append(li);
         }
         blocks.push(workspaceRailBlock(doc, { title: '案件（区画）', content: business.engagements.length ? ul : { text: '登録された案件はありません' } }));
-        blocks.push(workspaceRailBlock(doc, { title: '詳しく見る', content: projectLink(business.id, '「プロジェクトと関係者」でこの事業を開く') }));
+        blocks.push(detailBlock(business, '「プロジェクトと関係者」でこの事業を開く'));
       }
       blocks.push(cityJudgmentBlock(business));
       showRail(blocks);
@@ -947,16 +982,36 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
           ? judgmentList(placement.unplaced, (entry) => `${UNPLACED_REASON_TEXT[entry.reason] ?? entry.reason}${entry.workspace ? `（作業場所 ${entry.workspace}）` : ''}`)
           : { text: 'ありません' },
       }));
+      if (withheld) {
+        blocks.push(workspaceRailBlock(doc, {
+          title: `この世界に出していない判断（${withheld}件）`,
+          content: { text: 'この組織の事業で作業したと確かめられない判断です。ほかの会社の仕事が混ざるため、内容も作業場所も出しません。「今日」では見られます。' },
+        }));
+      }
       showRail(blocks);
     }
   }
 
   async function load() {
-    const [businessesResult, homeResult, placesResult] = await Promise.all([
-      readJson(fetcher, '/api/extensions/world/businesses'),
-      readJson(fetcher, '/api/value-proofs/home'),
-      readJson(fetcher, '/api/extensions/world/judgment-places'),
-    ]);
+    const businessesResult = await readJson(fetcher, '/api/extensions/world/businesses');
+    // A world drawn from an organization's Graph shows only that organization's judgments: the host keeps
+    // the others (another company's work, or unknown) back and sends only how many it kept back.
+    const organizationScoped = businessesResult.ok && businessesResult.data?.status === 'ok'
+      && businessesResult.data.source?.authority === 'organization_graph';
+    let homeResult;
+    let placesResult;
+    if (organizationScoped) {
+      const scoped = await readJson(fetcher, '/api/extensions/world/organization-judgments');
+      const available = scoped.ok && scoped.data?.status === 'available';
+      withheld = available ? scoped.data.withheld : 0;
+      homeResult = available ? { ok: true, data: scoped.data.home } : scoped.ok ? { ok: true, data: { status: 'unavailable', reason: scoped.data?.reason } } : scoped;
+      placesResult = available ? { ok: true, data: { status: 'available', places: scoped.data.places } } : { ok: true, data: { status: 'unavailable', reason: scoped.data?.reason } };
+    } else {
+      [homeResult, placesResult] = await Promise.all([
+        readJson(fetcher, '/api/value-proofs/home'),
+        readJson(fetcher, '/api/extensions/world/judgment-places'),
+      ]);
+    }
     notices.replaceChildren();
     const note = (label, textValue, tone = 'info') => {
       const line = el(doc, 'p', { className: `bb-world-hud-line is-${tone}`, attrs: tone === 'info' ? {} : { role: 'alert' } });
@@ -976,13 +1031,16 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
       const sourceText = businessPayload.source.authority === 'organization_graph' ? `組織のGraph（${businessPayload.source.server}）` : 'このMacのGraph';
       const unclassified = businesses.filter((business) => !business.kind).length;
       if (unclassified) extra.push(`分類の無い事業${unclassified}件は「分類なし」として描いています`);
+      if (businessPayload.vocabulary?.terms === 'unavailable') extra.push('組織の用語を読めないため、分類の名前は語彙ファイルか値のままです');
       note('事業', `${sourceText}の事業${businesses.length}件・案件${businesses.reduce((sum, business) => sum + business.engagements.length, 0)}件。${extra.join('。')}${extra.length ? '。' : ''}`);
     }
     const home = homeResult.ok ? homeResult.data : null;
     const readable = home?.status === 'available' && Array.isArray(home.delegation_map?.rows);
     const rows = readable ? home.delegation_map.rows : [];
     if (!homeResult.ok || !readable) {
-      note('判断', `判断の記録を読めません（${homeResult.ok ? home?.reason ?? home?.status ?? '状態不明' : homeResult.error}）。0件ではありません。`, 'warning');
+      const reason = homeResult.ok ? home?.reason ?? home?.status ?? '状態不明' : homeResult.error;
+      if (JUDGMENT_UNAVAILABLE_TEXT[reason]) note('判断', `${JUDGMENT_UNAVAILABLE_TEXT[reason]}。事業だけを描いています。`);
+      else note('判断', `判断の記録を読めません（${reason}）。0件ではありません。`, 'warning');
     } else {
       proofs = proofIndex(home);
       const waiting = [...proofs.values()].filter(isWaiting).length;
@@ -992,7 +1050,8 @@ export function createWorldView({ root, rail, page, document: explicitDocument,
         const known = places.filter((place) => proofs.has(place.decision_attempt_id)).map((place) => ({ ...place, item: proofs.get(place.decision_attempt_id) }));
         placement = groupJudgmentPlaces(known, businesses);
         const placed = known.length - placement.unplaced.length;
-        note('判断', `${home.delegation_map.judged}件のうち${placed}件を作業した事業の判断所に、${placement.unplaced.length}件は事業が分からないため広場に。今あなたを待っている判断${waiting}件${waiting ? '（光の柱）' : ''}。`, waiting ? 'attention' : 'info');
+        const kept = withheld ? `この組織の事業で作業したと確かめられない判断${withheld}件は、この世界には出していません（「今日」で見られます）。` : '';
+        note('判断', `${home.delegation_map.judged}件のうち${placed}件を作業した事業の判断所に、${placement.unplaced.length}件は事業が分からないため広場に。${kept}今あなたを待っている判断${waiting}件${waiting ? '（光の柱）' : ''}。`, waiting ? 'attention' : 'info');
       } else {
         note('判断', `${home.delegation_map.judged}件。作業した場所を読めないため、事業には置かず広場の種類別だけで描いています（${placesResult.ok ? placesResult.data?.reason ?? '理由不明' : placesResult.error}）。今あなたを待っている判断${waiting}件。`, 'warning');
       }
@@ -1028,6 +1087,6 @@ export const screen = Object.freeze({
     const root = context.document.createElement('div');
     root.className = 'bb-shell-page';
     container.append(root);
-    return createWorldView({ root, rail: context.rail, page: context.page, document: context.document, fetcher: context.fetcher });
+    return createWorldView({ root, rail: context.rail, page: context.page, document: context.document, fetcher: context.fetcher, organizationGraph: context.organizationGraph ?? null });
   },
 });