@unson/brainbase-mcp 0.1.0 → 0.2.2

package/dist/onboarding.d.ts

@@ -154,10 +154,16 @@ export interface ValueDemo {
     };
     answer: string;
     sampleResult: string;
+    resultKind: 'local_context_sample';
+    agentConnection: 'not_verified';
+    realVerification: string;
     valueExplanation: string;
     operationalization: OperationalizationPlan;
     nextStep: string;
-    completionSignal: 'needs_seed' | 'first_value_demo_ready';
+    completionSignal: 'needs_seed' | 'cli_sample_ready';
+    onboardingComplete: false;
+    humanValueStatus: 'not_observed';
+    actualAgentPrompt: string;
 }
 export declare function buildAgentOnboardingProtocol(): AgentOnboardingProtocol;
 export declare function buildValueDemo(input: ValueDemoInput): ValueDemo;
@@ -168,7 +174,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

@@ -41,12 +41,12 @@ export function buildAgentOnboardingProtocol() {
             },
             {
                 id: 'first_value_demo',
-                title: 'First value demo',
+                title: 'CLI preview and actual agent value check',
                 questions: [
-                    'Run brainbase onboard:demo with the real request the user chose.',
-                    'Show the try-this prompt, sample result, and what the user did not have to explain again.',
-                    'Treat the useful output, not ready=true or connector readiness, as the onboarding completion signal.',
-                    'After showing the useful output, report the remaining operationalization actions instead of calling onboarding done.'
+                    'Optionally run brainbase onboard:demo to preview which saved context should be used.',
+                    'Install the MCP config after user approval and restart the selected agent.',
+                    'Send the real request through that agent and require get_context/search evidence.',
+                    'Ask the user whether the actual answer was useful. A CLI sample or synthetic evaluator is not onboarding completion.'
                 ]
             },
             {
@@ -72,7 +72,10 @@ export function buildAgentOnboardingProtocol() {
             'brainbase onboard:init',
             'brainbase onboard:seed --name "<name>" --value "<what should not be re-explained>" --project "<current project>" --relationship "<person>|<role>|<context>"',
             'brainbase onboard:projects --name "<project>" --goal "<goal>" --status "<status>" --role "<your role>"',
-            'brainbase onboard:demo --scenario "<real request that should now work>"',
+            'brainbase onboard:install --target codex --dry-run',
+            'Restart the selected agent, then send the real request and require Brainbase get_context/search.',
+            'Ask the user whether the actual answer was useful.',
+            'brainbase onboard:demo --scenario "<optional local preview>"',
             'brainbase onboard:skills --target codex',
             'brainbase onboard:routines --target codex --cwd <brainbase-checkout>',
             'brainbase onboard:install --target codex --dry-run',
@@ -82,16 +85,17 @@ export function buildAgentOnboardingProtocol() {
         completionCheck: [
             'Personal OS directory exists.',
             'The approved self, work, and person context are saved locally.',
-            'brainbase onboard:demo returns a try-this prompt, sample result, and useful answer for the selected real request.',
-            'The user can see what they did not have to explain again.',
+            'The CLI sample, if used, is labeled as a preview rather than an onboarding completion signal.',
             'The completion report lists public skills, ohayo/oyasumi/retro routines, real MCP config merge, source allowlists, and MCP get_context/search verification as unfinished operationalization work.',
             'The selected MCP client has a Brainbase config snippet merged into its real config after user approval.',
+            'A fresh agent session used Brainbase get_context/search for the real request.',
+            'The user personally confirmed that the actual agent answer was useful.',
             'Source diagnosis is optional follow-up work, but source allowlist/import/candidate review must be explicitly completed or deferred.'
         ]
     };
 }
 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)
@@ -119,8 +123,9 @@ export function buildValueDemo(input) {
         dataDir: input.os.dataDir,
         firstValueReady: ready
     });
+    const actualAgentPrompt = `Brainbaseのget_contextとsearchを使い、保存済み文脈を根拠に「${scenario}」へ回答してください。使った前提と未確認事項を分けてください。`;
     return {
-        goal: 'Show one useful answer from the context the user just saved before any setup follow-up.',
+        goal: '実エージェント接続前に、保存した文脈から作れる出力をプレビューする。',
         ready,
         missing,
         scenario,
@@ -139,12 +144,18 @@ 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(', ')}.`,
-        completionSignal: ready ? 'first_value_demo_ready' : 'needs_seed'
+            ? 'MCP設定を反映して新しいエージェントを開き、実際の回答を確認した後、本人が役立ったかを判断します。'
+            : `まず最小文脈を保存します: ${missing.map(missingLabel).join(', ')}。`,
+        completionSignal: ready ? 'cli_sample_ready' : 'needs_seed',
+        onboardingComplete: false,
+        humanValueStatus: 'not_observed',
+        actualAgentPrompt
     };
 }
 export function buildSourceDiagnosis(input) {
@@ -495,45 +506,46 @@ 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:install --target codex --dir ${shellArg(input.os.dataDir)} --dry-run\``
+            : `\`brainbase onboard:start --dir ${shellArg(input.os.dataDir)} --target codex\``,
         demo.nextStep,
+        ...(demo.ready ? ['', '## 実エージェントへ送る依頼', demo.actualAgentPrompt, '', '回答後、本人に役立ったかを確認してください。'] : []),
         ''
-    ].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 +697,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 +708,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 +735,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) {
@@ -762,7 +790,7 @@ function buildValueExplanation(input) {
 }
 function buildMissingDemoAnswer(missing) {
     return [
-        'まだ最初の価値体験はできません。',
+        'まだ接続前プレビューを作れません。',
         `足りない最小メモ: ${missing.map(missingLabel).join(', ')}。`,
         'まず、あなたが毎回説明したくないことを一つだけ保存してから、同じプロンプトをもう一度試します。'
     ].join('\n');

package/dist/operationalization.js

@@ -6,76 +6,79 @@ 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: 'CLIプレビュー後、実エージェントで本人が初回価値を確認するまでを順に完了する。',
         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でCLI文脈プレビューの準備完了を確認可能。',
+                'onboard:demoを実行した場合も、確認できるのはローカルCLIサンプルだけ。'
             ]
             : [
-                '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.'
+            'Brainbase MCP設定を実際のCodex / Claude / CodeCode設定へ反映し、エージェントを再起動する。',
+            '新しいエージェントで現実の依頼を送り、MCP get_contextとsearchを使った実回答を確認する。',
+            '利用者本人に役立ったかを確認する。役立たなければ不足文脈だけを追加して再試行する。',
+            '対象エージェントへ公開スキルを配置する。',
+            '必要になった時だけohayo / oyasumi / retroを確認付きで登録する。',
+            '追加文脈が必要な場合だけ参照許可範囲を決め、取込と候補レビューを行う。',
+            '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を使って現実の依頼へ回答済み。',
+            '利用者本人がその回答を役立つと確認済み。',
+            '完了報告に残っている運用設定をすべて記載済み。',
+            '実設定反映後、対象エージェントからBrainbase MCP get_context/searchを呼び出せる。',
+            '参照許可範囲と候補レビューを完了、または明示的に延期済み。'
         ]
     };
 }