byterover-cli 0.1.0

package/dist/commands/space/switch.js

@@ -0,0 +1,110 @@
+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 { 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 examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '# Shows current configuration, then prompts for new team/space selection',
+    ];
+    createServices() {
+        const envConfig = getCurrentConfig();
+        return {
+            projectConfigStore: new ProjectConfigStore(),
+            spaceService: new HttpSpaceService({
+                apiBaseUrl: envConfig.apiBaseUrl,
+            }),
+            teamService: new HttpTeamService({
+                apiBaseUrl: envConfig.apiBaseUrl,
+            }),
+            tokenStore: new KeychainTokenStore(),
+        };
+    }
+    async promptForSpaceSelection(spaces) {
+        const selectedSpaceId = await select({
+            choices: spaces.map((space) => ({
+                name: space.getDisplayName(),
+                value: space.id,
+            })),
+            message: 'Select a space',
+        });
+        const selectedSpace = spaces.find((space) => space.id === selectedSpaceId);
+        if (!selectedSpace) {
+            this.error('Space selection failed');
+        }
+        return selectedSpace;
+    }
+    async promptForTeamSelection(teams) {
+        const selectedTeamId = await select({
+            choices: teams.map((team) => ({
+                name: team.name,
+                value: team.id,
+            })),
+            message: 'Select a team',
+        });
+        const selectedTeam = teams.find((team) => team.id === selectedTeamId);
+        if (!selectedTeam) {
+            this.error('Team selection failed');
+        }
+        return selectedTeam;
+    }
+    async run() {
+        try {
+            const { projectConfigStore, spaceService, teamService, tokenStore } = this.createServices();
+            // Check project initialization (MUST exist for switch)
+            const currentConfig = await projectConfigStore.read();
+            if (currentConfig === undefined) {
+                this.error('Project not initialized. Run "br init" first.');
+            }
+            // Show current configuration
+            this.log('Current configuration:');
+            this.log(`  Team: ${currentConfig.teamName}`);
+            this.log(`  Space: ${currentConfig.spaceName}`);
+            this.log();
+            // Validate authentication
+            const token = await tokenStore.load();
+            if (token === undefined) {
+                this.error('Not authenticated. Please run "br login" first.');
+            }
+            if (!token.isValid()) {
+                this.error('Authentication token expired. Please run "br login" again.');
+            }
+            // Fetch all teams
+            ux.action.start('Fetching all teams');
+            const teamResult = await teamService.getTeams(token.accessToken, token.sessionKey, { fetchAll: true });
+            ux.action.stop();
+            if (teamResult.teams.length === 0) {
+                this.error('No teams found. Please create a team in the ByteRover dashboard first.');
+            }
+            // Prompt for team selection
+            this.log();
+            const selectedTeam = await this.promptForTeamSelection(teamResult.teams);
+            // Fetch spaces for selected team
+            ux.action.start('Fetching all spaces');
+            const spaceResult = await spaceService.getSpaces(token.accessToken, token.sessionKey, selectedTeam.id, {
+                fetchAll: true,
+            });
+            ux.action.stop();
+            if (spaceResult.spaces.length === 0) {
+                this.error(`No spaces found in team "${selectedTeam.getDisplayName()}". Please create a space in the ByteRover dashboard first.`);
+            }
+            // Prompt for space selection
+            this.log();
+            const selectedSpace = await this.promptForSpaceSelection(spaceResult.spaces);
+            // Update configuration
+            const newConfig = BrConfig.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`);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : 'Switch failed');
+        }
+    }
+}

package/dist/commands/status.d.ts

@@ -0,0 +1,22 @@
+import { Command } from '@oclif/core';
+import type { IPlaybookStore } from '../core/interfaces/i-playbook-store.js';
+import type { IProjectConfigStore } from '../core/interfaces/i-project-config-store.js';
+import type { ITokenStore } from '../core/interfaces/i-token-store.js';
+import { ITrackingService } from '../core/interfaces/i-tracking-service.js';
+export default class Status extends Command {
+    static args: {
+        directory: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected createServices(): {
+        playbookStore: IPlaybookStore;
+        projectConfigStore: IProjectConfigStore;
+        tokenStore: ITokenStore;
+        trackingService: ITrackingService;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/status.js

@@ -0,0 +1,116 @@
+import { Args, Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { ACE_DIR, BR_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';
+import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
+export default class Status extends Command {
+    static args = {
+        directory: Args.string({ description: 'Project directory (defaults to current directory)', required: false }),
+    };
+    static description = 'Show CLI status and project information. Display local ACE context (ACE playbook) managed by ByteRover CLI';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '# Check status after login:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>',
+        '# Verify project initialization:\n<%= config.bin %> init\n<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> /path/to/project',
+        '<%= config.bin %> <%= command.id %> --format json',
+    ];
+    static flags = {
+        format: Flags.string({
+            char: 'f',
+            default: 'table',
+            description: 'Output format',
+            options: ['table', 'json'],
+        }),
+    };
+    createServices() {
+        const tokenStore = new KeychainTokenStore();
+        const trackingService = new MixpanelTrackingService(tokenStore);
+        return {
+            playbookStore: new FilePlaybookStore(),
+            projectConfigStore: new ProjectConfigStore(),
+            tokenStore,
+            trackingService,
+        };
+    }
+    async run() {
+        const { playbookStore, projectConfigStore, tokenStore } = this.createServices();
+        const { args, flags } = await this.parse(Status);
+        this.log(`CLI Version: ${this.config.version}`);
+        try {
+            const token = await tokenStore.load();
+            if (token !== undefined && token.isValid()) {
+                this.log(`Status: Logged in as ${token.userEmail}`);
+            }
+            else if (token === undefined) {
+                this.log('Status: Not logged in');
+            }
+            else {
+                this.log('Status: Session expired (login required)');
+            }
+        }
+        catch (error) {
+            this.log('Status: Unable to check authentication status');
+            this.warn(`Warning: ${error.message}`);
+        }
+        const cwd = process.cwd();
+        this.log(`Current Directory: ${cwd}`);
+        try {
+            const isInitialized = await projectConfigStore.exists();
+            if (isInitialized) {
+                const config = await projectConfigStore.read();
+                if (config) {
+                    this.log(`Project Status: Connected to ${config.teamName}/${config.spaceName}`);
+                }
+                else {
+                    this.log('Project Status: Configuration file exists but is invalid');
+                }
+            }
+            else {
+                this.log('Project Status: Not initialized');
+            }
+        }
+        catch (error) {
+            this.log('Project Status: Unable to read project configuration');
+            this.warn(`Warning: ${error.message}`);
+        }
+        try {
+            const playbook = await playbookStore.load(args.directory);
+            if (!playbook) {
+                this.error('Playbook not found. Run `br init` to initialize.');
+            }
+            // Display based on format
+            if (flags.format === 'json') {
+                return this.log(JSON.stringify(playbook.toJson(), null, 2));
+            }
+            // Display file URLs like git status
+            const bullets = playbook.getBullets();
+            const sections = playbook.getSections();
+            if (bullets.length === 0) {
+                this.log('Playbook is empty. Use "br add" commands to add knowledge.');
+                return;
+            }
+            this.log(`\nMemory not pushed to cloud:`);
+            for (const section of sections) {
+                // Space between sections
+                this.log(' ');
+                // Section title
+                this.log(`# ${section}`);
+                const sectionBullets = playbook.getBulletsInSection(section);
+                for (const bullet of sectionBullets) {
+                    const relativePath = `${BR_DIR}/${ACE_DIR}/${BULLETS_DIR}/${bullet.id}.md`;
+                    // Display like git status: red path
+                    this.log(`  ${chalk.red(relativePath)}`);
+                }
+            }
+            // Guide user to push memory to cloud
+            this.log(`Use "br push" to push memory to cloud.`);
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : 'Failed to load playbook statistics');
+        }
+    }
+}

package/dist/config/auth.config.d.ts

@@ -0,0 +1,32 @@
+import { IOidcDiscoveryService } from '../core/interfaces/i-oidc-discovery-service.js';
+/**
+ * OAuth/OIDC configuration for the application.
+ * This CLI uses PKCE flow (public client), so clientSecret is optional and typically undefined.
+ */
+export type OAuthConfig = {
+    authorizationUrl: string;
+    clientId: string;
+    clientSecret?: string;
+    /**
+     * OAuth redirect URI for receiving authorization codes.
+     *
+     * For CLI flows with local callback servers, this is typically built dynamically
+     * after the server starts on a random port (e.g., `http://localhost:3456/callback`).
+     *
+     * For other flows (web apps, etc.), this can be provided as a static value in config.
+     *
+     * Optional - can be omitted if redirectUri is determined at runtime.
+     */
+    redirectUri?: string;
+    scopes: string[];
+    tokenUrl: string;
+};
+/**
+ * Get OAuth configuration using OIDC discovery.
+ * Configuration is built from environment-specific defaults with fallback
+ * to hardcoded URLs if discovery fails.
+ *
+ * @param discoveryService OIDC discovery service for fetching endpoints
+ * @returns OAuth configuration
+ */
+export declare const getAuthConfig: (discoveryService: IOidcDiscoveryService) => Promise<OAuthConfig>;

package/dist/config/auth.config.js

@@ -0,0 +1,35 @@
+import { ENVIRONMENT, getCurrentConfig } from './environment.js';
+/**
+ * Get OAuth configuration using OIDC discovery.
+ * Configuration is built from environment-specific defaults with fallback
+ * to hardcoded URLs if discovery fails.
+ *
+ * @param discoveryService OIDC discovery service for fetching endpoints
+ * @returns OAuth configuration
+ */
+export const getAuthConfig = async (discoveryService) => {
+    // Get environment config
+    const envConfig = getCurrentConfig();
+    // Discover OIDC endpoints
+    let authorizationUrl;
+    let tokenUrl;
+    try {
+        const metadata = await discoveryService.discover(envConfig.issuerUrl);
+        // Use discovered endpoints
+        authorizationUrl = metadata.authorizationEndpoint;
+        tokenUrl = metadata.tokenEndpoint;
+    }
+    catch (error) {
+        // Fallback to hardcoded environment-specific URLs
+        authorizationUrl = envConfig.authorizationUrl;
+        tokenUrl = envConfig.tokenUrl;
+        // Warn user about fallback
+        console.warn(`Warning: OIDC discovery failed, using fallback URLs for ${ENVIRONMENT} environment.`, error instanceof Error ? error.message : 'Unknown error');
+    }
+    return {
+        authorizationUrl,
+        clientId: envConfig.clientId,
+        scopes: envConfig.scopes,
+        tokenUrl,
+    };
+};

package/dist/config/environment.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Environment types supported by the CLI.
+ */
+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
+ */
+export declare const ENVIRONMENT: Environment;
+/**
+ * Environment-specific configuration.
+ */
+type EnvironmentConfig = {
+    apiBaseUrl: string;
+    authorizationUrl: string;
+    clientId: string;
+    cogitApiBaseUrl: string;
+    issuerUrl: string;
+    memoraApiBaseUrl: string;
+    mixpanelToken: string;
+    scopes: string[];
+    tokenUrl: string;
+};
+/**
+ * Configuration for each environment.
+ * These values are bundled at build time.
+ */
+export declare const ENV_CONFIG: Record<Environment, EnvironmentConfig>;
+/**
+ * Get the configuration for the current environment.
+ * @returns The environment configuration.
+ */
+export declare const getCurrentConfig: () => EnvironmentConfig;
+export {};

package/dist/config/environment.js

@@ -0,0 +1,39 @@
+/**
+ * Current environment - set at runtime by the launcher scripts.
+ * - `./bin/dev.js` sets BR_ENV=development
+ * - `./bin/run.js` sets BR_ENV=production
+ */
+export const ENVIRONMENT = process.env.BR_ENV ?? 'development';
+/**
+ * Configuration for each environment.
+ * These values are bundled at build time.
+ */
+export const ENV_CONFIG = {
+    development: {
+        apiBaseUrl: 'https://dev-beta-iam.byterover.dev/api/v1',
+        authorizationUrl: 'https://dev-beta-iam.byterover.dev/api/v1/oidc/authorize',
+        clientId: 'byterover-cli-client',
+        cogitApiBaseUrl: 'https://dev-beta-cogit.byterover.dev/api/v1',
+        issuerUrl: 'https://dev-beta-iam.byterover.dev/api/v1/oidc',
+        memoraApiBaseUrl: 'https://dev-beta-memora-retrieve.byterover.dev/api/v3',
+        mixpanelToken: '258e1a2b3d44cc634ef28964771b1da0',
+        scopes: ['read', 'write', 'debug'],
+        tokenUrl: 'https://dev-beta-iam.byterover.dev/api/v1/oidc/token',
+    },
+    production: {
+        apiBaseUrl: 'https://prod-beta-iam.byterover.dev/api/v1',
+        authorizationUrl: 'https://prod-beta-iam.byterover.dev/api/v1/oidc/authorize',
+        clientId: 'byterover-cli-prod',
+        cogitApiBaseUrl: 'https://prod-beta-cogit.byterover.dev/api/v1',
+        issuerUrl: 'https://prod-beta-iam.byterover.dev/api/v1/oidc',
+        memoraApiBaseUrl: 'https://prod-beta-memora-retrieve.byterover.dev/api/v3',
+        mixpanelToken: 'fac9051df8242c885a9e0eaf60f78b10',
+        scopes: ['read', 'write'],
+        tokenUrl: 'https://prod-beta-iam.byterover.dev/api/v1/oidc/token',
+    },
+};
+/**
+ * Get the configuration for the current environment.
+ * @returns The environment configuration.
+ */
+export const getCurrentConfig = () => ENV_CONFIG[ENVIRONMENT];

package/dist/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const BR_DIR = ".br";
+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";
+/**
+ * Default ByteRover branch name for memory storage.
+ * This is ByteRover's internal branching mechanism, not Git branches.
+ */
+export declare const DEFAULT_BRANCH = "main";

package/dist/constants.js

@@ -0,0 +1,12 @@
+// 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';
+/**
+ * Default ByteRover branch name for memory storage.
+ * This is ByteRover's internal branching mechanism, not Git branches.
+ */
+export const DEFAULT_BRANCH = 'main';

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

@@ -0,0 +1,5 @@
+/**
+ * Array of all supported Agents.
+ */
+export declare const AGENT_VALUES: readonly ["Amp", "Augment Code", "Claude Code", "Cline", "Codex", "Cursor", "Gemini CLI", "Github Copilot", "Junie", "Kilo Code", "Kiro", "Qoder", "Qwen Code", "Roo Code", "Trae.ai", "Warp", "Windsurf", "Zed"];
+export type Agent = (typeof AGENT_VALUES)[number];

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

@@ -0,0 +1,23 @@
+/**
+ * Array of all supported Agents.
+ */
+export const AGENT_VALUES = [
+    'Amp',
+    'Augment Code',
+    'Claude Code',
+    'Cline',
+    'Codex',
+    'Cursor',
+    'Gemini CLI',
+    'Github Copilot',
+    'Junie',
+    'Kilo Code',
+    'Kiro',
+    'Qoder',
+    'Qwen Code',
+    'Roo Code',
+    'Trae.ai',
+    'Warp',
+    'Windsurf',
+    'Zed',
+];

package/dist/core/domain/entities/auth-token.d.ts

@@ -0,0 +1,43 @@
+export type AuthTokenParams = {
+    accessToken: string;
+    expiresAt: Date;
+    refreshToken: string;
+    sessionKey: string;
+    tokenType?: string;
+    userEmail: string;
+    userId: string;
+};
+/**
+ * Represents an authentication token with access and refresh tokens, expiration, and type.
+ */
+export declare class AuthToken {
+    readonly accessToken: string;
+    readonly expiresAt: Date;
+    readonly refreshToken: string;
+    readonly sessionKey: string;
+    readonly tokenType: string;
+    readonly userEmail: string;
+    readonly userId: string;
+    constructor(params: AuthTokenParams);
+    /**
+     * Create an AuthToken instance from a JSON object.
+     * @param json JSON object representing the AuthToken
+     * @returns An instance of AuthToken, or undefined if required fields are missing
+     */
+    static fromJson(json: Record<string, string>): AuthToken | undefined;
+    /**
+     * Check if the token is expired.
+     * @returns True if the token is expired, false otherwise.
+     */
+    isExpired(): boolean;
+    /**
+     * Check if the token is valid.
+     * @returns True if the token is valid, false otherwise.
+     */
+    isValid(): boolean;
+    /**
+     * Convert the AuthToken instance to a JSON object.
+     * @returns A JSON object representing the AuthToken
+     */
+    toJson(): Record<string, string>;
+}

package/dist/core/domain/entities/auth-token.js

@@ -0,0 +1,70 @@
+/**
+ * Represents an authentication token with access and refresh tokens, expiration, and type.
+ */
+export class AuthToken {
+    accessToken;
+    expiresAt;
+    refreshToken;
+    sessionKey;
+    tokenType;
+    userEmail;
+    userId;
+    constructor(params) {
+        this.accessToken = params.accessToken;
+        this.expiresAt = params.expiresAt;
+        this.refreshToken = params.refreshToken;
+        this.sessionKey = params.sessionKey;
+        this.tokenType = params.tokenType ?? 'Bearer';
+        this.userId = params.userId;
+        this.userEmail = params.userEmail;
+    }
+    /**
+     * Create an AuthToken instance from a JSON object.
+     * @param json JSON object representing the AuthToken
+     * @returns An instance of AuthToken, or undefined if required fields are missing
+     */
+    static fromJson(json) {
+        // Validate that new required fields exist (for backward compatibility with old tokens)
+        if (!json.userId || !json.userEmail) {
+            return undefined;
+        }
+        return new AuthToken({
+            accessToken: json.accessToken,
+            expiresAt: new Date(json.expiresAt),
+            refreshToken: json.refreshToken,
+            sessionKey: json.sessionKey,
+            tokenType: json.tokenType,
+            userEmail: json.userEmail,
+            userId: json.userId,
+        });
+    }
+    /**
+     * Check if the token is expired.
+     * @returns True if the token is expired, false otherwise.
+     */
+    isExpired() {
+        return this.expiresAt <= new Date();
+    }
+    /**
+     * Check if the token is valid.
+     * @returns True if the token is valid, false otherwise.
+     */
+    isValid() {
+        return Boolean(this.accessToken) && !this.isExpired();
+    }
+    /**
+     * Convert the AuthToken instance to a JSON object.
+     * @returns A JSON object representing the AuthToken
+     */
+    toJson() {
+        return {
+            accessToken: this.accessToken,
+            expiresAt: this.expiresAt.toISOString(),
+            refreshToken: this.refreshToken,
+            sessionKey: this.sessionKey,
+            tokenType: this.tokenType,
+            userEmail: this.userEmail,
+            userId: this.userId,
+        };
+    }
+}

package/dist/core/domain/entities/br-config.d.ts

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

package/dist/core/domain/entities/br-config.js

@@ -0,0 +1,58 @@
+/**
+ * Represents the configuration stored in .br/config.json
+ * This config links a project directory to a ByteRover space.
+ */
+export class BrConfig {
+    createdAt;
+    spaceId;
+    spaceName;
+    teamId;
+    teamName;
+    // eslint-disable-next-line max-params
+    constructor(createdAt, spaceId, spaceName, teamId, teamName) {
+        if (createdAt.trim().length === 0) {
+            throw new Error('Created at cannot be empty');
+        }
+        if (spaceId.trim().length === 0) {
+            throw new Error('Space ID cannot be empty');
+        }
+        if (spaceName.trim().length === 0) {
+            throw new Error('Space name cannot be empty');
+        }
+        if (teamId.trim().length === 0) {
+            throw new Error('Team ID cannot be empty');
+        }
+        if (teamName.trim().length === 0) {
+            throw new Error('Team name cannot be empty');
+        }
+        this.createdAt = createdAt;
+        this.spaceId = spaceId;
+        this.spaceName = spaceName;
+        this.teamId = teamId;
+        this.teamName = teamName;
+    }
+    /**
+     * Deserializes config from JSON format
+     */
+    static fromJson(json) {
+        return new BrConfig(json.createdAt, json.spaceId, json.spaceName, json.teamId, json.teamName);
+    }
+    /**
+     * Creates a BrConfig from a Space entity
+     */
+    static fromSpace(space) {
+        return new BrConfig(new Date().toISOString(), space.id, space.name, space.teamId, space.teamName);
+    }
+    /**
+     * Serializes the config to JSON format
+     */
+    toJson() {
+        return {
+            createdAt: this.createdAt,
+            spaceId: this.spaceId,
+            spaceName: this.spaceName,
+            teamId: this.teamId,
+            teamName: this.teamName,
+        };
+    }
+}