@unson/brainbase-mcp 0.4.0 → 0.5.0

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": "7cd5721b9a932f5b43dd01557dfbcd8ea73563d5d23337fabdd322367d678e28"
+      "sha256": "ec2f2419e7f43e2abdbedf6535e6d57a095e920f6c42b9e250bbabb50c00b745"
     }
   ],
-  "digest": "fd5587b97cf343290c7d6c78f365d2d78bef668b04578e5ab55c67886ba0e827"
+  "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/contracts/public-message-candidate.schema.json

@@ -0,0 +1,143 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://brainbase.pages.dev/contracts/public-message-candidate.schema.json",
+  "title": "Brainbase approved public-message candidate",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "candidate_id",
+    "status",
+    "source",
+    "approval",
+    "copy"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": "1.0.0"
+    },
+    "candidate_id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9._-]{2,127}$"
+    },
+    "status": {
+      "const": "approved"
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "type",
+        "entity_id",
+        "snapshot_hash",
+        "exported_at",
+        "scope"
+      ],
+      "properties": {
+        "type": {
+          "const": "brainbase_graph"
+        },
+        "entity_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "entity_version": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "snapshot_hash": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "exported_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "scope": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        }
+      }
+    },
+    "approval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "approved_by",
+        "approved_at",
+        "reason"
+      ],
+      "properties": {
+        "status": {
+          "const": "approved"
+        },
+        "approved_by": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 100
+        },
+        "approved_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 1000
+        }
+      }
+    },
+    "copy": {
+      "$ref": "#/$defs/copy"
+    }
+  },
+  "$defs": {
+    "copy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "headline",
+        "short_definition",
+        "definition",
+        "human_role",
+        "ai_role",
+        "package_description"
+      ],
+      "properties": {
+        "headline": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 80
+        },
+        "short_definition": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 160
+        },
+        "definition": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 400
+        },
+        "human_role": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 200
+        },
+        "ai_role": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        },
+        "package_description": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 240
+        }
+      }
+    }
+  }
+}

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':
@@ -65,7 +81,7 @@ export async function runCli(argv = process.argv.slice(2), io = process) {
             case 'ontology:migrate':
                 return await ontologyMigrate(parsed, io);
             case 'judgment:hook':
-                return await judgmentHook(io);
+                return await judgmentHook(parsed, io);
             case 'judgment:install':
                 return await judgmentInstall(parsed, io);
             case 'doctor':
@@ -83,12 +99,25 @@ export async function runCli(argv = process.argv.slice(2), io = process) {
         return 1;
     }
 }
-async function judgmentHook(io) {
+function judgmentAutonomyOptions(parsed) {
+    const rawMode = first(parsed, 'autonomy-mode');
+    if (rawMode !== undefined && !['off', 'canary', 'on'].includes(rawMode)) {
+        throw new Error('judgment_autonomy_mode_invalid');
+    }
+    const project = first(parsed, 'autonomy-project')?.trim();
+    if (rawMode === 'canary' && !project)
+        throw new Error('judgment_autonomy_canary_project_missing');
+    return {
+        ...(rawMode ? { autonomyMode: rawMode } : {}),
+        ...(project ? { autonomyCanaryProjects: [project] } : {})
+    };
+}
+async function judgmentHook(parsed, io) {
     let payload = {};
     try {
         const input = await readHookStdin(io.stdin ?? process.stdin);
         payload = JSON.parse(input || '{}');
-        write(io, `${JSON.stringify(await processJudgmentHook(payload))}\n`);
+        write(io, `${JSON.stringify(await processJudgmentHook(payload, judgmentAutonomyOptions(parsed)))}\n`);
     }
     catch (error) {
         const reason = error instanceof Error ? error.message : String(error);
@@ -106,10 +135,20 @@ async function judgmentInstall(parsed, io) {
     if (target !== 'codex')
         throw new Error('judgment:install currently requires --target codex');
     const cliPath = fileURLToPath(new URL('./cli.js', import.meta.url));
+    const autonomy = judgmentAutonomyOptions(parsed);
+    const hookArguments = [
+        process.execPath,
+        cliPath,
+        'judgment:hook',
+        ...(autonomy.autonomyMode ? ['--autonomy-mode', autonomy.autonomyMode] : []),
+        ...(autonomy.autonomyCanaryProjects?.[0]
+            ? ['--autonomy-project', autonomy.autonomyCanaryProjects[0]]
+            : [])
+    ];
     const hook = {
         hooks: [{
                 type: 'command',
-                command: `${JSON.stringify(process.execPath)} ${JSON.stringify(cliPath)} judgment:hook`,
+                command: hookArguments.map((argument) => JSON.stringify(argument)).join(' '),
                 statusMessage: 'brainbase judgment resolver'
             }]
     };
@@ -1064,9 +1103,10 @@ 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 [--dry-run] [--output path]
-  brainbase judgment:hook
+  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]
   brainbase doctor [--dir path] [--judgment-hooks path]
 `;
 }

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;