byterover-cli 1.0.5 → 1.1.0

package/README.md

@@ -1,6 +1,6 @@
 # ByteRover CLI
 
-Command-line interface for ByteRover, featuring an interactive REPL with a modern React/Ink terminal UI for managing your project's context tree and knowledge storage. Seamlessly integrate with AI coding agents like Claude Code, Cursor, Windsurf, and GitHub Copilot.
+Command-line interface for ByteRover, featuring an interactive REPL with a modern React/Ink terminal UI for managing your project's context tree and knowledge storage. Seamlessly integrate with 18+ AI coding agents including Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and more.
 
 [![Version](https://img.shields.io/npm/v/byterover-cli.svg)](https://npmjs.org/package/byterover-cli)
 [![Downloads/week](https://img.shields.io/npm/dw/byterover-cli.svg)](https://npmjs.org/package/byterover-cli)
@@ -46,7 +46,7 @@ brv --version
 
 ## Quick Start
 
-Visit [**ByteRover's Beta Docs**](https://docs.byterover.dev/beta) for more information.
+Visit [**ByteRover Docs**](https://docs.byterover.dev) for more information.
 
 Get started with ByteRover CLI in three simple steps:
 
@@ -122,7 +122,7 @@ The **Context Tree** is ByteRover's structured knowledge system that helps you a
 - **Organized Knowledge**: Structure your project knowledge by domain and topic
 - **Easy Retrieval**: Find relevant context quickly when you need it
 - **Persistent Memory**: Maintain project-specific knowledge across sessions
-- **Agent-Friendly**: Works seamlessly with AI coding agents like Claude Code, Cursor, Windsurf, and GitHub Copilot
+- **Agent-Friendly**: Works seamlessly with 18+ AI coding agents (Claude Code, Cursor, Windsurf, GitHub Copilot, Cline, and more) via rules-based or hook-based integration
 - **Cloud Sync**: Push and sync your context tree to ByteRover's cloud storage for backup and team collaboration
 - **Dynamic Domains**: Automatically creates new domains as your knowledge grows
 
@@ -135,13 +135,15 @@ The context tree organizes knowledge into:
 
 ### Integrating with Coding Agents
 
-Use `/gen-rules` to generate rule instruction files that help your AI coding agents understand and work with ByteRover:
+Use `/connectors` to manage integrations with your AI coding agents:
 
 ```
-/gen-rules
+/connectors
 ```
 
-This creates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that instruct the agent how to read from and contribute to your context tree.
+ByteRover supports two connector types:
+- **Hook integration** (Claude Code): Direct injection via IDE settings for seamless integration
+- **Rules-based** (all agents): Generates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that instruct the agent how to read from and contribute to your context tree
 
 ## Slash Commands Reference
 
@@ -198,12 +200,12 @@ This creates agent-specific rule files (e.g., `CLAUDE.md`, `.cursorrules`) that
 - `-l, --limit <n>`: Maximum spaces to fetch (default: 50)
 - `-o, --offset <n>`: Number of spaces to skip
 
-### Context Tree Management
+### Connectors & Context Tree Management
 
 | Command | Description |
 |---------|-------------|
-| `/gen-rules` | Generate rule files for AI coding agents (Claude Code, Cursor, etc.) |
-| `/reset [-y] [directory]` | Reset context tree to default domains |
+| `/connectors` | Manage agent connectors (rules-based or hook integration) |
+| `/reset [-y] [directory]` | Reset context tree to empty state |
 
 **Reset options:**
 - `-y, --yes`: Skip confirmation prompt
@@ -339,7 +341,7 @@ If you encounter issues or have questions:
 
 1. Check the command help in the REPL
 2. Run `/status` to review your project state
-3. Visit [ByteRover Docs](https://docs.byterover.dev)
+3. Visit the [ByteRover Docs](https://docs.byterover.dev)
 4. Contact ByteRover support
 
 ---

package/dist/commands/hook-prompt-submit.d.ts

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+import { ITemplateLoader } from '../core/interfaces/i-template-loader.js';
+/**
+ * Dependencies required by HookPromptSubmit command.
+ * Exported for test mocking.
+ */
+export type HookPromptSubmitDependencies = {
+    templateLoader: ITemplateLoader;
+};
+/**
+ * Hidden command for coding agent pre-prompt hooks.
+ * Outputs ByteRover workflow instructions to stdout.
+ * The agent wraps the output in system context (e.g., <system-reminder> tags).
+ *
+ * Supported agents:
+ * - Claude Code: .claude/settings.local.json (UserPromptSubmit)
+ */
+export default class HookPromptSubmit extends Command {
+    static description: string;
+    static hidden: boolean;
+    /**
+     * Factory method for creating dependencies.
+     * Override in tests to inject mock dependencies.
+     */
+    protected createDependencies(): HookPromptSubmitDependencies;
+    run(): Promise<void>;
+}

package/dist/commands/hook-prompt-submit.js

@@ -0,0 +1,39 @@
+import { Command } from '@oclif/core';
+import { isDevelopment } from '../config/environment.js';
+import { FsFileService } from '../infra/file/fs-file-service.js';
+import { FsTemplateLoader } from '../infra/template/fs-template-loader.js';
+/**
+ * Hidden command for coding agent pre-prompt hooks.
+ * Outputs ByteRover workflow instructions to stdout.
+ * The agent wraps the output in system context (e.g., <system-reminder> tags).
+ *
+ * Supported agents:
+ * - Claude Code: .claude/settings.local.json (UserPromptSubmit)
+ */
+export default class HookPromptSubmit extends Command {
+    static description = 'Internal: Pre-prompt hook for coding agents';
+    static hidden = true;
+    /**
+     * Factory method for creating dependencies.
+     * Override in tests to inject mock dependencies.
+     */
+    createDependencies() {
+        const fileService = new FsFileService();
+        const templateLoader = new FsTemplateLoader(fileService);
+        return { templateLoader };
+    }
+    async run() {
+        try {
+            const { templateLoader } = this.createDependencies();
+            const instructions = await templateLoader.loadSection('brv-instructions');
+            // Output to stdout (agent wraps in system context)
+            this.log(instructions);
+        }
+        catch (error) {
+            // Silently fail in production - don't interrupt agent workflow
+            if (isDevelopment()) {
+                console.error('[hook-prompt-submit] Template load failed:', error);
+            }
+        }
+    }
+}

package/dist/commands/status.js

@@ -14,9 +14,14 @@ export default class Status extends Command {
     static description = 'Show CLI status and project information. Display local context tree 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 %>',
+        '# Check status after login (in REPL):',
+        '/login',
+        '/status',
+        '',
+        '# Verify project initialization (in REPL):',
+        '/init',
+        '/status',
+        '',
         '<%= config.bin %> <%= command.id %> /path/to/project',
         '<%= config.bin %> <%= command.id %> --format json',
     ];

package/dist/constants.d.ts

@@ -23,7 +23,7 @@ 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";
+export declare const DOCS_URL = "https://docs.byterover.dev";
 export declare const TRANSPORT_HOST = "127.0.0.1";
 export declare const TRANSPORT_REQUEST_TIMEOUT_MS = 10000;
 export declare const TRANSPORT_ROOM_TIMEOUT_MS = 2000;

package/dist/constants.js

@@ -28,7 +28,7 @@ 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';
+export const DOCS_URL = 'https://docs.byterover.dev';
 // Transport layer constants (optimized for localhost real-time)
 export const TRANSPORT_HOST = '127.0.0.1'; // Use hostname for better sandbox compatibility
 export const TRANSPORT_REQUEST_TIMEOUT_MS = 10_000; // 10s - most operations complete quickly

package/dist/core/domain/cipher/tools/constants.d.ts

@@ -20,6 +20,7 @@ export declare const ToolName: {
     readonly READ_MEMORY: 'read_memory';
     readonly READ_TODOS: 'read_todos';
     readonly SEARCH_HISTORY: 'search_history';
+    readonly SEARCH_KNOWLEDGE: 'search_knowledge';
     readonly SPEC_ANALYZE: 'spec_analyze';
     readonly TASK: 'task';
     readonly WRITE_FILE: 'write_file';

package/dist/core/domain/cipher/tools/constants.js

@@ -20,6 +20,7 @@ export const ToolName = {
     READ_MEMORY: 'read_memory',
     READ_TODOS: 'read_todos',
     SEARCH_HISTORY: 'search_history',
+    SEARCH_KNOWLEDGE: 'search_knowledge',
     SPEC_ANALYZE: 'spec_analyze',
     TASK: 'task',
     WRITE_FILE: 'write_file',

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

@@ -1,5 +1,21 @@
+import type { ConnectorType } from './connector-type.js';
 /**
  * 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];
+/**
+ * Connector availability configuration for an agent.
+ */
+type AgentConnectorConfig = {
+    /** The default connector type for this agent */
+    default: ConnectorType;
+    /** Connector types supported by this agent */
+    supported: readonly ConnectorType[];
+};
+/**
+ * Single source of truth for agent connector configuration.
+ * Defines which connectors each agent supports and which is the default.
+ */
+export declare const AGENT_CONNECTOR_CONFIG: Record<Agent, AgentConnectorConfig>;
+export {};

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

@@ -21,3 +21,27 @@ export const AGENT_VALUES = [
     'Windsurf',
     'Zed',
 ];
+/**
+ * Single source of truth for agent connector configuration.
+ * Defines which connectors each agent supports and which is the default.
+ */
+export const AGENT_CONNECTOR_CONFIG = {
+    Amp: { default: 'rules', supported: ['rules'] },
+    'Augment Code': { default: 'rules', supported: ['rules'] },
+    'Claude Code': { default: 'hook', supported: ['rules', 'hook'] },
+    Cline: { default: 'rules', supported: ['rules'] },
+    Codex: { default: 'rules', supported: ['rules'] },
+    Cursor: { default: 'rules', supported: ['rules'] },
+    'Gemini CLI': { default: 'rules', supported: ['rules'] },
+    'Github Copilot': { default: 'rules', supported: ['rules'] },
+    Junie: { default: 'rules', supported: ['rules'] },
+    'Kilo Code': { default: 'rules', supported: ['rules'] },
+    Kiro: { default: 'rules', supported: ['rules'] },
+    Qoder: { default: 'rules', supported: ['rules'] },
+    'Qwen Code': { default: 'rules', supported: ['rules'] },
+    'Roo Code': { default: 'rules', supported: ['rules'] },
+    'Trae.ai': { default: 'rules', supported: ['rules'] },
+    Warp: { default: 'rules', supported: ['rules'] },
+    Windsurf: { default: 'rules', supported: ['rules'] },
+    Zed: { default: 'rules', supported: ['rules'] },
+};

package/dist/core/domain/entities/connector-type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Array of all supported connector types.
+ * Each connector type represents a different method for integrating BRV with coding agents.
+ *
+ * - 'rules': Agent reads instructions from a rule file (e.g., CLAUDE.md)
+ * - 'hook': Instructions are injected on each prompt via agent hooks
+ */
+export declare const CONNECTOR_TYPES: readonly ["rules", "hook"];
+export type ConnectorType = (typeof CONNECTOR_TYPES)[number];

package/dist/core/domain/entities/connector-type.js

@@ -0,0 +1,8 @@
+/**
+ * Array of all supported connector types.
+ * Each connector type represents a different method for integrating BRV with coding agents.
+ *
+ * - 'rules': Agent reads instructions from a rule file (e.g., CLAUDE.md)
+ * - 'hook': Instructions are injected on each prompt via agent hooks
+ */
+export const CONNECTOR_TYPES = ['rules', 'hook'];

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

@@ -1,7 +1,7 @@
 /**
  * Array of all supported Events.
  */
-export declare const EVENT_VALUES: readonly ["repl", "auth:sign_in", "auth:signed_out", "auth:token_invalid", "space:init", "space:changed", "rule:generate", "mem:status", "mem:curate", "mem:pull", "mem:push", "mem:query", "onboarding:init_completed", "onboarding:curate_completed", "onboarding:query_completed", "onboarding:skipped", "onboarding:completed", "init"];
+export declare const EVENT_VALUES: readonly ["repl", "auth:sign_in", "auth:signed_out", "auth:token_invalid", "space:init", "space:changed", "rule:generate", "connectors:configure", "connector:install", "mem:status", "mem:curate", "mem:pull", "mem:push", "mem:query", "onboarding:init_completed", "onboarding:curate_completed", "onboarding:query_completed", "onboarding:skipped", "onboarding:completed", "init"];
 export type EventName = (typeof EVENT_VALUES)[number];
 export interface PropertyDict {
     [key: string]: any;

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

@@ -9,6 +9,8 @@ export const EVENT_VALUES = [
     'space:init',
     'space:changed',
     'rule:generate',
+    'connectors:configure',
+    'connector:install',
     'mem:status',
     'mem:curate',
     'mem:pull',

package/dist/core/domain/errors/task-error.d.ts

@@ -5,6 +5,7 @@
 export declare const TaskErrorCode: {
     readonly AGENT_DISCONNECTED: "ERR_AGENT_DISCONNECTED";
     readonly AGENT_NOT_AVAILABLE: "ERR_AGENT_NOT_AVAILABLE";
+    readonly AGENT_NOT_INITIALIZED: "ERR_AGENT_NOT_INITIALIZED";
     readonly LLM_ERROR: "ERR_LLM_ERROR";
     readonly LLM_RATE_LIMIT: "ERR_LLM_RATE_LIMIT";
     readonly NOT_AUTHENTICATED: "ERR_NOT_AUTHENTICATED";
@@ -50,6 +51,9 @@ export declare class AgentNotAvailableError extends TaskError {
 export declare class AgentDisconnectedError extends TaskError {
     constructor();
 }
+export declare class AgentNotInitializedError extends TaskError {
+    constructor(reason?: string);
+}
 export declare class ProcessorNotInitError extends TaskError {
     constructor();
 }

package/dist/core/domain/errors/task-error.js

@@ -6,6 +6,7 @@ export const TaskErrorCode = {
     // Agent errors
     AGENT_DISCONNECTED: 'ERR_AGENT_DISCONNECTED',
     AGENT_NOT_AVAILABLE: 'ERR_AGENT_NOT_AVAILABLE',
+    AGENT_NOT_INITIALIZED: 'ERR_AGENT_NOT_INITIALIZED',
     // LLM errors
     LLM_ERROR: 'ERR_LLM_ERROR',
     LLM_RATE_LIMIT: 'ERR_LLM_RATE_LIMIT',
@@ -90,6 +91,12 @@ export class AgentDisconnectedError extends TaskError {
         this.name = 'AgentDisconnectedError';
     }
 }
+export class AgentNotInitializedError extends TaskError {
+    constructor(reason) {
+        super(reason ? `Agent not initialized: ${reason}` : 'Agent not initialized. Please complete login and setup first.', TaskErrorCode.AGENT_NOT_INITIALIZED);
+        this.name = 'AgentNotInitializedError';
+    }
+}
 export class ProcessorNotInitError extends TaskError {
     constructor() {
         super('TaskProcessor not initialized', TaskErrorCode.PROCESSOR_NOT_INIT);

package/dist/core/domain/transport/schemas.d.ts

@@ -1170,6 +1170,46 @@ export declare const AgentNewSessionResponseSchema: z.ZodObject<{
     error?: string | undefined;
     sessionId?: string | undefined;
 }>;
+/**
+ * Agent status event names.
+ */
+export declare const AgentStatusEventNames: {
+    /** Status changed broadcast */
+    readonly STATUS_CHANGED: "agent:status:changed";
+};
+/**
+ * Agent health status for monitoring.
+ * Used by Transport to check if CipherAgent is ready before forwarding tasks.
+ */
+export declare const AgentStatusSchema: z.ZodObject<{
+    /** Number of tasks currently processing */
+    activeTasks: z.ZodNumber;
+    /** Whether auth token is loaded and valid */
+    hasAuth: z.ZodBoolean;
+    /** Whether BrvConfig is loaded */
+    hasConfig: z.ZodBoolean;
+    /** Whether CipherAgent is initialized and ready */
+    isInitialized: z.ZodBoolean;
+    /** Last initialization error message */
+    lastError: z.ZodOptional<z.ZodString>;
+    /** Number of tasks waiting in queue */
+    queuedTasks: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    activeTasks: number;
+    hasAuth: boolean;
+    hasConfig: boolean;
+    isInitialized: boolean;
+    queuedTasks: number;
+    lastError?: string | undefined;
+}, {
+    activeTasks: number;
+    hasAuth: boolean;
+    hasConfig: boolean;
+    isInitialized: boolean;
+    queuedTasks: number;
+    lastError?: string | undefined;
+}>;
+export type AgentStatus = z.infer<typeof AgentStatusSchema>;
 export type TodoItem = z.infer<typeof TodoItemSchema>;
 export type ChunkPayload = z.infer<typeof ChunkPayloadSchema>;
 export type ResponsePayload = z.infer<typeof ResponsePayloadSchema>;

package/dist/core/domain/transport/schemas.js

@@ -581,3 +581,31 @@ export const AgentNewSessionResponseSchema = z.object({
     /** Whether the new session was created successfully */
     success: z.boolean(),
 });
+// ============================================================================
+// Agent Status (health check)
+// ============================================================================
+/**
+ * Agent status event names.
+ */
+export const AgentStatusEventNames = {
+    /** Status changed broadcast */
+    STATUS_CHANGED: 'agent:status:changed',
+};
+/**
+ * Agent health status for monitoring.
+ * Used by Transport to check if CipherAgent is ready before forwarding tasks.
+ */
+export const AgentStatusSchema = z.object({
+    /** Number of tasks currently processing */
+    activeTasks: z.number().int().nonnegative(),
+    /** Whether auth token is loaded and valid */
+    hasAuth: z.boolean(),
+    /** Whether BrvConfig is loaded */
+    hasConfig: z.boolean(),
+    /** Whether CipherAgent is initialized and ready */
+    isInitialized: z.boolean(),
+    /** Last initialization error message */
+    lastError: z.string().optional(),
+    /** Number of tasks waiting in queue */
+    queuedTasks: z.number().int().nonnegative(),
+});

package/dist/core/interfaces/connectors/connector-types.d.ts

@@ -0,0 +1,57 @@
+import type { ConnectorType } from '../../domain/entities/connector-type.js';
+/**
+ * Result of a connector installation operation.
+ */
+export type ConnectorInstallResult = {
+    /** Whether the connector was already installed (no action taken) */
+    alreadyInstalled: boolean;
+    /** Path to the configuration/rule file */
+    configPath: string;
+    /** Human-readable message describing the result */
+    message: string;
+    /** Whether the installation was successful */
+    success: boolean;
+};
+/**
+ * Result of a connector uninstallation operation.
+ */
+export type ConnectorUninstallResult = {
+    /** Path to the configuration/rule file */
+    configPath: string;
+    /** Human-readable message describing the result */
+    message: string;
+    /** Whether the uninstallation was successful */
+    success: boolean;
+    /** Whether the connector was installed before uninstall */
+    wasInstalled: boolean;
+};
+/**
+ * Status of a connector installation.
+ */
+export type ConnectorStatus = {
+    /** Whether the configuration/rule file exists */
+    configExists: boolean;
+    /** Path to the configuration/rule file */
+    configPath: string;
+    /** Error message if status check failed */
+    error?: string;
+    /** Whether the connector is currently installed */
+    installed: boolean;
+};
+/**
+ * Result of switching from one connector type to another.
+ */
+export type ConnectorSwitchResult = {
+    /** The connector type that was uninstalled (if any) */
+    fromType: ConnectorType | null;
+    /** Result of the installation operation */
+    installResult: ConnectorInstallResult;
+    /** Human-readable message describing the result */
+    message: string;
+    /** Whether the switch was successful */
+    success: boolean;
+    /** The connector type that was installed */
+    toType: ConnectorType;
+    /** Result of the uninstallation operation (if switching) */
+    uninstallResult?: ConnectorUninstallResult;
+};

package/dist/core/interfaces/connectors/i-connector-manager.d.ts

@@ -0,0 +1,72 @@
+import type { Agent } from '../../domain/entities/agent.js';
+import type { ConnectorType } from '../../domain/entities/connector-type.js';
+import type { ConnectorInstallResult, ConnectorStatus, ConnectorSwitchResult } from './connector-types.js';
+import type { IConnector } from './i-connector.js';
+/**
+ * Interface for managing connectors.
+ * Acts as a factory for creating connectors and orchestrates connector operations.
+ */
+export interface IConnectorManager {
+    /**
+     * Get all installed connectors across all agents.
+     * Iterates over all agents and checks which have connectors installed.
+     *
+     * @returns Map of agent to installed connector type (only includes agents with connectors)
+     */
+    getAllInstalledConnectors(): Promise<Map<Agent, ConnectorType>>;
+    /**
+     * Get a connector instance for the specified type.
+     *
+     * @param type - The connector type
+     * @returns The connector instance
+     * @throws Error if the connector type is not supported
+     */
+    getConnector(type: ConnectorType): IConnector;
+    /**
+     * Get the default connector type for the specified agent.
+     *
+     * @param agent - The agent to get the default connector for
+     * @returns The default connector type
+     */
+    getDefaultConnectorType(agent: Agent): ConnectorType;
+    /**
+     * Get the currently installed connector type for the specified agent.
+     * Checks all connector types and returns the first one that is installed.
+     *
+     * @param agent - The agent to check
+     * @returns The installed connector type, or null if none installed
+     */
+    getInstalledConnectorType(agent: Agent): Promise<ConnectorType | null>;
+    /**
+     * Get list of connector types that support the specified agent.
+     *
+     * @param agent - The agent to check
+     * @returns Array of supported connector types
+     */
+    getSupportedConnectorTypes(agent: Agent): ConnectorType[];
+    /**
+     * Install the default connector for the specified agent.
+     *
+     * @param agent - The agent to install for
+     * @returns Installation result
+     */
+    installDefault(agent: Agent): Promise<ConnectorInstallResult>;
+    /**
+     * Get the status of a specific connector type for an agent.
+     *
+     * @param type - The connector type
+     * @param agent - The agent to check
+     * @returns Connector status
+     */
+    status(type: ConnectorType, agent: Agent): Promise<ConnectorStatus>;
+    /**
+     * Switch from one connector type to another for the specified agent.
+     * Uninstalls the current connector (if any) and installs the new one.
+     * This ensures only one connector is active per agent.
+     *
+     * @param agent - The agent to switch connectors for
+     * @param toType - The connector type to switch to
+     * @returns Switch result with details of uninstall and install operations
+     */
+    switchConnector(agent: Agent, toType: ConnectorType): Promise<ConnectorSwitchResult>;
+}

package/dist/core/interfaces/connectors/i-connector-manager.js

@@ -0,0 +1 @@
+export {};

package/dist/core/interfaces/connectors/i-connector.d.ts

@@ -0,0 +1,54 @@
+import type { Agent } from '../../domain/entities/agent.js';
+import type { ConnectorType } from '../../domain/entities/connector-type.js';
+import type { ConnectorInstallResult, ConnectorStatus, ConnectorUninstallResult } from './connector-types.js';
+/**
+ * Interface for a connector that integrates BRV with a coding agent.
+ * Each connector type (rules, hook, mcp) has its own implementation.
+ */
+export interface IConnector {
+    /**
+     * Get the path to the configuration/rule file for a specific agent.
+     *
+     * @param agent - The agent to get the config path for
+     * @returns The path relative to project root
+     */
+    getConfigPath(agent: Agent): string;
+    /**
+     * Get list of agents supported by this connector type.
+     *
+     * @returns Array of supported agent names
+     */
+    getSupportedAgents(): Agent[];
+    /**
+     * Install the connector for the specified agent.
+     * If already installed, returns alreadyInstalled: true.
+     *
+     * @param agent - The coding agent to install for
+     * @returns Installation result with success status and message
+     */
+    install(agent: Agent): Promise<ConnectorInstallResult>;
+    /**
+     * Check if this connector supports the specified agent.
+     *
+     * @param agent - The agent to check
+     * @returns True if the agent is supported
+     */
+    isSupported(agent: Agent): boolean;
+    /**
+     * Check the installation status for the specified agent.
+     *
+     * @param agent - The coding agent to check status for
+     * @returns Status including installed state and config file existence
+     */
+    status(agent: Agent): Promise<ConnectorStatus>;
+    /** The type of this connector */
+    readonly type: ConnectorType;
+    /**
+     * Uninstall the connector for the specified agent.
+     * Only removes BRV content, preserves user's other configurations.
+     *
+     * @param agent - The coding agent to uninstall from
+     * @returns Uninstallation result with success status and message
+     */
+    uninstall(agent: Agent): Promise<ConnectorUninstallResult>;
+}

package/dist/core/interfaces/connectors/i-connector.js

@@ -0,0 +1 @@
+export {};

package/dist/core/interfaces/i-file-service.d.ts

@@ -15,6 +15,13 @@ export interface IFileService {
      * @returns A promise that resolves with the path to the backup file.
      */
     createBackup: (filePath: string) => Promise<string>;
+    /**
+     * Deletes a file at the specified path.
+     *
+     * @param filePath The path to the file to delete.
+     * @returns A promise that resolves when the file has been deleted.
+     */
+    delete: (filePath: string) => Promise<void>;
     /**
      * Checks if a file exists at the specified path.
      *

package/dist/core/interfaces/usecase/i-connectors-use-case.d.ts

@@ -0,0 +1,3 @@
+export interface IConnectorsUseCase {
+    run(): Promise<void>;
+}

package/dist/core/interfaces/usecase/i-connectors-use-case.js

@@ -0,0 +1 @@
+export {};

package/dist/hooks/init/update-notifier.d.ts

@@ -27,6 +27,7 @@ export type UpdateNotifierDeps = {
     execSyncFn: (command: string, options: {
         stdio: 'inherit';
     }) => void;
+    exitFn: (code: number) => never;
     isTTY: boolean;
     log: (message: string) => void;
     notifier: NarrowedUpdateNotifier;