@unson/brainbase-mcp 0.4.1 → 0.5.0

package/README.md

@@ -1,14 +1,14 @@
 <!-- brainbase:public-message:start -->
 # Brainbase
 
-## 会社の判断を、属人化させない。
+## 自分の判断力を、ひとり分で終わらせない。
 
-Brainbaseは、経営者や担当者の判断基準、過去の決定、その理由を会社に残し、AIや次の担当者が同じ前提で考え、動けるようにする仕組みです。
+Brainbaseは、あなたの目的、優先順位、判断基準、過去の決定を、複数のAIが使えるローカルの判断OSにします。CodexやClaude Codeは、同じ判断軸から深く考え、調査・設計・執筆・開発を進められます。
 
-> **人の頭の中にある判断を、AIと会社が引き継げるようにする。**
+> **頭のいい自分を、壁打ち相手にも、実行部隊にも。**
 
-人間が、目的と判断基準、任せてよい範囲を決める。  
-AIは、それをもとに調べ、選択肢を比較し、見落としを指摘し、許可された仕事を進める。
+人間は、目的、判断基準、任せてよい範囲を決める。  
+AIは、それらを参照して探索・反証し、許可された範囲の仕事を進める。
 <!-- brainbase:public-message:end -->
 
 ## なぜ必要か

package/contracts/judgment-dag/digest.json

@@ -13,7 +13,7 @@
     },
     {
       "path": "contracts/judgment-dag/source-lock.json",
-      "sha256": "c7b3020fe3952d90bd8ed991f613be66c0798983bb6cc2285a9aefff7ab2f0e9"
+      "sha256": "4d3fbc2f82c07f709d901fcda68718b12b45a0d11a16354edec32b3406370bfe"
     },
     {
       "path": "docs/architecture/judgment-dag-core.md",
@@ -21,12 +21,12 @@
     },
     {
       "path": "docs/management/judgment-dag-milestones.md",
-      "sha256": "ef51313f33de64f702fd6c86012984bd70cf99eeca5b4f4cfc27f6cb266172bd"
+      "sha256": "e028f084708aa4ef2dea9437b81d3c2de15cb62b2c9448f2c7fa7d9d32b1e6b2"
     },
     {
       "path": "README.md",
-      "sha256": "a263114611c100feb75f9d35ad793593eafb7dea217d846a99efacc06c7efa24"
+      "sha256": "ec2f2419e7f43e2abdbedf6535e6d57a095e920f6c42b9e250bbabb50c00b745"
     }
   ],
-  "digest": "e97cefb8dadd451d5929c266376f3774fa84dcdde412e5ff3305b9b70d580ecd"
+  "digest": "dbe232857d29a3178013c82fc80d87dadecf0fa07ebf5ca5d260b0eed35c34fb"
 }

package/contracts/judgment-dag/source-lock.json

@@ -4,6 +4,70 @@
   "repository": "https://github.com/Unson-LLC/brainbase",
   "status": "accepted",
   "accepted_base_commit": "7e5d5693f988f4ba84072c5910ef32f0e70871e1",
+  "program_governance": {
+    "repository": "https://github.com/Unson-LLC/brainbase-unson",
+    "commit": "18544f58a2a0298d97eab45de2f05544bed48a43",
+    "markdown": {
+      "path": "docs/management/milestones/brainbase-program-master-roadmap.md",
+      "sha256": "167afb6d3fc57198c9f5ffca06fbafea968a5435af04f44b55017199b6d859fe"
+    },
+    "machine_contract": {
+      "path": "docs/management/milestones/brainbase-program-master-roadmap.json",
+      "sha256": "f3e6e023060ef3976f367ed7efa62ac57f7091f517ea1ca1d13824d9e6ca429f"
+    },
+    "work_packages": [
+      "R0",
+      "J0",
+      "G0",
+      "R1",
+      "D0",
+      "P0",
+      "C0"
+    ],
+    "milestone_crosswalk": {
+      "M0": [
+        "R0",
+        "J0"
+      ],
+      "M1": [
+        "J0"
+      ],
+      "M2": [
+        "G0"
+      ],
+      "M3": [
+        "R1"
+      ],
+      "M4": [
+        "D0"
+      ],
+      "M5": [
+        "P0"
+      ],
+      "M6": [
+        "G0",
+        "C0"
+      ]
+    },
+    "status_vocabulary": [
+      "planned",
+      "contract_ready",
+      "implementing",
+      "verified",
+      "production_proven",
+      "done"
+    ],
+    "snapshot_update_policy": {
+      "requires_new_commit": true,
+      "required_artifact_hashes": [
+        "markdown.sha256",
+        "machine_contract.sha256"
+      ],
+      "requires_verification_evidence": true,
+      "requires_independent_review": true
+    },
+    "verification_boundary": "The OSS package records the accepted cross-repository commit and content hashes. Public tests do not fetch the organization repository or treat network access as runtime authority."
+  },
   "sources": [
     {
       "kind": "architecture",
@@ -13,7 +77,7 @@
     {
       "kind": "milestones",
       "path": "docs/management/judgment-dag-milestones.md",
-      "sha256": "ef51313f33de64f702fd6c86012984bd70cf99eeca5b4f4cfc27f6cb266172bd"
+      "sha256": "e028f084708aa4ef2dea9437b81d3c2de15cb62b2c9448f2c7fa7d9d32b1e6b2"
     }
   ],
   "notes": [

package/contracts/judgment-value-proof/fixture.json

@@ -0,0 +1,54 @@
+{
+  "schema_version": "brainbase-judgment-value-proof-v1",
+  "intent_id": "intent_example",
+  "decision_attempt_id": "decision_attempt_example",
+  "recorded_at": "2026-09-01T00:00:00.000Z",
+  "state": "outcome_verified",
+  "interruption": {
+    "resolution": "continued_without_human",
+    "question_display_text": "新規文書を作るか、既存文書を更新するか",
+    "question_digest": "sha256:example-question",
+    "reason_code": "routine_reversible_work",
+    "human_reason": null
+  },
+  "decision": {
+    "summary": "既存SSOTを最小更新する",
+    "work_impact": "確認で作業を止めず、実装と検証まで継続した",
+    "basis": [
+      {
+        "entity_id": "dec_example",
+        "application": "正本が存在する場合は重複する文書を増やさない"
+      }
+    ],
+    "prior_learning_reused": true
+  },
+  "execution": {
+    "status": "completed",
+    "summary": "既存文書を更新してPRを作成した",
+    "artifact_refs": [
+      {
+        "kind": "pull_request",
+        "ref": "github://pull/142",
+        "label": "PR #142"
+      }
+    ]
+  },
+  "outcome": {
+    "status": "outcome_verified",
+    "summary": "PRを読み戻し、変更内容とテスト成功を確認した",
+    "evidence_refs": [
+      {
+        "kind": "canonical_readback",
+        "ref": "github://pull/142",
+        "status": "verified",
+        "label": "PR #142"
+      }
+    ]
+  },
+  "human_decision": null,
+  "feedback": {
+    "status": "none",
+    "summary": null,
+    "evidence_ref": null
+  }
+}

package/contracts/judgment-value-proof/schema.json

@@ -0,0 +1,163 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://brainbase.local/contracts/judgment-value-proof/v1/schema.json",
+  "title": "Brainbase Judgment Value Proof v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "intent_id",
+    "decision_attempt_id",
+    "recorded_at",
+    "state",
+    "interruption",
+    "decision",
+    "execution",
+    "outcome",
+    "human_decision",
+    "feedback"
+  ],
+  "properties": {
+    "schema_version": { "const": "brainbase-judgment-value-proof-v1" },
+    "intent_id": { "type": "string", "minLength": 1 },
+    "decision_attempt_id": { "type": "string", "minLength": 1 },
+    "recorded_at": { "type": "string", "format": "date-time" },
+    "state": {
+      "enum": ["captured", "executing", "waiting_human", "outcome_verified", "blocked", "unconfirmed"]
+    },
+    "interruption": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["resolution", "question_display_text", "question_digest", "reason_code", "human_reason"],
+      "properties": {
+        "resolution": { "enum": ["not_applicable", "continued_without_human", "human_required"] },
+        "question_display_text": { "type": ["string", "null"] },
+        "question_digest": { "type": ["string", "null"] },
+        "reason_code": { "type": ["string", "null"] },
+        "human_reason": { "type": ["string", "null"] }
+      }
+    },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["summary", "work_impact", "basis", "prior_learning_reused"],
+      "properties": {
+        "summary": { "type": ["string", "null"] },
+        "work_impact": { "type": ["string", "null"] },
+        "basis": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/basis" }
+        },
+        "prior_learning_reused": {
+          "oneOf": [
+            { "type": "boolean" },
+            { "const": "unconfirmed" }
+          ]
+        }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "summary", "artifact_refs"],
+      "properties": {
+        "status": { "enum": ["not_started", "executing", "completed", "blocked"] },
+        "summary": { "type": ["string", "null"] },
+        "artifact_refs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/artifact_ref" }
+        }
+      }
+    },
+    "outcome": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "summary", "evidence_refs"],
+      "properties": {
+        "status": { "enum": ["outcome_verified", "unconfirmed", "not_applicable"] },
+        "summary": { "type": ["string", "null"] },
+        "evidence_refs": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidence_ref" }
+        }
+      }
+    },
+    "human_decision": {
+      "oneOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["question", "why_human", "options"],
+          "properties": {
+            "question": { "type": "string", "minLength": 1 },
+            "why_human": { "type": "string", "minLength": 1 },
+            "options": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/human_option" }
+            }
+          }
+        }
+      ]
+    },
+    "feedback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "summary", "evidence_ref"],
+      "properties": {
+        "status": { "enum": ["none", "pending", "accepted", "corrected", "next_time_ask", "reverted"] },
+        "summary": { "type": ["string", "null"] },
+        "evidence_ref": {
+          "oneOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/evidence_ref" }
+          ]
+        }
+      }
+    }
+  },
+  "$defs": {
+    "basis": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entity_id", "application"],
+      "properties": {
+        "entity_id": { "type": "string", "minLength": 1 },
+        "application": { "type": "string", "minLength": 1 }
+      }
+    },
+    "artifact_ref": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "ref"],
+      "properties": {
+        "kind": { "type": "string", "minLength": 1 },
+        "ref": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 }
+      }
+    },
+    "evidence_ref": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "ref", "status"],
+      "properties": {
+        "kind": {
+          "enum": ["judgment_receipt", "autonomy_receipt", "tool_event", "artifact", "canonical_readback", "human_feedback"]
+        },
+        "ref": { "type": "string", "minLength": 1 },
+        "status": { "enum": ["verified", "unconfirmed"] },
+        "label": { "type": "string", "minLength": 1 }
+      }
+    },
+    "human_option": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "label", "impact"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "impact": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/dist/cli.js

@@ -1,4 +1,6 @@
 #!/usr/bin/env node
+import { createPortableGraph, portableGraphDigest } from './portable-graph.js';
+import { createOrganizationGraphConfig, createOrganizationGraphClient } from './organization-graph.js';
 import { constants, realpathSync } from 'node:fs';
 import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
 import { delimiter, dirname, isAbsolute, join } from 'node:path';
@@ -25,6 +27,20 @@ export async function runCli(argv = process.argv.slice(2), io = process) {
             return 0;
         }
         switch (parsed.command) {
+            case 'graph:upgrade': {
+                const config = createOrganizationGraphConfig();
+                if (!config)
+                    throw new Error('graph:upgrade requires all BRAINBASE_ORGANIZATION_* settings');
+                const bundle = createPortableGraph(await loadPersonalOs(resolveDataDir(first(parsed, 'dir'))));
+                const client = createOrganizationGraphClient(config);
+                const imported = await client.importPortableGraph(bundle);
+                const readback = await client.readPortableGraph();
+                if (readback.digest !== portableGraphDigest(bundle))
+                    throw new Error('organization_graph_readback_mismatch');
+                write(io, JSON.stringify({ status: imported.status, digest: readback.digest, readbackVerified: true,
+                    sourceFilesUnchanged: true, graphId: config.graphId }) + '\n');
+                return 0;
+            }
             case 'onboard:init':
                 return await onboardInit(parsed, io);
             case 'onboard:seed':
@@ -1087,6 +1103,7 @@ function usage() {
   brainbase onboard:skills --target codex|claude|portable [--skills id,id] [--out dir] [--format markdown|json]
   brainbase ontology:show
   brainbase ontology:audit [--dir path] [--ontology-version 0.0.0|1.0.0|2.0.0]
+  brainbase graph:upgrade [--dir path]
   brainbase ontology:migrate [--dir path] [--write --expected-input-digest digest]
   brainbase judgment:install --target codex [--autonomy-mode off|canary|on] [--autonomy-project code] [--dry-run] [--output path]
   brainbase judgment:hook [--autonomy-mode off|canary|on] [--autonomy-project code]

package/dist/embedding-provider.d.ts

@@ -0,0 +1,72 @@
+/**
+ * A provider is deliberately small so the retrieval layer does not need to
+ * know whether embeddings are produced by a local service or a hosted one.
+ * Brainbase does not bundle a model; the HTTP adapter below is opt-in.
+ */
+export interface EmbeddingProvider {
+    readonly id: string;
+    embed(texts: string[]): Promise<number[][]>;
+}
+export type EmbeddingFetchResponse = {
+    readonly status: number;
+    readonly ok?: boolean;
+    readonly headers?: {
+        get(name: string): string | null;
+    } | Map<string, string> | Record<string, string | undefined>;
+    readonly body?: {
+        getReader(): {
+            read(): Promise<{
+                done: boolean;
+                value?: Uint8Array;
+            }>;
+            cancel?(reason?: unknown): Promise<void>;
+        };
+    } | null;
+    text?(): Promise<string>;
+    json?(): Promise<unknown>;
+};
+export type EmbeddingFetch = (input: string, init: {
+    method: 'POST';
+    headers: Record<string, string>;
+    body: string;
+    redirect: 'error';
+    signal: AbortSignal;
+}) => Promise<EmbeddingFetchResponse>;
+export interface HttpEmbeddingProviderConfig {
+    /** Full OpenAI-compatible /embeddings endpoint. */
+    url: string;
+    model: string;
+    apiKey?: string;
+    /** Test injection point. The default is the host's global fetch. */
+    fetch?: EmbeddingFetch;
+    /** Alias accepted for callers that avoid shadowing the global fetch name. */
+    fetchImpl?: EmbeddingFetch;
+    timeoutMs?: number;
+    cacheSize?: number;
+}
+export declare const EMBEDDING_MAX_INPUTS = 64;
+/** Maximum number of texts accepted by one embed() call across all batches. */
+export declare const EMBEDDING_MAX_TOTAL_INPUTS = 2048;
+export declare const EMBEDDING_MAX_TEXT_LENGTH = 16000;
+export declare const EMBEDDING_MAX_BATCH_BYTES = 1000000;
+export declare const EMBEDDING_MAX_RESPONSE_BYTES = 4000000;
+export declare const EMBEDDING_DEFAULT_TIMEOUT_MS = 10000;
+export declare const EMBEDDING_DEFAULT_CACHE_SIZE = 2048;
+export declare class EmbeddingProviderConfigError extends Error {
+    readonly code = "embedding_config_invalid";
+    constructor(message: string);
+}
+export declare class EmbeddingProviderError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Build an opt-in provider from environment variables.
+ *
+ * With no embedding variables configured this returns undefined and performs
+ * no network setup. A partial or invalid configuration throws instead of
+ * silently falling back to lexical search or another provider.
+ */
+export declare function createEmbeddingProviderFromEnv(env?: Record<string, string | undefined>): EmbeddingProvider | undefined;
+/** Create the HTTP adapter. No request is made until embed() is called. */
+export declare function createHttpEmbeddingProvider(config: HttpEmbeddingProviderConfig): EmbeddingProvider;