brainclaw 0.19.10 → 0.19.12

package/README.md

@@ -129,6 +129,7 @@ After that, the agent should stay on Brainclaw's MCP path for live state:
 
 ```text
 bclaw_session_start      -> open session + return board/context
+bclaw_get_execution_context -> inspect local tooling + notice Brainclaw package updates
 bclaw_get_context        -> fetch fresh prompt-ready context for a path
 bclaw_list_plans         -> inspect shared work
 bclaw_claim              -> claim scope before editing
@@ -177,6 +178,8 @@ If you want a machine-level CLI for operator workflows, debugging, or repeated l
 npm install -g brainclaw
 ```
 
+By default, Brainclaw's update checks for end-user installs follow the public npm `latest` channel. Projects that need a different track can override `brainclaw_update_source`, for example to use `prelaunch` or a local tarball channel.
+
 If you are working from source while developing Brainclaw itself:
 
 ```bash

package/dist/cli.js

@@ -515,6 +515,7 @@ program
     .option('--refresh', 'Force a fresh bootstrap scan instead of reusing the current profile')
     .option('--interview', 'Render the adaptive interview prompts instead of the bootstrap summary')
     .option('--audience <audience>', 'Target interview prompts for cli, ide_chat, or any')
+    .option('--answers-file <path>', 'Load structured bootstrap interview answers from a JSON file')
     .option('--apply', 'Import the current bootstrap proposal into canonical memory')
     .option('--uninstall', 'Deactivate the last bootstrap import managed by this workspace')
     .option('-y, --yes', 'Skip confirmation prompts for apply/uninstall')

package/dist/commands/bootstrap.js

@@ -1,7 +1,9 @@
+import fs from 'node:fs';
 import readline from 'node:readline/promises';
 import { stdin as input, stdout as output } from 'node:process';
 import { memoryExists } from '../core/io.js';
 import { applyBootstrapImport, renderBootstrapInterview, renderBootstrapSummary, runBootstrapProfile, uninstallBootstrapImport, } from '../core/bootstrap.js';
+import { BootstrapInterviewAnswerSchema } from '../core/schema.js';
 export async function runBootstrap(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     if (!memoryExists(cwd)) {
@@ -14,6 +16,7 @@ export async function runBootstrap(options = {}) {
             process.exit(1);
         }
         const audience = resolveBootstrapInterviewAudience(options.audience);
+        const interviewAnswers = loadBootstrapInterviewAnswers(options.answersFile);
         if (options.uninstall) {
             await confirmBootstrapAction('Remove the last bootstrap import?', options.yes);
             const result = uninstallBootstrapImport(cwd);
@@ -21,7 +24,7 @@ export async function runBootstrap(options = {}) {
                 console.log('No bootstrap import receipt found.');
                 return;
             }
-            console.log(`✔ Bootstrap uninstall completed: ${result.deactivatedCount} instruction(s) deactivated, ${result.skippedCount} artifact(s) skipped.`);
+            console.log(`✔ Bootstrap uninstall completed: ${result.deactivatedCount} instruction(s) deactivated, ${result.deletedCount} artifact(s) deleted, ${result.skippedCount} artifact(s) skipped.`);
             return;
         }
         if (options.apply) {
@@ -29,6 +32,7 @@ export async function runBootstrap(options = {}) {
             const result = applyBootstrapImport({
                 target: options.for,
                 refresh: options.refresh,
+                interviewAnswers,
                 cwd,
             });
             console.log(`✔ Bootstrap import applied: ${result.createdCount} item(s) created, ${result.skippedCount} suggestion(s) skipped.`);
@@ -40,6 +44,7 @@ export async function runBootstrap(options = {}) {
         const result = runBootstrapProfile({
             target: options.for,
             refresh: options.refresh,
+            interviewAnswers,
             cwd,
         });
         if (options.json) {
@@ -76,6 +81,17 @@ function resolveBootstrapInterviewAudience(value) {
     }
     throw new Error(`Unsupported bootstrap interview audience '${value}'. Use cli, ide_chat, or any.`);
 }
+function loadBootstrapInterviewAnswers(filepath) {
+    if (!filepath) {
+        return [];
+    }
+    const raw = fs.readFileSync(filepath, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) {
+        throw new Error(`Bootstrap interview answers file must contain a JSON array: ${filepath}`);
+    }
+    return parsed.map((entry) => BootstrapInterviewAnswerSchema.parse(entry));
+}
 async function confirmBootstrapAction(question, yes) {
     if (yes) {
         return;

package/dist/commands/env.js

@@ -1,7 +1,7 @@
 import { memoryExists } from '../core/io.js';
 import { loadConfig } from '../core/config.js';
 import { assessAgentIntegrationReadiness } from '../core/agent-integrations.js';
-import { assessBrainclawVersion } from '../core/brainclaw-version.js';
+import { assessBrainclawVersion, checkBrainclawInstallableUpdate, renderBrainclawInstallableUpdateNotice, } from '../core/brainclaw-version.js';
 import { buildExecutionContext, compactExecutionContext, renderExecutionContextSummary } from '../core/execution-context.js';
 import { buildAgentToolingContext, renderAgentToolingSummary } from '../core/agent-context.js';
 export function runEnv(options = {}) {
@@ -14,11 +14,14 @@ export function runEnv(options = {}) {
     const config = loadConfig(cwd);
     const integrationReadiness = assessAgentIntegrationReadiness(config, cwd);
     const brainclawVersion = assessBrainclawVersion(config);
+    const installableUpdate = checkBrainclawInstallableUpdate(config, cwd, { useDefaultNpmSource: true });
+    const installableUpdateNotice = renderBrainclawInstallableUpdateNotice(installableUpdate);
     const agentTooling = options.agentTooling ? buildAgentToolingContext({ cwd }) : undefined;
     if (options.json) {
         console.log(JSON.stringify({
             execution_context: executionContext,
             brainclaw_version: brainclawVersion,
+            installable_update: installableUpdate,
             declared_agent_integrations: config.agent_integrations,
             integration_readiness: integrationReadiness,
             ...(agentTooling ? { agent_tooling: agentTooling } : {}),
@@ -33,6 +36,9 @@ export function runEnv(options = {}) {
             console.log(`Upgrade benefits: ${brainclawVersion.upgrade_message}`);
         }
     }
+    if (installableUpdateNotice) {
+        console.log(installableUpdateNotice);
+    }
     console.log(`Declared agent integrations: ${config.agent_integrations.declarations.length}`);
     const missingDeclarations = integrationReadiness.filter((entry) => !entry.ready);
     if (missingDeclarations.length > 0) {

package/dist/commands/init.js

@@ -243,6 +243,7 @@ export async function runInit(options = {}) {
     if ((onboardingPreflight.importPlan.interview?.question_count ?? 0) > 0) {
         console.log('');
         console.log(`Interview: run 'brainclaw bootstrap --interview --audience cli' for terminal agents or '--audience ide_chat' for IDE chat agents.`);
+        console.log(`Apply confirmed answers: write a JSON answers file and run 'brainclaw bootstrap --answers-file <path> --apply'.`);
     }
     else if ((onboardingPreflight.profile.gaps?.length ?? 0) > 0) {
         console.log('');

package/dist/commands/mcp.js

@@ -2,11 +2,12 @@ import readline from 'node:readline';
 import { Worker } from 'node:worker_threads';
 import { getTriggeredItems, renderTriggeredItems } from '../core/lifecycle.js';
 import { resolveCrossProjectTarget, writeCrossProjectNote } from '../core/cross-project.js';
-import { renderBootstrapSummary, runBootstrapProfile } from '../core/bootstrap.js';
+import { applyBootstrapImport, renderBootstrapInterview, renderBootstrapSummary, runBootstrapProfile, uninstallBootstrapImport } from '../core/bootstrap.js';
 import { buildAgentToolingContext, renderAgentToolingSummary } from '../core/agent-context.js';
 import { buildCoordinationSnapshot } from '../core/coordination.js';
 import { buildContext, renderContextMarkdown, renderContextPromptTemplate } from '../core/context.js';
 import { buildExecutionContext, renderExecutionContextSummary } from '../core/execution-context.js';
+import { checkBrainclawInstallableUpdate, renderBrainclawInstallableUpdateNotice } from '../core/brainclaw-version.js';
 import { loadConfig } from '../core/config.js';
 import { loadState, persistState } from '../core/state.js';
 import { memoryExists } from '../core/io.js';
@@ -30,6 +31,7 @@ import { detectAiAgent } from '../core/ai-agent-detection.js';
 import { checkGitPresence, scanGitRepos, parseRoots, parseRepoSelection, parseAgentSelection, runGlobalInstall, initReposAndConfigureAgents, readSetupState, ALL_KNOWN_AGENTS, } from './setup.js';
 import { resolveTargetStore, resolveStoreChain } from '../core/store-resolution.js';
 import { readUnseenEvents, buildNotificationSummary } from '../core/event-log.js';
+import { BootstrapInterviewAnswerSchema } from '../core/schema.js';
 export const SCHEMA_VERSION = '0.6.0';
 export const MCP_PROTOCOL_VERSIONS = ['2025-11-25', '2024-11-05'];
 export const MCP_SERVER_NOT_INITIALIZED = -32002;
@@ -67,12 +69,21 @@ export const MCP_READ_TOOLS = [
             properties: {
                 target: { type: 'string', description: 'Optional path or scope to tailor the bootstrap.' },
                 refresh: { type: 'boolean', description: 'Force a fresh bootstrap scan.' },
+                audience: { type: 'string', description: 'Optional interview audience filter: cli, ide_chat, or any.' },
+                interview: { type: 'boolean', description: 'Render interview text instead of the summary text.' },
+                apply: { type: 'boolean', description: 'Apply the current import proposal into canonical memory.' },
+                uninstall: { type: 'boolean', description: 'Uninstall the last bootstrap-managed import.' },
+                interviewAnswers: {
+                    type: 'array',
+                    description: 'Optional structured interview answers. Each answer may include question_id, response_text, response_items, response_boolean, and explicit suggestions.',
+                    items: { type: 'object' },
+                },
             },
         },
     },
     {
         name: 'bclaw_get_execution_context',
-        description: 'Inspect the local execution environment and optionally agent tooling signals.',
+        description: 'Inspect the local execution environment, installable Brainclaw update channel, and optionally agent tooling signals.',
         inputSchema: {
             type: 'object',
             properties: {
@@ -506,6 +517,18 @@ export function createToolErrorResponse(kind, message, details) {
         },
     }, true);
 }
+function normalizeBootstrapInterviewAnswersArg(value) {
+    if (!Array.isArray(value)) {
+        return [];
+    }
+    return value.map((entry) => BootstrapInterviewAnswerSchema.parse(entry));
+}
+function normalizeBootstrapInterviewAudienceArg(value) {
+    if (value === 'cli' || value === 'ide_chat' || value === 'any') {
+        return value;
+    }
+    return 'any';
+}
 function requireObjectParams(params, id) {
     if (params === undefined) {
         return {};
@@ -1040,19 +1063,64 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
         };
     }
     if (name === 'bclaw_bootstrap') {
+        const interviewAnswers = normalizeBootstrapInterviewAnswersArg(args.interviewAnswers);
+        if (args.apply && args.uninstall) {
+            throw new Error('bclaw_bootstrap does not allow apply and uninstall at the same time.');
+        }
+        if (args.uninstall) {
+            const result = uninstallBootstrapImport(cwd);
+            const text = !result.receipt
+                ? 'No bootstrap import receipt found.'
+                : `Bootstrap uninstall completed: ${result.deactivatedCount} instruction(s) deactivated, ${result.deletedCount} artifact(s) deleted, ${result.skippedCount} artifact(s) skipped.`;
+            return {
+                content: [{ type: 'text', text }],
+                structuredContent: {
+                    receipt: result.receipt,
+                    deactivated_count: result.deactivatedCount,
+                    deleted_count: result.deletedCount,
+                    skipped_count: result.skippedCount,
+                },
+            };
+        }
+        if (args.apply) {
+            const applied = applyBootstrapImport({
+                target: args.target,
+                refresh: args.refresh,
+                interviewAnswers,
+                cwd,
+            });
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Bootstrap import applied: ${applied.createdCount} item(s) created, ${applied.skippedCount} suggestion(s) skipped.`,
+                    }],
+                structuredContent: {
+                    created_count: applied.createdCount,
+                    skipped_count: applied.skippedCount,
+                    receipt: applied.receipt,
+                    import_plan: applied.proposal,
+                },
+            };
+        }
         const result = runBootstrapProfile({
             target: args.target,
             refresh: args.refresh,
+            interviewAnswers,
             cwd,
         });
+        const audience = normalizeBootstrapInterviewAudienceArg(args.audience);
+        const text = args.interview
+            ? renderBootstrapInterview(result, audience)
+            : renderBootstrapSummary(result);
         return {
-            content: [{ type: 'text', text: renderBootstrapSummary(result) }],
+            content: [{ type: 'text', text }],
             structuredContent: {
                 summary: result.profile.summary,
                 target: result.profile.target,
                 repo_fingerprint: result.profile.repo_fingerprint,
                 sources_scanned: result.profile.sources_scanned,
                 workspace_kind: result.profile.workspace_kind,
+                onboarding_mode: result.profile.onboarding_mode,
                 confidence: result.profile.confidence,
                 native_instruction_files: result.profile.native_instruction_files,
                 gaps: result.profile.gaps,
@@ -1066,15 +1134,20 @@ export function handleMcpReadToolCall(name, args = {}, context = {}) {
     }
     if (name === 'bclaw_get_execution_context') {
         const executionContext = buildExecutionContext({ cwd });
+        const config = loadConfig(cwd);
+        const installableUpdate = checkBrainclawInstallableUpdate(config, cwd, { useDefaultNpmSource: true });
+        const installableUpdateNotice = renderBrainclawInstallableUpdateNotice(installableUpdate);
         const agentTooling = args.includeAgentTooling ? buildAgentToolingContext({ cwd }) : undefined;
         const text = [
             renderExecutionContextSummary(executionContext, true),
+            ...(installableUpdateNotice ? ['', installableUpdateNotice] : []),
             ...(agentTooling ? ['', renderAgentToolingSummary(agentTooling)] : []),
         ].join('\n');
         return {
             content: [{ type: 'text', text }],
             structuredContent: {
                 execution_context: executionContext,
+                installable_update: installableUpdate,
                 ...(agentTooling ? { agent_tooling: agentTooling } : {}),
             },
         };

package/dist/commands/version.js

@@ -31,7 +31,9 @@ export function runVersion(options = {}) {
         }
     }
     const assessment = assessBrainclawVersion(config);
-    const updateCheck = options.check ? checkBrainclawInstallableUpdate(config, cwd) : undefined;
+    const updateCheck = options.check
+        ? checkBrainclawInstallableUpdate(config, cwd, { useDefaultNpmSource: true })
+        : undefined;
     const result = {
         initialized,
         ...assessment,

package/dist/commands/whoami.js

@@ -4,7 +4,7 @@ import { loadConfig } from '../core/config.js';
 import { resolveCurrentHostId } from '../core/host.js';
 import { buildOperationalIdentity } from '../core/identity.js';
 import { assessAgentIntegrationReadiness } from '../core/agent-integrations.js';
-import { assessBrainclawVersion } from '../core/brainclaw-version.js';
+import { assessBrainclawVersion, checkBrainclawInstallableUpdate, renderBrainclawInstallableUpdateNotice, } from '../core/brainclaw-version.js';
 import { buildExecutionContext, compactExecutionContext } from '../core/execution-context.js';
 import { buildAgentToolingContext } from '../core/agent-context.js';
 export function runWhoami(options = {}) {
@@ -18,6 +18,8 @@ export function runWhoami(options = {}) {
     const executionContext = compactExecutionContext(buildExecutionContext({ cwd }));
     const integrationReadiness = assessAgentIntegrationReadiness(config, cwd);
     const brainclawVersion = assessBrainclawVersion(config);
+    const installableUpdate = checkBrainclawInstallableUpdate(config, cwd, { useDefaultNpmSource: true });
+    const installableUpdateNotice = renderBrainclawInstallableUpdateNotice(installableUpdate);
     const agentTooling = buildAgentToolingContext({ cwd });
     let identity;
     try {
@@ -45,6 +47,7 @@ export function runWhoami(options = {}) {
         env_session: process.env.BRAINCLAW_SESSION_ID ?? null,
         env_host: process.env.BRAINCLAW_HOST_ID ?? null,
         brainclaw_version: brainclawVersion,
+        installable_update: installableUpdate,
         declared_agent_integrations: config.agent_integrations,
         integration_readiness: integrationReadiness,
         execution_context: executionContext,
@@ -80,6 +83,13 @@ export function runWhoami(options = {}) {
     if (result.brainclaw_version.status !== 'ok') {
         console.log(`  Version    : ${result.brainclaw_version.message}`);
     }
+    if (installableUpdateNotice) {
+        const lines = installableUpdateNotice.split('\n');
+        console.log(`  Update     : ${lines[0]}`);
+        for (const line of lines.slice(1)) {
+            console.log(`             ${line}`);
+        }
+    }
     console.log(`  Declared integrations: ${result.declared_agent_integrations.declarations.length}`);
     const missingIntegrations = result.integration_readiness.filter((entry) => !entry.ready);
     if (missingIntegrations.length > 0) {