byterover-cli 1.2.1 → 1.4.0

package/dist/core/interfaces/cipher/i-coding-agent-log-parser.d.ts

@@ -1,20 +0,0 @@
-import type { CleanSession } from '../../domain/entities/parser.js';
-import { Agent } from '../../domain/entities/agent.js';
-/**
- * Interface for parsing coding agent log files.
- * Implementations use the raw/clean parser pipeline to process log files
- * from various coding agents (Claude Code, GitHub Copilot, Cursor, Codex, etc.).
- */
-export interface ICodingAgentLogParser {
-    /**
-     * Parses coding agent log files using the configured IDE and chat log path.
-     *
-     * This method follows the two-phase raw/clean parser pipeline:
-     * 1. Raw Phase: Parse IDE-specific files, write to .brv/logs/{ide}/raw/
-     * 2. Clean Phase: Read from .brv/logs/{ide}/raw/, normalize to CleanSession format
-     *
-     * @returns A promise that resolves to a frozen array of CleanSession objects
-     * @throws Error if parsing fails at any phase
-     */
-    parse: (chatLogPath: string, ide: Agent) => Promise<readonly CleanSession[]>;
-}

package/dist/core/interfaces/cipher/i-coding-agent-log-parser.js

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

package/dist/core/interfaces/cipher/i-coding-agent-log-watcher.d.ts

@@ -1,31 +0,0 @@
-import type { CleanSession } from '../../domain/entities/parser.js';
-import { Agent } from '../../domain/entities/agent.js';
-/** Options for starting the coding agent log watcher. */
-export type CodingAgentLogWatcherOptions = {
-    codingAgentInfo: {
-        chatLogPath: string;
-        name: Agent;
-    };
-    /** Callback invoked when sessions are parsed from log files */
-    onCleanSession: (cleanSession: CleanSession) => Promise<void>;
-};
-/**
- * Interface for watching coding agent log files and processing sessions.
- * Implementations should handle the first watch (process existing files) differently from subsequent watches (only new/changed files).
- */
-export interface ICodingAgentLogWatcher {
-    /**
-     * Checks if the watcher is currently active.
-     * @returns true if watching, false otherwise.
-     */
-    isWatching: () => boolean;
-    /**
-     * Starts watching the specified paths for coding agent log files.
-     * On initial start, processes existing files. Subsequent watches only process new or changed files.
-     * @param options Configuration options including paths and callback
-     * @throws Error if already watching or if paths are invalid
-     */
-    start: (options: CodingAgentLogWatcherOptions) => Promise<void>;
-    /** Stops watching for file changes and cleans up resources */
-    stop: () => Promise<void>;
-}

package/dist/core/interfaces/cipher/i-coding-agent-log-watcher.js

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

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

@@ -1,41 +0,0 @@
-/**
- * Represents a file system event.
- */
-export type FileEvent = {
-    /**
-     * The path to the file or directory that changed.
-     */
-    path: string;
-    /**
-     * The type of event that occurred.
-     * - add: File added
-     * - addDir: Directory added
-     * - change: File modified
-     * - unlink: File deleted
-     * - unlinkDir: Directory deleted
-     */
-    type: 'add' | 'addDir' | 'change' | 'unlink' | 'unlinkDir';
-};
-/**
- * Interface for a file watcher service that monitors file system changes.
- */
-export interface IFileWatcherService {
-    /**
-     * Sets the handler to be called when file system events occur.
-     * Only one handler can be registered at a time.
-     * The handler is async to support file reading and processing.
-     * @param handler The async callback function to invoke with file events.
-     */
-    setFileEventHandler: (handler: (event: FileEvent) => Promise<void>) => void;
-    /**
-     * Starts watching the specified paths for file system changes.
-     * @param paths Array of directory paths to watch.
-     * @returns Promise that resolves when watching has started.
-     */
-    start: (paths: string[]) => Promise<void>;
-    /**
-     * Stops watching and cleans up resources.
-     * @returns Promise that resolves when cleanup is complete.
-     */
-    stop: () => Promise<void>;
-}

package/dist/core/interfaces/i-file-watcher-service.js

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

package/dist/core/interfaces/parser/i-clean-parser-service.d.ts

@@ -1,18 +0,0 @@
-import type { CleanSession } from '../../domain/entities/parser.js';
-/**
- * Interface for clean parser services
- * Implementations handle transformation of raw IDE session data to clean normalized format
- */
-export interface ICleanParserService {
-    /**
-     * Parse and transform raw IDE sessions to clean normalized format
-     *
-     * Reads raw session files and transforms them into standardized format with
-     * normalized messages, metadata, and workspace information.
-     * Returns parsed sessions in-memory without writing to disk.
-     *
-     * @param rawDir - Path to directory containing raw IDE session files
-     * @returns Promise resolving to array of CleanSession objects
-     */
-    parse: (rawDir: string) => Promise<readonly CleanSession[]>;
-}

package/dist/core/interfaces/parser/i-clean-parser-service.js

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

package/dist/core/interfaces/parser/i-raw-parser-service.d.ts

@@ -1,17 +0,0 @@
-/**
- * Interface for raw parser services
- * Implementations handle extraction and transformation of raw IDE session data
- */
-export interface IRawParserService {
-    /**
-     * Parse IDE sessions from a custom directory
-     *
-     * Extracts raw session data from IDE storage and writes normalized JSON files
-     * to output directory (.brv/logs/{ide}/raw by default).
-     *
-     * @param customDir - Path to directory containing IDE session data
-     * @param outputDir - Optional output directory for parsed files (defaults to process.cwd()/.brv/logs/{ide}/raw)
-     * @returns Promise resolving to true if parsing succeeded, false otherwise
-     */
-    parse(customDir: string, outputDir?: string): Promise<boolean>;
-}

package/dist/core/interfaces/parser/i-raw-parser-service.js

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

package/dist/core/interfaces/parser/i-session-normalizer.d.ts

@@ -1,56 +0,0 @@
-/**
- * Interface for session normalization utilities
- * Provides standardized transformation of raw session data to clean normalized format
- */
-import { CleanMessage, CleanSession, SessionType } from '../../domain/entities/parser.js';
-export interface ISessionNormalizer {
-    /**
-     * Add turn_id to each message based on order
-     *
-     * @param messages - Array of messages to assign turn IDs to
-     * @returns Array of messages with turn_id property added
-     */
-    addTurnIds(messages: CleanMessage[]): CleanMessage[];
-    /**
-     * Combine tool_use and tool_result messages
-     *
-     * @param messages - Array of clean messages to process
-     * @returns Array of messages with combined tool execution blocks
-     */
-    combineToolResults(messages: CleanMessage[]): CleanMessage[];
-    /**
-     * Extract unique workspace paths from session messages and metadata
-     *
-     * @param messages - Array of clean messages to extract paths from
-     * @param metadata - Session metadata object (may contain cwd property)
-     * @param existingPaths - Optional pre-existing paths to include
-     * @returns Sorted array of unique workspace paths
-     */
-    extractWorkspacePaths(messages: CleanMessage[], metadata: unknown, existingPaths?: string[]): string[];
-    /**
-     * Normalize message content to always be an array of content blocks
-     *
-     * @param content - Content to normalize (can be string, array of blocks, object, or any value)
-     * @returns Array of normalized ContentBlock objects
-     */
-    normalizeContent(content: unknown): unknown[];
-    /**
-     * Normalize a single content block
-     *
-     * @param block - Block to normalize (string, object, or any value)
-     * @returns Normalized ContentBlock with proper type inference
-     */
-    normalizeContentBlock(block: unknown): unknown;
-    /**
-     * Normalize session to clean format
-     *
-     * Transforms raw session data into standardized CleanSession format. Normalizes message
-     * content to content blocks, combines tool calls with results, assigns turn IDs,
-     * and extracts workspace paths.
-     *
-     * @param session - Raw session object with messages and metadata
-     * @param sessionType - Type of session (Claude, Copilot, Cursor, Codex)
-     * @returns Normalized CleanSession with standardized format
-     */
-    normalizeSession(session: Record<string, unknown>, sessionType?: SessionType): CleanSession;
-}

package/dist/core/interfaces/parser/i-session-normalizer.js

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

package/dist/infra/cipher/parsers/coding-agent-log-parser.d.ts

@@ -1,24 +0,0 @@
-/**
- * Coding Agent Log Parser
- * Parses coding agent log files using the existing raw/clean parser pipeline
- * Follows the same logic as the 'brv watch' command's triggerParsing method
- */
-import type { CleanSession } from '../../../core/domain/entities/parser.js';
-import type { ICodingAgentLogParser } from '../../../core/interfaces/cipher/i-coding-agent-log-parser.js';
-import { Agent } from '../../../core/domain/entities/agent.js';
-/**
- * Coding Agent Log Parser
- *
- * Reuses the existing raw/clean parser infrastructure to parse coding agent log files.
- * This implementation follows the same two-phase pipeline as the 'brv watch' command:
- *
- * 1. Raw Phase: Parse IDE-specific files from chatLogPath directory, write to .brv/logs/{ide}/raw/
- * 2. Clean Phase: Read from .brv/logs/{ide}/raw/, normalize to CleanSession format
- *
- * Note: This parser processes entire directories (not individual files) for consistency
- * with the existing parser architecture. When a single file changes, all files in the
- * directory will be re-parsed. This is inefficient but safe, and can be optimized later.
- */
-export declare class CodingAgentLogParser implements ICodingAgentLogParser {
-    parse(chatLogPath: string, ide: Agent): Promise<readonly CleanSession[]>;
-}

package/dist/infra/cipher/parsers/coding-agent-log-parser.js

@@ -1,51 +0,0 @@
-/**
- * Coding Agent Log Parser
- * Parses coding agent log files using the existing raw/clean parser pipeline
- * Follows the same logic as the 'brv watch' command's triggerParsing method
- */
-import { CleanParserServiceFactory } from '../../parsers/clean/clean-parser-service-factory.js';
-import { RawParserServiceFactory } from '../../parsers/raw/raw-parser-service-factory.js';
-/**
- * Coding Agent Log Parser
- *
- * Reuses the existing raw/clean parser infrastructure to parse coding agent log files.
- * This implementation follows the same two-phase pipeline as the 'brv watch' command:
- *
- * 1. Raw Phase: Parse IDE-specific files from chatLogPath directory, write to .brv/logs/{ide}/raw/
- * 2. Clean Phase: Read from .brv/logs/{ide}/raw/, normalize to CleanSession format
- *
- * Note: This parser processes entire directories (not individual files) for consistency
- * with the existing parser architecture. When a single file changes, all files in the
- * directory will be re-parsed. This is inefficient but safe, and can be optimized later.
- */
-export class CodingAgentLogParser {
-    async parse(chatLogPath, ide) {
-        if (!RawParserServiceFactory.isSupported(ide)) {
-            throw new Error(`Unsupported IDE: ${ide}`);
-        }
-        if (!chatLogPath || chatLogPath.trim().length === 0) {
-            throw new Error('Chat log path cannot be empty');
-        }
-        let isRawSuccess = false;
-        try {
-            isRawSuccess = await RawParserServiceFactory.parseConversations(ide, chatLogPath);
-        }
-        catch (error) {
-            throw new Error(`Raw parsing error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-        }
-        if (isRawSuccess) {
-            try {
-                const rawOutputDir = `${process.cwd()}/.brv/logs/${ide}/raw`;
-                const cleanSessions = await CleanParserServiceFactory.parseConversations(ide, rawOutputDir);
-                if (cleanSessions.length > 0) {
-                    return Object.freeze(cleanSessions);
-                }
-                throw new Error('Clean parsing returned no sessions');
-            }
-            catch (error) {
-                throw new Error(`Clean parsing error: ${error instanceof Error ? error.message : 'Unknown error'}`);
-            }
-        }
-        throw new Error('Raw parsing failed');
-    }
-}

package/dist/infra/cipher/watcher/coding-agent-log-watcher.d.ts

@@ -1,14 +0,0 @@
-import type { ICodingAgentLogParser } from '../../../core/interfaces/cipher/i-coding-agent-log-parser.js';
-import type { CodingAgentLogWatcherOptions, ICodingAgentLogWatcher } from '../../../core/interfaces/cipher/i-coding-agent-log-watcher.js';
-import type { IFileWatcherService } from '../../../core/interfaces/i-file-watcher-service.js';
-export declare class CodingAgentLogWatcher implements ICodingAgentLogWatcher {
-    private callback;
-    private readonly fileWatcher;
-    private readonly parser;
-    private watching;
-    constructor(fileWatcher: IFileWatcherService, parser: ICodingAgentLogParser);
-    isWatching(): boolean;
-    start(options: CodingAgentLogWatcherOptions): Promise<void>;
-    stop(): Promise<void>;
-    private handleFileEvent;
-}

package/dist/infra/cipher/watcher/coding-agent-log-watcher.js

@@ -1,55 +0,0 @@
-export class CodingAgentLogWatcher {
-    callback;
-    fileWatcher;
-    parser;
-    watching;
-    constructor(fileWatcher, parser) {
-        this.watching = false;
-        this.fileWatcher = fileWatcher;
-        this.parser = parser;
-    }
-    isWatching() {
-        return this.watching;
-    }
-    async start(options) {
-        if (this.watching) {
-            throw new Error('Already watching. Stop the watcher before starting again.');
-        }
-        this.callback = options.onCleanSession;
-        this.watching = true;
-        this.fileWatcher.setFileEventHandler(async (event) => {
-            await this.handleFileEvent(event, options.codingAgentInfo.name);
-        });
-        await this.fileWatcher.start([options.codingAgentInfo.chatLogPath]);
-    }
-    async stop() {
-        if (!this.watching) {
-            return;
-        }
-        await this.fileWatcher.stop();
-        this.callback = undefined;
-        this.watching = false;
-    }
-    async handleFileEvent(event, codingAgent) {
-        try {
-            if (event.type !== 'add' && event.type !== 'change') {
-                return;
-            }
-            const sessions = await this.parser.parse(event.path, codingAgent);
-            if (this.callback !== undefined) {
-                for (const session of sessions) {
-                    try {
-                        // eslint-disable-next-line no-await-in-loop
-                        await this.callback(session);
-                    }
-                    catch (error) {
-                        console.error(`[CodingAgentLogWatcher] Error in session callback: ${error}`);
-                    }
-                }
-            }
-        }
-        catch (error) {
-            console.error(`[CodingAgentLogWatcher] Error processing file ${event.path}: ${error}`);
-        }
-    }
-}

package/dist/infra/parsers/clean/clean-claude-service.d.ts

@@ -1,111 +0,0 @@
-/**
- * Claude Clean Service
- * Transforms Claude raw parsed data to clean normalized format
- * Consolidates agent sessions and normalizes messages
- */
-import type { CleanSession } from '../../../core/domain/entities/parser.js';
-import { Agent } from '../../../core/domain/entities/agent.js';
-import { ICleanParserService } from '../../../core/interfaces/parser/i-clean-parser-service.js';
-/**
- * Claude Clean Service
- * Transforms Claude raw parsed sessions to clean normalized format
- */
-export declare class ClaudeCleanService implements ICleanParserService {
-    private ide;
-    /**
-     * Initialize Claude Clean Service
-     *
-     * @param ide - The IDE type (Claude Code)
-     */
-    constructor(ide: Agent);
-    /**
-     * Parse and transform raw Claude sessions to clean normalized format
-     *
-     * Reads raw sessions organized by workspace, consolidates agent sessions into main
-     * conversations, and normalizes message format. Returns sessions in-memory without file writing.
-     *
-     * @param rawDir - Path to directory containing raw Claude session files organized by workspace
-     * @returns Promise resolving to array of clean normalized sessions
-     */
-    parse(rawDir: string): Promise<readonly CleanSession[]>;
-    /**
-     * Calculate string similarity score using word overlap method
-     *
-     * Computes similarity by comparing words with length > 3 characters.
-     * Returns fraction of matching words relative to max length.
-     *
-     * @param str1 - First string to compare
-     * @param str2 - Second string to compare
-     * @returns Similarity score between 0 (no match) and 1 (perfect match)
-     */
-    private calculateSimilarity;
-    /**
-     * Consolidate agent session data into main conversation
-     *
-     * When main conversation contains Task subagent invocation, flattens the agent
-     * session messages into the main message stream. Two-pass algorithm: first identify
-     * Task invocations with matching agent sessions, then insert agent messages.
-     *
-     * @param mainSession - Main Claude conversation session to consolidate into
-     * @param agentSessions - Map of agent sessions keyed by agent session ID
-     * @returns Promise resolving to consolidated session with agent messages merged
-     */
-    private consolidateAgentSessions;
-    /**
-     * Find best matching agent session for a task description and timestamp
-     *
-     * Locates matching agent session using similarity scoring and timestamp proximity.
-     * Considers both task description similarity and temporal closeness (within 5 seconds).
-     *
-     * @param description - Task description from Task tool_use invocation
-     * @param messageTimestamp - Timestamp of message containing Task invocation
-     * @param agentSessions - Map of available agent sessions
-     * @returns Matching agent session or null if no good match found
-     */
-    private findMatchingAgentSession;
-    /**
-     * Flatten messages with agent sessions inserted after Task invocations
-     *
-     * Inserts agent session messages into message stream after Task tool_use invocations
-     * that have matching agent sessions. Preserves message order.
-     *
-     * @param messages - Array of raw session messages
-     * @param taskToolUseIds - Set of Task tool_use IDs that have matching agent sessions
-     * @param agentSessions - Map of available agent sessions
-     * @returns Flattened message array with agent messages interleaved
-     */
-    private flattenMessagesWithAgentSessions;
-    /**
-     * Identify Task tool_use IDs that have matching agent sessions
-     *
-     * Scans messages for Task tool_use invocations and identifies which ones
-     * have corresponding agent sessions that can be consolidated.
-     *
-     * @param messages - Array of session messages
-     * @param agentSessions - Map of available agent sessions
-     * @returns Set of tool_use IDs that have matching agent sessions
-     */
-    private identifyTaskToolIds;
-    /**
-     * Load and organize sessions from workspace directory
-     *
-     * Reads JSON files from workspace directory and organizes them into main sessions
-     * and agent sessions based on filename prefix ('agent-' for agent sessions).
-     *
-     * @param workspacePath - Path to workspace directory containing session files
-     * @param jsonFiles - Array of JSON filenames to load
-     * @returns Promise resolving to object with separated agentSessions and allSessions maps
-     */
-    private loadSessions;
-    /**
-     * Process main sessions and return normalized outputs
-     *
-     * Consolidates agent sessions and normalizes each session.
-     * Returns normalized sessions in-memory without writing to disk.
-     *
-     * @param allSessions - Map of main sessions to process
-     * @param agentSessions - Map of available agent sessions for consolidation
-     * @returns Promise resolving to array of clean normalized sessions
-     */
-    private processMainSessions;
-}