byterover-cli 0.1.1 → 0.2.1

package/dist/commands/space/list.js

@@ -51,13 +51,18 @@ export default class SpaceList extends Command {
             // Check project initialization
             const projectConfig = await projectConfigStore.read();
             if (projectConfig === undefined) {
-                this.error('Project not initialized. Run "br init" first.');
+                this.error('Project not initialized. Run "brv init" first.');
             }
             const token = await this.validateAuth(tokenStore);
             // Fetch spaces for the team from project config
             ux.action.start(`Fetching spaces for ${projectConfig.teamName}`);
-            const result = await spaceService.getSpaces(token.accessToken, token.sessionKey, projectConfig.teamId, flags.all ? { fetchAll: true } : { limit: flags.limit, offset: flags.offset });
-            ux.action.stop();
+            let result;
+            try {
+                result = await spaceService.getSpaces(token.accessToken, token.sessionKey, projectConfig.teamId, flags.all ? { fetchAll: true } : { limit: flags.limit, offset: flags.offset });
+            }
+            finally {
+                ux.action.stop();
+            }
             // Handle empty results
             if (result.spaces.length === 0) {
                 this.log(`No spaces found in team "${projectConfig.teamName}".`);
@@ -95,10 +100,10 @@ export default class SpaceList extends Command {
     async validateAuth(tokenStore) {
         const token = await tokenStore.load();
         if (token === undefined) {
-            this.error('Not authenticated. Please run "br login" first.');
+            this.error('Not authenticated. Please run "brv login" first.');
         }
         if (!token.isValid()) {
-            this.error('Authentication token expired. Please run "br login" again.');
+            this.error('Authentication token expired. Please run "brv login" again.');
         }
         return token;
     }

package/dist/commands/space/switch.js

@@ -1,13 +1,14 @@
 import { select } from '@inquirer/prompts';
 import { Command, ux } from '@oclif/core';
 import { getCurrentConfig } from '../../config/environment.js';
-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';
 import { ProjectConfigStore } from '../../infra/config/file-config-store.js';
 import { HttpSpaceService } from '../../infra/space/http-space-service.js';
 import { KeychainTokenStore } from '../../infra/storage/keychain-token-store.js';
 import { HttpTeamService } from '../../infra/team/http-team-service.js';
 export default class SpaceSwitch extends Command {
-    static description = 'Switch to a different team or space (updates .br/config.json)';
+    static description = `Switch to a different team or space (updates ${BRV_DIR}/${PROJECT_CONFIG_FILE})`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '# Shows current configuration, then prompts for new team/space selection',
@@ -59,7 +60,7 @@ export default class SpaceSwitch extends Command {
             // Check project initialization (MUST exist for switch)
             const currentConfig = await projectConfigStore.read();
             if (currentConfig === undefined) {
-                this.error('Project not initialized. Run "br init" first.');
+                this.error('Project not initialized. Run "brv init" first.');
             }
             // Show current configuration
             this.log('Current configuration:');
@@ -69,10 +70,10 @@ export default class SpaceSwitch extends Command {
             // Validate authentication
             const token = await tokenStore.load();
             if (token === undefined) {
-                this.error('Not authenticated. Please run "br login" first.');
+                this.error('Not authenticated. Please run "brv login" first.');
             }
             if (!token.isValid()) {
-                this.error('Authentication token expired. Please run "br login" again.');
+                this.error('Authentication token expired. Please run "brv login" again.');
             }
             // Fetch all teams
             ux.action.start('Fetching all teams');
@@ -97,11 +98,11 @@ export default class SpaceSwitch extends Command {
             this.log();
             const selectedSpace = await this.promptForSpaceSelection(spaceResult.spaces);
             // Update configuration
-            const newConfig = BrConfig.fromSpace(selectedSpace);
+            const newConfig = BrvConfig.fromSpace(selectedSpace);
             await projectConfigStore.write(newConfig);
             // Display success
             this.log(`\n✓ Successfully switched to space: ${selectedSpace.getDisplayName()}`);
-            this.log(`✓ Configuration updated in: .br/config.json`);
+            this.log(`✓ Configuration updated in: ${BRV_DIR}/${PROJECT_CONFIG_FILE}`);
         }
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Switch failed');

package/dist/commands/status.js

@@ -1,6 +1,6 @@
 import { Args, Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
-import { ACE_DIR, BR_DIR, BULLETS_DIR } from '../constants.js';
+import { ACE_DIR, BRV_DIR, BULLETS_DIR } from '../constants.js';
 import { FilePlaybookStore } from '../infra/ace/file-playbook-store.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
@@ -80,7 +80,7 @@ export default class Status extends Command {
         try {
             const playbook = await playbookStore.load(args.directory);
             if (!playbook) {
-                this.error('Playbook not found. Run `br init` to initialize.');
+                this.error('Playbook not found. Run `brv init` to initialize.');
             }
             // Display based on format
             if (flags.format === 'json') {
@@ -90,7 +90,7 @@ export default class Status extends Command {
             const bullets = playbook.getBullets();
             const sections = playbook.getSections();
             if (bullets.length === 0) {
-                this.log('Playbook is empty. Use "br add" commands to add knowledge.');
+                this.log('Playbook is empty. Use "brv add" commands to add knowledge.');
                 return;
             }
             this.log(`\nMemory not pushed to cloud:`);
@@ -101,12 +101,12 @@ export default class Status extends Command {
                 this.log(`# ${section}`);
                 const sectionBullets = playbook.getBulletsInSection(section);
                 for (const bullet of sectionBullets) {
-                    const relativePath = `${BR_DIR}/${ACE_DIR}/${BULLETS_DIR}/${bullet.id}.md`;
+                    const relativePath = `${BRV_DIR}/${ACE_DIR}/${BULLETS_DIR}/${bullet.id}.md`;
                     // Display like git status: red path
                     this.log(`  ${chalk.red(relativePath)}`);
                 }
             }
-            this.log(`\nUse "br push" to push playbook to ByteRover memory storage.`);
+            this.log(`\nUse "brv push" to push playbook to ByteRover memory storage.`);
         }
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Failed to load playbook statistics');

package/dist/config/environment.d.ts

@@ -4,8 +4,8 @@
 type Environment = 'development' | 'production';
 /**
  * Current environment - set at runtime by the launcher scripts.
- * - `./bin/dev.js` sets BR_ENV=development
- * - `./bin/run.js` sets BR_ENV=production
+ * - `./bin/dev.js` sets BRV_ENV=development
+ * - `./bin/run.js` sets BRV_ENV=production
  */
 export declare const ENVIRONMENT: Environment;
 /**
@@ -21,6 +21,7 @@ type EnvironmentConfig = {
     mixpanelToken: string;
     scopes: string[];
     tokenUrl: string;
+    webAppUrl: string;
 };
 /**
  * Configuration for each environment.

package/dist/config/environment.js

@@ -1,9 +1,9 @@
 /**
  * Current environment - set at runtime by the launcher scripts.
- * - `./bin/dev.js` sets BR_ENV=development
- * - `./bin/run.js` sets BR_ENV=production
+ * - `./bin/dev.js` sets BRV_ENV=development
+ * - `./bin/run.js` sets BRV_ENV=production
  */
-export const ENVIRONMENT = process.env.BR_ENV ?? 'development';
+export const ENVIRONMENT = process.env.BRV_ENV ?? 'development';
 /**
  * Configuration for each environment.
  * These values are bundled at build time.
@@ -19,6 +19,7 @@ export const ENV_CONFIG = {
         mixpanelToken: '258e1a2b3d44cc634ef28964771b1da0',
         scopes: ['read', 'write', 'debug'],
         tokenUrl: 'https://dev-beta-iam.byterover.dev/api/v1/oidc/token',
+        webAppUrl: 'https://dev-beta-app.byterover.dev/',
     },
     production: {
         apiBaseUrl: 'https://beta-iam.byterover.dev/api/v1',
@@ -30,6 +31,7 @@ export const ENV_CONFIG = {
         mixpanelToken: '4d1198b346d2d6ac75f2e77905cc65ac',
         scopes: ['read', 'write'],
         tokenUrl: 'https://beta-iam.byterover.dev/api/v1/oidc/token',
+        webAppUrl: 'https://beta-app.byterover.dev',
     },
 };
 /**

package/dist/constants.d.ts

@@ -1,11 +1,18 @@
-export declare const BR_DIR = ".br";
+export declare const BRV_DIR = ".brv";
+export declare const PROJECT_CONFIG_FILE = "config.json";
 export declare const ACE_DIR = "ace";
 export declare const EXECUTOR_OUTPUTS_DIR = "executor-outputs";
 export declare const REFLECTIONS_DIR = "reflections";
 export declare const DELTAS_DIR = "deltas";
 export declare const BULLETS_DIR = "bullets";
+export declare const PLAYBOOK_FILE = "playbook.json";
 /**
  * Default ByteRover branch name for memory storage.
  * This is ByteRover's internal branching mechanism, not Git branches.
  */
 export declare const DEFAULT_BRANCH = "main";
+/**
+ * ByteRover documentation URL.
+ * Used in CLI help output to direct users to online documentation.
+ */
+export declare const DOCS_URL = "https://docs.byterover.dev/beta";

package/dist/constants.js

@@ -1,12 +1,19 @@
+export const BRV_DIR = '.brv';
+export const PROJECT_CONFIG_FILE = 'config.json';
 // ACE directory structure constants
-export const BR_DIR = '.br';
 export const ACE_DIR = 'ace';
 export const EXECUTOR_OUTPUTS_DIR = 'executor-outputs';
 export const REFLECTIONS_DIR = 'reflections';
 export const DELTAS_DIR = 'deltas';
 export const BULLETS_DIR = 'bullets';
+export const PLAYBOOK_FILE = 'playbook.json';
 /**
  * Default ByteRover branch name for memory storage.
  * This is ByteRover's internal branching mechanism, not Git branches.
  */
 export const DEFAULT_BRANCH = 'main';
+/**
+ * ByteRover documentation URL.
+ * Used in CLI help output to direct users to online documentation.
+ */
+export const DOCS_URL = 'https://docs.byterover.dev/beta';

package/dist/core/domain/entities/{br-config.d.ts → brv-config.d.ts}

@@ -1,9 +1,9 @@
 import { Space } from './space.js';
 /**
- * Represents the configuration stored in .br/config.json
+ * Represents the configuration stored in .brv/config.json
  * This config links a project directory to a ByteRover space.
  */
-export declare class BrConfig {
+export declare class BrvConfig {
     readonly createdAt: string;
     readonly spaceId: string;
     readonly spaceName: string;
@@ -13,11 +13,11 @@ export declare class BrConfig {
     /**
      * Deserializes config from JSON format
      */
-    static fromJson(json: Record<string, string>): BrConfig;
+    static fromJson(json: Record<string, string>): BrvConfig;
     /**
-     * Creates a BrConfig from a Space entity
+     * Creates a BrvConfig from a Space entity
      */
-    static fromSpace(space: Space): BrConfig;
+    static fromSpace(space: Space): BrvConfig;
     /**
      * Serializes the config to JSON format
      */

package/dist/core/domain/entities/{br-config.js → brv-config.js}

@@ -1,8 +1,8 @@
 /**
- * Represents the configuration stored in .br/config.json
+ * Represents the configuration stored in .brv/config.json
  * This config links a project directory to a ByteRover space.
  */
-export class BrConfig {
+export class BrvConfig {
     createdAt;
     spaceId;
     spaceName;
@@ -35,13 +35,13 @@ export class BrConfig {
      * Deserializes config from JSON format
      */
     static fromJson(json) {
-        return new BrConfig(json.createdAt, json.spaceId, json.spaceName, json.teamId, json.teamName);
+        return new BrvConfig(json.createdAt, json.spaceId, json.spaceName, json.teamId, json.teamName);
     }
     /**
-     * Creates a BrConfig from a Space entity
+     * Creates a BrvConfig from a Space entity
      */
     static fromSpace(space) {
-        return new BrConfig(new Date().toISOString(), space.id, space.name, space.teamId, space.teamName);
+        return new BrvConfig(new Date().toISOString(), space.id, space.name, space.teamId, space.teamName);
     }
     /**
      * Serializes the config to JSON format

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-playbook-service.d.ts

@@ -60,7 +60,7 @@ export interface IPlaybookService {
     }>;
     /**
      * Initializes the ACE playbook directory structure and creates an empty playbook.
-     * Creates .br/ace/ directory with subdirectories: reflections/, executor-outputs/, deltas/
+     * Creates .brv/ace/ directory with subdirectories: reflections/, executor-outputs/, deltas/
      * @param directory - Optional base directory (defaults to current working directory)
      * @returns The absolute path to the created playbook file
      * @throws Error if playbook already exists or initialization fails

package/dist/core/interfaces/i-project-config-store.d.ts

@@ -1,26 +1,26 @@
-import type { BrConfig } from '../domain/entities/br-config.js';
+import type { BrvConfig } from '../domain/entities/brv-config.js';
 /**
  * Interface for storing and retrieving ByteRover CLI configuration.
- * Implementations handle persistence of .br/config.json files.
+ * Implementations handle persistence of .brv/config.json files.
  */
 export interface IProjectConfigStore {
     /**
-     * Checks if a configuration file exists in the .br directory.
+     * Checks if a configuration file exists in the .brv directory.
      * @param directory The project directory to check (defaults to current working directory).
-     * @returns True if .br/config.json exists, false otherwise.
+     * @returns True if .brv/config.json exists, false otherwise.
      */
     exists: (directory?: string) => Promise<boolean>;
     /**
-     * Reads the configuration from the .br directory.
-     * @param directory The project directory containing .br folder (defaults to current working directory)
+     * Reads the configuration from the .brv directory.
+     * @param directory The project directory containing .brv folder (defaults to current working directory)
      * @returns The configuration if found, undefined otherwise
      */
-    read: (directory?: string) => Promise<BrConfig | undefined>;
+    read: (directory?: string) => Promise<BrvConfig | undefined>;
     /**
-     * Writes the configuration to the .br directory.
+     * Writes the configuration to the .brv directory.
      * @param config The configuration to write.
-     * @param directory The project directory to create .br folder in (defaults to current working directory)
+     * @param directory The project directory to create .brv folder in (defaults to current working directory)
      * @returns
      */
-    write: (config: BrConfig, directory?: string) => Promise<void>;
+    write: (config: BrvConfig, directory?: string) => Promise<void>;
 }

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/hooks/init/welcome.d.ts

@@ -0,0 +1,3 @@
+import type { Hook } from '@oclif/core';
+declare const hook: Hook<'init'>;
+export default hook;

package/dist/hooks/init/welcome.js

@@ -0,0 +1,31 @@
+import chalk from 'chalk';
+import { DOCS_URL } from '../../constants.js';
+const hook = async function (options) {
+    // Detect root help commands only (not command-specific help)
+    const isRootHelp = (options.id === undefined && options.argv.length === 0) || // bare `brv`
+        (options.id === '--help' && options.argv.length === 0) || // `brv --help`
+        (options.id === 'help' && options.argv.length === 0); // `brv help`
+    if (isRootHelp) {
+        const logo = [
+            chalk.greenBright('  ____        _       ____                       '),
+            chalk.greenBright(String.raw ` | __ ) _   _| |_ ___|  _ \ _____   _____ _ __  `),
+            chalk.green(String.raw ` |  _ \| | | | __/ _ \ |_) / _ \ \ / / _ \ '__| `),
+            chalk.greenBright(String.raw ` | |_) | |_| | ||  __/  _ < (_) \ V /  __/ |    `),
+            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 connection and explore commands like `brv retrieve` or `brv complete`.',
+        ].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`);
+    }
+};
+export default hook;

package/dist/infra/ace/ace-file-utils.js

@@ -1,6 +1,6 @@
 import { mkdir, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { ACE_DIR, BR_DIR } from '../../constants.js';
+import { ACE_DIR, BRV_DIR } from '../../constants.js';
 import { DeltaBatch } from '../../core/domain/entities/delta-batch.js';
 import { ExecutorOutput } from '../../core/domain/entities/executor-output.js';
 import { ReflectorOutput } from '../../core/domain/entities/reflector-output.js';
@@ -38,7 +38,7 @@ export function generateTimestampedFilename(type, hint) {
  */
 export async function ensureAceDirectory(baseDir, subdir) {
     const resolvedBaseDir = baseDir ?? process.cwd();
-    const aceSubdir = join(resolvedBaseDir, BR_DIR, ACE_DIR, subdir);
+    const aceSubdir = join(resolvedBaseDir, BRV_DIR, ACE_DIR, subdir);
     await mkdir(aceSubdir, { recursive: true });
     return aceSubdir;
 }

package/dist/infra/ace/file-bullet-content-store.d.ts

@@ -1,7 +1,7 @@
 import type { IBulletContentStore } from '../../core/interfaces/i-bullet-content-store.js';
 /**
  * File-based implementation of IBulletContentStore.
- * Stores bullet content in .br/ace/bullets/{bullet-id}.md files.
+ * Stores bullet content in .brv/ace/bullets/{bullet-id}.md files.
  */
 export declare class FileBulletContentStore implements IBulletContentStore {
     delete(bulletId: string, directory?: string): Promise<void>;
@@ -9,15 +9,15 @@ export declare class FileBulletContentStore implements IBulletContentStore {
     load(bulletId: string, directory?: string): Promise<string | undefined>;
     save(bulletId: string, content: string, directory?: string): Promise<string>;
     /**
-     * Gets the full path to the .br/ace directory
+     * Gets the full path to the .brv/ace directory
      */
     private getAceDirPath;
     /**
-     * Gets the full path to the .br directory
+     * Gets the full path to the .brv directory
      */
     private getBrDirPath;
     /**
-     * Gets the full path to the .br/ace/bullets directory
+     * Gets the full path to the .brv/ace/bullets directory
      */
     private getBulletsDirPath;
     /**

package/dist/infra/ace/file-bullet-content-store.js

@@ -1,10 +1,10 @@
 import { existsSync } from 'node:fs';
 import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { ACE_DIR, BR_DIR, BULLETS_DIR } from '../../constants.js';
+import { ACE_DIR, BRV_DIR, BULLETS_DIR } from '../../constants.js';
 /**
  * File-based implementation of IBulletContentStore.
- * Stores bullet content in .br/ace/bullets/{bullet-id}.md files.
+ * Stores bullet content in .brv/ace/bullets/{bullet-id}.md files.
  */
 export class FileBulletContentStore {
     async delete(bulletId, directory) {
@@ -43,7 +43,7 @@ export class FileBulletContentStore {
         const bulletsDirPath = this.getBulletsDirPath(directory);
         const contentPath = this.getContentPath(bulletId, directory);
         try {
-            // Create .br/ace/bullets directory if it doesn't exist
+            // Create .brv/ace/bullets directory if it doesn't exist
             await mkdir(bulletsDirPath, { recursive: true });
             // Add warning header to content
             const header = `<!--
@@ -62,20 +62,20 @@ Renaming this file will break the link to the playbook metadata.
         }
     }
     /**
-     * Gets the full path to the .br/ace directory
+     * Gets the full path to the .brv/ace directory
      */
     getAceDirPath(directory) {
         return join(this.getBrDirPath(directory), ACE_DIR);
     }
     /**
-     * Gets the full path to the .br directory
+     * Gets the full path to the .brv directory
      */
     getBrDirPath(directory) {
         const baseDir = directory ?? process.cwd();
-        return join(baseDir, BR_DIR);
+        return join(baseDir, BRV_DIR);
     }
     /**
-     * Gets the full path to the .br/ace/bullets directory
+     * Gets the full path to the .brv/ace/bullets directory
      */
     getBulletsDirPath(directory) {
         return join(this.getAceDirPath(directory), BULLETS_DIR);

package/dist/infra/ace/file-delta-store.d.ts

@@ -2,7 +2,7 @@ import type { DeltaBatch } from '../../core/domain/entities/delta-batch.js';
 import type { IDeltaStore } from '../../core/interfaces/i-delta-store.js';
 /**
  * File-based implementation of IDeltaStore.
- * Stores delta batches as JSON files in .br/ace/deltas/ directory.
+ * Stores delta batches as JSON files in .brv/ace/deltas/ directory.
  */
 export declare class FileDeltaStore implements IDeltaStore {
     save(deltaBatch: DeltaBatch, hint?: string, directory?: string): Promise<string>;

package/dist/infra/ace/file-delta-store.js

@@ -4,7 +4,7 @@ import { DELTAS_DIR } from '../../constants.js';
 import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
 /**
  * File-based implementation of IDeltaStore.
- * Stores delta batches as JSON files in .br/ace/deltas/ directory.
+ * Stores delta batches as JSON files in .brv/ace/deltas/ directory.
  */
 export class FileDeltaStore {
     async save(deltaBatch, hint, directory) {

package/dist/infra/ace/file-executor-output-store.d.ts

@@ -2,7 +2,7 @@ import type { ExecutorOutput } from '../../core/domain/entities/executor-output.
 import type { IExecutorOutputStore } from '../../core/interfaces/i-executor-output-store.js';
 /**
  * File-based implementation of IExecutorOutputStore.
- * Stores executor outputs as JSON files in .br/ace/executor-outputs/ directory.
+ * Stores executor outputs as JSON files in .brv/ace/executor-outputs/ directory.
  */
 export declare class FileExecutorOutputStore implements IExecutorOutputStore {
     save(output: ExecutorOutput, directory?: string): Promise<string>;

package/dist/infra/ace/file-executor-output-store.js

@@ -4,7 +4,7 @@ import { EXECUTOR_OUTPUTS_DIR } from '../../constants.js';
 import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
 /**
  * File-based implementation of IExecutorOutputStore.
- * Stores executor outputs as JSON files in .br/ace/executor-outputs/ directory.
+ * Stores executor outputs as JSON files in .brv/ace/executor-outputs/ directory.
  */
 export class FileExecutorOutputStore {
     async save(output, directory) {

package/dist/infra/ace/file-playbook-store.d.ts

@@ -3,7 +3,7 @@ import type { IPlaybookStore } from '../../core/interfaces/i-playbook-store.js';
 import { Playbook } from '../../core/domain/entities/playbook.js';
 /**
  * File-based implementation of IPlaybookStore.
- * Stores playbook metadata in .br/ace/playbook.json and bullet content in .br/ace/bullets/{id}.md files.
+ * Stores playbook metadata in .brv/ace/playbook.json and bullet content in .brv/ace/bullets/{id}.md files.
  */
 export declare class FilePlaybookStore implements IPlaybookStore {
     private static readonly PLAYBOOK_FILE;
@@ -15,11 +15,11 @@ export declare class FilePlaybookStore implements IPlaybookStore {
     load(directory?: string): Promise<Playbook | undefined>;
     save(playbook: Playbook, directory?: string): Promise<void>;
     /**
-     * Gets the full path to the .br/ace directory
+     * Gets the full path to the .brv/ace directory
      */
     private getAceDirPath;
     /**
-     * Gets the full path to the .br directory
+     * Gets the full path to the .brv directory
      */
     private getBrDirPath;
     /**

package/dist/infra/ace/file-playbook-store.js

@@ -1,13 +1,13 @@
 import { existsSync } from 'node:fs';
 import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { ACE_DIR, BR_DIR } from '../../constants.js';
+import { ACE_DIR, BRV_DIR } from '../../constants.js';
 import { Playbook } from '../../core/domain/entities/playbook.js';
 import { PlaybookNotFoundError } from '../../core/domain/errors/ace-error.js';
 import { FileBulletContentStore } from './file-bullet-content-store.js';
 /**
  * File-based implementation of IPlaybookStore.
- * Stores playbook metadata in .br/ace/playbook.json and bullet content in .br/ace/bullets/{id}.md files.
+ * Stores playbook metadata in .brv/ace/playbook.json and bullet content in .brv/ace/bullets/{id}.md files.
  */
 export class FilePlaybookStore {
     static PLAYBOOK_FILE = 'playbook.json';
@@ -72,7 +72,7 @@ export class FilePlaybookStore {
         const aceDirPath = this.getAceDirPath(directory);
         const playbookPath = this.getPlaybookPath(directory);
         try {
-            // Create .br/ace directory if it doesn't exist
+            // Create .brv/ace directory if it doesn't exist
             await mkdir(aceDirPath, { recursive: true });
             // Save all bullet content to separate files
             const bullets = playbook.getBullets();
@@ -86,17 +86,17 @@ export class FilePlaybookStore {
         }
     }
     /**
-     * Gets the full path to the .br/ace directory
+     * Gets the full path to the .brv/ace directory
      */
     getAceDirPath(directory) {
         return join(this.getBrDirPath(directory), ACE_DIR);
     }
     /**
-     * Gets the full path to the .br directory
+     * Gets the full path to the .brv directory
      */
     getBrDirPath(directory) {
         const baseDir = directory ?? process.cwd();
-        return join(baseDir, BR_DIR);
+        return join(baseDir, BRV_DIR);
     }
     /**
      * Gets the full path to the playbook.json file

package/dist/infra/ace/file-reflection-store.d.ts

@@ -2,7 +2,7 @@ import type { IReflectionStore } from '../../core/interfaces/i-reflection-store.
 import { ReflectorOutput } from '../../core/domain/entities/reflector-output.js';
 /**
  * File-based implementation of IReflectionStore.
- * Stores reflections as JSON files in .br/ace/reflections/ directory.
+ * Stores reflections as JSON files in .brv/ace/reflections/ directory.
  */
 export declare class FileReflectionStore implements IReflectionStore {
     loadRecent(directory?: string, count?: number): Promise<ReflectorOutput[]>;

package/dist/infra/ace/file-reflection-store.js

@@ -5,7 +5,7 @@ import { ReflectorOutput } from '../../core/domain/entities/reflector-output.js'
 import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
 /**
  * File-based implementation of IReflectionStore.
- * Stores reflections as JSON files in .br/ace/reflections/ directory.
+ * Stores reflections as JSON files in .brv/ace/reflections/ directory.
  */
 export class FileReflectionStore {
     async loadRecent(directory, count = 3) {