byterover-cli 1.6.0 → 1.7.0

package/dist/core/interfaces/cipher/i-process-service.d.ts

@@ -1,65 +0,0 @@
-import type { ExecuteOptions, ProcessConfig, ProcessHandle, ProcessInfo, ProcessOutput, ProcessResult } from '../../domain/cipher/process/types.js';
-/**
- * Process service interface.
- *
- * Provides secure command execution with foreground/background support,
- * security validation, and resource management.
- */
-export interface IProcessService {
-    /**
-     * Clean up completed background processes.
-     *
-     * Removes processes that have been completed for more than 1 hour.
-     */
-    cleanup(): Promise<void>;
-    /**
-     * Execute a shell command.
-     *
-     * Validates command security, handles approval if needed, and executes
-     * either in foreground (waiting for completion) or background (returns immediately).
-     *
-     * @param command - Shell command to execute
-     * @param options - Execution options (timeout, cwd, background, etc.)
-     * @returns Process result (foreground) or process handle (background)
-     * @throws ProcessError if validation fails, approval denied, or execution fails
-     */
-    executeCommand(command: string, options?: ExecuteOptions): Promise<ProcessHandle | ProcessResult>;
-    /**
-     * Get the current process configuration.
-     *
-     * @returns Readonly configuration object
-     */
-    getConfig(): Readonly<ProcessConfig>;
-    /**
-     * Get output from a background process.
-     *
-     * Retrieves new output since last read and clears the buffer (destructive read).
-     *
-     * @param processId - Unique process identifier
-     * @returns Process output with status and exit code (if completed)
-     * @throws ProcessError if process not found
-     */
-    getProcessOutput(processId: string): Promise<ProcessOutput>;
-    /**
-     * Initialize the process service.
-     *
-     * Must be called before executing commands.
-     * Performs cleanup of any stale processes from previous runs.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Terminate a background process.
-     *
-     * Sends SIGTERM, waits 5 seconds, then escalates to SIGKILL if still running.
-     *
-     * @param processId - Unique process identifier
-     * @throws ProcessError if process not found or kill fails
-     */
-    killProcess(processId: string): Promise<void>;
-    /**
-     * List all background processes.
-     *
-     * @returns Array of process information (status, timestamps, etc.)
-     */
-    listProcesses(): Promise<ProcessInfo[]>;
-}

package/dist/core/interfaces/cipher/i-session-persistence.d.ts

@@ -1,133 +0,0 @@
-/**
- * Interface for Session Persistence Operations
- *
- * Defines the contract for session metadata storage and retrieval.
- * Implementation uses JSON files in .brv/sessions/ directory.
- */
-import type { ActiveSessionPointer, SessionInfo, SessionMetadata } from '../../domain/cipher/session/session-metadata.js';
-/**
- * Session retention configuration for auto-cleanup.
- */
-export interface SessionRetentionConfig {
-    /** Maximum age in days before auto-cleanup */
-    maxAgeDays: number;
-    /** Maximum number of sessions to keep */
-    maxCount: number;
-    /** Whether to run cleanup on startup */
-    runOnStartup: boolean;
-}
-/**
- * Result of session cleanup operation.
- */
-export interface SessionCleanupResult {
-    /** Number of corrupted session files removed */
-    corruptedRemoved: number;
-    /** Number of sessions deleted due to age */
-    deletedByAge: number;
-    /** Number of sessions deleted due to count limit */
-    deletedByCount: number;
-    /** Total sessions remaining after cleanup */
-    remaining: number;
-}
-/**
- * Interface for session metadata persistence.
- *
- * Manages session metadata stored in .brv/sessions/ directory:
- * - active.json: Current active session pointer
- * - session-*.json: Individual session metadata files
- */
-export interface ISessionPersistence {
-    /**
-     * Clean up expired sessions based on retention policy.
-     *
-     * @param config - Retention configuration
-     * @returns Cleanup result with counts
-     */
-    cleanupSessions(config: SessionRetentionConfig): Promise<SessionCleanupResult>;
-    /**
-     * Clear the active session pointer.
-     * Removes .brv/sessions/active.json
-     */
-    clearActiveSession(): Promise<void>;
-    /**
-     * Delete a session and its metadata.
-     *
-     * @param sessionId - Session ID to delete
-     * @returns True if session was deleted, false if not found
-     */
-    deleteSession(sessionId: string): Promise<boolean>;
-    /**
-     * Get the currently active session pointer.
-     *
-     * @returns Active session pointer or null if no active session
-     */
-    getActiveSession(): Promise<ActiveSessionPointer | null>;
-    /**
-     * Get session metadata by ID.
-     *
-     * @param sessionId - Session ID to look up
-     * @returns Session metadata or null if not found
-     */
-    getSession(sessionId: string): Promise<null | SessionMetadata>;
-    /**
-     * Check if the active session pointer is stale (process not running).
-     *
-     * @returns True if active session exists but process is not running
-     */
-    isActiveSessionStale(): Promise<boolean>;
-    /**
-     * Validate that a session belongs to the current working directory.
-     *
-     * @param sessionId - Session ID to validate
-     * @returns True if session belongs to current project
-     */
-    isSessionForCurrentProject(sessionId: string): Promise<boolean>;
-    /**
-     * List all session metadata files.
-     *
-     * @returns Array of session info sorted by lastUpdated (newest first)
-     */
-    listSessions(): Promise<SessionInfo[]>;
-    /**
-     * Mark a session as ended.
-     * Updates the session status to 'ended' and lastUpdated timestamp.
-     *
-     * @param sessionId - Session ID to mark as ended
-     */
-    markSessionEnded(sessionId: string): Promise<void>;
-    /**
-     * Mark a session as interrupted (e.g., process crashed).
-     * Updates the session status to 'interrupted'.
-     *
-     * @param sessionId - Session ID to mark as interrupted
-     */
-    markSessionInterrupted(sessionId: string): Promise<void>;
-    /**
-     * Save session metadata to disk.
-     * Creates or updates the session metadata file.
-     *
-     * @param metadata - Session metadata to save
-     */
-    saveSession(metadata: SessionMetadata): Promise<void>;
-    /**
-     * Set the active session pointer.
-     * Creates or updates .brv/sessions/active.json
-     *
-     * @param sessionId - Session ID to set as active
-     */
-    setActiveSession(sessionId: string): Promise<void>;
-    /**
-     * Set session title from first user message.
-     *
-     * @param sessionId - Session ID to update
-     * @param title - Session title
-     */
-    setSessionTitle(sessionId: string, title: string): Promise<void>;
-    /**
-     * Update session activity (lastUpdated timestamp and message count).
-     *
-     * @param sessionId - Session ID to update
-     * @param messageCount - Current message count
-     */
-    updateSessionActivity(sessionId: string, messageCount: number): Promise<void>;
-}

package/dist/core/interfaces/cipher/i-system-prompt-contributor.d.ts

@@ -1,25 +0,0 @@
-import type { SystemPromptContext } from '../../domain/cipher/system-prompt/types.js';
-/**
- * Interface for system prompt contributors.
- * Contributors are responsible for generating parts of the system prompt
- * that will be sent to the LLM. Each contributor has a priority that
- * determines the order in which its content appears in the final prompt.
- */
-export interface ISystemPromptContributor {
-    /**
-     * Generate the content for this contributor.
-     * @param context - Runtime context containing dependencies and configuration
-     * @returns The generated content string
-     */
-    getContent(context: SystemPromptContext): Promise<string>;
-    /**
-     * Unique identifier for this contributor
-     */
-    id: string;
-    /**
-     * Priority for ordering contributors. Lower numbers = higher priority.
-     * Contributors are executed in priority order, and their content is
-     * concatenated in that order.
-     */
-    priority: number;
-}

package/dist/core/interfaces/cipher/i-todo-storage.d.ts

@@ -1,24 +0,0 @@
-import type { Todo } from '../../domain/cipher/todos/types.js';
-/**
- * Interface for session-based todo storage.
- *
- * Implementations can use different storage backends (in-memory, persistent, etc.)
- * to store and retrieve todo lists per session.
- */
-export interface ITodoStorage {
-    /**
-     * Get todos for a specific session.
-     *
-     * @param sessionId - Unique session identifier
-     * @returns Promise that resolves to array of todos, empty array if not found
-     */
-    get(sessionId: string): Promise<Todo[]>;
-    /**
-     * Update (replace) todos for a specific session.
-     *
-     * @param sessionId - Unique session identifier
-     * @param todos - Array of todos to store
-     * @returns Promise that resolves when todos are saved
-     */
-    update(sessionId: string, todos: Todo[]): Promise<void>;
-}

package/dist/core/interfaces/cipher/i-tool-plugin.d.ts

@@ -1,90 +0,0 @@
-import type { ToolExecutionResult } from '../../domain/cipher/tools/tool-error.js';
-/**
- * Context provided to plugin hooks during tool execution.
- * Contains metadata about the current tool invocation.
- */
-export interface ToolHookContext {
-    /** Unique identifier for this tool call */
-    callId: string;
-    /** Session ID where the tool is being executed */
-    sessionId: string;
-    /** Name of the tool being executed */
-    toolName: string;
-}
-/**
- * Result from a before-execute hook.
- * Determines whether tool execution should proceed and allows argument modification.
- */
-export interface BeforeHookResult {
-    /**
-     * Modified arguments to use for execution.
-     * If provided, these replace the original arguments.
-     */
-    args?: Record<string, unknown>;
-    /**
-     * Whether to proceed with tool execution.
-     * If false, execution is blocked and reason should explain why.
-     */
-    proceed: boolean;
-    /**
-     * Reason for blocking execution (when proceed is false).
-     * Used to generate an error message for the LLM.
-     */
-    reason?: string;
-}
-/**
- * Plugin interface for extending tool execution behavior.
- *
- * Plugins can intercept tool execution at two points:
- * 1. beforeExecute: Called before the tool runs. Can modify args or block execution.
- * 2. afterExecute: Called after the tool completes. Can log, audit, or react to results.
- *
- * @example
- * ```typescript
- * const loggingPlugin: IToolPlugin = {
- *   name: 'logging',
- *   priority: 1,
- *   beforeExecute(ctx, args) {
- *     console.log(`[${ctx.toolName}] Starting with args:`, args)
- *     return { proceed: true }
- *   },
- *   afterExecute(ctx, args, result) {
- *     console.log(`[${ctx.toolName}] Completed:`, result.success ? 'success' : 'error')
- *   }
- * }
- * ```
- */
-export interface IToolPlugin {
-    /**
-     * Called after a tool has completed execution.
-     * Receives the original arguments and the execution result.
-     *
-     * Use for logging, auditing, analytics, or triggering side effects.
-     * Errors in afterExecute are caught and logged but don't affect the result.
-     *
-     * @param ctx - Hook context with tool metadata
-     * @param args - Arguments that were passed to the tool
-     * @param result - Result from tool execution
-     */
-    afterExecute?(ctx: ToolHookContext, args: Record<string, unknown>, result: ToolExecutionResult): Promise<void> | void;
-    /**
-     * Called before a tool is executed.
-     * Can inspect/modify arguments or block execution entirely.
-     *
-     * @param ctx - Hook context with tool metadata
-     * @param args - Arguments to be passed to the tool
-     * @returns Result indicating whether to proceed and optionally modified args
-     */
-    beforeExecute?(ctx: ToolHookContext, args: Record<string, unknown>): BeforeHookResult | Promise<BeforeHookResult>;
-    /**
-     * Unique name for this plugin.
-     * Used for logging and to allow unregistering by name.
-     */
-    name: string;
-    /**
-     * Execution priority (lower = earlier).
-     * Plugins with lower priority numbers execute first.
-     * Default is 100 if not specified.
-     */
-    priority?: number;
-}

package/dist/core/interfaces/cipher/i-tool-provider.d.ts

@@ -1,65 +0,0 @@
-import type { ToolMarker } from '../../../infra/cipher/tools/tool-markers.js';
-import type { ToolExecutionContext, ToolSet } from '../../domain/cipher/tools/types.js';
-/**
- * Interface for tool provider.
- * Manages tool registration, validation, and execution.
- */
-export interface IToolProvider {
-    /**
-     * Execute a tool with the given arguments.
-     *
-     * @param toolName - Name of the tool to execute
-     * @param args - Tool arguments (will be validated against schema)
-     * @param sessionId - Optional session ID for context
-     * @param context - Optional execution context (includes metadata callback for streaming)
-     * @returns Tool execution result
-     * @throws ToolNotFoundError if tool doesn't exist
-     * @throws ToolValidationError if input validation fails
-     * @throws ToolExecutionError if execution fails
-     */
-    executeTool(toolName: string, args: Record<string, unknown>, sessionId?: string, context?: ToolExecutionContext): Promise<unknown>;
-    /**
-     * Get all registered tools in JSON Schema format.
-     * Used to expose tools to the LLM.
-     *
-     * @returns Tool set with JSON Schema definitions
-     */
-    getAllTools(): ToolSet;
-    /**
-     * Get all available tool markers from registered tools.
-     *
-     * @returns Set of tool marker strings
-     */
-    getAvailableMarkers(): Set<string>;
-    /**
-     * Get the count of registered tools.
-     *
-     * @returns Number of registered tools
-     */
-    getToolCount(): number;
-    /**
-     * Get names of all registered tools.
-     *
-     * @returns Array of tool names
-     */
-    getToolNames(): string[];
-    /**
-     * Get tool names that have a specific marker.
-     *
-     * @param marker - The tool marker to filter by
-     * @returns Array of tool names with the specified marker
-     */
-    getToolsByMarker(marker: ToolMarker): string[];
-    /**
-     * Check if a tool exists.
-     *
-     * @param toolName - Name of the tool
-     * @returns True if the tool exists
-     */
-    hasTool(toolName: string): boolean;
-    /**
-     * Initialize the tool provider.
-     * Registers all available tools based on available services.
-     */
-    initialize(): Promise<void>;
-}

package/dist/core/interfaces/cipher/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * Cipher interfaces and types.
- *
- * This module re-exports all cipher-related interfaces, types, and utilities.
- */
-export type { BlobMetadata, StoredBlob } from '../../domain/cipher/blob/types.js';
-export * from './cipher-services.js';
-export type { IBlobStorage } from './i-blob-storage.js';
-export type { IChatSession } from './i-chat-session.js';
-export type { ICipherAgent } from './i-cipher-agent.js';
-export type { IContentGenerator } from './i-content-generator.js';
-export type { IEventEmitter } from './i-event-emitter.js';
-export type { IFileSystem } from './i-file-system.js';
-export type { IHistoryStorage } from './i-history-storage.js';
-export type { IKeyStorage } from './i-key-storage.js';
-export type { ILlmProvider } from './i-llm-provider.js';
-export type { ILLMService } from './i-llm-service.js';
-export type { ILogger } from './i-logger.js';
-export type { IMessageFormatter } from './i-message-formatter.js';
-export type { IPolicyEngine } from './i-policy-engine.js';
-export type { IProcessService } from './i-process-service.js';
-export type { ISystemPromptContributor } from './i-system-prompt-contributor.js';
-export type { ITodoStorage } from './i-todo-storage.js';
-export type { ITokenizer } from './i-tokenizer.js';
-export type { IToolPlugin } from './i-tool-plugin.js';
-export type { IToolProvider } from './i-tool-provider.js';
-export type { IToolScheduler } from './i-tool-scheduler.js';
-export * from './llm-types.js';
-export * from './message-factory.js';
-export * from './message-type-guards.js';
-export * from './message-types.js';
-export * from './tokenizer-types.js';

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

@@ -1,70 +0,0 @@
-import type { ConnectorType } from '../../domain/entities/connector-type.js';
-/**
- * Instructions for manual MCP setup when automatic configuration is not possible.
- */
-export type ManualInstallInstructions = {
-    /** The config content to copy (JSON or TOML formatted) */
-    configContent: string;
-    /** Guide URL or step-by-step instructions */
-    guide: string;
-};
-/**
- * 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;
-    /** Instructions for manual setup (present when requiresManualSetup is true) */
-    manualInstructions?: ManualInstallInstructions;
-    /** Human-readable message describing the result */
-    message: string;
-    /** Whether this requires manual setup by the user */
-    requiresManualSetup?: boolean;
-    /** 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

@@ -1,72 +0,0 @@
-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.d.ts

@@ -1,54 +0,0 @@
-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 {
-    /** The type of this connector */
-    readonly connectorType: ConnectorType;
-    /**
-     * 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>;
-    /**
-     * 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/executor/i-curate-executor.d.ts

@@ -1,36 +0,0 @@
-import type { ICipherAgent } from '../cipher/i-cipher-agent.js';
-/**
- * Options for executing curate with an injected agent.
- * Agent uses its default session (Single-Session pattern).
- */
-export interface CurateExecuteOptions {
-    /** Client's working directory for file validation (defaults to process.cwd() if not provided) */
-    clientCwd?: string;
-    /** Context content to curate */
-    content: string;
-    /** Optional file paths for --files flag */
-    files?: string[];
-    /** Task ID for event routing (required for concurrent task isolation) */
-    taskId: string;
-}
-/**
- * ICurateExecutor - Executes curate tasks with an injected CipherAgent.
- *
- * This is NOT a UseCase (which orchestrates business logic).
- * It's an Executor that wraps agent.execute() with curate-specific options.
- *
- * Architecture:
- * - TaskProcessor injects the long-lived CipherAgent
- * - Event streaming is handled by agent-worker (subscribes to agentEventBus)
- * - Executor focuses solely on curate execution
- */
-export interface ICurateExecutor {
-    /**
-     * Execute curate with an injected agent.
-     *
-     * @param agent - Long-lived CipherAgent (managed by caller)
-     * @param options - Execution options (content, file references)
-     * @returns Result string from agent execution
-     */
-    executeWithAgent(agent: ICipherAgent, options: CurateExecuteOptions): Promise<string>;
-}