byterover-cli 0.4.0 → 0.4.1

package/dist/core/domain/entities/event.d.ts

@@ -1,7 +1,7 @@
 /**
  * Array of all supported Events.
  */
-export declare const EVENT_VALUES: readonly ["auth:signed_in", "auth:signed_out", "space:init", "space:changed", "rule:generate", "mem:status", "mem:curate", "mem:pull", "mem:push", "mem:query", "onboarding:init_completed", "onboarding:curate_completed", "onboarding:query_completed", "onboarding:skipped", "onboarding:completed"];
+export declare const EVENT_VALUES: readonly ["repl", "auth:sign_in", "auth:signed_out", "space:init", "space:changed", "rule:generate", "mem:status", "mem:curate", "mem:pull", "mem:push", "mem:query", "onboarding:init_completed", "onboarding:curate_completed", "onboarding:query_completed", "onboarding:skipped", "onboarding:completed", "init"];
 export type EventName = (typeof EVENT_VALUES)[number];
 export interface PropertyDict {
     [key: string]: any;

package/dist/core/domain/entities/event.js

@@ -2,7 +2,8 @@
  * Array of all supported Events.
  */
 export const EVENT_VALUES = [
-    'auth:signed_in',
+    'repl',
+    'auth:sign_in',
     'auth:signed_out',
     'space:init',
     'space:changed',
@@ -17,4 +18,5 @@ export const EVENT_VALUES = [
     'onboarding:query_completed',
     'onboarding:skipped',
     'onboarding:completed',
+    'init'
 ];

package/dist/hooks/init/welcome.js

@@ -16,11 +16,11 @@ function checkNodeVersion() {
     const [, major, minor] = versionMatch;
     const majorVersion = Number.parseInt(major, 10);
     const minorVersion = Number.parseInt(minor, 10);
-    // Minimum supported version: Node 18
-    if (majorVersion < 18) {
+    // Minimum supported version: Node 20
+    if (majorVersion < 20) {
         return {
             message: `Node.js ${majorVersion}.${minorVersion} is not supported.\n` +
-                'ByteRover CLI requires Node.js 18 or higher.\n' +
+                'ByteRover CLI requires Node.js 20 or higher.\n' +
                 `Current version: ${nodeVersion}\n\n` +
                 'Please upgrade Node.js:\n' +
                 '  - Using nvm: nvm install 22 && nvm use 22\n' +
@@ -28,21 +28,21 @@ function checkNodeVersion() {
             type: 'error',
         };
     }
-    // Recommended versions: Node 18, 20, 22
-    // Node 24+ may have compatibility issues with native modules (better-sqlite3, grpc)
+    // Recommended versions: Node 20, 22
+    // Node 24+ may have compatibility issues with native modules
     if (majorVersion >= 24) {
         return {
             message: `Node.js ${majorVersion}.${minorVersion} has not been fully tested with ByteRover CLI.\n` +
                 `Current version: ${nodeVersion}\n` +
-                'Recommended versions: Node.js 18.x, 20.x, or 22.x (LTS)\n\n' +
-                'Some native dependencies (sqlite, grpc) may not work correctly.\n' +
+                'Recommended versions: Node.js 20.x or 22.x\n\n' +
+                'Some native dependencies may not work correctly.\n' +
                 'If you encounter errors, please switch to a recommended version:\n' +
                 '  - Using nvm: nvm install 22 && nvm use 22',
             type: 'warning',
         };
     }
     // All checks passed
-    return null;
+    return undefined;
 }
 const hook = async function (options) {
     // Check Node.js version compatibility first
@@ -79,23 +79,8 @@ const hook = async function (options) {
             chalk.cyan(String.raw ` |____/ \__, |\__\___|_| \_\___/ \_/ \___|_|    `),
             chalk.cyan('        |___/                                  '),
         ].join('\n');
-        const onboardingText = [
-            'ByteRover CLI quick start:',
-            '',
-            '  1. Authenticate with ByteRover:',
-            '     brv login',
-            '  2. Link your workspace:',
-            '     brv init',
-            '',
-            'After setup, run `brv status` to confirm your connection.',
-            '',
-            '  Explore commands:',
-            '    • `brv curate` - Organize and curate your context tree',
-            '    • `brv query` - Search and query your context tree',
-            '    • `brv push` - Push your context tree to ByteRover',
-        ].join('\n');
         const docsLink = `For more information, run 'brv --help', 'brv [command] --help' or visit ${DOCS_URL}`;
-        this.log(`\n${logo}\n\n${onboardingText}\n\n${docsLink}\n\n`);
+        this.log(`\n${logo}\n\n${docsLink}\n\n`);
     }
 };
 export default hook;

package/dist/infra/repl/repl-startup.js

@@ -19,8 +19,10 @@ export async function startRepl(options) {
             brvConfig = await projectConfigStore.read();
         }
     }
+    await trackingService.track('repl', { status: 'started' });
     // Render the App with providers
     const { waitUntilExit } = render(_jsx(AppProviders, { initialAuthToken: isAuthorized ? authToken : undefined, initialBrvConfig: brvConfig, onboardingPreferenceStore: onboardingPreferenceStore, projectConfigStore: projectConfigStore, tokenStore: tokenStore, trackingService: trackingService, version: version, children: _jsx(App, {}) }));
     await waitUntilExit();
     stopQueuePollingService();
+    await trackingService.track('repl', { status: 'finished' });
 }

package/dist/infra/usecase/curate-use-case.js

@@ -124,6 +124,7 @@ export class CurateUseCase {
         }
     }
     async run(options) {
+        await this.trackingService.track('mem:curate', { status: 'started' });
         // Determine mode: autonomous if context is provided
         return options.context ? this.runAutonomous(options.context, options) : this.runInteractive();
     }
@@ -131,7 +132,7 @@ export class CurateUseCase {
      * Handle workspace not initialized error
      */
     handleWorkspaceError(_error) {
-        const message = 'Project not initialized. Please run "brv init" to select your team and workspace.';
+        const message = 'Project not initialized. Please run "/init" to select your team and workspace.';
         this.terminal.log(message);
     }
     /**
@@ -197,14 +198,14 @@ export class CurateUseCase {
             // Get authentication token
             const token = await this.tokenStore.load();
             if (!token) {
-                this.terminal.log('Authentication required. Please run "brv login" first.');
+                this.terminal.log('Authentication required. Please run "/login" first.');
                 return;
             }
             // Load project config
             const brvConfig = await this.projectConfigStore.read();
             // Validate workspace is initialized
             if (!brvConfig) {
-                throw new WorkspaceNotInitializedError('Project not initialized. Please run "brv init" to select your team and workspace.', '.brv');
+                throw new WorkspaceNotInitializedError('Project not initialized. Please run "/init" to select your team and workspace.', '.brv');
             }
             // Process file references if provided (validates and creates instructions)
             const fileReferenceInstructions = this.processFileReferences(options.files ?? []);
@@ -223,7 +224,7 @@ export class CurateUseCase {
             // Simple output for agents - just confirm saved
             this.terminal.log('✓ Context queued for processing.');
             // Track the event
-            await this.trackingService.track('mem:curate');
+            await this.trackingService.track('mem:curate', { status: 'finished' });
         }
         catch (error) {
             if (error instanceof WorkspaceNotInitializedError) {
@@ -231,7 +232,9 @@ export class CurateUseCase {
                 return;
             }
             // Display error
-            this.terminal.error(error instanceof Error ? error.message : 'Runtime error occurred');
+            const errMsg = error instanceof Error ? error.message : 'Runtime error occurred';
+            await this.trackingService.track('mem:curate', { message: errMsg, status: 'error' });
+            this.terminal.error(errMsg);
         }
     }
     /**
@@ -261,7 +264,9 @@ export class CurateUseCase {
             await this.openFile(contextFilePath);
         }
         catch (error) {
-            this.terminal.error(error instanceof Error ? error.message : 'Unexpected error occurred');
+            const errMsg = error instanceof Error ? error.message : 'Unexpected error occurred';
+            await this.trackingService.track('mem:curate', { message: errMsg, status: 'error' });
+            this.terminal.error(errMsg);
         }
     }
     validateTopicName(value, targetPath) {

package/dist/infra/usecase/init-use-case.js

@@ -58,7 +58,9 @@ export class InitUseCase {
         }
         catch (error) {
             this.terminal.actionStop('✗');
-            throw new Error(`Failed to remove ${BRV_DIR}/: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            const brvDirRemovalErr = `Failed to remove ${BRV_DIR}/: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            await this.trackingService.track('init', { message: brvDirRemovalErr, status: 'error' });
+            throw new Error(brvDirRemovalErr);
         }
     }
     async confirmReInitialization(config) {
@@ -93,11 +95,11 @@ export class InitUseCase {
     async ensureAuthenticated() {
         const token = await this.tokenStore.load();
         if (token === undefined) {
-            this.terminal.log('Not authenticated. Please run "brv login" first.');
+            this.terminal.log('Not authenticated. Please run "/login" first.');
             return undefined;
         }
         if (!token.isValid()) {
-            this.terminal.log('Authentication token expired. Please run "brv login" again.');
+            this.terminal.log('Authentication token expired. Please run "/login" again.');
             return undefined;
         }
         return token;
@@ -205,7 +207,9 @@ export class InitUseCase {
         try {
             const projectConfig = await this.projectConfigStore.read();
             if (projectConfig === undefined) {
-                throw new Error('Configuration file exists but cannot be read. Please check .brv/config.json');
+                const corruptedConfigFileErr = 'Configuration file exists but cannot be read. Please check .brv/config.json';
+                this.trackingService.track('init', { message: corruptedConfigFileErr, status: 'error' });
+                throw new Error(corruptedConfigFileErr);
             }
             return projectConfig;
         }
@@ -362,6 +366,7 @@ export class InitUseCase {
     }
     async run(options) {
         try {
+            await this.trackingService.track('init', { status: 'started' });
             const authToken = await this.ensureAuthenticated();
             if (!authToken)
                 return;
@@ -416,11 +421,14 @@ export class InitUseCase {
             await this.trackingService.track('rule:generate');
             await this.trackingService.track('space:init');
             this.logSuccess(selectedSpace);
+            await this.trackingService.track('init', { status: 'finished' });
         }
         catch (error) {
             // Stop action if it's in progress
             this.terminal.actionStop();
-            this.terminal.error(`Initialization failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+            const initErr = `Initialization failed: ${error instanceof Error ? error.message : 'Unknown error'}`;
+            await this.trackingService.track('init', { message: initErr, status: 'error' });
+            this.terminal.error(initErr);
         }
     }
     async syncFromRemoteOrInitialize(params) {
@@ -452,7 +460,9 @@ export class InitUseCase {
             }
         }
         catch (error) {
-            throw new Error(`Failed to sync from ByteRover: ${error instanceof Error ? error.message : 'Unknown error'}. Please try again.`);
+            const syncFailureErr = `Failed to sync from ByteRover: ${error instanceof Error ? error.message : 'Unknown error'}. Please try again.`;
+            await this.trackingService.track('init', { message: syncFailureErr, status: 'error' });
+            throw new Error(syncFailureErr);
         }
     }
     /**

package/dist/infra/usecase/login-use-case.js

@@ -19,13 +19,16 @@ export class LoginUseCase {
     }
     async run() {
         try {
+            await this.trackingService.track('auth:sign_in', { status: 'started' });
             this.terminal.log('Starting authentication process...');
             // Start callback server
             await this.callbackHandler.start();
             // Get port and build redirect URI
             const port = this.callbackHandler.getPort();
             if (!port) {
-                throw new Error('Failed to get callback server port');
+                const getPortFailedErr = 'Failed to get callback server port';
+                await this.trackingService.track('auth:sign_in', { message: getPortFailedErr, status: 'error' });
+                throw new Error(getPortFailedErr);
             }
             const redirectUri = `http://localhost:${port}/callback`;
             // Initiate authorization (generates PKCE parameters and state internally)
@@ -38,6 +41,7 @@ export class LoginUseCase {
             }
             catch {
                 // Browser launch failed, will return URL to user
+                await this.trackingService.track('auth:sign_in', { message: 'browser launch failed', status: 'error' });
             }
             // If browser failed to open, display the URL for manual copy
             if (!browserOpened) {
@@ -60,13 +64,13 @@ export class LoginUseCase {
                     userId: user.id,
                 });
                 await this.tokenStore.save(authToken);
-                // Track successful authentication
-                await this.trackingService.track('auth:signed_in');
+                await this.trackingService.track('auth:sign_in', { status: 'finished' });
                 this.terminal.log(`Logged in as ${user.email}`);
             }
             catch (error) {
                 // Throw error to let oclif handle display
                 const errorMessage = error instanceof Error ? error.message : 'Authentication failed';
+                await this.trackingService.track('auth:sign_in', { message: errorMessage, status: 'error' });
                 this.terminal.error(errorMessage);
             }
         }
@@ -74,10 +78,12 @@ export class LoginUseCase {
             if (error instanceof DiscoveryError) {
                 const errorMessage = `Failed to configure authentication: ${error.message}\n` +
                     'Please check your network connection and try again.';
+                await this.trackingService.track('auth:sign_in', { message: errorMessage, status: 'error' });
                 this.terminal.error(errorMessage);
             }
             // Throw error to let oclif handle display
             const errorMessage = error instanceof Error ? error.message : 'Authentication failed';
+            await this.trackingService.track('auth:sign_in', { message: errorMessage, status: 'error' });
             this.terminal.error(errorMessage);
         }
         finally {

package/dist/infra/usecase/query-use-case.js

@@ -32,6 +32,7 @@ export class QueryUseCase {
         return randomUUID();
     }
     async run(options) {
+        await this.trackingService.track('mem:query', { status: 'started' });
         // Initialize storage for tool call tracking (auto-detects .brv/blobs)
         const storage = await getAgentStorage();
         let executionId = null;
@@ -39,14 +40,14 @@ export class QueryUseCase {
             // Get authentication token
             const token = await this.tokenStore.load();
             if (!token) {
-                this.terminal.log('Authentication required. Please run "brv login" first.');
+                this.terminal.log('Authentication required. Please run "/login" first.');
                 return;
             }
             // Load project config
             const brvConfig = await this.projectConfigStore.read();
             // Validate workspace is initialized
             if (!brvConfig) {
-                throw new WorkspaceNotInitializedError('Project not initialized. Please run "brv init" to select your team and workspace.', '.brv');
+                throw new WorkspaceNotInitializedError('Project not initialized. Please run "/init" to select your team and workspace.', '.brv');
             }
             // Create execution with status='running' (query runs synchronously)
             executionId = storage.createExecution('query', options.query);
@@ -87,8 +88,7 @@ export class QueryUseCase {
                 storage.updateExecutionStatus(executionId, 'completed', response);
                 this.terminal.log('\nQuery Results:');
                 this.terminal.log(response);
-                // Track query
-                await this.trackingService.track('mem:query');
+                await this.trackingService.track('mem:query', { status: 'finished' });
             }
             finally {
                 // Cleanup old executions
@@ -107,6 +107,7 @@ export class QueryUseCase {
             }
             // Display context on one line, error on separate line
             process.stderr.write('Failed to query context tree:\n');
+            await this.trackingService.track('mem:query', { message: formatError(error), status: 'error' });
             this.terminal.log(formatError(error));
         }
     }

package/dist/tui/contexts/use-commands.js

@@ -19,9 +19,11 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext, useEffect, useMemo, useState } from 'react';
 import { load } from '../../infra/repl/commands/index.js';
 import { useSlashCommandProcessor } from '../hooks/index.js';
+import { useServices } from './services-context.js';
 const CommandsContext = createContext(undefined);
 export function CommandsProvider({ children }) {
     const [commands, setCommands] = useState([]);
+    const { version } = useServices();
     useEffect(() => {
         const abortController = new AbortController();
         async function loadCommands() {
@@ -34,9 +36,8 @@ export function CommandsProvider({ children }) {
     }, []);
     const commandContext = useMemo(() => ({
         slashCommands: commands,
-        // version:, -> need pass version here
-        // syncService:, -> need pass sync service here
-    }), [commands]);
+        version,
+    }), [commands, version]);
     const { handleSlashCommand } = useSlashCommandProcessor(commandContext, commands);
     const contextValue = useMemo(() => ({
         commands,

package/oclif.manifest.json

@@ -386,5 +386,5 @@
       ]
     }
   },
-  "version": "0.4.0"
+  "version": "0.4.1"
 }

package/package.json

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