byterover-cli 3.1.0 → 3.3.0

package/dist/oclif/commands/source/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class Source extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/source/index.js

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Source extends Command {
+    static description = 'Manage knowledge sources (read-only references to other projects)';
+    static examples = ['<%= config.bin %> <%= command.id %> --help'];
+    async run() {
+        await this.config.runCommand('help', ['source']);
+    }
+}

package/dist/oclif/commands/source/list.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class SourceList extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/source/list.js

@@ -0,0 +1,32 @@
+import { Command } from '@oclif/core';
+import chalk from 'chalk';
+import { SourceEvents } from '../../../shared/transport/events/source-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class SourceList extends Command {
+    static description = 'List all knowledge sources and their status';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    async run() {
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(SourceEvents.LIST), { projectPath: process.cwd() });
+            if (result.error) {
+                this.error(result.error, { exit: 1 });
+            }
+            if (result.statuses.length === 0) {
+                this.log('No knowledge sources configured.');
+                return;
+            }
+            this.log('Knowledge Sources:');
+            for (const source of result.statuses) {
+                if (source.valid) {
+                    this.log(`   ${source.alias} → ${source.projectRoot} ${chalk.green('(valid)')}`);
+                }
+                else {
+                    this.log(`   ${source.alias} → ${source.projectRoot} ${chalk.red(`[BROKEN - run brv source remove ${source.alias}]`)}`);
+                }
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error), { exit: 1 });
+        }
+    }
+}

package/dist/oclif/commands/source/remove.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class SourceRemove extends Command {
+    static args: {
+        aliasOrPath: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/source/remove.js

@@ -0,0 +1,33 @@
+import { Args, Command } from '@oclif/core';
+import { SourceEvents } from '../../../shared/transport/events/source-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class SourceRemove extends Command {
+    static args = {
+        aliasOrPath: Args.string({
+            description: 'Alias or path of the knowledge source to remove',
+            required: true,
+        }),
+    };
+    static description = 'Remove a knowledge source';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> shared-lib',
+        '<%= config.bin %> <%= command.id %> /path/to/shared-lib',
+    ];
+    async run() {
+        const { args } = await this.parse(SourceRemove);
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(SourceEvents.REMOVE, {
+                aliasOrPath: args.aliasOrPath,
+            }), { projectPath: process.cwd() });
+            if (result.success) {
+                this.log(result.message);
+            }
+            else {
+                this.error(result.message, { exit: 1 });
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error), { exit: 1 });
+        }
+    }
+}

package/dist/oclif/commands/status.d.ts

@@ -6,8 +6,12 @@ export default class Status extends Command {
     static examples: string[];
     static flags: {
         format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'project-root': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    protected fetchStatus(options?: DaemonClientOptions): Promise<StatusDTO>;
+    protected fetchStatus(options?: DaemonClientOptions & {
+        projectRootFlag?: string;
+    }): Promise<StatusDTO>;
     run(): Promise<void>;
     private formatTextOutput;
     private logVcHint;

package/dist/oclif/commands/status.js

@@ -1,6 +1,6 @@
 import { Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
-import { StatusEvents } from '../../shared/transport/events/status-events.js';
+import { StatusEvents, } from '../../shared/transport/events/status-events.js';
 import { formatConnectionError, withDaemonRetry } from '../lib/daemon-client.js';
 import { writeJsonResponse } from '../lib/json-response.js';
 export default class Status extends Command {
@@ -13,18 +13,29 @@ export default class Status extends Command {
             description: 'Output format',
             options: ['text', 'json'],
         }),
+        'project-root': Flags.string({
+            description: 'Explicit project root path (overrides auto-detection)',
+            required: false,
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            default: false,
+            description: 'Show resolution source and diagnostic info',
+        }),
     };
     async fetchStatus(options) {
+        const request = { cwd: process.cwd(), projectRootFlag: options?.projectRootFlag };
         return withDaemonRetry(async (client) => {
-            const response = await client.requestWithAck(StatusEvents.GET);
+            const response = await client.requestWithAck(StatusEvents.GET, request);
             return response.status;
         }, options);
     }
     async run() {
         const { flags } = await this.parse(Status);
+        const projectRootFlag = flags['project-root'];
         const isJson = flags.format === 'json';
         try {
-            const status = await this.fetchStatus({ projectPath: process.cwd() });
+            const status = await this.fetchStatus({ projectPath: process.cwd(), projectRootFlag });
             if (isJson) {
                 writeJsonResponse({
                     command: 'status',
@@ -33,7 +44,7 @@ export default class Status extends Command {
                 });
             }
             else {
-                this.formatTextOutput(status);
+                this.formatTextOutput(status, flags.verbose);
                 this.logVcHint();
             }
         }
@@ -51,7 +62,7 @@ export default class Status extends Command {
             }
         }
     }
-    formatTextOutput(status) {
+    formatTextOutput(status, verbose = false) {
         this.log(`CLI Version: ${this.config.version}`);
         // Auth status (cloud sync only — not required for local usage)
         switch (status.authStatus) {
@@ -71,7 +82,31 @@ export default class Status extends Command {
                 this.log('Account: Unable to check');
             }
         }
-        this.log(`Current Directory: ${status.currentDirectory}`);
+        this.log(`Project: ${status.projectRoot ?? status.currentDirectory}`);
+        if (status.worktreeRoot && status.worktreeRoot !== status.projectRoot) {
+            this.log(`Worktree: ${status.worktreeRoot} (linked)`);
+        }
+        if (status.resolverError) {
+            this.log(chalk.yellow(`⚠ ${status.resolverError}`));
+        }
+        if (verbose && status.resolutionSource) {
+            this.log(`Resolution: ${status.resolutionSource}`);
+        }
+        // Knowledge sources
+        if (status.sourcesError) {
+            this.log(chalk.yellow(`⚠ ${status.sourcesError}`));
+        }
+        else if (status.sources && status.sources.length > 0) {
+            this.log('Knowledge Sources:');
+            for (const source of status.sources) {
+                if (source.valid) {
+                    this.log(`   ${source.alias} → ${source.projectRoot} ${chalk.green('(valid)')}`);
+                }
+                else {
+                    this.log(`   ${source.alias} → ${source.projectRoot} ${chalk.red(`[BROKEN - run brv source remove ${source.alias}]`)}`);
+                }
+            }
+        }
         // Space
         if (status.teamName && status.spaceName) {
             this.log(`Space: ${status.teamName}/${status.spaceName}`);
@@ -104,6 +139,10 @@ export default class Status extends Command {
                 this.log('Context Tree: No changes');
                 break;
             }
+            case 'no_vc': {
+                this.log('Context Tree: Managed by Byterover version control (use brv vc commands)');
+                break;
+            }
             case 'not_initialized': {
                 this.log('Context Tree: Not initialized');
                 break;

package/dist/oclif/commands/worktree/add.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+export default class WorktreeAdd extends Command {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/oclif/commands/worktree/add.js

@@ -0,0 +1,44 @@
+import { Args, Command, Flags } from '@oclif/core';
+import { resolve } from 'node:path';
+import { WorktreeEvents } from '../../../shared/transport/events/worktree-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class WorktreeAdd extends Command {
+    static args = {
+        path: Args.string({
+            description: 'Path to the directory to register as a worktree (relative or absolute)',
+            required: false,
+        }),
+    };
+    static description = 'Register a directory as a worktree of this project';
+    static examples = [
+        '<%= config.bin %> <%= command.id %> packages/api',
+        '<%= config.bin %> <%= command.id %> ../other-checkout',
+        '<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)',
+    ];
+    static flags = {
+        force: Flags.boolean({
+            default: false,
+            description: 'Replace existing .brv/ directory in target with a worktree pointer',
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(WorktreeAdd);
+        const cwd = resolve(process.cwd());
+        const worktreePath = args.path ? resolve(args.path) : cwd;
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(WorktreeEvents.ADD, {
+                force: flags.force,
+                worktreePath,
+            }), { projectPath: cwd });
+            if (result.success) {
+                this.log(result.message);
+            }
+            else {
+                this.error(result.message, { exit: 1 });
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error), { exit: 1 });
+        }
+    }
+}

package/dist/oclif/commands/worktree/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class Worktree extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/worktree/index.js

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+export default class Worktree extends Command {
+    static description = 'Manage worktree links for subdirectories and sibling checkouts';
+    static examples = ['<%= config.bin %> <%= command.id %> --help'];
+    async run() {
+        await this.config.runCommand('help', ['worktree']);
+    }
+}

package/dist/oclif/commands/worktree/list.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class WorktreeList extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/worktree/list.js

@@ -0,0 +1,28 @@
+import { Command } from '@oclif/core';
+import { WorktreeEvents } from '../../../shared/transport/events/worktree-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class WorktreeList extends Command {
+    static description = 'Show the current worktree link and list all registered worktrees';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    async run() {
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(WorktreeEvents.LIST), { projectPath: process.cwd() });
+            if (result.source === 'linked') {
+                this.log(`Worktree: ${result.worktreeRoot}`);
+                this.log(`Linked to: ${result.projectRoot}`);
+            }
+            else {
+                this.log(`Project: ${result.projectRoot}`);
+            }
+            if (result.worktrees.length > 0) {
+                this.log('\nRegistered worktrees:');
+                for (const wt of result.worktrees) {
+                    this.log(`   ${wt.name} → ${wt.worktreePath}`);
+                }
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error), { exit: 1 });
+        }
+    }
+}

package/dist/oclif/commands/worktree/remove.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@oclif/core';
+export default class WorktreeRemove extends Command {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/oclif/commands/worktree/remove.js

@@ -0,0 +1,35 @@
+import { Args, Command } from '@oclif/core';
+import { resolve } from 'node:path';
+import { WorktreeEvents } from '../../../shared/transport/events/worktree-events.js';
+import { formatConnectionError, withDaemonRetry } from '../../lib/daemon-client.js';
+export default class WorktreeRemove extends Command {
+    static args = {
+        path: Args.string({
+            description: 'Path to the worktree to remove (defaults to cwd)',
+            required: false,
+        }),
+    };
+    static description = 'Remove a worktree registration and its .brv pointer';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>  (remove cwd as worktree)',
+        '<%= config.bin %> <%= command.id %> packages/api  (remove from parent)',
+    ];
+    async run() {
+        const { args } = await this.parse(WorktreeRemove);
+        const targetPath = args.path ? resolve(args.path) : resolve(process.cwd());
+        try {
+            const result = await withDaemonRetry(async (client) => client.requestWithAck(WorktreeEvents.REMOVE, {
+                worktreePath: targetPath,
+            }), { projectPath: process.cwd() });
+            if (result.success) {
+                this.log(result.message);
+            }
+            else {
+                this.error(result.message, { exit: 1 });
+            }
+        }
+        catch (error) {
+            this.error(formatConnectionError(error), { exit: 1 });
+        }
+    }
+}

package/dist/oclif/hooks/init/validate-brv-config.js

@@ -2,6 +2,7 @@ import { BRV_CONFIG_VERSION } from '../../../server/constants.js';
 import { ensureProjectInitialized } from '../../../server/infra/config/auto-init.js';
 import { ProjectConfigStore } from '../../../server/infra/config/file-config-store.js';
 import { FileContextTreeService } from '../../../server/infra/context-tree/file-context-tree-service.js';
+import { isWorktreePointer } from '../../../server/infra/project/resolve-project.js';
 import { syncConfigToXdg } from '../../../server/utils/config-xdg-sync.js';
 /**
  * Commands that should skip auto-init and config version validation.
@@ -22,6 +23,9 @@ const HELP_FLAGS = new Set(['--h', '--help', '-h', '-help']);
 export const validateBrvConfigVersion = async (commandId, configStore, argv = [], autoInitDeps) => {
     if (argv.some((arg) => HELP_FLAGS.has(arg)))
         return;
+    // Skip auto-init if .brv is a pointer file (worktree) — the project lives elsewhere
+    if (isWorktreePointer(process.cwd()))
+        return;
     const exists = await configStore.exists();
     if (!exists && COMMANDS_NEED_AUTO_INIT.has(commandId)) {
         const deps = autoInitDeps ?? {

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

@@ -5,6 +5,8 @@ export interface DaemonClientOptions {
     maxRetries?: number;
     /** Explicit project path — bypasses walk-up discovery. Use for `init` where .brv/ doesn't exist yet. */
     projectPath?: string;
+    /** Explicit --project-root flag value to override auto-detection */
+    projectRootFlag?: string;
     /** Delay between retries in ms. Default: 2000. Set to 0 in tests. */
     retryDelayMs?: number;
     /** Optional transport connector for DI/testing */
@@ -13,14 +15,14 @@ export interface DaemonClientOptions {
 /**
  * Connects to the daemon, auto-starting it if needed.
  */
-export declare function connectToDaemonClient(options?: Pick<DaemonClientOptions, 'transportConnector'>): Promise<ConnectionResult>;
+export declare function connectToDaemonClient(options?: Pick<DaemonClientOptions, 'projectRootFlag' | 'transportConnector'>): Promise<ConnectionResult>;
 /**
  * Executes an operation against the daemon with retry logic.
  *
  * Retries on infrastructure failures (daemon spawn timeout, connection dropped,
  * agent disconnected). Does NOT retry on business errors (auth, validation, etc.).
  */
-export declare function withDaemonRetry<T>(fn: (client: ITransportClient, projectRoot?: string) => Promise<T>, options?: DaemonClientOptions & {
+export declare function withDaemonRetry<T>(fn: (client: ITransportClient, projectRoot?: string, worktreeRoot?: string) => Promise<T>, options?: DaemonClientOptions & {
     /** Called before each retry with attempt number (1-indexed) */
     onRetry?: (attempt: number, maxRetries: number) => void;
 }): Promise<T>;

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

@@ -1,5 +1,6 @@
 import { ConnectionError, ConnectionFailedError, DaemonSpawnError, InstanceCrashedError, NoInstanceRunningError, TransportRequestError, TransportRequestTimeoutError, } from '@campfirein/brv-transport-client';
 import { TaskErrorCode } from '../../server/core/domain/errors/task-error.js';
+import { resolveProject } from '../../server/infra/project/resolve-project.js';
 import { createDaemonAwareConnector } from '../../server/infra/transport/transport-connector.js';
 import { getSandboxEnvironmentName, isSandboxEnvironment, isSandboxNetworkError, } from '../../server/utils/sandbox-detector.js';
 import { VcErrorCode } from '../../shared/transport/events/vc-events.js';
@@ -17,7 +18,6 @@ const USER_FRIENDLY_MESSAGES = {
     [TaskErrorCode.OAUTH_TOKEN_EXPIRED]: 'OAuth token has expired. Run "brv providers connect <provider> --oauth" to reconnect.',
     [TaskErrorCode.PROJECT_NOT_INIT]: 'Project not initialized. Run "brv restart" to reinitialize.',
     [TaskErrorCode.PROVIDER_NOT_CONFIGURED]: 'No provider connected. Run "brv providers connect byterover" to use the free built-in provider, or connect another provider.',
-    [TaskErrorCode.SPACE_NOT_CONFIGURED]: 'No space configured. Run "brv space list" to see available spaces, then "brv space switch --team <team> --name <space>" to select one.',
     [TaskErrorCode.SPACE_NOT_FOUND]: 'Space not found. Check your configuration.',
     [TaskErrorCode.VC_GIT_INITIALIZED]: 'ByteRover version control is active. Use brv vc commands instead of legacy sync commands.',
     [VcErrorCode.AUTH_FAILED]: 'Authentication failed. Run brv login.',
@@ -34,12 +34,22 @@ const USER_FRIENDLY_MESSAGES = {
     // UNCOMMITTED_CHANGES intentionally omitted: fall through to server's detailed message with file paths
     // USER_NOT_CONFIGURED intentionally omitted: fall through to server's specific hint with actual values
 };
+function resolveRequiredProjectPath(projectRootFlag) {
+    const resolution = resolveProject({ projectRootFlag });
+    if (!resolution) {
+        // No .brv found at cwd — fall back to cwd. The daemon will auto-init .brv/ on first connection.
+        const cwd = process.cwd();
+        return { projectRoot: cwd, worktreeRoot: cwd };
+    }
+    return resolution;
+}
 /**
  * Connects to the daemon, auto-starting it if needed.
  */
 export async function connectToDaemonClient(options) {
     const connector = options?.transportConnector ?? createDaemonAwareConnector();
-    return connector();
+    const resolution = resolveRequiredProjectPath(options?.projectRootFlag);
+    return connector(undefined, resolution.projectRoot);
 }
 /**
  * Executes an operation against the daemon with retry logic.
@@ -51,14 +61,19 @@ export async function withDaemonRetry(fn, options) {
     const maxRetries = options?.maxRetries ?? MAX_RETRIES;
     const retryDelayMs = options?.retryDelayMs ?? DEFAULT_RETRY_DELAY_MS;
     const connector = options?.transportConnector ?? createDaemonAwareConnector(options?.projectPath);
+    // Pre-resolve project (workspace-link-aware) so the connector registers
+    // with the correct projectPath and callers get the resolved worktreeRoot.
+    const resolution = resolveRequiredProjectPath(options?.projectRootFlag);
+    const resolvedProjectPath = resolution.projectRoot;
+    const resolvedWorkspaceRoot = resolution.worktreeRoot;
     let lastError;
     /* eslint-disable no-await-in-loop -- intentional sequential retry loop */
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
         let client;
         try {
-            const { client: connectedClient, projectRoot } = await connector();
+            const { client: connectedClient, projectRoot } = await connector(undefined, resolvedProjectPath);
             client = connectedClient;
-            const value = await fn(client, projectRoot);
+            const value = await fn(client, projectRoot ?? resolvedProjectPath, resolvedWorkspaceRoot);
             await client.disconnect().catch(() => { });
             return value;
         }

package/dist/oclif/lib/search-format.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Text formatting for the `brv search` CLI command.
+ * Pure function — no oclif, transport, or daemon dependencies.
+ */
+import type { SearchKnowledgeResult } from '../../agent/infra/sandbox/tools-sdk.js';
+/**
+ * Format search results for terminal display.
+ * Returns an array of lines (without trailing newlines).
+ */
+export declare function formatSearchTextOutput(searchResult: SearchKnowledgeResult): string[];

package/dist/oclif/lib/search-format.js

@@ -0,0 +1,25 @@
+/**
+ * Text formatting for the `brv search` CLI command.
+ * Pure function — no oclif, transport, or daemon dependencies.
+ */
+/**
+ * Format search results for terminal display.
+ * Returns an array of lines (without trailing newlines).
+ */
+export function formatSearchTextOutput(searchResult) {
+    const lines = [];
+    if (searchResult.totalFound === 0) {
+        lines.push('', 'No results found.', '');
+        return lines;
+    }
+    const displayed = searchResult.results.length;
+    const total = searchResult.totalFound;
+    const countLabel = displayed < total ? `Showing ${displayed} of ${total} results` : `Found ${total} result${total === 1 ? '' : 's'}`;
+    lines.push('', `${countLabel}:`, '');
+    for (const [i, result] of searchResult.results.entries()) {
+        const scoreStr = (result.score * 100).toFixed(0);
+        const excerpt = result.excerpt && result.excerpt.length > 120 ? `${result.excerpt.slice(0, 117)}...` : result.excerpt;
+        lines.push(`  ${i + 1}. ${result.title} [${scoreStr}%]`, `     Path: ${result.path}`, ...(excerpt ? [`     ${excerpt}`] : []), ...(result.backlinkCount ? [`     Backlinks: ${result.backlinkCount}`] : []), '');
+    }
+    return lines;
+}

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

@@ -58,6 +58,12 @@ export interface WaitForTaskOptions {
     /** Timeout in ms (default: 5 minutes) */
     timeoutMs?: number;
 }
+/** Default timeout for task completion (seconds) — shared across curate/query commands. */
+export declare const DEFAULT_TIMEOUT_SECONDS = 300;
+/** Minimum --timeout value accepted from the CLI (seconds). */
+export declare const MIN_TIMEOUT_SECONDS = 10;
+/** Maximum --timeout value accepted from the CLI (seconds). */
+export declare const MAX_TIMEOUT_SECONDS = 3600;
 /**
  * Format tool call for CLI display (simplified version of TUI formatToolDisplay).
  */

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

@@ -4,8 +4,14 @@ import { ReviewEvents } from '../../shared/transport/events/review-events.js';
 import { writeJsonResponse } from './json-response.js';
 /** Grace period before treating 'reconnecting' as daemon death (ms) */
 const DISCONNECT_GRACE_MS = 10_000;
+/** Default timeout for task completion (seconds) — shared across curate/query commands. */
+export const DEFAULT_TIMEOUT_SECONDS = 300;
+/** Minimum --timeout value accepted from the CLI (seconds). */
+export const MIN_TIMEOUT_SECONDS = 10;
+/** Maximum --timeout value accepted from the CLI (seconds). */
+export const MAX_TIMEOUT_SECONDS = 3600;
 /** Default timeout for task completion (ms) */
-const DEFAULT_TIMEOUT_MS = 5 * 60 * 1000;
+const DEFAULT_TIMEOUT_MS = DEFAULT_TIMEOUT_SECONDS * 1000;
 /**
  * Format tool call for CLI display (simplified version of TUI formatToolDisplay).
  */
@@ -70,13 +76,14 @@ export function waitForTaskCompletion(options, log) {
             if (!completed) {
                 completed = true;
                 cleanup();
+                const timeoutMessage = `Task timed out after ${timeoutMs / 1000}s`;
                 if (isText) {
-                    reject(new Error('Task timed out after 5 minutes'));
+                    reject(new Error(timeoutMessage));
                 }
                 else {
                     writeJsonResponse({
                         command,
-                        data: { event: 'error', message: 'Task timed out after 5 minutes', status: 'error' },
+                        data: { event: 'error', message: timeoutMessage, status: 'error' },
                         success: false,
                     });
                     resolve();

package/dist/server/constants.d.ts

@@ -1,6 +1,12 @@
 export declare const BRV_DIR = ".brv";
 export declare const PROJECT_CONFIG_FILE = "config.json";
 export declare const BRV_CONFIG_VERSION = "0.0.1";
+export declare const WORKTREES_DIR = "worktrees";
+export declare const WORKTREE_LINK_METADATA = "link.json";
+export declare const SOURCES_FILE = "sources.json";
+export declare const SHARED_SOURCE_LOCAL_SCORE_BOOST = 0.1;
+export declare const MCP_ASSOCIATE_PROJECT_TIMEOUT_MS = 3000;
+export declare const MCP_ASSOCIATE_PROJECT_MAX_ATTEMPTS = 2;
 export declare const GLOBAL_CONFIG_DIR = "brv";
 export declare const GLOBAL_CONFIG_FILE = "config.json";
 export declare const GLOBAL_CONFIG_VERSION = "0.0.1";
@@ -61,4 +67,4 @@ export declare const MANIFEST_FILE = "_manifest.json";
 export declare const ARCHIVE_IMPORTANCE_THRESHOLD = 35;
 export declare const DEFAULT_GHOST_CUE_MAX_TOKENS = 220;
 /** .gitignore content for the context tree — ignore derived artifacts only */
-export declare const CONTEXT_TREE_GITIGNORE = "# Derived artifacts \u2014 do not track\n.gitignore\n.snapshot.json\n_manifest.json\n_index.md\n";
+export declare const CONTEXT_TREE_GITIGNORE = "# Derived artifacts \u2014 do not track\n.gitignore\n.snapshot.json\n_manifest.json\n_index.md\n*.abstract.md\n*.overview.md\n";

package/dist/server/constants.js

@@ -1,6 +1,14 @@
 export const BRV_DIR = '.brv';
 export const PROJECT_CONFIG_FILE = 'config.json';
 export const BRV_CONFIG_VERSION = '0.0.1';
+// Worktree linking (git-style: .brv is a file pointing to parent project)
+export const WORKTREES_DIR = 'worktrees';
+export const WORKTREE_LINK_METADATA = 'link.json';
+// Knowledge sources (read-only references to other projects)
+export const SOURCES_FILE = 'sources.json';
+export const SHARED_SOURCE_LOCAL_SCORE_BOOST = 0.1;
+export const MCP_ASSOCIATE_PROJECT_TIMEOUT_MS = 3000;
+export const MCP_ASSOCIATE_PROJECT_MAX_ATTEMPTS = 2;
 // Global config constants (user-level, stored in XDG config directory)
 export const GLOBAL_CONFIG_DIR = 'brv';
 export const GLOBAL_CONFIG_FILE = 'config.json';
@@ -86,4 +94,6 @@ export const CONTEXT_TREE_GITIGNORE = `# Derived artifacts — do not track
 .snapshot.json
 _manifest.json
 _index.md
+*.abstract.md
+*.overview.md
 `;

package/dist/server/core/domain/client/client-info.d.ts

@@ -78,5 +78,12 @@ export declare class ClientInfo {
      * Called after MCP initialize handshake provides clientInfo.
      */
     setAgentName(agentName: string): void;
+    /**
+     * Update this client's project path, even if already associated.
+     * Used for reassociation after worktree add/remove operations.
+     *
+     * @returns The previous project path (undefined if not previously associated)
+     */
+    updateProjectPath(projectPath: string): string | undefined;
 }
 export {};

package/dist/server/core/domain/client/client-info.js

@@ -84,4 +84,15 @@ export class ClientInfo {
     setAgentName(agentName) {
         this._agentName = agentName;
     }
+    /**
+     * Update this client's project path, even if already associated.
+     * Used for reassociation after worktree add/remove operations.
+     *
+     * @returns The previous project path (undefined if not previously associated)
+     */
+    updateProjectPath(projectPath) {
+        const oldPath = this._projectPath;
+        this._projectPath = projectPath;
+        return oldPath;
+    }
 }