byterover-cli 1.0.5 → 1.2.0

package/dist/infra/repl/commands/connectors-command.d.ts

@@ -0,0 +1,8 @@
+import { SlashCommand } from '../../../tui/types.js';
+/**
+ * Connectors command
+ *
+ * Manages connectors (rules, hook) for integrating BRV with coding agents.
+ * Lists connected agents and allows managing or adding new connections.
+ */
+export declare const connectorsCommand: SlashCommand;

package/dist/infra/repl/commands/{gen-rules-command.js → connectors-command.js}

@@ -1,19 +1,20 @@
 import { CommandKind } from '../../../tui/types.js';
+import { ConnectorManager } from '../../connectors/connector-manager.js';
+import { RuleTemplateService } from '../../connectors/shared/template-service.js';
 import { FsFileService } from '../../file/fs-file-service.js';
-import { LegacyRuleDetector } from '../../rule/legacy-rule-detector.js';
-import { RuleTemplateService } from '../../rule/rule-template-service.js';
-import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { FileGlobalConfigStore } from '../../storage/file-global-config-store.js';
 import { createTokenStore } from '../../storage/token-store.js';
 import { FsTemplateLoader } from '../../template/fs-template-loader.js';
 import { ReplTerminal } from '../../terminal/repl-terminal.js';
 import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
-import { GenerateRulesUseCase } from '../../usecase/generate-rules-use-case.js';
+import { ConnectorsUseCase } from '../../usecase/connectors-use-case.js';
 /**
- * Generate rules command
+ * Connectors command
  *
- * Creates and runs GenerateRulesUseCase with ReplTerminal for TUI integration.
+ * Manages connectors (rules, hook) for integrating BRV with coding agents.
+ * Lists connected agents and allows managing or adding new connections.
  */
-export const genRulesCommand = {
+export const connectorsCommand = {
     action: () => ({
         async execute(onMessage, onPrompt) {
             // Create ReplTerminal with callbacks
@@ -24,15 +25,25 @@ export const genRulesCommand = {
             const templateService = new RuleTemplateService(templateLoader);
             const globalConfigStore = new FileGlobalConfigStore();
             const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore: createTokenStore() });
+            // Create ConnectorManager
+            const connectorManager = new ConnectorManager({
+                fileService,
+                projectRoot: process.cwd(),
+                templateService,
+            });
             // Create and run UseCase
-            const useCase = new GenerateRulesUseCase(fileService, new LegacyRuleDetector(), templateService, terminal, trackingService);
+            const useCase = new ConnectorsUseCase({
+                connectorManager,
+                terminal,
+                trackingService,
+            });
             await useCase.run();
         },
         type: 'streaming',
     }),
     aliases: [],
     autoExecute: true,
-    description: 'Generate rule instructions for coding agents to work with ByteRover correctly',
+    description: 'Manage agent connectors (rules, hooks)',
     kind: CommandKind.BUILT_IN,
-    name: 'gen-rules',
+    name: 'connectors',
 };

package/dist/infra/repl/commands/curate-command.js

@@ -1,7 +1,7 @@
 import { randomUUID } from 'node:crypto';
 import { isDevelopment } from '../../../config/environment.js';
 import { CommandKind } from '../../../tui/types.js';
-import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { FileGlobalConfigStore } from '../../storage/file-global-config-store.js';
 import { createTokenStore } from '../../storage/token-store.js';
 import { ReplTerminal } from '../../terminal/repl-terminal.js';
 import { MixpanelTrackingService } from '../../tracking/mixpanel-tracking-service.js';
@@ -73,7 +73,7 @@ export const curateCommand = {
         {
             char: '@',
             description: 'Include files (type @ to browse, max 5)',
-            name: 'files',
+            name: 'file',
             type: 'file',
         },
         ...(isDevelopment() ? toCommandFlags(devFlags) : []),

package/dist/infra/repl/commands/index.js

@@ -1,5 +1,5 @@
+import { connectorsCommand } from './connectors-command.js';
 import { curateCommand } from './curate-command.js';
-import { genRulesCommand } from './gen-rules-command.js';
 import { initCommand } from './init-command.js';
 import { loginCommand } from './login-command.js';
 import { logoutCommand } from './logout-command.js';
@@ -21,13 +21,14 @@ export const load = () => [
     statusCommand, // Quick check current state
     curateCommand, // Add context (primary action)
     queryCommand, // Query context tree
+    // Connectors management
+    connectorsCommand, // Manage agent connectors (rules/hook)
     // Sync operations
     pushCommand, // Push to cloud
     pullCommand, // Pull from cloud
     // Space management
     spaceCommand, // Switch/list spaces
     // Context tree management
-    genRulesCommand, // Generate rule files
     resetCommand, // Reset context tree (destructive)
     // Session management
     newCommand, // Start fresh session (ends current, clears conversation)

package/dist/infra/repl/commands/init-command.js

@@ -2,14 +2,14 @@ import { getCurrentConfig } from '../../../config/environment.js';
 import { CommandKind } from '../../../tui/types.js';
 import { HttpCogitPullService } from '../../cogit/http-cogit-pull-service.js';
 import { ProjectConfigStore } from '../../config/file-config-store.js';
+import { ConnectorManager } from '../../connectors/connector-manager.js';
+import { RuleTemplateService } from '../../connectors/shared/template-service.js';
 import { FileContextTreeService } from '../../context-tree/file-context-tree-service.js';
 import { FileContextTreeSnapshotService } from '../../context-tree/file-context-tree-snapshot-service.js';
 import { FileContextTreeWriterService } from '../../context-tree/file-context-tree-writer-service.js';
 import { FsFileService } from '../../file/fs-file-service.js';
-import { LegacyRuleDetector } from '../../rule/legacy-rule-detector.js';
-import { RuleTemplateService } from '../../rule/rule-template-service.js';
 import { HttpSpaceService } from '../../space/http-space-service.js';
-import { FileGlobalConfigStore } from "../../storage/file-global-config-store.js";
+import { FileGlobalConfigStore } from '../../storage/file-global-config-store.js';
 import { createTokenStore } from '../../storage/token-store.js';
 import { HttpTeamService } from '../../team/http-team-service.js';
 import { FsTemplateLoader } from '../../template/fs-template-loader.js';
@@ -42,21 +42,26 @@ export const initCommand = {
                 const trackingService = new MixpanelTrackingService({ globalConfigStore, tokenStore });
                 const fileService = new FsFileService();
                 const templateLoader = new FsTemplateLoader(fileService);
-                const ruleTemplateService = new RuleTemplateService(templateLoader);
-                const legacyRuleDetector = new LegacyRuleDetector();
+                const templateService = new RuleTemplateService(templateLoader);
                 const contextTreeSnapshotService = new FileContextTreeSnapshotService();
+                // Create ConnectorManager
+                const connectorManager = new ConnectorManager({
+                    fileService,
+                    projectRoot: process.cwd(),
+                    templateService,
+                });
                 // Create and run use case
                 const useCase = new InitUseCase({
                     cogitPullService: new HttpCogitPullService({
                         apiBaseUrl: envConfig.cogitApiBaseUrl,
                     }),
+                    connectorManager,
                     contextTreeService: new FileContextTreeService(),
                     contextTreeSnapshotService,
                     contextTreeWriterService: new FileContextTreeWriterService({
                         snapshotService: contextTreeSnapshotService,
                     }),
                     fileService,
-                    legacyRuleDetector,
                     projectConfigStore: new ProjectConfigStore(),
                     spaceService: new HttpSpaceService({
                         apiBaseUrl: envConfig.apiBaseUrl,
@@ -64,7 +69,6 @@ export const initCommand = {
                     teamService: new HttpTeamService({
                         apiBaseUrl: envConfig.apiBaseUrl,
                     }),
-                    templateService: ruleTemplateService,
                     terminal,
                     tokenStore,
                     trackingService,

package/dist/infra/repl/commands/query-command.js

@@ -50,13 +50,33 @@ export const queryCommand = {
     aliases: ['q'],
     args: [
         {
-            description: 'Natural language question about your codebase',
+            description: `Natural language question about your codebase or project knowledge.
+
+Ask specific questions for better results. The query system will:
+- Search your curated context tree for relevant information
+- Analyze the query from multiple perspectives for comprehensive results
+- Synthesize findings into a clear, cited answer
+
+EXAMPLES:
+  /query How is authentication implemented?
+  /query What are the API error handling patterns?
+  /query Explain the database schema design decisions
+  /query What testing strategies are used in this project?
+
+TIPS:
+  - Be specific: "How does JWT refresh work?" vs "authentication"
+  - Add context: "in the API layer" or "for user management"
+  - Ask about patterns, decisions, or implementations`,
             name: 'query',
             required: true,
         },
     ],
     autoExecute: false,
-    description: 'Query and retrieve information from the context tree',
+    description: `Query and retrieve information from the context tree.
+
+Searches your curated knowledge base using natural language. Complex queries
+are automatically analyzed from multiple perspectives to find comprehensive
+answers with file citations.`,
     flags: isDevelopment() ? toCommandFlags(devFlags) : [],
     kind: CommandKind.BUILT_IN,
     name: 'query',

package/dist/infra/repl/commands/reset-command.js

@@ -54,7 +54,7 @@ export const resetCommand = {
         },
     ],
     autoExecute: true,
-    description: 'Reset the current context tree and start with 6 default domains',
+    description: 'Reset the current context tree to an empty state',
     flags: toCommandFlags(resetFlags),
     kind: CommandKind.BUILT_IN,
     name: 'reset',

package/dist/infra/transport/socket-io-transport-client.d.ts

@@ -7,26 +7,76 @@ import type { ConnectionState, ConnectionStateHandler, EventHandler, ITransportC
  * - Auto-reconnects with exponential backoff
  * - Request/response uses Socket.IO acknowledgements (callbacks)
  * - Connection state is tracked and exposed via onStateChange
+ * - Force reconnect after all built-in attempts fail (sleep/wake recovery)
+ * - Auto-rejoins rooms after reconnect
  */
 export declare class SocketIOTransportClient implements ITransportClient {
     private readonly config;
     private eventHandlers;
+    /** Track force reconnect attempt count for backoff calculation */
+    private forceReconnectAttempt;
+    /** Timer for scheduled force reconnect */
+    private forceReconnectTimer?;
+    /** Track joined rooms for auto-rejoin after reconnect */
+    private joinedRooms;
+    /** Last time we checked for wake (for detecting time jumps) */
+    private lastWakeCheckTime;
     /** Track which events have socket listeners registered (prevents duplicates on reconnect) */
     private registeredSocketEvents;
+    /** Store server URL for force reconnect */
+    private serverUrl?;
     private socket;
     private state;
     private stateHandlers;
+    /** Timer for wake detection */
+    private wakeDetectionTimer?;
     constructor(config?: TransportClientConfig);
     connect(url: string): Promise<void>;
     disconnect(): Promise<void>;
     getClientId(): string | undefined;
     getState(): ConnectionState;
+    /**
+     * Checks if the socket is actually connected and responsive.
+     * Uses Socket.IO's built-in volatile emit with acknowledgement to verify bidirectional communication.
+     * @param timeoutMs - Timeout in milliseconds (default: 2000)
+     * @returns true if socket is connected and responsive, false otherwise
+     */
+    isConnected(timeoutMs?: number): Promise<boolean>;
     joinRoom(room: string): Promise<void>;
     leaveRoom(room: string): Promise<void>;
     on<T = unknown>(event: string, handler: EventHandler<T>): () => void;
     once<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Subscribe to connection state changes.
+     *
+     * Important: Subscriptions persist across disconnect/connect cycles. Call the returned
+     * function to unsubscribe when no longer needed to prevent memory leaks.
+     *
+     * @returns Unsubscribe function - call to remove the handler
+     */
     onStateChange(handler: ConnectionStateHandler): () => void;
     request<TResponse = unknown, TRequest = unknown>(event: string, data?: TRequest, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Attempt force reconnect after Socket.IO gives up.
+     * Creates a new socket and connects.
+     * Gives up after MAX_FORCE_RECONNECT_ATTEMPTS (ProcessManager will detect via periodic health check).
+     */
+    private attemptForceReconnect;
+    /**
+     * Cancel force reconnect completely (clears timer AND resets counter).
+     * Used when connection is stable or on disconnect().
+     */
+    private cancelForceReconnect;
+    /**
+     * Clear force reconnect timer only (does NOT reset counter).
+     * Used when initiating new connection attempt - counter preserved for backoff continuity.
+     */
+    private clearForceReconnectTimer;
+    /**
+     * Handle system wake from sleep/hibernate.
+     * Re-triggers reconnection if not connected and force reconnect has given up.
+     */
+    private handleWakeFromSleep;
     /**
      * Register all pending event handlers on the socket.
      * Called after successful connection to handle handlers added before connect().
@@ -37,9 +87,34 @@ export declare class SocketIOTransportClient implements ITransportClient {
      * Uses registeredSocketEvents set to prevent duplicates.
      */
     private registerSocketEventIfNeeded;
+    /**
+     * Re-join all tracked rooms after reconnect.
+     * Retries failed room joins with exponential backoff.
+     */
+    private rejoinRooms;
+    /**
+     * Rejoin a single room with retry logic.
+     * Uses exponential backoff: 50ms, 100ms, 200ms, 400ms, 800ms (max 5 attempts).
+     * Retries BOTH when socket not connected AND when room:join fails.
+     */
+    private rejoinRoomWithRetry;
     /**
      * Remove socket listener for an event and clear tracking.
      */
     private removeSocketEventListener;
+    /**
+     * Schedule force reconnect with exponential backoff.
+     * Called after Socket.IO's built-in reconnection gives up.
+     */
+    private scheduleForceReconnect;
     private setState;
+    /**
+     * Start wake detection timer.
+     * Periodically checks for time jumps that indicate system woke from sleep.
+     */
+    private startWakeDetection;
+    /**
+     * Stop wake detection timer.
+     */
+    private stopWakeDetection;
 }