byterover-cli 1.0.3 → 1.0.5

package/dist/utils/global-data-path.js

@@ -0,0 +1,32 @@
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { GLOBAL_DATA_DIR } from '../constants.js';
+/**
+ * Returns the global data directory path following XDG spec:
+ * - Linux: $XDG_DATA_HOME/brv (defaults to ~/.local/share/brv)
+ * - macOS: ~/.local/share/brv
+ * - Windows: %LOCALAPPDATA%/brv
+ *
+ * Use this for user data and secrets (not config files).
+ *
+ * @returns Absolute path to the global data directory
+ */
+export const getGlobalDataDir = () => {
+    const currentPlatform = platform();
+    if (currentPlatform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (localAppData !== undefined) {
+            return join(localAppData, GLOBAL_DATA_DIR);
+        }
+        return join(homedir(), 'AppData', 'Local', GLOBAL_DATA_DIR);
+    }
+    // Linux: respect XDG_DATA_HOME if set
+    if (currentPlatform === 'linux') {
+        const xdgDataHome = process.env.XDG_DATA_HOME;
+        if (xdgDataHome !== undefined) {
+            return join(xdgDataHome, GLOBAL_DATA_DIR);
+        }
+    }
+    // Linux (default) and macOS: use ~/.local/share/brv
+    return join(homedir(), '.local', 'share', GLOBAL_DATA_DIR);
+};

package/oclif.manifest.json

@@ -9,7 +9,7 @@
           "required": false
         }
       },
-      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
+      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood examples:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
       "examples": [
         "# Curate context - queues task for background processing",
         "<%= config.bin %> <%= command.id %> \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"",
@@ -75,7 +75,7 @@
           "required": true
         }
       },
-      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
+      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv\n\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
       "examples": [
         "# Ask questions about patterns, decisions, or implementation details",
         "<%= config.bin %> <%= command.id %> What are the coding standards?",
@@ -198,5 +198,5 @@
       ]
     }
   },
-  "version": "1.0.3"
+  "version": "1.0.5"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"

package/dist/config/context-tree-domains.d.ts

@@ -1,17 +0,0 @@
-/**
- * Domain configurations for the context tree structure.
- * Each domain represents a specific area of knowledge in the project.
- */
-export interface DomainConfig {
-    description: string;
-    name: string;
-}
-/**
- * Predefined domains that will be scaffolded during project initialization.
- */
-export declare const DEFAULT_CONTEXT_TREE_DOMAINS: DomainConfig[];
-/**
- * Alias for backward compatibility.
- * @deprecated Use DEFAULT_CONTEXT_TREE_DOMAINS instead
- */
-export declare const CONTEXT_TREE_DOMAINS: DomainConfig[];

package/dist/config/context-tree-domains.js

@@ -1,34 +0,0 @@
-/**
- * Predefined domains that will be scaffolded during project initialization.
- */
-export const DEFAULT_CONTEXT_TREE_DOMAINS = [
-    {
-        description: 'Ensure all code follows style guidelines and quality standards',
-        name: 'code_style',
-    },
-    {
-        description: 'UI libraries, themes, and design guidelines',
-        name: 'design',
-    },
-    {
-        description: 'Project structure, components, and related context',
-        name: 'structure',
-    },
-    {
-        description: 'Security and compliance information',
-        name: 'compliance',
-    },
-    {
-        description: 'Testing implementation context',
-        name: 'testing',
-    },
-    {
-        description: 'Bug fixing logic and procedures',
-        name: 'bug_fixes',
-    },
-];
-/**
- * Alias for backward compatibility.
- * @deprecated Use DEFAULT_CONTEXT_TREE_DOMAINS instead
- */
-export const CONTEXT_TREE_DOMAINS = DEFAULT_CONTEXT_TREE_DOMAINS;

package/dist/core/interfaces/cipher/i-agent-storage.d.ts

@@ -1,152 +0,0 @@
-import type { Execution, ExecutionStatus, ExecutionType, ToolCall, ToolCallInfo, ToolCallStatus, ToolCallUpdateOptions } from '../../domain/cipher/queue/types.js';
-/**
- * Interface for agent execution storage.
- *
- * Manages the execution queue, tool call tracking, and consumer locks.
- * Implementations can use different storage backends (SQLite, in-memory, etc.)
- */
-export interface IAgentStorage {
-    /**
-     * Acquire consumer lock (register this consumer).
-     * Only ONE consumer can run at a time.
-     * @param consumerId - Unique ID for this consumer
-     * @returns true if lock acquired, false if another consumer is already running
-     */
-    acquireConsumerLock(consumerId: string): boolean;
-    /**
-     * Add a tool call record.
-     * @returns tool call id
-     */
-    addToolCall(executionId: string, info: ToolCallInfo): string;
-    /**
-     * Cleanup old executions, keep only maxKeep most recent completed/failed.
-     * @returns number of deleted executions
-     */
-    cleanupOldExecutions(maxKeep?: number): number;
-    /**
-     * Cleanup orphaned executions (status='running') from previous session crash.
-     * @returns number of orphaned executions
-     */
-    cleanupOrphanedExecutions(): number;
-    /**
-     * Cleanup stale consumers and orphan their executions.
-     * @param timeoutMs - heartbeat timeout (default 30 seconds)
-     * @returns number of orphaned executions
-     */
-    cleanupStaleConsumers(timeoutMs?: number): number;
-    /**
-     * Close storage connection.
-     */
-    close(): void;
-    /**
-     * Create a new execution.
-     * @param type - 'curate' or 'query'
-     * @param input - content (curate) or query string (query)
-     * @returns execution id
-     */
-    createExecution(type: ExecutionType, input: string): string;
-    /**
-     * Dequeue multiple executions at once (atomic batch SELECT + UPDATE).
-     * @param limit - max number of executions to dequeue
-     * @param consumerId - ID of the consumer claiming these executions
-     * @returns array of executions (may be empty if queue is empty)
-     */
-    dequeueBatch(limit: number, consumerId?: string): Execution[];
-    /**
-     * Dequeue next queued execution (atomic SELECT + UPDATE).
-     * @param consumerId - ID of the consumer claiming this execution
-     * @returns execution or null if queue is empty
-     */
-    dequeueExecution(consumerId?: string): Execution | null;
-    /**
-     * Get execution by id.
-     */
-    getExecution(id: string): Execution | null;
-    /**
-     * Get executions updated since timestamp (for incremental polling).
-     */
-    getExecutionsSince(timestamp: number): Execution[];
-    /**
-     * Get execution with all its tool calls (for UI display).
-     */
-    getExecutionWithToolCalls(id: string): null | {
-        execution: Execution;
-        toolCalls: ToolCall[];
-    };
-    /**
-     * Get all queued executions.
-     */
-    getQueuedExecutions(): Execution[];
-    /**
-     * Get recent executions (for UI display).
-     */
-    getRecentExecutions(limit?: number): Execution[];
-    /**
-     * Get all running executions.
-     */
-    getRunningExecutions(): Execution[];
-    /**
-     * Get all executions belonging to a specific consumer session.
-     * Returns executions ordered by created_at ASC (oldest first, newest last).
-     * @param consumerId - The consumer ID to filter by
-     */
-    getSessionExecutions(consumerId: string): Execution[];
-    /**
-     * Get queue statistics (queries DB directly for accurate counts).
-     */
-    getStats(): {
-        completed: number;
-        failed: number;
-        queued: number;
-        running: number;
-        total: number;
-    };
-    /**
-     * Get all tool calls for an execution.
-     */
-    getToolCalls(executionId: string): ToolCall[];
-    /**
-     * Check if any consumer is currently active (has recent heartbeat).
-     * @param timeoutMs - heartbeat timeout (default 30 seconds)
-     */
-    hasActiveConsumer(timeoutMs?: number): boolean;
-    /**
-     * Check if a specific consumer lock exists in the database.
-     * Used by Consumer to verify its lock is still valid after DB reconnection.
-     */
-    hasConsumerLock(consumerId: string): boolean;
-    /**
-     * Initialize storage.
-     */
-    initialize(options?: {
-        cleanupOrphans?: boolean;
-    }): Promise<void>;
-    /** Whether the storage has been initialized */
-    readonly initialized: boolean;
-    /**
-     * Check if the DB file has been replaced (different inode).
-     * Returns true if DB needs reconnection.
-     */
-    isDbFileChanged(): boolean;
-    /**
-     * Reconnect to the database (close and reinitialize).
-     * Use when DB file has been replaced by another process (e.g., brv init).
-     */
-    reconnect(): Promise<void>;
-    /**
-     * Release consumer lock (unregister this consumer).
-     */
-    releaseConsumerLock(consumerId: string): void;
-    /**
-     * Update consumer heartbeat.
-     */
-    updateConsumerHeartbeat(consumerId: string): void;
-    /**
-     * Update execution status.
-     */
-    updateExecutionStatus(id: string, status: ExecutionStatus, result?: string, error?: string): void;
-    /**
-     * Update tool call status and result.
-     */
-    updateToolCall(id: string, status: ToolCallStatus, options?: ToolCallUpdateOptions): void;
-}

package/dist/core/interfaces/usecase/i-clear-use-case.js

@@ -1 +0,0 @@
-export {};

package/dist/infra/cipher/consumer/consumer-lock.d.ts

@@ -1,20 +0,0 @@
-/**
- * DB-based consumer lock utilities
- *
- * The actual locking is now handled by AgentStorage methods:
- * - acquireConsumerLock(consumerId)
- * - releaseConsumerLock(consumerId)
- * - hasActiveConsumer(timeoutMs)
- *
- * These utility functions provide a simple interface for checking consumer status.
- */
-/**
- * Check if a consumer is currently running (has active heartbeat in DB)
- * Auto-detects .brv/blobs path from cwd
- */
-export declare function isConsumerRunning(): Promise<boolean>;
-/**
- * Check if a consumer is currently running (sync version)
- * Assumes storage is already initialized
- */
-export declare function isConsumerRunningSync(): boolean;

package/dist/infra/cipher/consumer/consumer-lock.js

@@ -1,41 +0,0 @@
-// TODO(v0.5.0): Remove this file. Consumer locking is no longer needed (one CoreProcess per TUI).
-import { getAgentStorage, getAgentStorageSync } from '../storage/agent-storage.js';
-// Consumer is considered stale after 30 seconds without heartbeat
-const STALE_TIMEOUT_MS = 30_000;
-/**
- * DB-based consumer lock utilities
- *
- * The actual locking is now handled by AgentStorage methods:
- * - acquireConsumerLock(consumerId)
- * - releaseConsumerLock(consumerId)
- * - hasActiveConsumer(timeoutMs)
- *
- * These utility functions provide a simple interface for checking consumer status.
- */
-/**
- * Check if a consumer is currently running (has active heartbeat in DB)
- * Auto-detects .brv/blobs path from cwd
- */
-export async function isConsumerRunning() {
-    try {
-        const storage = await getAgentStorage();
-        return storage.hasActiveConsumer(STALE_TIMEOUT_MS);
-    }
-    catch {
-        // If we can't check, assume not running
-        return false;
-    }
-}
-/**
- * Check if a consumer is currently running (sync version)
- * Assumes storage is already initialized
- */
-export function isConsumerRunningSync() {
-    try {
-        const storage = getAgentStorageSync();
-        return storage.hasActiveConsumer(STALE_TIMEOUT_MS);
-    }
-    catch {
-        return false;
-    }
-}

package/dist/infra/cipher/consumer/consumer-service.d.ts

@@ -1,99 +0,0 @@
-export interface ConsumerServiceOptions {
-    /** Max concurrent jobs (default: 5) */
-    concurrency?: number;
-    /** Poll interval in ms (default: 1000) */
-    pollInterval?: number;
-}
-/**
- * ConsumerService - Singleton background worker that processes the execution queue
- *
- * Architecture:
- * ```
- * ┌─────────────────┐
- * │ ConsumerService │  ← Singleton, start once in main
- * │ (process jobs)  │
- * └────────┬────────┘
- *          │ writes
- *          ▼
- * ┌─────────────────┐
- * │  AgentStorage   │  ← SQLite DB (source of truth)
- * │   (agent.db)    │
- * └────────┬────────┘
- *          │ polls
- *          ▼
- * ┌─────────────────┐
- * │QueuePollingServ │  ← UI subscribes here for updates
- * └─────────────────┘
- * ```
- *
- * Usage:
- * ```typescript
- * // Main - start consumer singleton (once)
- * const consumer = getConsumerService({ concurrency: 5 })
- * await consumer.start()
- *
- * // UI components - use QueuePollingService for monitoring
- * import { getQueuePollingService } from './queue-polling-service'
- * const poller = getQueuePollingService({ pollInterval: 500 })
- * poller.on('snapshot', (snapshot) => renderUI(snapshot))
- * await poller.start()
- *
- * // Cleanup
- * consumer.dispose()
- * ```
- *
- * Features:
- * - Auto-loads auth token from Keychain
- * - Auto-loads project config from .brv/config.json
- * - Handles lock acquisition/release
- * - Single dispose() for full cleanup
- */
-export declare class ConsumerService {
-    private consumer;
-    private readonly options;
-    private running;
-    constructor(options?: ConsumerServiceOptions);
-    /**
-     * Stop the consumer and cleanup all resources
-     */
-    dispose(): void;
-    /**
-     * Get the consumer ID (unique per session)
-     * Returns null if consumer hasn't started yet
-     */
-    getConsumerId(): null | string;
-    /**
-     * Check if consumer is running
-     */
-    isRunning(): boolean;
-    /**
-     * Start the consumer
-     *
-     * - Loads auth token from Keychain
-     * - Loads project config from .brv/config.json
-     * - Acquires consumer lock
-     * - Starts processing queue
-     *
-     * @throws Error if not authenticated
-     * @throws Error if another consumer is already running
-     */
-    start(): Promise<void>;
-    stop(): void;
-    private setupSignalHandlers;
-}
-/**
- * Get or create singleton ConsumerService
- *
- * Usage:
- * ```typescript
- * const consumer = getConsumerService()
- * await consumer.start()
- * // later...
- * consumer.dispose()
- * ```
- */
-export declare function getConsumerService(options?: ConsumerServiceOptions): ConsumerService;
-/**
- * Dispose singleton and clear reference
- */
-export declare function disposeConsumerService(): void;

package/dist/infra/cipher/consumer/consumer-service.js

@@ -1,166 +0,0 @@
-// TODO(v0.5.0): Remove this file. ConsumerService is replaced by CoreProcess → TaskProcessor.
-import { ProjectConfigStore } from '../../config/file-config-store.js';
-import { KeychainTokenStore } from '../../storage/keychain-token-store.js';
-import { closeAgentStorage } from '../storage/agent-storage.js';
-import { createExecutionConsumer } from './execution-consumer.js';
-// ==================== SERVICE ====================
-/**
- * ConsumerService - Singleton background worker that processes the execution queue
- *
- * Architecture:
- * ```
- * ┌─────────────────┐
- * │ ConsumerService │  ← Singleton, start once in main
- * │ (process jobs)  │
- * └────────┬────────┘
- *          │ writes
- *          ▼
- * ┌─────────────────┐
- * │  AgentStorage   │  ← SQLite DB (source of truth)
- * │   (agent.db)    │
- * └────────┬────────┘
- *          │ polls
- *          ▼
- * ┌─────────────────┐
- * │QueuePollingServ │  ← UI subscribes here for updates
- * └─────────────────┘
- * ```
- *
- * Usage:
- * ```typescript
- * // Main - start consumer singleton (once)
- * const consumer = getConsumerService({ concurrency: 5 })
- * await consumer.start()
- *
- * // UI components - use QueuePollingService for monitoring
- * import { getQueuePollingService } from './queue-polling-service'
- * const poller = getQueuePollingService({ pollInterval: 500 })
- * poller.on('snapshot', (snapshot) => renderUI(snapshot))
- * await poller.start()
- *
- * // Cleanup
- * consumer.dispose()
- * ```
- *
- * Features:
- * - Auto-loads auth token from Keychain
- * - Auto-loads project config from .brv/config.json
- * - Handles lock acquisition/release
- * - Single dispose() for full cleanup
- */
-export class ConsumerService {
-    consumer = null;
-    options;
-    running = false;
-    constructor(options) {
-        this.options = options ?? {};
-    }
-    /**
-     * Stop the consumer and cleanup all resources
-     */
-    dispose() {
-        if (!this.running)
-            return;
-        this.running = false;
-        if (this.consumer) {
-            this.consumer.stop();
-            this.consumer = null;
-        }
-        closeAgentStorage();
-    }
-    /**
-     * Get the consumer ID (unique per session)
-     * Returns null if consumer hasn't started yet
-     */
-    getConsumerId() {
-        return this.consumer?.getConsumerId() ?? null;
-    }
-    /**
-     * Check if consumer is running
-     */
-    isRunning() {
-        return this.running && this.consumer !== null;
-    }
-    /**
-     * Start the consumer
-     *
-     * - Loads auth token from Keychain
-     * - Loads project config from .brv/config.json
-     * - Acquires consumer lock
-     * - Starts processing queue
-     *
-     * @throws Error if not authenticated
-     * @throws Error if another consumer is already running
-     */
-    async start() {
-        if (this.running) {
-            throw new Error('Consumer already running');
-        }
-        // Load auth token
-        const tokenStore = new KeychainTokenStore();
-        const token = await tokenStore.load();
-        if (!token) {
-            throw new Error('Not authenticated. Please run "brv login" first.');
-        }
-        // Load project config (optional)
-        const configStore = new ProjectConfigStore();
-        const brvConfig = await configStore.read();
-        // Create consumer (auto-detects .brv/blobs from cwd)
-        this.consumer = createExecutionConsumer({
-            authToken: { accessToken: token.accessToken, sessionKey: token.sessionKey },
-            brvConfig: brvConfig ?? undefined,
-            maxConcurrency: this.options.concurrency ?? 5,
-            pollInterval: this.options.pollInterval ?? 1000,
-        });
-        // Start consumer
-        const started = await this.consumer.start();
-        if (!started) {
-            this.consumer = null;
-            throw new Error('Another consumer is already running in this directory');
-        }
-        this.running = true;
-        this.setupSignalHandlers();
-    }
-    // Alias for dispose
-    stop() {
-        this.dispose();
-    }
-    // ==================== PRIVATE ====================
-    setupSignalHandlers() {
-        // eslint-disable-next-line unicorn/consistent-function-scoping -- needs 'this' context
-        const cleanup = () => {
-            this.dispose();
-        };
-        process.on('SIGTERM', cleanup);
-        process.on('SIGINT', cleanup);
-        process.on('exit', cleanup);
-    }
-}
-// ==================== SINGLETON HELPER ====================
-let instance = null;
-/**
- * Get or create singleton ConsumerService
- *
- * Usage:
- * ```typescript
- * const consumer = getConsumerService()
- * await consumer.start()
- * // later...
- * consumer.dispose()
- * ```
- */
-export function getConsumerService(options) {
-    if (!instance) {
-        instance = new ConsumerService(options);
-    }
-    return instance;
-}
-/**
- * Dispose singleton and clear reference
- */
-export function disposeConsumerService() {
-    if (instance) {
-        instance.dispose();
-        instance = null;
-    }
-}