@unson/brainbase-mcp 0.1.0 → 0.2.1

package/dist/guided-onboarding.d.ts

@@ -94,4 +94,4 @@ export interface GuidedFirstRun {
     completionCheck: string[];
 }
 export declare function buildGuidedFirstRun(input: GuidedFirstRunInput): GuidedFirstRun;
-export declare function renderGuidedFirstRun(input: GuidedFirstRunInput, format: GuidedFormat): string;
+export declare function renderGuidedFirstRun(input: GuidedFirstRunInput, format: GuidedFormat, details?: boolean): string;

package/dist/guided-onboarding.js

@@ -61,6 +61,7 @@ export function buildGuidedFirstRun(input) {
         '--name', input.name || '<あなたの名前>',
         ...values.flatMap((value) => ['--value', value]),
         '--project', input.project?.name || '<最初に登録するプロジェクト>',
+        ...(input.project?.decisionPrinciples ?? []).flatMap((value) => ['--decision-principle', value]),
         '--relationship', firstRelationshipArg
     ]);
     const demoCommand = command([
@@ -203,11 +204,33 @@ export function buildGuidedFirstRun(input) {
         ]
     };
 }
-export function renderGuidedFirstRun(input, format) {
+export function renderGuidedFirstRun(input, format, details = false) {
     const guide = buildGuidedFirstRun(input);
     if (format === 'json') {
         return `${JSON.stringify(guide, null, 2)}\n`;
     }
+    if (!details) {
+        const next = guide.currentStatus.missing.length > 0
+            ? guide.nextCommands.find((item) => item.id === 'self-seed')
+            : guide.nextCommands.find((item) => item.id === 'first-value-demo');
+        return [
+            '# Brainbase 初回オンボーディング',
+            '',
+            `- 状態: ${guide.currentStatus.missing.length > 0 ? '最小文脈の保存待ち' : '初回価値を確認できます'}`,
+            `- データ: \`${guide.dataDir}\``,
+            `- 不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
+            '',
+            '## 次に実行',
+            next ? `\`${next.command}\`` : '次の操作はありません。',
+            '',
+            '## 確認できる価値',
+            guide.firstValueExperience.expectedValue,
+            '',
+            '- この案内だけではデータを書き込みません。seed実行時も既存データは削除しません。',
+            `- 詳細を見る: \`${command(['brainbase', 'onboard:start', '--target', guide.target, '--dir', guide.dataDir, '--details'])}\``,
+            ''
+        ].join('\n');
+    }
     const lines = [
         '# Brainbase 初回オンボーディング開始',
         '',
@@ -216,7 +239,7 @@ export function renderGuidedFirstRun(input, format) {
         `- 対象エージェント: ${targetLabel(guide.target)}`,
         `- データディレクトリ: \`${guide.dataDir}\``,
         `- 正本ファクト書き込み: ${guide.initialized.canonicalFactWrites ? 'あり' : 'なし'}`,
-        `- 現在の不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.join(', ') : 'なし'}`,
+        `- 現在の不足: ${guide.currentStatus.missing.length > 0 ? guide.currentStatus.missing.map(canonicalAreaLabel).join('、') : 'なし'}`,
         '',
         '## まず試すこと',
         guide.firstValueExperience.title,
@@ -449,6 +472,15 @@ function statusLabel(status) {
         return '追加の許可範囲が必要';
     return '未設定';
 }
+function canonicalAreaLabel(area) {
+    if (area === 'self')
+        return '本人の前提';
+    if (area === 'work')
+        return '今の仕事';
+    if (area === 'relationships')
+        return '関係者';
+    return area;
+}
 function translateRequiredInput(value) {
     if (value.includes('GoG'))
         return value.replace('Install or configure local GoG command', 'ローカルGoGコマンドをインストールまたは設定する');

package/dist/import-extract.d.ts

@@ -102,6 +102,7 @@ export interface ApplyResult {
         id: string;
         kind: string;
         summary: string;
+        canonicalIds: string[];
     }[];
     skipped: {
         id: string;

package/dist/import-extract.js

@@ -328,7 +328,7 @@ export function planApply(candidates, selection, base, now) {
                 ownerName = name;
                 upsertEntity(graphEntities, { id: 'self', type: 'person', name, summary: 'Owner of this local Brainbase Personal OS.', tags: ['self'] });
                 personalKgAdditions.push({ id: `self-${stableHash(name)}`, type: 'self', text: `I am ${name}.`, tags: ['self'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: ['self', `self-${stableHash(name)}`] });
                 break;
             }
             case 'person':
@@ -344,7 +344,14 @@ export function planApply(candidates, selection, base, now) {
                 if (candidate.kind === 'relationship' && !relationships.some((relationship) => relationship.person === person && relationship.context === context)) {
                     relationships.push({ id: `relationship-${stableHash(`${person}|${context}`)}`, person, role: role || undefined, context, tags: ['relationship'], updatedAt: now });
                 }
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: person });
+                applied.push({
+                    id: candidate.id,
+                    kind: candidate.kind,
+                    summary: person,
+                    canonicalIds: candidate.kind === 'relationship'
+                        ? [`person-${stableHash(person)}`, `relationship-${stableHash(`${person}|${context}`)}`]
+                        : [`person-${stableHash(person)}`]
+                });
                 break;
             }
             case 'org': {
@@ -354,7 +361,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 upsertEntity(graphEntities, { id: `org-${stableHash(name)}`, type: 'org', name, summary: 'Imported from onboarding sources.', tags: ['org'] });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: [`org-${stableHash(name)}`] });
                 break;
             }
             case 'project': {
@@ -365,7 +372,7 @@ export function planApply(candidates, selection, base, now) {
                 }
                 upsertEntity(graphEntities, { id: `project-${stableHash(name)}`, type: 'project', name, summary: 'Imported from onboarding sources.', tags: ['work'] });
                 personalKgAdditions.push({ id: `work-${stableHash(name)}`, type: 'work', text: name, tags: ['work'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: name });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: name, canonicalIds: [`project-${stableHash(name)}`, `work-${stableHash(name)}`] });
                 break;
             }
             case 'value': {
@@ -375,7 +382,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 personalKgAdditions.push({ id: `value-${stableHash(text)}`, type: 'value', text, tags: ['onboarding'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`value-${stableHash(text)}`] });
                 break;
             }
             case 'next_action': {
@@ -385,7 +392,7 @@ export function planApply(candidates, selection, base, now) {
                     break;
                 }
                 personalKgAdditions.push({ id: `next-action-${stableHash(text)}`, type: 'work', text, tags: ['next-action'], source: candidate.id, updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`next-action-${stableHash(text)}`] });
                 break;
             }
             case 'decision': {
@@ -394,8 +401,23 @@ export function planApply(candidates, selection, base, now) {
                     skipped.push({ id: candidate.id, reason: 'decision candidate missing decision text' });
                     break;
                 }
-                decisionAdditions.push({ id: `decision-${stableHash(text)}`, title: 'Promoted decision principle', decision: text, tags: ['principle'], updatedAt: now });
-                applied.push({ id: candidate.id, kind: candidate.kind, summary: text });
+                const topic = payloadString(payload, 'topic');
+                const effectiveAt = payloadString(payload, 'effectiveAt');
+                const rationale = payloadString(payload, 'rationale');
+                const supersedes = readStringArray(payload, ['supersedes']);
+                const tags = readStringArray(payload, ['tags']);
+                decisionAdditions.push({
+                    id: `decision-${stableHash(text)}`,
+                    title: payloadString(payload, 'title') || 'Promoted decision principle',
+                    decision: text,
+                    topic: topic || undefined,
+                    supersedes: supersedes.length > 0 ? supersedes : undefined,
+                    effectiveAt: effectiveAt || undefined,
+                    rationale: rationale || undefined,
+                    tags: tags.length > 0 ? tags : ['principle'],
+                    updatedAt: now
+                });
+                applied.push({ id: candidate.id, kind: candidate.kind, summary: text, canonicalIds: [`decision-${stableHash(text)}`] });
                 break;
             }
             default:

package/dist/judgment-host.d.ts

@@ -0,0 +1,205 @@
+type Environment = Record<string, string | undefined>;
+export interface ConversationMessage {
+    sequence?: number;
+    turn_id?: string | null;
+    role: 'user' | 'assistant';
+    phase?: string | null;
+    text: string;
+}
+export interface JudgmentHookPayload {
+    hook_event_name?: string;
+    hookEventName?: string;
+    prompt?: string;
+    session_id?: string;
+    turn_id?: string;
+    transcript_path?: string;
+    cwd?: string;
+    model?: string;
+    permission_mode?: string;
+    tool_use_id?: string;
+    tool_name?: string;
+    tool_input?: unknown;
+    tool_response?: unknown;
+    last_assistant_message?: string;
+    stop_hook_active?: boolean;
+}
+export interface JudgmentRequest {
+    request: string;
+    turn_id: string;
+    project_code?: string;
+    conversation_context: {
+        schema_version: 'brainbase-conversation-context-v1';
+        session_ref: string;
+        messages: Required<ConversationMessage>[];
+        prior_receipts: Array<Record<string, unknown>>;
+        runtime: {
+            host: string;
+            model: string | null;
+            permission_mode: string | null;
+            project_binding: string | null;
+        };
+        instruction_bindings: Array<{
+            scope: string;
+            source_ref: string;
+            digest: string;
+        }>;
+        completeness: 'complete' | 'partial';
+        source_digest: string;
+    };
+}
+export interface JudgmentClassification {
+    intent: 'answer' | 'investigate' | 'diagnose' | 'design' | 'implement' | 'review' | 'operate';
+    domains: Array<'general' | 'knowledge' | 'engineering' | 'organization' | 'operations' | 'personal_judgment'>;
+    confidence: 'confirmed' | 'inferred';
+}
+export interface JudgmentNodeDefinition {
+    id: string;
+    kind: 'common' | 'judgment' | 'constraint' | 'clarification';
+    instruction: string;
+}
+export interface JudgmentReceipt {
+    resolution_id: string;
+    resolved_at: string;
+    turn_id: string;
+    request_digest: string;
+    context_digest: string;
+    plan_digest: string;
+    status: 'resolved' | 'needs_clarification';
+    runtime_version: string;
+    manifest_digest: string;
+    host_binding: {
+        adapter_id: 'brainbase-local';
+        adapter_version: '1';
+        status: 'managed';
+        enforcement_level: 'host_contract';
+    };
+    project_code?: string;
+    classification: JudgmentClassification | null;
+    classification_evidence: {
+        source: 'current_request' | 'prior_message' | 'prior_receipt' | 'resolver';
+        source_turn_ids: string[];
+        matcher_ids: string[];
+    };
+    reconciliation_reasons: string[];
+    selected_dag_ids: string[];
+    applicable_policies: Array<{
+        id: string;
+        instruction: string;
+    }>;
+    active_nodes: string[];
+    active_edges: Array<[string, string]>;
+    active_node_definitions: JudgmentNodeDefinition[];
+    unresolved: string[];
+    rationale: string[];
+}
+export interface JudgmentHookOutput {
+    continue: true;
+    suppressOutput: true;
+    receipt: JudgmentReceipt;
+    hookSpecificOutput: {
+        hookEventName: 'UserPromptSubmit';
+        additionalContext: string;
+    };
+}
+export interface JudgmentHostOptions {
+    env?: Environment;
+    resolver?: (request: JudgmentRequest) => Promise<JudgmentReceipt>;
+    trustedConversationMessages?: ConversationMessage[];
+}
+interface LocalResolverOptions {
+    now?: () => Date;
+    id?: () => string;
+}
+export interface JudgmentOwnerAudit {
+    schema_version: 'brainbase-owner-audit-v1';
+    renderer_version: '1';
+    locale: 'ja-JP';
+    historical_exact: boolean;
+    source_receipt_digest: string;
+    source_kind: 'current_request' | 'prior_turn' | 'prior_turn_fallback' | 'prior_turn_unavailable';
+    source_turn_ids: string[];
+    source_excerpt: string;
+    decision: string;
+    display_line: string;
+    text_digest: string;
+}
+interface JudgmentAdoptionEntry {
+    schema_version: 'brainbase-judgment-adoption-v1' | 'brainbase-judgment-adoption-v2';
+    accepted_at: string;
+    request_text_digest: string;
+    request: JudgmentRequest;
+    receipt: JudgmentReceipt;
+    receipt_digest?: string;
+    owner_audit: JudgmentOwnerAudit;
+}
+export interface JudgmentEpisode {
+    schema_version: 'brainbase-judgment-episode-v1';
+    session_ref: string;
+    turn_id: string;
+    started_at: string;
+    request_text_digest: string;
+    initial_receipt_digest: string;
+    adoption: JudgmentAdoptionEntry;
+    audit_contract: {
+        schema_version: 'brainbase-owner-audit-contract-v1';
+        repair_body_policy: 'preserve';
+        zero_call_display_line: string | null;
+        zero_call_display_line_digest: string | null;
+    };
+    episode_digest: string;
+}
+export interface JudgmentToolEvent {
+    schema_version: 'brainbase-judgment-tool-event-v1';
+    session_ref: string;
+    turn_id: string;
+    sequence: number;
+    recorded_at: string;
+    tool_use_id: string;
+    tool_name: string;
+    tool_input: unknown;
+    tool_response: unknown;
+    audit_kind: 'routing' | 'search' | 'retrieval';
+    success: boolean;
+    satisfies: string[];
+    display_line: string;
+    event_fingerprint: string;
+    event_digest: string;
+}
+export interface JudgmentFinalReceipt {
+    schema_version: 'brainbase-judgment-final-v1';
+    session_ref: string;
+    turn_id: string;
+    finalized_at: string;
+    initial_receipt_digest: string;
+    event_count: number;
+    event_set_digest: string;
+    answer_digest: string;
+    completion_status?: 'complete';
+    owner_audit_complete?: boolean;
+    owner_audit_line_count?: number;
+    final_digest: string;
+}
+export interface JudgmentStopBlock {
+    decision: 'block';
+    reason: string;
+}
+export declare function canonicalJson(value: unknown): string;
+export declare function buildJudgmentRequest(payload: JudgmentHookPayload, { env, trustedConversationMessages }?: {
+    env?: Environment;
+    trustedConversationMessages?: ConversationMessage[];
+}): JudgmentRequest;
+export declare function resolveLocalJudgment(request: JudgmentRequest, options?: LocalResolverOptions): Promise<JudgmentReceipt>;
+export declare function buildOwnerAudit(request: JudgmentRequest, receipt: JudgmentReceipt, { historicalExact }?: {
+    historicalExact?: boolean;
+}): JudgmentOwnerAudit;
+export declare function buildOwnerReferenceLine(request: JudgmentRequest, receipt: JudgmentReceipt): string;
+export declare function runJudgmentHost(payload: JudgmentHookPayload, options?: JudgmentHostOptions): Promise<JudgmentHookOutput>;
+export declare function processJudgmentHook(payload: JudgmentHookPayload, options?: JudgmentHostOptions): Promise<JudgmentHookOutput | JudgmentFinalReceipt | JudgmentStopBlock | {
+    systemMessage: string;
+} | Record<string, never>>;
+export declare function blockedJudgmentOutput(reason: string): {
+    continue: false;
+    suppressOutput: false;
+    stopReason: string;
+};
+export {};