@unson/brainbase-mcp 0.1.0 → 0.2.1

package/dist/onboarding.d.ts

@@ -154,6 +154,9 @@ export interface ValueDemo {
     };
     answer: string;
     sampleResult: string;
+    resultKind: 'local_context_sample';
+    agentConnection: 'not_verified';
+    realVerification: string;
     valueExplanation: string;
     operationalization: OperationalizationPlan;
     nextStep: string;
@@ -168,7 +171,7 @@ export declare function buildConnectorRecommendations(input: RecommendationInput
 export declare function renderAgentProtocol(format: OnboardingFormat): string;
 export declare function renderConnectorRecommendations(input: RecommendationInput, format: OnboardingFormat): string;
 export declare function renderSourceDiagnosis(input: SourceDiagnosisInput, format: OnboardingFormat): string;
-export declare function renderValueDemo(input: ValueDemoInput, format: OnboardingFormat): string;
+export declare function renderValueDemo(input: ValueDemoInput, format: OnboardingFormat, details?: boolean): string;
 export declare function renderCandidateDrafts(input: CandidateInput, format: OnboardingFormat): string;
 export declare function renderLocalOnboardingPlan(input: LocalOnboardingPlanInput, format: OnboardingFormat): string;
 export declare function parseOnboardingFormat(value: string | undefined): OnboardingFormat;

package/dist/onboarding.js

@@ -91,7 +91,7 @@ export function buildAgentOnboardingProtocol() {
     };
 }
 export function buildValueDemo(input) {
-    const scenario = input.scenario?.trim() || 'Draft the first message or working note that should use my saved Brainbase context.';
+    const scenario = input.scenario?.trim() || '保存した文脈を使って、次に進めるメモを作って';
     const seeded = seededAreas(input.os);
     const missing = Object.entries(seeded)
         .filter(([, value]) => !value)
@@ -120,7 +120,7 @@ export function buildValueDemo(input) {
         firstValueReady: ready
     });
     return {
-        goal: 'Show one useful answer from the context the user just saved before any setup follow-up.',
+        goal: '追加設定へ進む前に、保存した文脈が役立つ回答を一つ確認する。',
         ready,
         missing,
         scenario,
@@ -139,11 +139,14 @@ export function buildValueDemo(input) {
         },
         answer: sampleResult,
         sampleResult,
+        resultKind: 'local_context_sample',
+        agentConnection: 'not_verified',
+        realVerification: 'MCP設定を実際のエージェントへ反映した後、同じ依頼をCodex / Claude Codeへ送って実際の応答を確認します。',
         valueExplanation,
         operationalization,
         nextStep: ready
-            ? 'Do not stop here. Use the operationalization checklist below to install skills, register routines with confirmation, merge MCP config, decide source allowlists, and verify MCP get_context/search.'
-            : `First save the minimum missing memo: ${missing.map(missingLabel).join(', ')}.`,
+            ? '必要なら --details で、スキル、ルーティン、MCP設定、参照許可、動作確認の残作業を確認します。'
+            : `まず最小文脈を保存します: ${missing.map(missingLabel).join(', ')}。`,
         completionSignal: ready ? 'first_value_demo_ready' : 'needs_seed'
     };
 }
@@ -495,45 +498,44 @@ export function renderSourceDiagnosis(input, format) {
         ''
     ].join('\n');
 }
-export function renderValueDemo(input, format) {
+export function renderValueDemo(input, format, details = false) {
     const demo = buildValueDemo(input);
     if (format === 'json') {
         return `${JSON.stringify(demo, null, 2)}\n`;
     }
-    return [
-        '# Brainbase First Value Demo',
+    const lines = [
+        '# Brainbase 初回価値デモ',
         '',
         demo.goal,
         '',
-        `- Ready: ${String(demo.ready)}`,
-        `- Completion signal: ${demo.completionSignal}`,
-        `- Missing: ${demo.missing.length === 0 ? 'none' : demo.missing.map(missingLabel).join(', ')}`,
+        `- 状態: ${demo.ready ? '準備済み' : '要設定'}`,
+        `- 完了シグナル: ${demo.completionSignal}`,
+        `- 不足: ${demo.missing.length === 0 ? 'なし' : demo.missing.map(missingLabel).join(', ')}`,
         '',
-        '## Try This Now',
+        '## 今すぐ試す',
         demo.tryPrompt,
         '',
-        '## Sample Result',
+        '## サンプル結果',
+        'これはCLIが保存済み文脈から組み立てたサンプルです。実際のエージェント応答ではありません。',
+        '- 実エージェント接続: 未確認',
+        `- 実応答の確認方法: ${demo.realVerification}`,
+        '',
         demo.sampleResult,
         '',
-        '## What Changed',
+        '## 反映された文脈',
         demo.valueExplanation,
         '',
-        '## Operationalization Still Pending',
-        demo.operationalization.goal,
-        '',
-        '### Completed',
-        ...demo.operationalization.completed.map((item) => `- ${item}`),
-        '',
-        '### Next Actions',
-        ...demo.operationalization.pending.map((item) => `- ${item.title}: \`${item.command}\` (${item.safety})`),
-        '',
-        '### Recommended Order',
-        ...demo.operationalization.recommendedOrder.map((item, index) => `${index + 1}. ${item}`),
-        '',
-        '## Next Step',
+        '## 次に実行',
+        demo.ready
+            ? `\`brainbase onboard:demo --dir ${shellArg(input.os.dataDir)} --scenario ${shellArg(demo.scenario)} --details\``
+            : `\`brainbase onboard:start --dir ${shellArg(input.os.dataDir)} --target codex\``,
         demo.nextStep,
         ''
-    ].join('\n');
+    ];
+    if (details) {
+        lines.push('## まだ残っている運用化', demo.operationalization.goal, '', '### 完了済み', ...demo.operationalization.completed.map((item) => `- ${item}`), '', '### 次の操作', ...demo.operationalization.pending.map((item) => `- ${item.title}: \`${item.command}\` (${item.safety})`), '', '### 推奨順序', ...demo.operationalization.recommendedOrder.map((item, index) => `${index + 1}. ${item}`), '');
+    }
+    return lines.join('\n');
 }
 export function renderCandidateDrafts(input, format) {
     const candidateSet = buildCandidateDrafts(input);
@@ -685,7 +687,7 @@ function seededAreas(os) {
 }
 function selfContext(os) {
     return [
-        ...(os.graph.owner?.name ? [`Owner: ${os.graph.owner.name}`] : []),
+        ...(os.graph.owner?.name ? [`本人: ${os.graph.owner.name}`] : []),
         ...(os.graph.owner?.summary ? [os.graph.owner.summary] : []),
         ...os.personalKg
             .filter((entry) => entry.type === 'self' || entry.type === 'value' || entry.type === 'judgment')
@@ -696,7 +698,7 @@ function workContext(os) {
     return [
         ...os.graph.entities
             .filter((entity) => entity.type === 'project')
-            .map((entity) => entity.summary ? `${entity.name}: ${entity.summary}` : entity.name),
+            .map((entity) => entity.name),
         ...os.personalKg
             .filter((entry) => entry.type === 'work' || entry.type === 'experience')
             .map((entry) => entry.text)
@@ -723,27 +725,43 @@ function relationshipTerms(name) {
 function normalizeForMatch(value) {
     return value.toLowerCase().replace(/\s+/g, '');
 }
+function shellArg(value) {
+    return /^[A-Za-z0-9_./:@%+=,-]+$/.test(value) ? value : JSON.stringify(value);
+}
 function buildReadySampleResult(input) {
     const projectLine = input.work[0] ?? '保存済みの仕事メモ';
     const ownerLine = input.self[0] ?? 'あなたの進め方';
     const relationshipLine = input.selectedRelationship
-        ? `${input.selectedRelationship.person}${input.selectedRelationship.role ? `（${input.selectedRelationship.role}）` : ''}には、${input.selectedRelationship.context}を前提に相談します。`
+        ? `${input.selectedRelationship.person}${input.selectedRelationship.role ? `（${input.selectedRelationship.role}）` : ''}には、「${input.selectedRelationship.context}」という関係を前提に相談します。`
         : '特定の相談相手が未指定なので、まず保存済みの仕事メモから次の一手を整理します。';
     const decisionLine = input.decisions[0]
         ? `判断基準: ${input.decisions[0].decision}`
         : '追加の判断基準はまだないので、次に動ける形へ絞ります。';
+    const decisionCriterion = input.decisions[0]?.decision ?? '保存済みの前提を崩さず、次の一手を小さく決める';
+    const recipient = input.selectedRelationship
+        ? `${input.selectedRelationship.person}さん`
+        : '次の判断者';
     return [
         `「${input.scenario}」への回答例:`,
         '',
         `次に進める作業は、${projectLine}を前提に一つのメモへ整理することです。`,
-        `進め方は、${ownerLine}を崩さず、説明を足しすぎない形にします。`,
+        `進め方は、${ownerLine.replace(/^本人: /u, '')}さんの前提を崩さず、説明を足しすぎない形にします。`,
         relationshipLine,
         decisionLine,
         '',
         'そのまま送れる最初のアウトプット:',
-        input.selectedRelationship
-            ? `${input.selectedRelationship.person}さんに確認したい論点を、背景説明ではなく「次に判断したいこと」と「相談したいこと」に分けて出します。`
-            : '保存済みの仕事メモから、今日進める作業と追加で確認したい一点だけを出します。'
+        '',
+        '次に判断したいこと:',
+        `- ${projectLine}について、「${decisionCriterion}」を満たす進め方を一つ選ぶ。`,
+        '',
+        '相談したいこと:',
+        `- ${recipient}に、${projectLine}を進める条件、懸念、判断期限を確認する。`,
+        '',
+        '未確認事項:',
+        '- 期限、最終承認者、判断前に追加で必要な情報。',
+        '',
+        '次の行動:',
+        `- ${recipient}へこのメモを送り、回答後に実行案を一つへ絞る。`
     ].join('\n');
 }
 function buildValueExplanation(input) {

package/dist/operationalization.js

@@ -6,76 +6,76 @@ export function buildOperationalizationPlan(input = {}) {
     const skillsTarget = target === 'claude' ? 'claude' : target === 'codex' ? 'codex' : 'portable';
     const routinesTarget = target === 'claude' ? 'claude' : 'codex';
     return {
-        goal: 'Keep onboarding open until the first value demo is followed by the operating setup the user still needs.',
+        goal: '初回価値を確認した後、必要な運用設定だけを順に完了する。',
         completed: input.firstValueReady
             ? [
-                'Initial approved context is seeded locally.',
-                'doctor can report the first value demo as ready.',
-                'onboard:demo produced a prompt, sample result, and plain-language value explanation.'
+                '承認した最小文脈をローカルへ保存済み。',
+                'doctorで初回価値デモの準備完了を確認可能。',
+                'onboard:demoでプロンプト、サンプル結果、価値の説明を確認済み。'
             ]
             : [
-                'Personal OS setup has started.'
+                'Personal OSの準備を開始済み。'
             ],
         pending: [
             {
                 id: 'public-skills',
-                title: 'Place the public Brainbase onboarding skills',
+                title: '公開Brainbaseオンボーディングスキルを配置する',
                 status: 'pending',
                 command: `brainbase onboard:skills --target ${skillsTarget}`,
-                why: 'Agents need the public onboarding, source import, candidate review, and daily routine instructions available where they run.',
-                safety: 'Generation is dry-run by default; write files only with an explicit --out path and do not overwrite existing SKILL.md files.'
+                why: 'エージェントが実行環境で、オンボーディング、参照元取込、候補レビュー、日次ルーティンの手順を使えるようにします。',
+                safety: '標準はプレビューです。明示的な --out 指定時だけ書き込み、既存のSKILL.mdを上書きしません。'
             },
             {
                 id: 'routines',
-                title: 'Register ohayo / oyasumi / retro routines',
+                title: 'ohayo / oyasumi / retroルーティンを登録する',
                 status: 'pending',
                 command: `brainbase onboard:routines --target ${routinesTarget} --cwd ${commandArg(cwd)}`,
-                why: 'The operating loop is not active until the morning, end-of-day, and weekly retrospective routines are scheduled.',
-                safety: 'Register routines paused or confirmation-gated first; generated definitions alone do not create a live scheduler.'
+                why: '朝、終業時、週次振り返りの予定を登録して初めて運用ループが動きます。',
+                safety: '最初は一時停止または確認付きで登録します。定義生成だけではスケジュール済みになりません。'
             },
             {
                 id: 'mcp-config',
-                title: 'Merge the Brainbase MCP config into the real agent config',
+                title: 'Brainbase MCP設定を実際のエージェント設定へ反映する',
                 status: 'pending',
                 command: `brainbase onboard:install --target ${installTarget} --dir ${commandArg(dataDir)} --dry-run`,
-                why: 'A dry-run snippet proves the config shape, but the agent cannot call Brainbase until the real Codex / Claude / CodeCode config is updated.',
-                safety: 'Keep dry-run as preview only; merge into live config after user approval and restart the target agent.'
+                why: 'プレビューは設定形式の確認に留まり、実設定を更新するまでエージェントはBrainbaseを呼べません。',
+                safety: 'プレビュー確認後、利用者の承認を得て実設定へ反映し、対象エージェントを再起動します。'
             },
             {
                 id: 'source-allowlist',
-                title: 'Decide source allowlists, import, and candidate review',
+                title: '参照許可範囲、取込、候補レビューを決める',
                 status: 'pending',
                 command: 'brainbase onboard:diagnose-sources --email <provider> --calendar <provider> --drive <provider> --drive-folder <folder-id> --tasks <tool>',
-                why: 'Mail, calendar, drive, files, and tasks are optional follow-up sources and need explicit allowlists before import.',
-                safety: 'Keep imported material under sources/ and promote only reviewed candidates into approved local memory.'
+                why: 'メール、カレンダー、ドライブ、ファイル、タスクは任意の追加参照元であり、取込前に明示的な許可範囲が必要です。',
+                safety: '取込素材はsources/に置き、レビュー済み候補だけを承認済みローカル記憶へ昇格します。'
             },
             {
                 id: 'verification',
-                title: 'Verify doctor and MCP get_context / search',
+                title: 'doctorとMCP get_context / searchで確認する',
                 status: 'pending',
                 command: `brainbase doctor --dir ${commandArg(dataDir)}`,
-                why: 'Onboarding is operational only when doctor and the MCP tools show the approved context from a fresh agent session.',
-                safety: 'Check get_context/search after config merge instead of assuming command generation was enough.'
+                why: '新しいエージェントセッションでdoctorとMCPツールが承認済み文脈を示して初めて運用可能です。',
+                safety: 'コマンド生成だけで完了扱いせず、設定反映後にget_context/searchを確認します。'
             }
         ],
         recommendedOrder: [
-            'Install or write public skills for the target agent.',
-            'Generate ohayo / oyasumi / retro routines and register them paused or confirmation-gated.',
-            'Merge the Brainbase MCP snippet into the real Codex / Claude / CodeCode config and restart the agent.',
-            'Decide source allowlists and run import / candidate review only where more context is needed.',
-            'Run doctor, then verify MCP get_context and search from a fresh agent session.'
+            '対象エージェントへ公開スキルを配置する。',
+            'ohayo / oyasumi / retroを生成し、一時停止または確認付きで登録する。',
+            'Brainbase MCP設定を実際のCodex / Claude / CodeCode設定へ反映し、エージェントを再起動する。',
+            '追加文脈が必要な場合だけ参照許可範囲を決め、取込と候補レビューを行う。',
+            'doctorを実行し、新しいエージェントセッションでMCP get_contextとsearchを確認する。'
         ],
         safetyRules: [
-            'Do not write live config, scheduler entries, or canonical facts without user approval.',
-            'Do not treat generated skills, generated routines, or MCP dry-run snippets as completed installation.',
-            'Do not ask users to paste OAuth tokens, passwords, API keys, or refresh tokens into chat.',
-            'Source imports stay local-first and reviewed before canonical promotion.'
+            '利用者の承認なしに実設定、スケジュール、正本ファクトを書き込みません。',
+            '生成したスキル、ルーティン、MCPプレビューをインストール完了扱いしません。',
+            'OAuthトークン、パスワード、APIキー、更新トークンをチャットへ貼るよう求めません。',
+            '参照元の取込はローカル優先とし、正本化前にレビューします。'
         ],
         completionCheck: [
-            'The user has seen the first value output.',
-            'The completion report names all still-pending operationalization actions.',
-            'The target agent can call Brainbase MCP get_context/search after real config merge.',
-            'Source allowlists and candidate review are either completed or explicitly deferred.'
+            '利用者が初回価値の出力を確認済み。',
+            '完了報告に残っている運用設定をすべて記載済み。',
+            '実設定反映後、対象エージェントからBrainbase MCP get_context/searchを呼び出せる。',
+            '参照許可範囲と候補レビューを完了、または明示的に延期済み。'
         ]
     };
 }

package/dist/server.d.ts

@@ -26,7 +26,7 @@ export declare const toolDefinitions: readonly [{
     };
 }, {
     readonly name: "search";
-    readonly description: "Search canonical local Graph, Personal KG, relationships, and decisions.";
+    readonly description: "Search all canonical local stores: Graph entities, Personal KG, relationships, and decisions. Use this for people and projects.";
     readonly inputSchema: {
         readonly type: "object";
         readonly required: readonly ["query"];
@@ -44,7 +44,7 @@ export declare const toolDefinitions: readonly [{
     };
 }, {
     readonly name: "search_personal_kg";
-    readonly description: "Search owner-local Personal KG only.";
+    readonly description: "Search owner-local Personal KG only. People and projects are Graph entities, so use search for them.";
     readonly inputSchema: {
         readonly type: "object";
         readonly required: readonly ["query"];
@@ -71,9 +71,301 @@ export declare const toolDefinitions: readonly [{
             };
         };
     };
+}, {
+    readonly name: "brainbase_onboarding_start";
+    readonly description: "Start a local first-value onboarding run from actually callable sources. The result exposes runId (also id); pass runId to every later onboarding tool.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["valueTarget", "sources"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+                readonly description: "Optional Personal OS directory.";
+            };
+            readonly valueTarget: {
+                readonly type: "string";
+                readonly description: "One concrete question the first useful answer should resolve.";
+            };
+            readonly sources: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "object";
+                    readonly required: readonly ["id", "mode", "status"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly id: {
+                            readonly type: "string";
+                        };
+                        readonly mode: {
+                            readonly enum: readonly ["mcp", "drive", "gmail", "local_folder", "single_document"];
+                        };
+                        readonly status: {
+                            readonly enum: readonly ["ready", "waiting_for_authorization", "unavailable", "error", "unconfirmed"];
+                        };
+                        readonly evidencePointer: {
+                            readonly type: "string";
+                        };
+                        readonly permissionScope: {
+                            readonly type: "array";
+                            readonly items: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly detail: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_get";
+    readonly description: "Read a connected-world onboarding run without exposing source or answer bodies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_ingest";
+    readonly description: "Ingest one selected source receipt under source plus review candidates. Do not flatten sourceId or receipt fields at the top level.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "source", "candidates"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly description: "runId returned by brainbase_onboarding_start.";
+            };
+            readonly source: {
+                readonly type: "object";
+                readonly required: readonly ["sourceId", "evidencePointer", "contentHash", "permissionSnapshot", "collectionStatus"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly sourceId: {
+                        readonly type: "string";
+                    };
+                    readonly evidencePointer: {
+                        readonly type: "string";
+                    };
+                    readonly contentHash: {
+                        readonly type: "string";
+                    };
+                    readonly permissionSnapshot: {
+                        readonly type: "object";
+                    };
+                    readonly collectionStatus: {
+                        readonly const: "collected";
+                    };
+                };
+            };
+            readonly candidates: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "object";
+                    readonly required: readonly ["kind", "payload", "observationClass", "evidenceId"];
+                    readonly additionalProperties: false;
+                    readonly properties: {
+                        readonly kind: {
+                            readonly type: "string";
+                        };
+                        readonly payload: {
+                            readonly type: "object";
+                        };
+                        readonly observationClass: {
+                            readonly enum: readonly ["observed", "inferred"];
+                        };
+                        readonly evidenceId: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_review";
+    readonly description: "Submit review decisions in actions. Inferred candidates cannot be approved or merged; use edit with a human-confirmed payload, or reject.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "actions"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 200;
+            };
+            readonly actions: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly oneOf: readonly [{
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "approve";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason", "payload"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "edit";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                            readonly payload: {
+                                readonly type: "object";
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "reject";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                        };
+                    }, {
+                        readonly type: "object";
+                        readonly required: readonly ["candidateId", "decision", "reason", "mergeIntoCandidateId"];
+                        readonly additionalProperties: false;
+                        readonly properties: {
+                            readonly candidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                            readonly decision: {
+                                readonly const: "merge";
+                            };
+                            readonly reason: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 500;
+                            };
+                            readonly mergeIntoCandidateId: {
+                                readonly type: "string";
+                                readonly minLength: 1;
+                                readonly maxLength: 200;
+                            };
+                        };
+                    }];
+                };
+            };
+        };
+    };
+}, {
+    readonly name: "brainbase_onboarding_first_value";
+    readonly description: "Finish onboarding in two calls. First choose action=record with an answer hash and promoted canonical IDs. Then choose action=review with useful or not_useful.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["runId", "action"];
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly dataDir: {
+                readonly type: "string";
+                readonly description: "Optional Personal OS directory.";
+            };
+            readonly runId: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 200;
+                readonly description: "runId returned by the previous onboarding step.";
+            };
+            readonly action: {
+                readonly enum: readonly ["record", "review"];
+                readonly description: "Use record first. Use review only after the answer receipt has been recorded.";
+            };
+            readonly answerHash: {
+                readonly type: "string";
+                readonly pattern: "^sha256:[a-f0-9]{64}$";
+                readonly description: "Required for action=record. SHA-256 of the answer body; the body itself is not stored.";
+            };
+            readonly usedCanonicalIds: {
+                readonly type: "array";
+                readonly minItems: 1;
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 200;
+                };
+                readonly description: "Required for action=record. Use only promotedCanonicalIds returned by review.";
+            };
+            readonly verdict: {
+                readonly enum: readonly ["useful", "not_useful"];
+                readonly description: "Required for action=review.";
+            };
+            readonly missingContext: {
+                readonly type: "array";
+                readonly maxItems: 50;
+                readonly items: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 200;
+                };
+                readonly description: "Optional short labels for context the answer still lacked.";
+            };
+        };
+    };
 }, {
     readonly name: "get_ontology";
-    readonly description: "Return the bundled immutable Brainbase Portable Ontology Kernel release.";
+    readonly description: "Return a beginner guide followed by the bundled immutable Brainbase Portable Ontology Kernel release.";
     readonly inputSchema: {
         readonly type: "object";
         readonly properties: {};