byterover-cli 0.2.0 → 0.2.1

package/dist/commands/init.d.ts

@@ -6,10 +6,16 @@ import type { IProjectConfigStore } from '../core/interfaces/i-project-config-st
 import type { ISpaceService } from '../core/interfaces/i-space-service.js';
 import type { ITeamService } from '../core/interfaces/i-team-service.js';
 import type { ITokenStore } from '../core/interfaces/i-token-store.js';
+import { BrvConfig } from '../core/domain/entities/brv-config.js';
 import { ITrackingService } from '../core/interfaces/i-tracking-service.js';
 export default class Init extends Command {
     static description: string;
     static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected cleanupBeforeReInitialization(): Promise<void>;
+    protected confirmReInitialization(config: BrvConfig): Promise<boolean>;
     protected createServices(): {
         playbookService: IPlaybookService;
         projectConfigStore: IProjectConfigStore;

package/dist/commands/init.js

@@ -1,5 +1,7 @@
-import { select } from '@inquirer/prompts';
-import { Command, ux } from '@oclif/core';
+import { confirm, select } from '@inquirer/prompts';
+import { Command, Flags, ux } from '@oclif/core';
+import { rm } from 'node:fs/promises';
+import { join } from 'node:path';
 import { getCurrentConfig } from '../config/environment.js';
 import { BRV_DIR, PROJECT_CONFIG_FILE } from '../constants.js';
 import { BrvConfig } from '../core/domain/entities/brv-config.js';
@@ -16,6 +18,41 @@ export default class Init extends Command {
         '# Re-initialize if config exists (will show current config and exit):\n<%= config.bin %> <%= command.id %>',
         '# Full workflow: login then initialize:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>',
     ];
+    static flags = {
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Force re-initialization without confirmation prompt',
+        }),
+    };
+    async cleanupBeforeReInitialization() {
+        const brvDir = join(process.cwd(), BRV_DIR);
+        this.log('\n Cleaning up existing ByteRover directory...');
+        ux.action.start(`  Removing ${BRV_DIR}/`);
+        try {
+            await rm(brvDir, { force: true, recursive: true });
+            ux.action.stop('✓');
+        }
+        catch (error) {
+            ux.action.stop('✗');
+            this.error(`Failed to remove ${BRV_DIR}/: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async confirmReInitialization(config) {
+        this.log('\n Project is already initialized');
+        this.log(`  Team: ${config.teamName}`);
+        this.log(`  Space: ${config.spaceName}`);
+        this.log(`  Config: ${join(process.cwd(), BRV_DIR, PROJECT_CONFIG_FILE)}`);
+        this.log('\n Re-initializing will:');
+        this.log(`  - Remove the entire ${BRV_DIR}/ directory and all its contents`);
+        this.log('  - Allow you to select a new team/space');
+        this.log('  - Create a fresh configuration and ACE playbook');
+        this.log('  - Regenerate rule instructions\n');
+        return confirm({
+            default: false,
+            message: 'Continue with re-initialization?',
+        });
+    }
     createServices() {
         const envConfig = getCurrentConfig();
         const tokenStore = new KeychainTokenStore();
@@ -62,18 +99,31 @@ export default class Init extends Command {
         return selectedTeam;
     }
     async run() {
+        const { flags } = await this.parse(Init);
         try {
             const { playbookService, projectConfigStore, spaceService, teamService, tokenStore, trackingService } = this.createServices();
-            // 1. Check if already initialized
-            const isInitialized = await projectConfigStore.exists();
-            if (isInitialized) {
-                this.log('Project is already initialized with ByteRover.');
-                const existingProjectConfig = await projectConfigStore.read();
-                this.log(`Your space for this project is: ${existingProjectConfig?.teamName}/${existingProjectConfig?.spaceName}`);
-                return;
+            const alreadyInitialized = await projectConfigStore.exists();
+            if (alreadyInitialized) {
+                const currentConfig = await projectConfigStore.read();
+                if (currentConfig === undefined) {
+                    this.error('Configuration file exists but cannot be read. Please check .brv/config.json');
+                }
+                if (!flags.force) {
+                    const confirmed = await this.confirmReInitialization(currentConfig);
+                    if (!confirmed) {
+                        this.log('\nCancelled. Project configuration unchanged.');
+                        return;
+                    }
+                }
+                try {
+                    await this.cleanupBeforeReInitialization();
+                }
+                catch (error) {
+                    this.error(`Failed to clean up existing data: ${error instanceof Error ? error.message : 'Unknown error'}`);
+                }
+                this.log('\n'); // Spacing before continuing with init flow
             }
             this.log('Initializing ByteRover project...\n');
-            // 2. Load and validate authentication token
             const token = await tokenStore.load();
             if (token === undefined) {
                 this.error('Not authenticated. Please run "brv login" first.');
@@ -81,7 +131,6 @@ export default class Init extends Command {
             if (!token.isValid()) {
                 this.error('Authentication token expired. Please run "brv login" again.');
             }
-            // 3. Fetch all teams with spinner
             ux.action.start('Fetching all teams');
             const teamResult = await teamService.getTeams(token.accessToken, token.sessionKey, { fetchAll: true });
             ux.action.stop();
@@ -91,10 +140,8 @@ export default class Init extends Command {
                 this.log(`Please visit ${getCurrentConfig().webAppUrl} to create your first team.`);
                 return;
             }
-            // 4. Prompt for team selection
             this.log();
             const selectedTeam = await this.promptForTeamSelection(teams);
-            // 5. Fetch all spaces for the selected team with spinner
             ux.action.start('Fetching all spaces');
             const spaceResult = await spaceService.getSpaces(token.accessToken, token.sessionKey, selectedTeam.id, {
                 fetchAll: true,
@@ -106,13 +153,10 @@ export default class Init extends Command {
                 this.log(`Please visit ${getCurrentConfig().webAppUrl} to create your first space for ${selectedTeam.getDisplayName()}.`);
                 return;
             }
-            // 6. Prompt for space selection
             this.log();
             const selectedSpace = await this.promptForSpaceSelection(spaces);
-            // 7. Create and save configuration
             const config = BrvConfig.fromSpace(selectedSpace);
             await projectConfigStore.write(config);
-            // 8. Initialize ACE playbook
             this.log('\nInitializing ACE context...');
             try {
                 const playbookPath = await playbookService.initialize();
@@ -122,13 +166,10 @@ export default class Init extends Command {
                 // Warn but don't fail if ACE init fails
                 this.warn(`ACE initialization skipped: ${error instanceof Error ? error.message : 'Unknown error'}`);
             }
-            // 9. Generate rules
             this.log(`\nGenerate rule instructions for coding agents to work with ByteRover correctly`);
             this.log();
             await this.config.runCommand('gen-rules');
-            // Track space initialization
             await trackingService.track('space:init');
-            // 10. Display success
             this.log(`\n✓ Project initialized successfully!`);
             this.log(`✓ Connected to space: ${selectedSpace.getDisplayName()}`);
             this.log(`✓ Configuration saved to: ${BRV_DIR}/${PROJECT_CONFIG_FILE}`);

package/dist/commands/logout.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+import type { ITokenStore } from '../core/interfaces/i-token-store.js';
+import type { ITrackingService } from '../core/interfaces/i-tracking-service.js';
+export default class Logout extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected confirmLogout(userEmail: string): Promise<boolean>;
+    protected createServices(): {
+        tokenStore: ITokenStore;
+        trackingService: ITrackingService;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/logout.js

@@ -0,0 +1,61 @@
+import { confirm } from '@inquirer/prompts';
+import { Command, Flags } from '@oclif/core';
+import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
+import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
+export default class Logout extends Command {
+    static description = 'Log out of ByteRover CLI and clear authentication (does not affect local project files)';
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --yes'];
+    static flags = {
+        yes: Flags.boolean({
+            char: 'y',
+            default: false,
+            description: 'Skip confirmation prompt',
+        }),
+    };
+    async confirmLogout(userEmail) {
+        return confirm({
+            // Pressing 'Enter' = Yes
+            default: true,
+            message: `Logging out ${userEmail}. Are you sure?`,
+        });
+    }
+    createServices() {
+        const tokenStore = new KeychainTokenStore();
+        const trackingService = new MixpanelTrackingService(tokenStore);
+        return {
+            tokenStore,
+            trackingService,
+        };
+    }
+    async run() {
+        const { flags } = await this.parse(Logout);
+        const { tokenStore, trackingService } = this.createServices();
+        try {
+            const token = await tokenStore.load();
+            if (token === undefined) {
+                this.log('You are not currently logged in.');
+                return;
+            }
+            if (!flags.yes) {
+                const confirmed = await this.confirmLogout(token.userEmail);
+                if (!confirmed) {
+                    this.log('Logout cancelled.');
+                    return;
+                }
+            }
+            try {
+                await trackingService.track('auth:signed_out');
+            }
+            catch { }
+            await tokenStore.clear();
+            this.log('Successfully logged out.');
+            this.log("Run 'brv login' to authenticate again.");
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes('keychain')) {
+                this.error('Unable to access system keychain. Please check your system permissions and try again.');
+            }
+            this.error(error instanceof Error ? error.message : 'Logout failed');
+        }
+    }
+}

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", "space:init", "space:changed", "rule:generate", "ace:add_bullet", "ace:update_bullet", "ace:remove_bullet", "ace:view_status", "mem:push", "mem:retrieve"];
+export declare const EVENT_VALUES: readonly ["auth:signed_in", "auth:signed_out", "space:init", "space:changed", "rule:generate", "ace:add_bullet", "ace:update_bullet", "ace:remove_bullet", "ace:view_status", "mem:push", "mem:retrieve"];
 export type EventName = (typeof EVENT_VALUES)[number];
 export interface PropertyDict {
     [key: string]: any;

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

@@ -3,6 +3,7 @@
  */
 export const EVENT_VALUES = [
     'auth:signed_in',
+    'auth:signed_out',
     'space:init',
     'space:changed',
     'rule:generate',

package/dist/core/interfaces/i-rule-template-service.d.ts

@@ -1,8 +1,4 @@
 import { Agent } from '../domain/entities/agent.js';
-/**
- * ByteRover CLI generated rule template tag.
- */
-export declare const BR_RULE_TAG = "Generated by ByteRover CLI for";
 /**
  * Interface for rule template service operations.
  */

package/dist/core/interfaces/i-rule-template-service.js

@@ -1,4 +1 @@
-/**
- * ByteRover CLI generated rule template tag.
- */
-export const BR_RULE_TAG = 'Generated by ByteRover CLI for';
+export {};

package/dist/infra/rule/constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * ByteRover CLI generated rule template tag.
+ */
+export declare const BR_RULE_TAG = "Generated by ByteRover CLI for";

package/dist/infra/rule/constants.js

@@ -0,0 +1,4 @@
+/**
+ * ByteRover CLI generated rule template tag.
+ */
+export const BR_RULE_TAG = 'Generated by ByteRover CLI for';

package/dist/infra/rule/rule-template-service.js

@@ -1,4 +1,4 @@
-import { BR_RULE_TAG } from '../../core/interfaces/i-rule-template-service.js';
+import { BR_RULE_TAG } from './constants.js';
 const guideHeaders = [
     {
         agent: 'Augment Code',

package/dist/infra/rule/rule-writer-service.js

@@ -1,6 +1,6 @@
 import { RuleExistsError } from '../../core/domain/errors/rule-error.js';
-import { BR_RULE_TAG } from '../../core/interfaces/i-rule-template-service.js';
 import { AGENT_RULE_CONFIGS } from './agent-rule-config.js';
+import { BR_RULE_TAG } from './constants.js';
 /**
  * Service for writing agent-specific rule files.
  * Uses IFileService to write files and RuleTemplateService to generate content.
@@ -24,20 +24,16 @@ export class RuleWriterService {
         }
         const { filePath, writeMode } = config;
         const fileExists = await this.fileService.exists(filePath);
-        // Throw an error if the file exists and force is not set
         if (writeMode === 'overwrite' && fileExists && !force) {
             throw new RuleExistsError();
         }
         if (writeMode === 'append' && fileExists && !force) {
             const content = await this.fileService.read(filePath);
-            // Throw an error if the rule already exists
             if (content.includes(BR_RULE_TAG)) {
                 throw new RuleExistsError();
             }
         }
-        // Generate rule content
         const ruleContent = await this.templateService.generateRuleContent(agent);
-        // Write the rule file
         await this.fileService.write(ruleContent, filePath, writeMode);
     }
 }

package/dist/templates/sections/command-reference.md

@@ -72,6 +72,7 @@ brv retrieve -q "database connection issues"
 **Flags:**
 
 - `-b, --branch <string>`: ByteRover branch name (default: "main", NOT git branch)
+- `-y, --yes`: Skip confirmation prompt
 
 **Examples:**
 
@@ -120,7 +121,24 @@ brv complete "auth-update" "Improved error handling" "Better errors" --tool-usag
 
 ---
 
-### `brv show`
+### `brv status`
+
+**Description**: Show CLI status and project information. Display local ACE context (ACE playbook) managed by ByteRover CLI.
+
+**Arguments:**
+
+- `DIRECTORY`:Project directory (defaults to current directory).
+
+**Flags:**
+
+- `-f, --format=<option>`: [default: table] Output format. <options: table|json>
+
+**Examples:**
+
+```bash
+brv status
+brv status --format json
+```
 
 ## Best Practices
 

package/dist/templates/sections/workflow.md

@@ -19,19 +19,19 @@ Once the user chooses "Auto-run", apply that preference to all subsequent `brv`
 
 ## Daily Flow
 
-1.Retrieve context
+1. Always attempt to retrieve relevant context from ByteRover first by running `brv retrieve`.
 
-2.Do the work with minimal code reads
+2. Do the work with minimal code reads
 
-3.Record new or refined knowledge in the playbook
+3. Record new or refined knowledge in the playbook
 
-- Add only specific, actionable, contextual items; avoid secrets. Redact when in doubt.
+    - Add only specific, actionable, contextual items; avoid secrets. Redact when in doubt.
 
-4.Sync policy (manual by default)
+4. Sync policy (manual by default)
 
-- Do not auto-push.
-- When the playbook has meaningful updates, prompt the user to run the command
-- If the user has explicitly allowed auto-push, proceed non-interactively.
+    - Do not auto-push.
+    - When the playbook has meaningful updates, prompt the user to run the command
+    - If the user has explicitly allowed auto-push, proceed non-interactively by running `brv push -y`.
 
 ## Playbook Guideline
 

package/oclif.manifest.json

@@ -210,7 +210,15 @@
         "# Re-initialize if config exists (will show current config and exit):\n<%= config.bin %> <%= command.id %>",
         "# Full workflow: login then initialize:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>"
       ],
-      "flags": {},
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Force re-initialization without confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "init",
@@ -251,6 +259,38 @@
         "login.js"
       ]
     },
+    "logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Log out of ByteRover CLI and clear authentication (does not affect local project files)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logout",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logout.js"
+      ]
+    },
     "push": {
       "aliases": [],
       "args": {},
@@ -479,5 +519,5 @@
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -47,10 +47,8 @@
     "./dist",
     "./oclif.manifest.json"
   ],
-  "homepage": "https://github.com/campfirein/byterover-cli",
-  "keywords": [
-    "oclif"
-  ],
+  "homepage": "https://www.byterover.dev/",
+  "keywords": [],
   "license": "UNLICENSED",
   "main": "dist/index.js",
   "type": "module",