byterover-cli 3.10.2 → 3.11.0

package/dist/oclif/lib/task-client.d.ts

@@ -7,6 +7,7 @@
  * Used by: curate, query commands.
  */
 import type { ITransportClient } from '@campfirein/brv-transport-client';
+import type { QueryLogMatchedDoc, QueryLogTier } from '../../server/core/domain/entities/query-log-entry.js';
 /** Collected tool call with result (mirrors TUI ToolCallEvent) */
 export interface ToolCallRecord {
     args: Record<string, unknown>;
@@ -19,7 +20,11 @@ export interface ToolCallRecord {
 }
 /** Completion result passed to onCompleted callback */
 export interface TaskCompletionResult {
+    /** Wall-clock execution time for query tasks, in milliseconds. Absent for non-query tasks. */
+    durationMs?: number;
     logId?: string;
+    /** Documents matched by the query. Empty array on cache hits; absent for non-query tasks. */
+    matchedDocs?: QueryLogMatchedDoc[];
     /** Pending review notification from the server, present when review is required after task completion. */
     pendingReview?: {
         pendingCount: number;
@@ -27,7 +32,11 @@ export interface TaskCompletionResult {
     };
     result?: string;
     taskId: string;
+    /** Resolution tier for query tasks. Absent for non-query tasks. */
+    tier?: QueryLogTier;
     toolCalls: ToolCallRecord[];
+    /** Top compound score across matchedDocs. Absent for cache hits and non-query tasks. */
+    topScore?: number;
 }
 /** Error result passed to onError callback */
 export interface TaskErrorResult {

package/dist/oclif/lib/task-client.js

@@ -195,7 +195,17 @@ export function waitForTaskCompletion(options, log) {
                 const resolvedPendingReview = payload.pendingReviewCount !== undefined && payload.pendingReviewCount > 0
                     ? { pendingCount: payload.pendingReviewCount, reviewUrl: pendingReview?.reviewUrl ?? '' }
                     : pendingReview;
-                onCompleted({ logId: payload.logId, pendingReview: resolvedPendingReview, result: payload.result, taskId, toolCalls });
+                onCompleted({
+                    durationMs: payload.durationMs,
+                    logId: payload.logId,
+                    matchedDocs: payload.matchedDocs,
+                    pendingReview: resolvedPendingReview,
+                    result: payload.result,
+                    taskId,
+                    tier: payload.tier,
+                    toolCalls,
+                    topScore: payload.topScore,
+                });
                 resolve();
             }),
             // Task error

package/dist/server/core/domain/entities/provider-registry.js

@@ -72,6 +72,19 @@ export const PROVIDER_REGISTRY = {
         name: 'DeepInfra',
         priority: 10,
     },
+    deepseek: {
+        apiKeyUrl: 'https://platform.deepseek.com/api_keys',
+        baseUrl: 'https://api.deepseek.com/v1',
+        category: 'other',
+        defaultModel: 'deepseek-chat',
+        description: 'DeepSeek V3 and R1 reasoning models',
+        envVars: ['DEEPSEEK_API_KEY'],
+        headers: {},
+        id: 'deepseek',
+        modelsEndpoint: '/models',
+        name: 'DeepSeek',
+        priority: 19,
+    },
     glm: {
         apiKeyUrl: 'https://open.z.ai',
         baseUrl: 'https://api.z.ai/api/paas/v4',
@@ -85,6 +98,19 @@ export const PROVIDER_REGISTRY = {
         name: 'GLM (Z.AI)',
         priority: 17,
     },
+    'glm-coding-plan': {
+        apiKeyUrl: 'https://z.ai/manage-apikey/apikey-list',
+        baseUrl: 'https://api.z.ai/api/coding/paas/v4',
+        category: 'other',
+        defaultModel: 'glm-4.7',
+        description: 'GLM models on the Z.AI Coding Plan subscription',
+        envVars: ['ZHIPU_API_KEY'],
+        headers: {},
+        id: 'glm-coding-plan',
+        modelsEndpoint: '',
+        name: 'GLM Coding Plan (Z.AI)',
+        priority: 17.5,
+    },
     google: {
         apiKeyUrl: 'https://aistudio.google.com/apikey',
         baseUrl: '',

package/dist/server/infra/daemon/brv-server.js

@@ -337,6 +337,10 @@ async function main() {
         const transportHandlers = new TransportHandlers({
             agentPool,
             clientManager,
+            // The version we read at startup gets relayed in the client:register ack
+            // so peer clients (TUI / MCP) can render drift indicators without an
+            // extra round-trip.
+            daemonVersion: version,
             // Resolves the project's review-disabled flag once at task-create. The result
             // is stamped onto TaskInfo + TaskExecute so daemon hooks (CurateLogHandler) and
             // the agent process (curate-tool backups, dream review entries) all observe a

package/dist/server/infra/http/provider-model-fetcher-registry.js

@@ -45,6 +45,7 @@ export async function getModelFetcher(providerId) {
         case 'cerebras': // falls through
         case 'cohere': // falls through
         case 'deepinfra': // falls through
+        case 'deepseek': // falls through
         case 'groq': // falls through
         case 'mistral': // falls through
         case 'togetherai': // falls through
@@ -59,6 +60,10 @@ export async function getModelFetcher(providerId) {
             fetcher = new ChatBasedModelFetcher('https://api.z.ai/api/paas/v4', 'GLM (Z.AI)', ['glm-4.7', 'glm-4.6', 'glm-4.5', 'glm-4.5-flash']);
             break;
         }
+        case 'glm-coding-plan': {
+            fetcher = new ChatBasedModelFetcher('https://api.z.ai/api/coding/paas/v4', 'GLM Coding Plan (Z.AI)', ['glm-4.7', 'glm-4.7-flash', 'glm-4.7-flashx', 'glm-5-turbo', 'glm-4.5', 'glm-4.5-flash']);
+            break;
+        }
         case 'google': {
             fetcher = new GoogleModelFetcher();
             break;

package/dist/server/infra/http/provider-model-fetchers.js

@@ -429,36 +429,63 @@ export class ChatBasedModelFetcher {
         return this.knownModels;
     }
     async validateApiKey(apiKey) {
-        try {
-            await axios.post(`${this.baseUrl}/chat/completions`, {
-                max_tokens: 1,
-                messages: [{ content: 'hi', role: 'user' }],
-                model: this.knownModels[0]?.id ?? 'default',
-            }, {
-                headers: {
-                    Authorization: `Bearer ${apiKey}`,
-                    'Content-Type': 'application/json',
-                },
-                httpAgent: ProxyConfig.getProxyAgent(),
-                httpsAgent: ProxyConfig.getProxyAgent(),
-                proxy: false,
-                timeout: 15_000,
-            });
-            return { isValid: true };
-        }
-        catch (error) {
-            if (isAxiosError(error)) {
-                if (error.response?.status === 401) {
-                    return { error: 'Invalid API key', isValid: false };
-                }
-                if (error.response?.status === 403) {
-                    return { error: 'API key does not have required permissions', isValid: false };
-                }
-                // Other errors (429, 400, etc.) mean the key was accepted
+        // Iterate through known models so a single missing model on a tier (e.g.
+        // GLM Coding Plan doesn't yet serve the latest glm-4.7) doesn't
+        // misclassify a valid key as invalid. We accept the key as soon as ANY
+        // model responds successfully, OR returns a non-auth error like 429/5xx
+        // (which still proves the key passed auth).
+        const candidates = this.knownModels.length > 0 ? this.knownModels : [{ id: 'default' }];
+        let lastNonAuthError;
+        for (const candidate of candidates) {
+            try {
+                // eslint-disable-next-line no-await-in-loop
+                await axios.post(`${this.baseUrl}/chat/completions`, {
+                    max_tokens: 1,
+                    messages: [{ content: 'hi', role: 'user' }],
+                    model: candidate.id,
+                }, {
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`,
+                        'Content-Type': 'application/json',
+                    },
+                    httpAgent: ProxyConfig.getProxyAgent(),
+                    httpsAgent: ProxyConfig.getProxyAgent(),
+                    proxy: false,
+                    timeout: 15_000,
+                });
                 return { isValid: true };
             }
-            return { error: error instanceof Error ? error.message : 'Unknown error', isValid: false };
+            catch (error) {
+                if (isAxiosError(error)) {
+                    if (error.response?.status === 401) {
+                        return { error: 'Invalid API key', isValid: false };
+                    }
+                    if (error.response?.status === 403) {
+                        return { error: 'API key does not have required permissions', isValid: false };
+                    }
+                    // 400/404 may mean "model not available on this tier" — try next.
+                    if (error.response?.status === 400 || error.response?.status === 404) {
+                        lastNonAuthError = error;
+                        continue;
+                    }
+                    // Axios errors that are not 401/403/400/404 (e.g. 429, 5xx, or
+                    // network-level errors with no response like ECONNREFUSED) are
+                    // treated as "key accepted" — either auth was passed (429/5xx) or
+                    // we can't determine otherwise (no response). Optimistic: prefer a
+                    // false-positive valid over a false-negative invalid.
+                    return { isValid: true };
+                }
+                lastNonAuthError = error;
+            }
         }
+        // Every candidate model returned 400/404 or a non-axios error and none
+        // gave us a positive auth signal. Treat the key as inconclusive — but
+        // since 401/403 was never observed, surface the last error so the user
+        // can see the real cause (often a model-availability issue, not auth).
+        return {
+            error: lastNonAuthError instanceof Error ? lastNonAuthError.message : 'Validation failed for all known models',
+            isValid: false,
+        };
     }
 }
 // ============================================================================

package/dist/server/infra/mcp/mcp-server.d.ts

@@ -57,6 +57,12 @@ export declare class ByteRoverMcpServer {
      * Log to stderr (stdout is reserved for MCP protocol).
      */
     private log;
+    /**
+     * Logs a one-line drift notice when the running daemon's version differs
+     * from this MCP's. Helps users notice an out-of-sync IDE without forcing
+     * a reconnect — the protocol is backward-compatible across the gap.
+     */
+    private logDaemonVersionDrift;
     /**
      * Sends the cached agent name to the daemon (fire-and-forget).
      * Called after MCP initialize handshake and on Socket.IO reconnection.

package/dist/server/infra/mcp/mcp-server.js

@@ -1,4 +1,4 @@
-import { connectToDaemon, createDaemonReconnector, } from '@campfirein/brv-transport-client';
+import { connectToDaemon, createDaemonReconnector, versionsAreEquivalent, } from '@campfirein/brv-transport-client';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { TransportClientEventNames } from '../../core/domain/transport/schemas.js';
@@ -55,8 +55,8 @@ export class ByteRoverMcpServer {
             : undefined;
         // Register tools with lazy client getter
         // Client will be set when start() is called
-        registerBrvQueryTool(this.server, () => this.client, () => this.getWorkingDirectory(), getStartupProjectContext);
-        registerBrvCurateTool(this.server, () => this.client, () => this.getWorkingDirectory(), getStartupProjectContext);
+        registerBrvQueryTool(this.server, () => this.client, () => this.getWorkingDirectory(), getStartupProjectContext, config.version);
+        registerBrvCurateTool(this.server, () => this.client, () => this.getWorkingDirectory(), getStartupProjectContext, config.version);
     }
     /**
      * Starts the MCP server.
@@ -80,12 +80,14 @@ export class ByteRoverMcpServer {
         this.log(`Connected to brv instance at ${result.projectRoot}`);
         this.log(`Client ID: ${result.client.getClientId()}`);
         this.log(`Initial connection state: ${result.client.getState()}`);
+        this.logDaemonVersionDrift(result.client.getDaemonVersion?.());
         // Auto-reconnect on disconnect (shared logic from brv-transport-client)
         this.reconnectorHandle = createDaemonReconnector(result.client, {
             connectOptions: this.connectOptions,
             onReconnected: (newClient) => {
                 this.client = newClient;
                 this.log(`Reconnected successfully! Client ID: ${newClient.getClientId()}`);
+                this.logDaemonVersionDrift(newClient.getDaemonVersion?.());
                 this.sendAgentName();
             },
             onStateChange: (state) => {
@@ -157,6 +159,16 @@ export class ByteRoverMcpServer {
     log(msg) {
         process.stderr.write(`[brv-mcp] ${msg}\n`);
     }
+    /**
+     * Logs a one-line drift notice when the running daemon's version differs
+     * from this MCP's. Helps users notice an out-of-sync IDE without forcing
+     * a reconnect — the protocol is backward-compatible across the gap.
+     */
+    logDaemonVersionDrift(daemonVersion) {
+        if (daemonVersion && !versionsAreEquivalent(this.config.version, daemonVersion)) {
+            this.log(`connected to daemon ${daemonVersion}; this MCP is ${this.config.version} (backward-compatible protocol)`);
+        }
+    }
     /**
      * Sends the cached agent name to the daemon (fire-and-forget).
      * Called after MCP initialize handshake and on Socket.IO reconnection.

package/dist/server/infra/mcp/tools/brv-curate-tool.d.ts

@@ -27,4 +27,4 @@ export declare const BrvCurateInputSchema: z.ZodObject<{
  * Uses fire-and-forget pattern: returns immediately after queueing the task.
  * The curation is processed asynchronously by the ByteRover agent.
  */
-export declare function registerBrvCurateTool(server: McpServer, getClient: () => ITransportClient | undefined, getWorkingDirectory: () => string | undefined, getStartupProjectContext: () => McpStartupProjectContext | undefined): void;
+export declare function registerBrvCurateTool(server: McpServer, getClient: () => ITransportClient | undefined, getWorkingDirectory: () => string | undefined, getStartupProjectContext: () => McpStartupProjectContext | undefined, clientVersion: string): void;

package/dist/server/infra/mcp/tools/brv-curate-tool.js

@@ -2,6 +2,7 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
+import { appendDriftFooter } from './drift-footer.js';
 import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
 import { cwdField } from './shared-schema.js';
@@ -30,7 +31,7 @@ export const BrvCurateInputSchema = z.object({
  * Uses fire-and-forget pattern: returns immediately after queueing the task.
  * The curation is processed asynchronously by the ByteRover agent.
  */
-export function registerBrvCurateTool(server, getClient, getWorkingDirectory, getStartupProjectContext) {
+export function registerBrvCurateTool(server, getClient, getWorkingDirectory, getStartupProjectContext, clientVersion) {
     server.registerTool('brv-curate', {
         description: 'Store context to the ByteRover context tree. Save patterns, decisions, or insights. ' +
             'Curation is processed asynchronously — the tool returns immediately after queueing.',
@@ -92,10 +93,11 @@ export function registerBrvCurateTool(server, getClient, getWorkingDirectory, ge
             const logId = ack?.logId;
             const modeDescription = hasFolder ? 'folder pack' : 'curation';
             const logSuffix = logId ? `, logId: ${logId}` : '';
+            const queuedMessage = `✓ Context queued for ${modeDescription} (taskId: ${taskId}${logSuffix}). The curation will be processed asynchronously.`;
             return {
                 content: [
                     {
-                        text: `✓ Context queued for ${modeDescription} (taskId: ${taskId}${logSuffix}). The curation will be processed asynchronously.`,
+                        text: appendDriftFooter(queuedMessage, clientVersion, client.getDaemonVersion?.()),
                         type: 'text',
                     },
                 ],

package/dist/server/infra/mcp/tools/brv-query-tool.d.ts

@@ -18,4 +18,4 @@ export declare const BrvQueryInputSchema: z.ZodObject<{
  * This tool allows coding agents to query the ByteRover context tree
  * for patterns, decisions, implementation details, or any stored knowledge.
  */
-export declare function registerBrvQueryTool(server: McpServer, getClient: () => ITransportClient | undefined, getWorkingDirectory: () => string | undefined, getStartupProjectContext: () => McpStartupProjectContext | undefined): void;
+export declare function registerBrvQueryTool(server: McpServer, getClient: () => ITransportClient | undefined, getWorkingDirectory: () => string | undefined, getStartupProjectContext: () => McpStartupProjectContext | undefined, clientVersion: string): void;

package/dist/server/infra/mcp/tools/brv-query-tool.js

@@ -2,6 +2,7 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
+import { appendDriftFooter } from './drift-footer.js';
 import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
 import { cwdField } from './shared-schema.js';
@@ -16,7 +17,7 @@ export const BrvQueryInputSchema = z.object({
  * This tool allows coding agents to query the ByteRover context tree
  * for patterns, decisions, implementation details, or any stored knowledge.
  */
-export function registerBrvQueryTool(server, getClient, getWorkingDirectory, getStartupProjectContext) {
+export function registerBrvQueryTool(server, getClient, getWorkingDirectory, getStartupProjectContext, clientVersion) {
     server.registerTool('brv-query', {
         description: 'Query the ByteRover context tree for patterns, decisions, or implementation details.',
         inputSchema: BrvQueryInputSchema,
@@ -64,7 +65,7 @@ export function registerBrvQueryTool(server, getClient, getWorkingDirectory, get
             // Wait for the already-listening result promise
             const result = await resultPromise;
             return {
-                content: [{ text: result, type: 'text' }],
+                content: [{ text: appendDriftFooter(result, clientVersion, client.getDaemonVersion?.()), type: 'text' }],
             };
         }
         catch (error) {

package/dist/server/infra/mcp/tools/drift-footer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Appends a version-drift footer to MCP tool text responses when the MCP
+ * client and the running daemon are at different versions.
+ *
+ * Returns the body unchanged when versions match or when the daemon hasn't
+ * reported its version yet (pre-fix daemon during a rolling upgrade).
+ */
+export declare function appendDriftFooter(body: string, clientVersion: string, daemonVersion?: string): string;

package/dist/server/infra/mcp/tools/drift-footer.js

@@ -0,0 +1,16 @@
+import { versionsAreEquivalent } from '@campfirein/brv-transport-client';
+/**
+ * Appends a version-drift footer to MCP tool text responses when the MCP
+ * client and the running daemon are at different versions.
+ *
+ * Returns the body unchanged when versions match or when the daemon hasn't
+ * reported its version yet (pre-fix daemon during a rolling upgrade).
+ */
+export function appendDriftFooter(body, clientVersion, daemonVersion) {
+    if (!daemonVersion || versionsAreEquivalent(clientVersion, daemonVersion)) {
+        return body;
+    }
+    return (body +
+        `\n\n---\nNote: this brv MCP is at ${clientVersion} while the running daemon is at ${daemonVersion}. ` +
+        `The protocol is backward-compatible. Restart your IDE to align versions.`);
+}

package/dist/server/infra/process/connection-coordinator.d.ts

@@ -18,6 +18,12 @@ import type { TaskRouter } from './task-router.js';
 type ConnectionCoordinatorOptions = {
     agentPool?: IAgentPool;
     clientManager?: IClientManager;
+    /**
+     * Daemon version surfaced in `client:register` ack. Lets clients render
+     * drift indicators without a separate round-trip. Optional so older
+     * deployments still build.
+     */
+    daemonVersion?: string;
     projectRegistry?: IProjectRegistry;
     projectRouter?: IProjectRouter;
     taskRouter: TaskRouter;
@@ -31,6 +37,7 @@ export declare class ConnectionCoordinator {
     private agentClients;
     private readonly agentPool;
     private readonly clientManager;
+    private readonly daemonVersion;
     private readonly projectRegistry;
     private readonly projectRouter;
     private readonly taskRouter;

package/dist/server/infra/process/connection-coordinator.js

@@ -24,6 +24,7 @@ export class ConnectionCoordinator {
     agentClients = new Map();
     agentPool;
     clientManager;
+    daemonVersion;
     projectRegistry;
     projectRouter;
     taskRouter;
@@ -32,6 +33,7 @@ export class ConnectionCoordinator {
         this.transport = options.transport;
         this.agentPool = options.agentPool;
         this.clientManager = options.clientManager;
+        this.daemonVersion = options.daemonVersion;
         this.projectRouter = options.projectRouter;
         this.projectRegistry = options.projectRegistry;
         this.taskRouter = options.taskRouter;
@@ -189,6 +191,9 @@ export class ConnectionCoordinator {
         if (data.projectPath) {
             this.addToProjectRoom(clientId, data.projectPath);
         }
+        if (this.daemonVersion) {
+            return { daemonVersion: this.daemonVersion, success: true };
+        }
         return { success: true };
     }
     handleClientUpdateAgentName(clientId, data) {

package/dist/server/infra/process/query-log-handler.d.ts

@@ -25,6 +25,12 @@ export declare class QueryLogHandler implements ITaskLifecycleHook {
     private readonly tasks;
     constructor(createStore?: ((projectPath: string) => IQueryLogStore) | undefined);
     cleanup(taskId: string): void;
+    /**
+     * Expose query metadata via the lifecycle-hook contract so TaskRouter can merge it into
+     * the task:completed payload sent to the originating client. Returning {} when no metadata
+     * is available keeps the merge a no-op and lets the daemon emit task:completed unchanged.
+     */
+    getTaskCompletionData(taskId: string): Record<string, unknown>;
     onTaskCancelled(taskId: string, _task: TaskInfo): Promise<void>;
     onTaskCompleted(taskId: string, result: string, _task: TaskInfo): Promise<void>;
     onTaskCreate(task: TaskInfo): Promise<void | {

package/dist/server/infra/process/query-log-handler.js

@@ -39,6 +39,29 @@ export class QueryLogHandler {
             }
         }
     }
+    /**
+     * Expose query metadata via the lifecycle-hook contract so TaskRouter can merge it into
+     * the task:completed payload sent to the originating client. Returning {} when no metadata
+     * is available keeps the merge a no-op and lets the daemon emit task:completed unchanged.
+     */
+    getTaskCompletionData(taskId) {
+        const state = this.tasks.get(taskId);
+        if (!state?.queryResult)
+            return {};
+        // Flatten the QueryExecutorResult's nested shape onto the task:completed payload so
+        // it matches the public RecallResult contract (flat `durationMs` / `topScore`).
+        // `timing` is always populated by every QueryExecutor branch, so no guard.
+        // `searchMetadata` is omitted on cache hits (Tier 0/1), so guard before extracting.
+        const out = {
+            durationMs: state.queryResult.timing.durationMs,
+            matchedDocs: state.queryResult.matchedDocs,
+            tier: state.queryResult.tier,
+        };
+        if (state.queryResult.searchMetadata !== undefined) {
+            out.topScore = state.queryResult.searchMetadata.topScore;
+        }
+        return out;
+    }
     async onTaskCancelled(taskId, _task) {
         const state = this.tasks.get(taskId);
         if (!state)

package/dist/server/infra/process/transport-handlers.d.ts

@@ -38,6 +38,11 @@ export type { TaskInfo } from './types.js';
 type TransportHandlersOptions = {
     agentPool?: IAgentPool;
     clientManager?: IClientManager;
+    /**
+     * Daemon's CLI version (read from package.json at startup). Surfaced in the
+     * `client:register` ack so clients can render version-drift indicators.
+     */
+    daemonVersion?: string;
     /** Resolves project's review-disabled flag at task-create. Snapshotted once into TaskInfo + TaskExecute. */
     isReviewDisabled?: IsReviewDisabledResolver;
     /** Lifecycle hooks for task events (e.g. CurateLogHandler). */

package/dist/server/infra/process/transport-handlers.js

@@ -52,6 +52,7 @@ export class TransportHandlers {
         this.connectionCoordinator = new ConnectionCoordinator({
             agentPool: options.agentPool,
             clientManager: options.clientManager,
+            daemonVersion: options.daemonVersion,
             projectRegistry: options.projectRegistry,
             projectRouter: options.projectRouter,
             taskRouter: this.taskRouter,

package/dist/tui/components/header.js

@@ -7,10 +7,16 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * - Connected agent status
  * - Queue stats (pending/processing)
  */
+import { versionsAreEquivalent } from '@campfirein/brv-transport-client';
 import { Box } from 'ink';
 import { useTransportStore } from '../stores/transport-store.js';
 import { Logo } from './logo.js';
 export const Header = ({ compact }) => {
     const version = useTransportStore((s) => s.version);
-    return (_jsx(Box, { flexDirection: "column", marginBottom: 1, width: "100%", children: _jsx(Logo, { compact: compact, version: version }) }));
+    const daemonVersion = useTransportStore((s) => s.daemonVersion);
+    // Drift indicator surfaces when this brv build connects to a daemon spawned
+    // by a different build. Rendered inline by Logo so the banner stays a single
+    // line; hidden when versions match or the daemon is too old to advertise.
+    const isOutdated = daemonVersion !== undefined && !versionsAreEquivalent(version, daemonVersion);
+    return (_jsx(Box, { flexDirection: "column", marginBottom: 1, width: "100%", children: _jsx(Logo, { compact: compact, driftDaemonVersion: isOutdated ? daemonVersion : undefined, version: version }) }));
 };

package/dist/tui/components/logo.d.ts

@@ -25,6 +25,12 @@ interface LogoProps {
      * Compact mode, only show text logo
      */
     compact?: boolean;
+    /**
+     * Daemon version to surface inline as a drift indicator. Pass undefined when
+     * the local CLI and the running daemon agree on version (or the daemon is
+     * too old to advertise its version) so the indicator stays hidden.
+     */
+    driftDaemonVersion?: string;
     /**
      * Optional version to display
      */

package/dist/tui/components/logo.js

@@ -80,7 +80,7 @@ function getLogoLines(variant, terminalWidth) {
  *
  * Automatically selects the best logo variant based on terminal dimensions.
  */
-export const Logo = ({ compact, version }) => {
+export const Logo = ({ compact, driftDaemonVersion, version }) => {
     const { stdout } = useStdout();
     const { theme: { colors }, } = useTheme();
     const isLatestVersion = useIsLatestVersion(version ?? '');
@@ -88,15 +88,28 @@ export const Logo = ({ compact, version }) => {
     const terminalHeight = stdout?.rows ?? 24;
     const variant = useMemo(() => (compact ? 'text' : selectLogoVariant(terminalWidth, terminalHeight)), [compact, terminalWidth, terminalHeight]);
     const logoLines = useMemo(() => getLogoLines(variant, terminalWidth), [variant, terminalWidth]);
-    const headerLine = useMemo(() => (variant === 'full' && LOGO_FULL[0] ? getHeaderLine(LOGO_FULL[0], version ?? '', terminalWidth) : null), [variant, version, terminalWidth]);
+    // Inline drift token, e.g. " [outdated, daemon v3.99.0]". Empty when the
+    // header has no daemon-version drift to surface — keeps the banner length
+    // calculation symmetric with the no-drift case.
+    const driftText = driftDaemonVersion ? ` [outdated, daemon v${driftDaemonVersion}]` : '';
+    const headerLine = useMemo(() => {
+        if (variant !== 'full' || !LOGO_FULL[0])
+            return null;
+        const base = getHeaderLine(LOGO_FULL[0], version ?? '', terminalWidth);
+        if (!driftText)
+            return base;
+        // Re-pad so the trailing `/////` fills the row after the drift token.
+        const contentLength = base.brv.length + base.spaces.length + base.version.length + driftText.length;
+        return { ...base, padEnd: calculatePadEnd(contentLength, terminalWidth) };
+    }, [variant, version, terminalWidth, driftText]);
     // Text-only logo for minimal terminals
     if (variant === 'text') {
-        const textContent = MINI_LOGO + (version ? ` v${version}` : '') + (isLatestVersion ? ' (latest)' : '');
+        const textContent = MINI_LOGO + (version ? ` v${version}` : '') + (isLatestVersion ? ' (latest)' : '') + driftText;
         const padEnd = calculatePadEnd(textContent.length, terminalWidth);
-        return (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: PAD_START }), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: colors.primary, children: MINI_LOGO }), version && _jsxs(Text, { color: colors.primary, children: [" v", version] }), isLatestVersion && _jsx(Text, { color: colors.primary, children: " (latest)" })] }), _jsx(Text, { color: colors.primary, children: padEnd })] }));
+        return (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: PAD_START }), _jsxs(Text, { children: [_jsx(Text, { bold: true, color: colors.primary, children: MINI_LOGO }), version && _jsxs(Text, { color: colors.primary, children: [" v", version] }), isLatestVersion && _jsx(Text, { color: colors.primary, children: " (latest)" }), driftText && _jsx(Text, { color: colors.warning, children: driftText })] }), _jsx(Text, { color: colors.primary, children: padEnd })] }));
     }
     // ASCII logo with header line and version
-    return (_jsxs(Box, { flexDirection: "column", children: [headerLine && (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: headerLine.padStart }), _jsxs(Text, { children: [_jsx(Text, { children: headerLine.brv }), _jsx(Text, { children: headerLine.spaces }), _jsx(Text, { color: colors.primary, children: headerLine.version })] }), _jsx(Text, { color: colors.primary, children: headerLine.padEnd })] })), logoLines.map((line, index) => (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: line.padStart }), _jsx(Text, { color: colors.primary, children: line.content }), _jsx(Text, { color: colors.primary, children: line.padEnd })] }, index)))] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [headerLine && (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: headerLine.padStart }), _jsxs(Text, { children: [_jsx(Text, { children: headerLine.brv }), _jsx(Text, { children: headerLine.spaces }), _jsx(Text, { color: colors.primary, children: headerLine.version }), driftText && _jsx(Text, { color: colors.warning, children: driftText })] }), _jsx(Text, { color: colors.primary, children: headerLine.padEnd })] })), logoLines.map((line, index) => (_jsxs(Box, { children: [_jsx(Text, { color: colors.primary, children: line.padStart }), _jsx(Text, { color: colors.primary, children: line.content }), _jsx(Text, { color: colors.primary, children: line.padEnd })] }, index)))] }));
 };
 /**
  * Export utilities for external use

package/dist/tui/features/transport/components/transport-initializer.js

@@ -14,7 +14,7 @@ import { getAllEventValues } from '../../../../shared/transport/events/index.js'
 import { initTransportLog, logTransportEvent } from '../../../lib/transport-logger.js';
 import { useTransportStore } from '../../../stores/transport-store.js';
 export function TransportInitializer({ children }) {
-    const { incrementReconnectCount, setClient, setConnectionState, setError } = useTransportStore();
+    const { incrementReconnectCount, setClient, setConnectionState, setDaemonVersion, setError } = useTransportStore();
     useEffect(() => {
         let mounted = true;
         let reconnectorHandle;
@@ -87,6 +87,9 @@ export function TransportInitializer({ children }) {
                 logTransportEvent('_connection', { clientId: newClient.getClientId(), state: 'initialized' });
                 // Set client in store (this also creates apiClient)
                 setClient(newClient);
+                // Capture daemon version from register ack so the header can render
+                // a drift indicator when the daemon was started by a different brv build.
+                setDaemonVersion(newClient.getDaemonVersion?.());
                 // Auto-reconnect on disconnect (shared logic from brv-transport-client)
                 reconnectorHandle = createDaemonReconnector(newClient, {
                     connectOptions,
@@ -95,6 +98,9 @@ export function TransportInitializer({ children }) {
                             return;
                         registerEventHandlers(reconnectedClient);
                         setClient(reconnectedClient);
+                        // Refresh on reconnect — the daemon may have been replaced by a
+                        // peer client at a different version.
+                        setDaemonVersion(reconnectedClient.getDaemonVersion?.());
                         logTransportEvent('_reconnect', { clientId: reconnectedClient.getClientId(), state: 'success' });
                     },
                     onStateChange(state, client) {
@@ -137,6 +143,6 @@ export function TransportInitializer({ children }) {
                 });
             }
         };
-    }, [incrementReconnectCount, setClient, setConnectionState, setError]);
+    }, [incrementReconnectCount, setClient, setConnectionState, setDaemonVersion, setError]);
     return _jsx(_Fragment, { children: children });
 }

package/dist/tui/stores/transport-store.d.ts

@@ -14,6 +14,12 @@ export interface TransportState {
     client: ITransportClient | null;
     /** Current connection state */
     connectionState: ConnectionState;
+    /**
+     * Daemon version reported in the most recent client:register ack.
+     * Undefined when the daemon is too old to advertise its version.
+     * Drives the version-drift indicator in the TUI header.
+     */
+    daemonVersion: string | undefined;
     /** Connection error if any */
     error: Error | null;
     /** Whether the client is connected */
@@ -36,6 +42,8 @@ export interface TransportActions {
     setClient: (client: ITransportClient) => void;
     /** Update connection state */
     setConnectionState: (state: ConnectionState) => void;
+    /** Set or clear the daemon version (called after every connect / reconnect) */
+    setDaemonVersion: (daemonVersion: string | undefined) => void;
     /** Set connection error */
     setError: (error: Error | null) => void;
     /** Set resolved project info from oclif main */