byterover-cli 1.0.2 → 1.0.4

package/dist/tui/views/logs-view.js

@@ -1,23 +1,31 @@
-import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Logs View
  *
  * Activity log display using ScrollableList with dynamic height calculation
  */
-import { Box, Text } from 'ink';
-import { useCallback } from 'react';
-import { LogItem, OnboardingFlow, ScrollableList } from '../components/index.js';
+import { Box } from 'ink';
+import { useCallback, useState } from 'react';
+import { LogItem, OnboardingFlow, ScrollableList, WelcomeBox } from '../components/index.js';
+import { useAuth } from '../contexts/index.js';
 import { useActivityLogs, useMode, useTheme, useUIHeights } from '../hooks/index.js';
 import { useOnboarding } from '../hooks/use-onboarding.js';
 import { calculateActualLogHeight, calculateLogContentLimit } from '../utils/log.js';
+import { InitView } from './init-view.js';
 export const LogsView = ({ availableHeight }) => {
     const { theme: { colors }, } = useTheme();
     const { mode } = useMode();
     const { logs } = useActivityLogs();
-    const { shouldShowOnboarding } = useOnboarding();
+    const { isLoadingDismissed, shouldShowOnboarding } = useOnboarding();
     const { messageItem } = useUIHeights();
+    const { brvConfig } = useAuth();
+    // Track if user has completed init flow
+    const [initFlowCompleted, setInitFlowCompleted] = useState(Boolean(brvConfig));
     // Calculate scrollable height for dynamic per-log calculations
     const scrollableHeight = Math.max(1, availableHeight);
+    const handleInitEnd = () => {
+        setInitFlowCompleted(true);
+    };
     const renderLogItem = useCallback((log) => {
         // Calculate dynamic content limit for this specific log
         const parts = calculateLogContentLimit(log, scrollableHeight, messageItem);
@@ -40,9 +48,15 @@ export const LogsView = ({ availableHeight }) => {
             maxContentLines: maxContentLine,
         });
     }, [messageItem, scrollableHeight]);
-    // Show onboarding when project is not initialized
+    if (isLoadingDismissed) {
+        return null;
+    }
     if (shouldShowOnboarding) {
-        return _jsx(OnboardingFlow, { availableHeight: availableHeight });
+        return _jsx(OnboardingFlow, { availableHeight: availableHeight, onInitComplete: handleInitEnd });
+    }
+    // Show init view if config doesn't exist and user hasn't completed init flow
+    if (!initFlowCompleted) {
+        return _jsx(InitView, { availableHeight: availableHeight, onInitComplete: handleInitEnd });
     }
-    return (_jsx(Box, { borderColor: colors.border, borderLeft: false, borderRight: false, borderStyle: "single", borderTop: false, flexDirection: "column", height: "100%", width: "100%", children: logs.length > 0 ? (_jsx(Box, { flexDirection: "column", height: "100%", paddingX: 2, children: _jsx(ScrollableList, { autoScrollToBottom: true, availableHeight: scrollableHeight, estimateItemHeight: heightEstimator, isActive: mode === 'activity', items: logs, keyExtractor: keyExtractor, renderItem: renderLogItem }) })) : (_jsxs(_Fragment, { children: [_jsx(Text, { color: colors.primary, children: "Welcome to ByteRover!" }), _jsx(Text, { color: colors.text, children: "Start by telling your AI Agent what to save or retrieve." }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: colors.text, dimColor: true, children: "Press [Tab] to switch to commands view" }) })] })) }));
+    return (_jsx(Box, { borderColor: colors.border, borderLeft: false, borderRight: false, borderStyle: "single", borderTop: false, flexDirection: "column", height: "100%", width: "100%", children: logs.length > 0 ? (_jsx(Box, { flexDirection: "column", height: "100%", paddingX: 2, children: _jsx(ScrollableList, { autoScrollToBottom: true, availableHeight: scrollableHeight, estimateItemHeight: heightEstimator, isActive: mode === 'activity', items: logs, keyExtractor: keyExtractor, renderItem: renderLogItem }) })) : (_jsx(WelcomeBox, { isCopyActive: mode === 'activity' && logs.length === 0 })) }));
 };

package/dist/utils/environment-detector.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Check if running in WSL environment (cached).
+ * Detects both WSL1 and WSL2. Result is cached after first call for performance.
+ */
+export declare function isWsl(): boolean;

package/dist/utils/environment-detector.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs';
+let wslCached;
+/**
+ * Detect if running in WSL (Windows Subsystem for Linux) environment.
+ * Checks WSL-specific environment variables first, then falls back to /proc/version.
+ */
+function detectWsl() {
+    if (process.platform !== 'linux') {
+        return false;
+    }
+    if (process.env.WSL_DISTRO_NAME !== undefined || process.env.WSLENV !== undefined) {
+        return true;
+    }
+    try {
+        const version = readFileSync('/proc/version', 'utf8');
+        return /microsoft|wsl/i.test(version);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if running in WSL environment (cached).
+ * Detects both WSL1 and WSL2. Result is cached after first call for performance.
+ */
+export function isWsl() {
+    if (wslCached === undefined) {
+        wslCached = detectWsl();
+    }
+    return wslCached;
+}

package/dist/utils/global-data-path.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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 declare const getGlobalDataDir: () => string;

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

@@ -198,5 +198,5 @@
       ]
     }
   },
-  "version": "1.0.2"
+  "version": "1.0.4"
 }

package/package.json

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

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/cipher/i-agent-storage.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;
-    }
-}