byterover-cli 1.7.2 → 2.0.0

package/dist/server/infra/terminal/repl-terminal.d.ts

@@ -1,31 +0,0 @@
-import type { PromptRequest, StreamingMessage } from '../../../tui/types.js';
-import type { ConfirmOptions, FileSelectorItem, FileSelectorOptions, InputOptions, ITerminal, SearchOptions, SelectOptions } from '../../core/interfaces/services/i-terminal.js';
-/**
- * Callbacks for ReplTerminal operations.
- * These bridge the terminal to the TUI streaming system.
- */
-export interface ReplTerminalCallbacks {
-    /** Callback for streaming output messages */
-    onMessage: (msg: StreamingMessage) => void;
-    /** Callback for interactive prompts */
-    onPrompt: (prompt: PromptRequest) => void;
-}
-/**
- * REPL-compatible ITerminal implementation.
- * Uses callbacks to integrate with TUI streaming and prompt system.
- */
-export declare class ReplTerminal implements ITerminal {
-    private readonly callbacks;
-    private currentActionId;
-    constructor(callbacks: ReplTerminalCallbacks);
-    actionStart(message: string): void;
-    actionStop(message?: string): void;
-    confirm(options: ConfirmOptions): Promise<boolean>;
-    error(message: string): void;
-    fileSelector(options: FileSelectorOptions): Promise<FileSelectorItem | null>;
-    input(options: InputOptions): Promise<string>;
-    log(message?: string): void;
-    search<T>(options: SearchOptions<T>): Promise<T>;
-    select<T>(options: SelectOptions<T>): Promise<T>;
-    warn(message: string): void;
-}

package/dist/server/infra/terminal/repl-terminal.js

@@ -1,116 +0,0 @@
-import { randomUUID } from 'node:crypto';
-/**
- * Generate a unique message ID
- */
-function generateId() {
-    return randomUUID();
-}
-/**
- * REPL-compatible ITerminal implementation.
- * Uses callbacks to integrate with TUI streaming and prompt system.
- */
-export class ReplTerminal {
-    callbacks;
-    currentActionId = null;
-    constructor(callbacks) {
-        this.callbacks = callbacks;
-    }
-    actionStart(message) {
-        // Generate a unique action ID to link start/stop
-        this.currentActionId = generateId();
-        this.callbacks.onMessage({
-            actionId: this.currentActionId,
-            content: message,
-            id: generateId(),
-            type: 'action_start',
-        });
-    }
-    actionStop(message) {
-        // Stop action if it's in progress
-        if (!this.currentActionId) {
-            return;
-        }
-        this.callbacks.onMessage({
-            actionId: this.currentActionId,
-            content: message ?? '',
-            id: generateId(),
-            type: 'action_stop',
-        });
-        this.currentActionId = null;
-    }
-    confirm(options) {
-        return new Promise((resolve) => {
-            this.callbacks.onPrompt({
-                default: options.default,
-                message: options.message,
-                onResponse: resolve,
-                type: 'confirm',
-            });
-        });
-    }
-    error(message) {
-        this.callbacks.onMessage({
-            content: message,
-            id: generateId(),
-            type: 'error',
-        });
-    }
-    fileSelector(options) {
-        return new Promise((resolve) => {
-            this.callbacks.onPrompt({
-                allowCancel: options.allowCancel,
-                basePath: options.basePath,
-                filter: options.filter,
-                message: options.message,
-                mode: options.type,
-                onResponse: resolve,
-                pageSize: options.pageSize,
-                type: 'file_selector',
-            });
-        });
-    }
-    input(options) {
-        return new Promise((resolve) => {
-            this.callbacks.onPrompt({
-                message: options.message,
-                onResponse: resolve,
-                type: 'input',
-                validate: options.validate,
-            });
-        });
-    }
-    log(message) {
-        this.callbacks.onMessage({
-            content: message ?? '',
-            id: generateId(),
-            type: 'output',
-        });
-    }
-    search(options) {
-        return new Promise((resolve) => {
-            this.callbacks.onPrompt({
-                message: options.message,
-                onResponse: resolve,
-                source: options.source,
-                type: 'search',
-            });
-        });
-    }
-    select(options) {
-        return new Promise((resolve) => {
-            this.callbacks.onPrompt({
-                choices: options.choices,
-                message: options.message,
-                onResponse: resolve,
-                type: 'select',
-            });
-        });
-    }
-    warn(message) {
-        this.callbacks.onMessage({
-            content: message,
-            id: generateId(),
-            type: 'warning',
-        });
-    }
-}

package/dist/server/infra/tracking/mixpanel-tracking-service.d.ts

@@ -1,24 +0,0 @@
-import { Mixpanel } from 'mixpanel';
-import { EventName, PropertyDict } from '../../core/domain/entities/event.js';
-import { ITokenStore } from '../../core/interfaces/auth/i-token-store.js';
-import { ITrackingService } from '../../core/interfaces/services/i-tracking-service.js';
-import { IGlobalConfigStore } from '../../core/interfaces/storage/i-global-config-store.js';
-/**
- * Parameters for creating a MixpanelTrackingService instance.
- */
-export interface MixpanelTrackingServiceParams {
-    readonly globalConfigStore: IGlobalConfigStore;
-    readonly mixpanel?: Mixpanel;
-    readonly tokenStore: ITokenStore;
-}
-/**
- * Tracking service implementation using the Mixpanel library.
- */
-export declare class MixpanelTrackingService implements ITrackingService {
-    private readonly globalConfigStore;
-    private readonly mp;
-    private readonly tokenStore;
-    constructor(params: MixpanelTrackingServiceParams);
-    track(eventName: EventName, properties?: PropertyDict): Promise<void>;
-    private getIdentificationProperties;
-}

package/dist/server/infra/tracking/mixpanel-tracking-service.js

@@ -1,49 +0,0 @@
-import mixpanel from 'mixpanel';
-import { getCurrentConfig } from '../../config/environment.js';
-/**
- * Tracking service implementation using the Mixpanel library.
- */
-export class MixpanelTrackingService {
-    globalConfigStore;
-    mp;
-    tokenStore;
-    constructor(params) {
-        this.tokenStore = params.tokenStore;
-        this.globalConfigStore = params.globalConfigStore;
-        if (params.mixpanel === undefined) {
-            // Initialize with real implementations for production
-            const envConfig = getCurrentConfig();
-            this.mp = mixpanel.init(envConfig.mixpanelToken);
-        }
-        else {
-            // Injected dependencies for testing
-            this.mp = params.mixpanel;
-        }
-    }
-    async track(eventName, properties) {
-        try {
-            const identificationProps = await this.getIdentificationProperties();
-            this.mp.track(`cli:${eventName}`, {
-                ...identificationProps,
-                ...properties,
-                beta: true,
-            });
-        }
-        catch (error) {
-            console.error(`Failed to track event ${eventName}:`, error);
-        }
-    }
-    async getIdentificationProperties() {
-        // Always include $device_id for anonymous/pre-auth tracking
-        const deviceId = await this.globalConfigStore.getOrCreateDeviceId();
-        const props = {
-            $device_id: deviceId, // eslint-disable-line camelcase
-        };
-        // Add $user_id if authenticated (enables Mixpanel identity merging)
-        const token = await this.tokenStore.load();
-        if (token !== undefined) {
-            props.$user_id = token.userId; // eslint-disable-line camelcase
-        }
-        return props;
-    }
-}

package/dist/server/infra/transport/transport-factory.d.ts

@@ -1,17 +0,0 @@
-import type { TransportServerConfig } from '../../core/domain/transport/types.js';
-import type { ITransportServer } from '../../core/interfaces/transport/i-transport-server.js';
-/**
- * Creates a transport server instance.
- *
- * @param config - Optional server configuration, defaults to constants
- * @returns Transport server implementation
- *
- * @example
- * // Use defaults
- * const server = createTransportServer();
- *
- * @example
- * // Custom config
- * const server = createTransportServer({ pingIntervalMs: 2000 });
- */
-export declare function createTransportServer(config?: TransportServerConfig): ITransportServer;

package/dist/server/infra/transport/transport-factory.js

@@ -1,31 +0,0 @@
-import { TRANSPORT_PING_INTERVAL_MS, TRANSPORT_PING_TIMEOUT_MS } from '../../constants.js';
-import { SocketIOTransportServer } from './socket-io-transport-server.js';
-/**
- * Default server configuration using constants.
- */
-const DEFAULT_SERVER_CONFIG = {
-    corsOrigin: '*',
-    pingIntervalMs: TRANSPORT_PING_INTERVAL_MS,
-    pingTimeoutMs: TRANSPORT_PING_TIMEOUT_MS,
-};
-/**
- * Creates a transport server instance.
- *
- * @param config - Optional server configuration, defaults to constants
- * @returns Transport server implementation
- *
- * @example
- * // Use defaults
- * const server = createTransportServer();
- *
- * @example
- * // Custom config
- * const server = createTransportServer({ pingIntervalMs: 2000 });
- */
-export function createTransportServer(config) {
-    const mergedConfig = { ...DEFAULT_SERVER_CONFIG, ...config };
-    return new SocketIOTransportServer(mergedConfig);
-}
-// NOTE: For transport client, use connectToTransport() from @campfirein/brv-transport-client
-// Do NOT use new TransportClient() directly - it requires manual discovery and connection
-// Example: const {client, projectRoot} = await connectToTransport()

package/dist/server/infra/usecase/connectors-use-case.d.ts

@@ -1,63 +0,0 @@
-import type { IConnectorManager } from '../../core/interfaces/connectors/i-connector-manager.js';
-import type { ITerminal } from '../../core/interfaces/services/i-terminal.js';
-import type { ITrackingService } from '../../core/interfaces/services/i-tracking-service.js';
-import { IConnectorsUseCase } from '../../core/interfaces/usecase/i-connectors-use-case.js';
-/**
- * Options for constructing ConnectorsUseCase.
- */
-export interface ConnectorsUseCaseOptions {
-    connectorManager: IConnectorManager;
-    terminal: ITerminal;
-    trackingService: ITrackingService;
-}
-/**
- * Use case for managing connectors.
- * Shows list of connected agents and allows managing or adding new connections.
- */
-export declare class ConnectorsUseCase implements IConnectorsUseCase {
-    private readonly connectorManager;
-    private readonly terminal;
-    private readonly trackingService;
-    constructor(options: ConnectorsUseCaseOptions);
-    run(): Promise<void>;
-    /**
-     * Display manual setup instructions for MCP configuration.
-     */
-    private displayManualInstructions;
-    /**
-     * Gets a description for a connector type.
-     */
-    private getConnectorDescription;
-    /**
-     * Gets a human-readable label for a connector type.
-     */
-    private getConnectorLabel;
-    /**
-     * Handles the case when connectors are already installed.
-     */
-    private handleExistingConnectors;
-    /**
-     * Handles the case when no connectors are installed.
-     */
-    private handleNoConnectorsInstalled;
-    /**
-     * Installs the selected connector and displays result.
-     */
-    private installConnector;
-    /**
-     * Prompts user to select from connected agents or add new.
-     */
-    private promptForAgentToManage;
-    /**
-     * Prompts the user to select a connector type.
-     */
-    private promptForConnectorType;
-    /**
-     * Prompts user to select a new agent (excludes already connected agents).
-     */
-    private promptForNewAgentSelection;
-    /**
-     * Prompts the user to confirm switching connectors.
-     */
-    private promptForSwitchConfirmation;
-}

package/dist/server/infra/usecase/connectors-use-case.js

@@ -1,234 +0,0 @@
-import chalk from 'chalk';
-import { AGENT_VALUES } from '../../core/domain/entities/agent.js';
-/** Sentinel value for "Connect a new agent" option */
-const CONNECT_NEW_AGENT = '__connect_new__';
-/**
- * Array of all agents with name and value properties.
- * Useful for UI components like select dropdowns.
- */
-const AGENTS = AGENT_VALUES.map((agent) => ({
-    name: agent,
-    value: agent,
-}));
-/**
- * Use case for managing connectors.
- * Shows list of connected agents and allows managing or adding new connections.
- */
-export class ConnectorsUseCase {
-    connectorManager;
-    terminal;
-    trackingService;
-    constructor(options) {
-        this.connectorManager = options.connectorManager;
-        this.terminal = options.terminal;
-        this.trackingService = options.trackingService;
-    }
-    async run() {
-        await this.trackingService.track('connectors:configure');
-        // Step 1: Get all installed connectors
-        const installedConnectors = await this.connectorManager.getAllInstalledConnectors();
-        // Step 2: Show list or prompt for new agent
-        const selectedAgent = installedConnectors.size === 0
-            ? await this.handleNoConnectorsInstalled()
-            : await this.handleExistingConnectors(installedConnectors);
-        // Step 3: Get current status and supported types for selected agent
-        const currentType = await this.connectorManager.getInstalledConnectorType(selectedAgent);
-        const supportedTypes = this.connectorManager.getSupportedConnectorTypes(selectedAgent);
-        // Step 4: Select connector type
-        const selectedType = await this.promptForConnectorType(selectedAgent, supportedTypes, currentType);
-        // Step 5: Handle switching with confirmation if needed
-        if (currentType && currentType !== selectedType) {
-            const shouldSwitch = await this.promptForSwitchConfirmation(selectedAgent, currentType, selectedType);
-            if (!shouldSwitch) {
-                this.terminal.log(`Kept ${selectedAgent} connected via ${currentType}`);
-                return;
-            }
-        }
-        // Step 6: Install the selected connector
-        await this.installConnector(selectedAgent, selectedType);
-    }
-    /**
-     * Display manual setup instructions for MCP configuration.
-     */
-    displayManualInstructions(agent, instructions) {
-        this.terminal.log(`\nManual setup required for ${agent}`);
-        this.terminal.log('');
-        this.terminal.log('Add this configuration to your MCP settings:');
-        this.terminal.log('');
-        this.terminal.log(instructions.configContent);
-        this.terminal.log('');
-        if (instructions.guide) {
-            this.terminal.log(`\nFor detailed instructions, see: ${instructions.guide}`);
-        }
-    }
-    /**
-     * Gets a description for a connector type.
-     */
-    getConnectorDescription(type, configPath) {
-        switch (type) {
-            case 'hook': {
-                return `Instructions injected on each prompt (${configPath})`;
-            }
-            case 'mcp': {
-                return `Agent connects via MCP protocol ${configPath ? `(${configPath})` : ''}`;
-            }
-            case 'rules': {
-                return `Agent reads instructions from rule file (${configPath})`;
-            }
-            case 'skill': {
-                return `Agent reads skill files from project directory (${configPath})`;
-            }
-        }
-    }
-    /**
-     * Gets a human-readable label for a connector type.
-     */
-    getConnectorLabel(type) {
-        switch (type) {
-            case 'hook': {
-                return 'Hook';
-            }
-            case 'mcp': {
-                return 'MCP';
-            }
-            case 'rules': {
-                return 'Rules';
-            }
-            case 'skill': {
-                return 'Skill';
-            }
-        }
-    }
-    /**
-     * Handles the case when connectors are already installed.
-     */
-    async handleExistingConnectors(installedConnectors) {
-        const selection = await this.promptForAgentToManage(installedConnectors);
-        if (selection === CONNECT_NEW_AGENT) {
-            return this.promptForNewAgentSelection(installedConnectors);
-        }
-        return selection;
-    }
-    /**
-     * Handles the case when no connectors are installed.
-     */
-    async handleNoConnectorsInstalled() {
-        this.terminal.log('No agents connected yet.\n');
-        return this.promptForNewAgentSelection();
-    }
-    /**
-     * Installs the selected connector and displays result.
-     */
-    async installConnector(agent, connectorType) {
-        const result = await this.connectorManager.switchConnector(agent, connectorType);
-        if (result.success) {
-            // Handle manual setup instructions
-            if (result.installResult.requiresManualSetup && result.installResult.manualInstructions) {
-                this.displayManualInstructions(agent, result.installResult.manualInstructions);
-                return;
-            }
-            if (result.fromType && result.fromType !== result.toType) {
-                this.terminal.log(`${agent} switched from ${this.getConnectorLabel(result.fromType)} to ${this.getConnectorLabel(result.toType)}`);
-                if (result.uninstallResult?.wasInstalled) {
-                    this.terminal.log(`   Uninstalled: ${result.uninstallResult.configPath}`);
-                }
-                this.terminal.log(`   Installed: ${result.installResult.configPath}`);
-            }
-            else if (result.installResult.alreadyInstalled) {
-                this.terminal.log(`${agent} is already connected via ${result.toType}`);
-                this.terminal.log(`   Config: ${result.installResult.configPath}`);
-            }
-            else {
-                this.terminal.log(`${agent} connected via ${result.toType}`);
-                this.terminal.log(`   Installed: ${result.installResult.configPath}`);
-            }
-            // Show how to use instructions
-            this.terminal.log("\nWHAT'S NEXT");
-            this.terminal.log('Try this in your next prompt:');
-            this.terminal.log(chalk.hex('#0AA77D').italic('> "Save our API authentication patterns, use brv curate"'));
-            this.terminal.log('Docs: https://docs.byterover.dev/common-workflows/curate-context');
-            // Show restart message for hook connector
-            if (['hook', 'mcp', 'skill'].includes(result.toType) && !result.installResult.alreadyInstalled) {
-                this.terminal.warn(`\n⚠️  Please restart ${agent} to apply the new ${result.toType}.`);
-            }
-        }
-        else {
-            this.terminal.error(`Failed to configure ${agent}: ${result.message}`);
-        }
-    }
-    /**
-     * Prompts user to select from connected agents or add new.
-     */
-    async promptForAgentToManage(installedConnectors) {
-        const choices = [];
-        // Add installed agents as choices
-        for (const [agent, connectorType] of installedConnectors) {
-            const connector = this.connectorManager.getConnector(connectorType);
-            const configPath = connector.getConfigPath(agent);
-            choices.push({
-                description: configPath,
-                name: `${agent} (${this.getConnectorLabel(connectorType)})`,
-                value: agent,
-            });
-        }
-        // Add separator and "Connect new" option
-        choices.push({
-            name: '+ Connect a new agent',
-            value: CONNECT_NEW_AGENT,
-        });
-        return this.terminal.select({
-            choices,
-            message: 'Manage agent connectors:',
-        });
-    }
-    /**
-     * Prompts the user to select a connector type.
-     */
-    async promptForConnectorType(agent, supportedTypes, currentType) {
-        const choices = supportedTypes.map((type) => {
-            const connector = this.connectorManager.getConnector(type);
-            const configPath = connector.getConfigPath(agent);
-            const isCurrent = type === currentType;
-            const label = this.getConnectorLabel(type);
-            const description = this.getConnectorDescription(type, configPath);
-            return {
-                description,
-                name: isCurrent ? `${label} (current)` : label,
-                value: type,
-            };
-        });
-        return this.terminal.select({
-            choices,
-            message: 'Select connector type:',
-        });
-    }
-    /**
-     * Prompts user to select a new agent (excludes already connected agents).
-     */
-    async promptForNewAgentSelection(installedConnectors) {
-        const connectedAgents = installedConnectors ? new Set(installedConnectors.keys()) : new Set();
-        // Filter out already connected agents
-        const availableAgents = AGENTS.filter((agent) => !connectedAgents.has(agent.value));
-        return this.terminal.search({
-            message: 'Which agent are you using (type to search):',
-            source(input) {
-                if (!input)
-                    return availableAgents;
-                return availableAgents.filter((agent) => agent.name.toLowerCase().includes(input.toLowerCase()) ||
-                    agent.value.toLowerCase().includes(input.toLowerCase()));
-            },
-        });
-    }
-    /**
-     * Prompts the user to confirm switching connectors.
-     */
-    async promptForSwitchConfirmation(agent, fromType, toType) {
-        const fromConnector = this.connectorManager.getConnector(fromType);
-        const fromPath = fromConnector.getConfigPath(agent);
-        this.terminal.warn(`${agent} is currently connected via ${this.getConnectorLabel(fromType)} ${fromPath ? `(${fromPath})` : ''}`);
-        return this.terminal.confirm({
-            default: true,
-            message: `Switch to ${toType}? This will uninstall the current connector.`,
-        });
-    }
-}

package/dist/server/infra/usecase/curate-use-case.d.ts

@@ -1,59 +0,0 @@
-import { type ConnectionResult } from '@campfirein/brv-transport-client';
-import { z } from 'zod';
-import type { ITerminal } from '../../core/interfaces/services/i-terminal.js';
-import type { CurateUseCaseRunOptions, ICurateUseCase } from '../../core/interfaces/usecase/i-curate-use-case.js';
-import { ITrackingService } from '../../core/interfaces/services/i-tracking-service.js';
-/** Type for transport connection function (for DI/testing) */
-export type TransportConnector = (fromDir?: string) => Promise<ConnectionResult>;
-declare const CurateOperationSchema: z.ZodObject<{
-    filePath: z.ZodString;
-    path: z.ZodString;
-    status: z.ZodEnum<["success", "failed"]>;
-    type: z.ZodEnum<["ADD", "UPDATE", "MERGE", "DELETE"]>;
-}, "strip", z.ZodTypeAny, {
-    path: string;
-    type: "ADD" | "DELETE" | "MERGE" | "UPDATE";
-    status: "failed" | "success";
-    filePath: string;
-}, {
-    path: string;
-    type: "ADD" | "DELETE" | "MERGE" | "UPDATE";
-    status: "failed" | "success";
-    filePath: string;
-}>;
-type CurateOperation = z.infer<typeof CurateOperationSchema>;
-export interface CurateResult {
-    message: string;
-    operations?: CurateOperation[];
-    status: 'completed' | 'error' | 'queued';
-    taskId?: string;
-}
-export interface CurateUseCaseOptions {
-    terminal: ITerminal;
-    trackingService: ITrackingService;
-    /** Optional transport connector for dependency injection (defaults to connectToTransport) */
-    transportConnector?: TransportConnector;
-}
-export declare class CurateUseCase implements ICurateUseCase {
-    private readonly terminal;
-    private readonly trackingService;
-    private readonly transportConnector;
-    constructor(options: CurateUseCaseOptions);
-    run({ context, files, folders, format, headless, verbose, }: CurateUseCaseRunOptions): Promise<void>;
-    private createClient;
-    private handleConnectionError;
-    /**
-     * Handle connection errors with JSON output.
-     */
-    private handleConnectionErrorJson;
-    /**
-     * Output JSON result for headless mode.
-     */
-    private outputJsonResult;
-    /**
-     * Wait for task completion in headless mode.
-     * Listens for task:completed or task:error events before returning.
-     */
-    private waitForTaskCompletion;
-}
-export {};