@unson/brainbase-mcp 0.4.0 → 0.5.0

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 export declare const toolDefinitions: readonly [{
     readonly name: "get_context";
-    readonly description: "Return initial AI context from local Graph and Personal KG canonical files.";
+    readonly description: "Return an initial owner context snapshot. For a question needing related judgments or evidence, use search with an explicit relation plan; this snapshot is not a retrieval answer.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {
@@ -35,19 +35,58 @@ export declare const toolDefinitions: readonly [{
     };
 }, {
     readonly name: "search";
-    readonly description: "Search all canonical local stores: Graph entities, Personal KG, relationships, and decisions. Use this for people and projects.";
+    readonly description: "Find canonical Graph candidates, follow explicit typed relations, and return evidence and missing information. Use seedIds from resolve_entity/list_entities or previous results and steps from the observed relation catalog. Configured embeddings enable semantic discovery; without them discovery is lexical and reported as limited. Never treat similarity as proof or empty results as absence. Personal KG has its own search tool.";
     readonly inputSchema: {
         readonly type: "object";
         readonly required: readonly ["query"];
+        readonly additionalProperties: false;
         readonly properties: {
             readonly dataDir: {
                 readonly type: "string";
             };
+            readonly asOf: {
+                readonly type: "string";
+                readonly format: "date-time";
+                readonly description: "Compatibility alias for as_of.";
+            };
             readonly query: {
                 readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly seedIds: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 10;
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Canonical IDs chosen by the calling model; no embeddings needed.";
+            };
+            readonly steps: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 3;
+                readonly items: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly required: readonly ["relation", "direction"];
+                    readonly properties: {
+                        readonly relation: {
+                            readonly enum: readonly ["member_of", "participates_in", "accountable_for", "owned_by", "governs", "supersedes"];
+                        };
+                        readonly direction: {
+                            readonly enum: readonly ["incoming", "outgoing"];
+                        };
+                        readonly targetType: {
+                            readonly enum: readonly ["person", "org", "project", "decision"];
+                        };
+                    };
+                };
             };
             readonly limit: {
-                readonly type: "number";
+                readonly type: "integer";
+                readonly minimum: 1;
+                readonly maximum: 50;
             };
             readonly project: {
                 readonly type: "string";

package/dist/server.js

@@ -1,4 +1,7 @@
+import { createOrganizationGraphConfig, createOrganizationGraphClient } from './organization-graph.js';
 import { createHash } from 'node:crypto';
+import { retrieveGraph } from './graph-retrieval.js';
+import { createEmbeddingProviderFromEnv } from './embedding-provider.js';
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
@@ -22,8 +25,16 @@ const argsSchema = z.object({
     ontologyVersion: z.string().optional(),
     asOf: z.string().datetime({ offset: true }).optional(),
     project: z.string().min(1).optional(),
-    as_of: z.string().datetime({ offset: true }).optional()
+    as_of: z.string().datetime({ offset: true }).optional(),
+    seedIds: z.array(z.string().min(1)).min(1).max(10).optional(),
+    steps: z.array(z.object({
+        relation: z.enum(['member_of', 'participates_in', 'accountable_for', 'owned_by', 'governs', 'supersedes']),
+        direction: z.enum(['incoming', 'outgoing']),
+        targetType: z.enum(['person', 'org', 'project', 'decision']).optional()
+    }).strict()).min(1).max(3).optional(),
+    mode: z.never().optional()
 });
+const searchArgsSchema = argsSchema.pick({ dataDir: true, query: true, limit: true, project: true, as_of: true, asOf: true, seedIds: true, steps: true, mode: true }).strict();
 const mentionSpanSchema = z.object({
     start: z.number().int().nonnegative(),
     end: z.number().int().positive()
@@ -117,7 +128,7 @@ const connectedSchemas = {
 export const toolDefinitions = [
     {
         name: 'get_context',
-        description: 'Return initial AI context from local Graph and Personal KG canonical files.',
+        description: 'Return an initial owner context snapshot. For a question needing related judgments or evidence, use search with an explicit relation plan; this snapshot is not a retrieval answer.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -140,14 +151,24 @@ export const toolDefinitions = [
     },
     {
         name: 'search',
-        description: 'Search all canonical local stores: Graph entities, Personal KG, relationships, and decisions. Use this for people and projects.',
+        description: 'Find canonical Graph candidates, follow explicit typed relations, and return evidence and missing information. Use seedIds from resolve_entity/list_entities or previous results and steps from the observed relation catalog. Configured embeddings enable semantic discovery; without them discovery is lexical and reported as limited. Never treat similarity as proof or empty results as absence. Personal KG has its own search tool.',
         inputSchema: {
             type: 'object',
             required: ['query'],
+            additionalProperties: false,
             properties: {
                 dataDir: { type: 'string' },
-                query: { type: 'string' },
-                limit: { type: 'number' },
+                asOf: { type: 'string', format: 'date-time', description: 'Compatibility alias for as_of.' },
+                query: { type: 'string', minLength: 1 },
+                seedIds: { type: 'array', minItems: 1, maxItems: 10, items: { type: 'string' }, description: 'Canonical IDs chosen by the calling model; no embeddings needed.' },
+                steps: { type: 'array', minItems: 1, maxItems: 3, items: {
+                        type: 'object', additionalProperties: false, required: ['relation', 'direction'], properties: {
+                            relation: { enum: ['member_of', 'participates_in', 'accountable_for', 'owned_by', 'governs', 'supersedes'] },
+                            direction: { enum: ['incoming', 'outgoing'] },
+                            targetType: { enum: ['person', 'org', 'project', 'decision'] }
+                        }
+                    } },
+                limit: { type: 'integer', minimum: 1, maximum: 50 },
                 project: { type: 'string', description: 'Optional canonical project ID, name, or alias.' },
                 as_of: { type: 'string', format: 'date-time', description: 'RFC 3339 validity instant. Defaults to now.' }
             }
@@ -330,6 +351,15 @@ export const toolDefinitions = [
         }
     }
 ];
+let embeddingProvider;
+let embeddingProviderInitialized = false;
+function configuredEmbeddingProvider() {
+    if (!embeddingProviderInitialized) {
+        embeddingProvider = createEmbeddingProviderFromEnv();
+        embeddingProviderInitialized = true;
+    }
+    return embeddingProvider;
+}
 export async function callBrainbaseTool(name, rawArgs = {}) {
     if (name in connectedSchemas) {
         return callConnectedOnboardingTool(name, rawArgs);
@@ -337,7 +367,7 @@ export async function callBrainbaseTool(name, rawArgs = {}) {
     if (name === 'resolve_entity') {
         return callResolveEntityTool(rawArgs);
     }
-    const args = argsSchema.parse(rawArgs ?? {});
+    const args = (name === 'search' ? searchArgsSchema : argsSchema).parse(rawArgs ?? {});
     const dataDir = resolveDataDir(args.dataDir);
     switch (name) {
         case 'get_ontology':
@@ -400,6 +430,13 @@ export async function callBrainbaseTool(name, rawArgs = {}) {
         case 'ontology_impact':
             return getOntologyImpact(args.fromVersion);
     }
+    if (name === 'search') {
+        const organization = createOrganizationGraphConfig();
+        if (organization) {
+            return createOrganizationGraphClient(organization).search({ query: args.query, limit: args.limit,
+                project: args.project, asOf: args.as_of ?? args.asOf, seedIds: args.seedIds, steps: args.steps });
+        }
+    }
     const os = await loadPersonalOs(dataDir);
     switch (name) {
         case 'get_context':
@@ -410,7 +447,15 @@ export async function callBrainbaseTool(name, rawArgs = {}) {
             if (!args.query) {
                 throw new Error('search requires query');
             }
-            return { results: searchAll(os, args.query, args.limit, { project: args.project, asOf: args.as_of ?? args.asOf }) };
+            if (os.graph.version !== 2) {
+                if (args.seedIds || args.steps)
+                    throw new Error('graph_retrieval_migration_required');
+                return { results: searchAll(os, args.query, args.limit, { project: args.project, asOf: args.as_of ?? args.asOf }),
+                    status: 'migration_required', discovery: 'legacy_lexical', absenceConfirmed: false,
+                    sufficiency: 'insufficient', partialReasons: ['canonical_graph_v2_required'] };
+            }
+            return retrieveGraph(os, { query: args.query, limit: args.limit, project: args.project,
+                asOf: args.as_of ?? args.asOf, seedIds: args.seedIds, steps: args.steps }, args.seedIds ? undefined : configuredEmbeddingProvider());
         case 'search_personal_kg':
             if (!args.query) {
                 throw new Error('search_personal_kg requires query');

package/docs/management/judgment-dag-milestones.md

@@ -3,12 +3,42 @@ title: Brainbase Judgment DAG Milestones
 status: active
 date: 2026-08-20
 scope: OSS Brainbase
+governed_by_repository: Unson-LLC/brainbase-unson
+governed_by_path: docs/management/milestones/brainbase-program-master-roadmap.md
+governed_by_machine_path: docs/management/milestones/brainbase-program-master-roadmap.json
+governed_by_commit: 18544f58a2a0298d97eab45de2f05544bed48a43
+governed_by_markdown_sha256: 167afb6d3fc57198c9f5ffca06fbafea968a5435af04f44b55017199b6d859fe
+governed_by_json_sha256: f3e6e023060ef3976f367ed7efa62ac57f7091f517ea1ca1d13824d9e6ca429f
+program_packages:
+  - R0
+  - J0
+  - G0
+  - R1
+  - D0
+  - P0
+  - C0
 ---
 
 # Brainbase Judgment DAG Milestones
 
 This roadmap replaces any implicit assumption that OSS Brainbase stops at memory retrieval. The next milestones make the shared Judgment DAG core real without prematurely building a complete enterprise ontology.
 
+## Program governance
+
+この文書はOSS Judgment DAGのcomponent roadmapであり、cross-repositoryの依存順、開始条件、完了条件は`Unson-LLC/brainbase-unson`の`docs/management/milestones/brainbase-program-master-roadmap.md`に従う。受理した正本snapshotはcommit `18544f58a2a0298d97eab45de2f05544bed48a43`へ固定し、Markdownとmachine-readable JSONのpath・SHA-256は`contracts/judgment-dag/source-lock.json`を正本とする。対応するProgram work packageは R0 / J0 / G0 / R1 / D0 / P0 / C0 である。競合時は固定したProgram Master Roadmapを優先し、この文書のM0〜M6をProgram全体の順序や完了判定へ読み替えない。新しいProgram revisionへ追随する場合は、commitと両content hashを明示的に更新し、契約生成・検証・独立レビューを再実行する。
+
+| Component milestone | Program work package |
+|---|---|
+| M0 Architecture lock | R0 + J0 |
+| M1 Local DAG kernel | J0 |
+| M2 Human + Agent judgment runners | G0 |
+| M3 Replay and evaluation | R1 |
+| M4 Brainbase Deployment dogfood | D0 |
+| M5 Scope promotion | P0 |
+| M6 Organization-ready primitives | G0 + C0 |
+
+Program statusには `planned` / `contract_ready` / `implementing` / `verified` / `production_proven` / `done` の6語彙だけを使う。hard dependencyを満たさないmilestoneを`done`にしない。文書のmergeだけを実装完了または`done`と扱わず、未実施・未収集・staleな証跡をpassや0件へ丸めない。
+
 ## M0 — Architecture lock
 
 Goal: freeze semantic boundaries before implementation.
@@ -140,4 +170,4 @@ The roadmap is not complete merely because graph/node counts increase. Measure:
 4. **Outcome calibration** — do judgment versions improve against declared goals?
 5. **Promotion quality** — are reusable judgments correctly distinguished from case-specific decisions?
 
-The primary dogfood KPI is **expert escalation count per deployment**, not total stored knowledge.
+The primary dogfood KPI is **expert escalation count per deployment**, not total stored knowledge.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@unson/brainbase-mcp",
-  "version": "0.4.0",
-  "description": "Local-first Brainbase MCP server and personal onboarding kit.",
+  "version": "0.5.0",
+  "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",
   "repository": {
@@ -19,11 +19,21 @@
       "types": "./dist/judgment-dag.d.ts",
       "import": "./dist/judgment-dag.js"
     },
+    "./judgment-value-proof": {
+      "types": "./dist/judgment-value-proof.d.ts",
+      "import": "./dist/judgment-value-proof.js"
+    },
+    "./portable-graph": {
+      "types": "./dist/portable-graph.d.ts",
+      "import": "./dist/portable-graph.js"
+    },
     "./dist/*": "./dist/*",
     "./contracts/judgment-dag/schema.json": "./contracts/judgment-dag/schema.json",
     "./contracts/judgment-dag/fixture.json": "./contracts/judgment-dag/fixture.json",
     "./contracts/judgment-dag/source-lock.json": "./contracts/judgment-dag/source-lock.json",
     "./contracts/judgment-dag/digest.json": "./contracts/judgment-dag/digest.json",
+    "./contracts/judgment-value-proof/schema.json": "./contracts/judgment-value-proof/schema.json",
+    "./contracts/judgment-value-proof/fixture.json": "./contracts/judgment-value-proof/fixture.json",
     "./package.json": "./package.json"
   },
   "bin": {
@@ -44,13 +54,19 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "vitest run",
+    "test": "vitest run --exclude tests/npm-prepublication-evidence.integration.test.ts",
     "test:integration": "vitest run tests/mcp-contract.test.ts tests/ontology-cli.test.ts tests/npm-release-validation.integration.test.ts tests/npm-consumer-smoke.integration.test.ts",
     "test:consumer-smoke": "vitest run tests/npm-consumer-smoke.integration.test.ts",
     "test:integration:release-evidence": "vitest run tests/npm-release-validation.integration.test.ts tests/npm-prepublication-evidence.integration.test.ts",
     "test:e2e": "vitest run tests/e2e/brainbase-mcp-only-acceptance.spec.ts tests/e2e/story-brainbase-portable-ontology-kernel-acceptance.spec.ts",
     "docs:dev": "vitepress dev docs",
+    "docs:sync": "node scripts/sync-public-message.mjs --write",
+    "docs:check": "node scripts/check-public-docs.mjs && node scripts/check-organization-teaser.mjs",
     "docs:build": "vitepress build docs",
+    "docs:smoke": "node scripts/check-built-docs.mjs && node scripts/check-built-organization-teaser.mjs",
+    "docs:verify-public": "node scripts/verify-public-site.mjs && node scripts/verify-organization-teaser.mjs",
+    "docs:promotion:plan": "node scripts/promote-public-message.mjs --plan",
+    "docs:promotion:apply": "node scripts/promote-public-message.mjs --apply",
     "docs:preview": "vitepress preview docs",
     "start": "node dist/index.js",
     "doctor": "node dist/cli.js doctor",
@@ -82,5 +98,5 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "0ee5db39ac8f91a484628cc07a2df21cdfb149b7"
+  "gitHead": "00ba08ebc953a3f8db66e9b624eceebd331c1e24"
 }