byterover-cli 0.1.1 → 0.2.1

package/dist/infra/config/file-config-store.d.ts

@@ -1,19 +1,17 @@
 import type { IProjectConfigStore } from '../../core/interfaces/i-project-config-store.js';
-import { BrConfig } from '../../core/domain/entities/br-config.js';
+import { BrvConfig } from '../../core/domain/entities/brv-config.js';
 /**
  * File-based implementation of IProjectConfigStore.
- * Stores configuration in .br/config.json in the project directory.
+ * Stores configuration in .brv/config.json in the project directory.
  */
 export declare class ProjectConfigStore implements IProjectConfigStore {
-    private static readonly BR_DIR;
-    private static readonly CONFIG_FILE;
     exists(directory?: string): Promise<boolean>;
-    read(directory?: string): Promise<BrConfig | undefined>;
-    write(config: BrConfig, directory?: string): Promise<void>;
+    read(directory?: string): Promise<BrvConfig | undefined>;
+    write(config: BrvConfig, directory?: string): Promise<void>;
     /**
-     * Gets the full path to the .br directory.
+     * Gets the full path to the .brv directory.
      */
-    private getBrDirPath;
+    private getBrvDirPath;
     /**
      * Gets the full path to the config.json file.
      */

package/dist/infra/config/file-config-store.js

@@ -1,14 +1,13 @@
 import { existsSync } from 'node:fs';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { BrConfig } from '../../core/domain/entities/br-config.js';
+import { BRV_DIR, PROJECT_CONFIG_FILE } from '../../constants.js';
+import { BrvConfig } from '../../core/domain/entities/brv-config.js';
 /**
  * File-based implementation of IProjectConfigStore.
- * Stores configuration in .br/config.json in the project directory.
+ * Stores configuration in .brv/config.json in the project directory.
  */
 export class ProjectConfigStore {
-    static BR_DIR = '.br';
-    static CONFIG_FILE = 'config.json';
     async exists(directory) {
         const configPath = this.getConfigPath(directory);
         return existsSync(configPath);
@@ -21,17 +20,17 @@ export class ProjectConfigStore {
         try {
             const content = await readFile(configPath, 'utf8');
             const json = JSON.parse(content);
-            return BrConfig.fromJson(json);
+            return BrvConfig.fromJson(json);
         }
         catch (error) {
             throw new Error(`Failed to read config from ${configPath}: ${error.message}`);
         }
     }
     async write(config, directory) {
-        const brDirPath = this.getBrDirPath(directory);
+        const brDirPath = this.getBrvDirPath(directory);
         const configPath = this.getConfigPath(directory);
         try {
-            // Create .br directory if it doesn't exist
+            // Create .brv directory if it doesn't exist
             await mkdir(brDirPath, { recursive: true });
             // Write config.json
             const content = JSON.stringify(config.toJson(), undefined, 2);
@@ -42,16 +41,16 @@ export class ProjectConfigStore {
         }
     }
     /**
-     * Gets the full path to the .br directory.
+     * Gets the full path to the .brv directory.
      */
-    getBrDirPath(directory) {
+    getBrvDirPath(directory) {
         const baseDir = directory ?? process.cwd();
-        return join(baseDir, ProjectConfigStore.BR_DIR);
+        return join(baseDir, BRV_DIR);
     }
     /**
      * Gets the full path to the config.json file.
      */
     getConfigPath(directory) {
-        return join(this.getBrDirPath(directory), ProjectConfigStore.CONFIG_FILE);
+        return join(this.getBrvDirPath(directory), PROJECT_CONFIG_FILE);
     }
 }

package/dist/infra/playbook/file-playbook-service.d.ts

@@ -13,7 +13,6 @@ export type PlaybookServiceConfig = {
  * bullet management, delta application, and reflection tag processing.
  */
 export declare class FilePlaybookService implements IPlaybookService {
-    private static readonly BULLETS_DIR;
     private static readonly SUBDIRS;
     private readonly config;
     private readonly playbookStore;

package/dist/infra/playbook/file-playbook-service.js

@@ -1,6 +1,6 @@
 import { mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
-import { ACE_DIR, BR_DIR, DELTAS_DIR, EXECUTOR_OUTPUTS_DIR, REFLECTIONS_DIR } from '../../constants.js';
+import { ACE_DIR, BRV_DIR, BULLETS_DIR, DELTAS_DIR, EXECUTOR_OUTPUTS_DIR, REFLECTIONS_DIR } from '../../constants.js';
 import { Playbook } from '../../core/domain/entities/playbook.js';
 import { FilePlaybookStore } from '../ace/file-playbook-store.js';
 /**
@@ -9,8 +9,7 @@ import { FilePlaybookStore } from '../ace/file-playbook-store.js';
  * bullet management, delta application, and reflection tag processing.
  */
 export class FilePlaybookService {
-    static BULLETS_DIR = 'bullets';
-    static SUBDIRS = [REFLECTIONS_DIR, EXECUTOR_OUTPUTS_DIR, DELTAS_DIR, FilePlaybookService.BULLETS_DIR];
+    static SUBDIRS = [REFLECTIONS_DIR, EXECUTOR_OUTPUTS_DIR, DELTAS_DIR, BULLETS_DIR];
     config;
     playbookStore;
     constructor(config = {}, playbookStore = new FilePlaybookStore()) {
@@ -87,7 +86,7 @@ export class FilePlaybookService {
         // Load playbook
         const playbook = await this.playbookStore.load(directory);
         if (!playbook) {
-            throw new Error('Playbook not found. Run `br init` to initialize.');
+            throw new Error('Playbook not found. Run `brv init` to initialize.');
         }
         // Apply tags from reflection
         let tagsApplied = 0;
@@ -114,16 +113,16 @@ export class FilePlaybookService {
     }
     async initialize(directory) {
         const baseDir = directory ?? this.config.baseDirectory ?? process.cwd();
-        const brDir = join(baseDir, BR_DIR);
-        const aceDir = join(brDir, ACE_DIR);
-        // Create .br/ace/ directory
+        const brvDir = join(baseDir, BRV_DIR);
+        const aceDir = join(brvDir, ACE_DIR);
+        // Create .brv/ace/ directory
         await mkdir(aceDir, { recursive: true });
         // Create subdirectories
         await Promise.all(FilePlaybookService.SUBDIRS.map((subdir) => mkdir(join(aceDir, subdir), { recursive: true })));
         // Check if playbook already exists
         const exists = await this.playbookStore.exists(directory ?? this.config.baseDirectory);
         if (exists) {
-            throw new Error('Playbook already exists. Use `br clear` to remove it first.');
+            throw new Error('Playbook already exists. Use `brv clear` to remove it first.');
         }
         // Create empty playbook
         const playbook = new Playbook();

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/README.md

@@ -1,6 +1,6 @@
 # ByteRover CLI Template System
 
-This directory contains template files used to generate agent instructions via the `br gen-rules` command.
+This directory contains template files used to generate agent instructions via the `brv gen-rules` command.
 
 ## Directory Structure
 
@@ -44,7 +44,7 @@ Each command includes:
 
 ## How It Works
 
-1. User runs `br gen-rules`
+1. User runs `brv gen-rules`
 2. User selects an agent (e.g., "Claude Code")
 3. `RuleTemplateService` loads templates via `FsTemplateLoader`
 4. Templates are assembled:
@@ -62,10 +62,10 @@ The template system supports simple variable substitution using `{{variable_name
 ## Updating Templates
 
 ### To Update Command Documentation:
-Edit `sections/command-reference.md` - changes will be reflected next time `br gen-rules` runs.
+Edit `sections/command-reference.md` - changes will be reflected next time `brv gen-rules` runs.
 
 ### To Update ACE Workflow Guide:
-Edit `sections/workflow.md` - changes will be reflected next time `br gen-rules` runs.
+Edit `sections/workflow.md` - changes will be reflected next time `brv gen-rules` runs.
 
 ### To Change Output Structure:
 Edit `base.md` - modify how sections are combined.
@@ -75,7 +75,7 @@ Edit `base.md` - modify how sections are combined.
 1. **Keep templates in sync with code**: When adding/modifying commands, update `command-reference.md`
 2. **Use clear examples**: Show realistic use cases in examples
 3. **Maintain markdown formatting**: Ensure proper headers, code blocks, and lists
-4. **Test after changes**: Run `br gen-rules` and verify output in `.clinerules/byterover-rules.md`
+4. **Test after changes**: Run `brv gen-rules` and verify output in `.clinerules/byterover-rules.md`
 
 ## Future Enhancements
 

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

@@ -2,7 +2,7 @@
 
 ## Memory Commands
 
-### `br add`
+### `brv add`
 
 **Description:** Add or update a bullet in the playbook (bypasses ACE workflow for direct agent usage)
 
@@ -15,9 +15,9 @@
 **Examples:**
 
 ```bash
-br add --section "Common Errors" --content "Authentication fails when token expires"
-br add --section "Common Errors" --bullet-id "common-00001" --content "Updated: Auth fails when token expires"
-br add -s "Best Practices" -c "Always validate user input before processing"
+brv add --section "Common Errors" --content "Authentication fails when token expires"
+brv add --section "Common Errors" --bullet-id "common-00001" --content "Updated: Auth fails when token expires"
+brv add -s "Best Practices" -c "Always validate user input before processing"
 ```
 
 **Suggested Sections:** Common Errors, Best Practices, Strategies, Lessons Learned, Project Structure and Dependencies, Testing, Code Style and Quality, Styling and Design
@@ -29,11 +29,11 @@ br add -s "Best Practices" -c "Always validate user input before processing"
 - Updates existing bullet if `--bullet-id` matches existing bullet
 - Displays bullet ID, section, content, and tags after operation
 
-**Requirements:** Playbook must exist (run `br init` first)
+**Requirements:** Playbook must exist (run `brv init` first)
 
 ---
 
-### `br retrieve`
+### `brv retrieve`
 
 **Description:** Retrieve memories from ByteRover Memora service and save to local ACE playbook
 
@@ -45,9 +45,9 @@ br add -s "Best Practices" -c "Always validate user input before processing"
 **Examples:**
 
 ```bash
-br retrieve --query "authentication best practices"
-br retrieve -q "error handling" -n "src/auth/login.ts,src/auth/oauth.ts"
-br retrieve -q "database connection issues"
+brv retrieve --query "authentication best practices"
+brv retrieve -q "error handling" -n "src/auth/login.ts,src/auth/oauth.ts"
+brv retrieve -q "database connection issues"
 ```
 
 **Behavior:**
@@ -65,24 +65,25 @@ br retrieve -q "database connection issues"
 
 ---
 
-### `br push`
+### `brv push`
 
 **Description:** Push playbook to ByteRover memory storage and clean up local ACE files
 
 **Flags:**
 
 - `-b, --branch <string>`: ByteRover branch name (default: "main", NOT git branch)
+- `-y, --yes`: Skip confirmation prompt
 
 **Examples:**
 
 ```bash
-br push
-br push --branch develop
+brv push
+brv push --branch develop
 ```
 
 ---
 
-### `br complete`
+### `brv complete`
 
 **Description:** Complete ACE workflow: save executor output, generate reflection, and update playbook in one command
 
@@ -102,9 +103,9 @@ br push --branch develop
 **Examples:**
 
 ```bash
-br complete "user-auth" "Implemented OAuth2 flow" "Auth works" --tool-usage "Read:src/auth.ts,Edit:src/auth.ts,Bash:npm test" --feedback "All tests passed"
-br complete "validation-fix" "Analyzed validator" "Fixed bug" --tool-usage "Grep:pattern:\"validate\",Read:src/validator.ts" --bullet-ids "bullet-123" --feedback "Tests passed"
-br complete "auth-update" "Improved error handling" "Better errors" --tool-usage "Edit:src/auth.ts" --feedback "Tests passed" --update-bullet "bullet-5"
+brv complete "user-auth" "Implemented OAuth2 flow" "Auth works" --tool-usage "Read:src/auth.ts,Edit:src/auth.ts,Bash:npm test" --feedback "All tests passed"
+brv complete "validation-fix" "Analyzed validator" "Fixed bug" --tool-usage "Grep:pattern:\"validate\",Read:src/validator.ts" --bullet-ids "bullet-123" --feedback "Tests passed"
+brv complete "auth-update" "Improved error handling" "Better errors" --tool-usage "Edit:src/auth.ts" --feedback "Tests passed" --update-bullet "bullet-5"
 ```
 
 **Behavior:**
@@ -120,22 +121,39 @@ br complete "auth-update" "Improved error handling" "Better errors" --tool-usage
 
 ---
 
-### `br 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
 
 ### Efficient Workflow
 
-1. **Retrieve wisely:** Use `br retrieve` with specific queries and `--node-keys` to filter
-2. **Read only what's needed:** Check playbook with `br status` to see statistics before reading full content
-3. **Update precisely:** Use `br add` to add/update specific bullets or `br complete` for complete workflow
-4. **Push when appropriate:** Prompt user to run `br push` after completing significant work
+1. **Retrieve wisely:** Use `brv retrieve` with specific queries and `--node-keys` to filter
+2. **Read only what's needed:** Check playbook with `brv status` to see statistics before reading full content
+3. **Update precisely:** Use `brv add` to add/update specific bullets or `brv complete` for complete workflow
+4. **Push when appropriate:** Prompt user to run `brv push` after completing significant work
 
 ### Memory Management
 
 **Retrieve pattern:**
 
-- Use `br add` to directly add/update bullets
-- `br retrieve` **clears existing playbook** - use carefully
+- Use `brv add` to directly add/update bullets
+- `brv retrieve` **clears existing playbook** - use carefully
 - Retrieved memories use actual Memora tags (not "auto-generated")
 - Both memories and related memories are saved to playbook

package/dist/templates/sections/workflow.md

@@ -1,6 +1,6 @@
 # Workflow Instruction
 
-You are a coding agent focused on one codebase. Use the br CLI to manage working context.
+You are a coding agent focused on one codebase. Use the brv CLI to manage working context.
 Core Rules:
 
 - Start from memory. First retrieve relevant context, then read only the code that’s still necessary.
@@ -8,31 +8,30 @@ Core Rules:
 
 ## user-centric
 
-Before running any `br` command, ask the user to choose:
+Before running any `brv` command, ask the user to choose:
 
 1. **Accept** - Review the command, then run if approved
 2. **Auto-run** - Execute immediately (remember this preference for the session)
 3. **No** - Cancel the command and continue without alternative
 4. **Custom** - Skip the command and provide different instruction
 
-Once the user chooses "Auto-run", apply that preference to all subsequent `br` commands in this conversation without asking again.
-
+Once the user chooses "Auto-run", apply that preference to all subsequent `brv` commands in this conversation without asking again.
 
 ## 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

@@ -204,13 +204,21 @@
     "init": {
       "aliases": [],
       "args": {},
-      "description": "Initialize a project with ByteRover (creates .br/config.json with team/space selection and initializes ACE playbook)",
+      "description": "Initialize a project with ByteRover (creates .brv/config.json with team/space selection and initializes ACE playbook)",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "# 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": {},
@@ -456,7 +496,7 @@
     "space:switch": {
       "aliases": [],
       "args": {},
-      "description": "Switch to a different team or space (updates .br/config.json)",
+      "description": "Switch to a different team or space (updates .brv/config.json)",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "# Shows current configuration, then prompts for new team/space selection"
@@ -479,5 +519,5 @@
       ]
     }
   },
-  "version": "0.1.1"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "author": "ByteRover",
   "bin": {
-    "br": "./bin/run.js"
+    "brv": "./bin/run.js"
   },
   "bugs": "https://github.com/campfirein/byterover-cli/issues",
   "dependencies": {
@@ -47,17 +47,18 @@
     "./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",
   "oclif": {
-    "bin": "br",
-    "dirname": "br",
+    "bin": "brv",
+    "dirname": "brv",
     "commands": "./dist/commands",
+    "hooks": {
+      "init": "./dist/hooks/init/welcome"
+    },
     "plugins": [
       "@oclif/plugin-help"
     ],