byterover-cli 0.2.1 → 0.3.1

package/dist/infra/parsers/raw/raw-copilot-service.d.ts

@@ -0,0 +1,196 @@
+/**
+ * GitHub Copilot Raw Service
+ * Consolidates CopilotParser + CopilotRawParser
+ * Extracts and exports GitHub Copilot chat sessions
+ */
+import { Agent } from '../../../core/domain/entities/agent.js';
+import { IRawParserService } from '../../../core/interfaces/parser/i-raw-parser-service.js';
+/**
+ * Copilot Raw Parser Service class
+ * Handles extraction of GitHub Copilot sessions from VS Code workspace storage
+ */
+export declare class CopilotRawService implements IRawParserService {
+    private ide;
+    private workspaceStoragePath;
+    /**
+     * Initialize Copilot Raw Service
+     *
+     * Detects and initializes the VS Code workspace storage path where
+     * GitHub Copilot chat session databases are stored.
+     *
+     * @param ide - The IDE type (Github Copilot)
+     */
+    constructor(ide: Agent);
+    /**
+     * Main entry point - Parse and export GitHub Copilot sessions
+     *
+     * Parses GitHub Copilot sessions from custom directory, extracts session data,
+     * and exports to JSON files organized by workspace. Creates summary file with
+     * aggregate statistics across all sessions. Returns success status.
+     *
+     * @param customDir - Path to directory containing GitHub Copilot session data
+     * @param outputDir - Optional output directory (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>;
+    /**
+     * Calculate total session duration from request timings
+     *
+     * Aggregates the totalElapsed time from all requests' result.timings field.
+     * Returns total duration in milliseconds across all request/response cycles.
+     *
+     * @param requests - Array of Copilot request data with timing information
+     * @returns Total elapsed time in milliseconds
+     */
+    private calculateTotalDuration;
+    /**
+     * Convert Copilot requests to normalized messages
+     *
+     * Transforms request/response pairs into alternating user and assistant messages.
+     * Each request becomes a user message (with attachments), and the response becomes
+     * an assistant message. Handles multiple response blocks and normalizes content format.
+     *
+     * @param requests - Array of Copilot request data to convert
+     * @returns Array of normalized RawCopilotRawMessage objects
+     */
+    private convertRequestsToMessages;
+    /**
+     * Detect VS Code Copilot workspace storage path
+     *
+     * Locates the VS Code workspace storage directory where GitHub Copilot chat sessions
+     * are stored. Defaults to ~/Library/Application Support/Code/User/workspaceStorage
+     * on macOS or constructs path from HOME environment variable.
+     *
+     * @returns Absolute path to VS Code workspace storage directory
+     * @throws Error if VS Code workspace storage directory not found
+     */
+    private detectWorkspacePath;
+    /**
+     * Extract attachment file names from variable data
+     *
+     * Extracts names of attached files/references from Copilot variable data.
+     * Returns empty array if variable data is missing or contains no variables.
+     *
+     * @param variableData - Optional Copilot variable data containing attachments
+     * @returns Array of attachment file names
+     */
+    private extractAttachments;
+    /**
+     * Extract metadata from session data
+     *
+     * Aggregates session metadata including message counts, participant information,
+     * total duration, and workspace identification. Calculates message count as requests * 2
+     * (user + assistant message per request).
+     *
+     * @param data - Copilot session file data
+     * @param sessionId - Unique session identifier
+     * @param workspaceHash - Workspace hash identifying the workspace
+     * @returns Extracted RawCopilotSessionMetadata object
+     */
+    private extractMetadata;
+    /**
+     * Extract session title from first message or request
+     *
+     * Uses the first message content as session title (preferred), falls back to first request text.
+     * Truncates to TITLE_TRUNCATE_LENGTH (100) if content exceeds TITLE_MAX_LENGTH (150) characters.
+     * Appends ellipsis ("...") if truncated. Returns default title if no messages or requests.
+     *
+     * @param requests - Array of Copilot requests (fallback source)
+     * @param messages - Array of normalized messages (preferred source)
+     * @returns Session title string (max 103 characters with ellipsis)
+     */
+    private extractTitle;
+    /**
+     * Extract workspace path using hybrid approach
+     *
+     * Attempts extraction using two tiers in order of reliability:
+     * - Tier 1A: SQLite scm:view:visibleRepositories (most reliable, handles monorepos)
+     * - Tier 1B: baseUri.path from session data (fallback approach)
+     * Returns single string for single repo, array for monorepo, or null if not found.
+     *
+     * @param data - Copilot session file data (used for Tier 1B fallback)
+     * @param workspaceHash - Workspace hash for SQLite database lookup
+     * @returns Workspace path(s) as string, string array, or null if not found
+     */
+    private extractWorkspacePath;
+    /**
+     * Tier 1A: Extract repository paths from VS Code SQLite state.vscdb
+     * This is the most reliable source as it contains actual repositories visible in the workspace
+     * and can handle multi-repo/monorepo setups
+     *
+     * Returns:
+     * - Array of strings for monorepo/multi-repo workspaces
+     * - Single string for single-repo workspaces
+     * - null if not found
+     */
+    private extractWorkspacePathTier1A;
+    /**
+     * Extract workspace path from baseUri in session data (Tier 1B fallback)
+     *
+     * Recursively searches session data for objects with baseUri.path property containing
+     * an absolute file path. Used as fallback when SQLite extraction fails. Returns first
+     * valid path found, or null if no baseUri path found.
+     *
+     * @param data - Copilot session file data to search
+     * @returns Extracted workspace path string, or null if not found
+     */
+    private extractWorkspacePathTier1B;
+    /**
+     * Normalize Copilot content blocks
+     *
+     * Converts various content block formats to normalized RawCopilotContentBlock format.
+     * Preserves string content as-is, ensures all blocks have a kind field (defaults to 'unknown'),
+     * and stringifies non-object content as fallback.
+     *
+     * @param block - Content block to normalize (string or object)
+     * @returns Normalized content block or string
+     */
+    private normalizeContentBlock;
+    /**
+     * Normalize a Copilot request to RawCopilotParsedRequest type
+     *
+     * Standardizes request data structure, ensuring all required fields have values
+     * (using empty defaults where needed). Preserves response, result, and variable data.
+     *
+     * @param req - Raw Copilot request data to normalize
+     * @returns Normalized RawCopilotParsedRequest object
+     */
+    private normalizeParsedRequest;
+    /**
+     * Parse GitHub Copilot sessions from a custom directory
+     *
+     * Handles two directory structures:
+     * 1. Direct workspace directory (containing chatSessions/ subdirectory)
+     * 2. Parent directory (containing multiple workspace hash subdirectories)
+     * Parses all workspace directories in parallel and returns combined sessions array.
+     *
+     * @param customDir - Path to custom directory containing Copilot session data
+     * @returns Promise resolving to array of parsed RawCopilotRawSession objects
+     */
+    private parseFromDirectory;
+    /**
+     * Parse a single Copilot session file
+     *
+     * Reads and parses a GitHub Copilot session JSON file, extracting all session data
+     * including messages, metadata, requests, title, and workspace information.
+     * Returns null if file cannot be read or parsed.
+     *
+     * @param filePath - Absolute path to Copilot session JSON file
+     * @param workspaceHash - Workspace hash for the session (used for lookups)
+     * @returns Parsed RawCopilotRawSession object, or null if parsing fails
+     */
+    private parseSessionFile;
+    /**
+     * Parse sessions from a specific workspace directory
+     *
+     * Reads all .json files from the chatSessions subdirectory within a workspace,
+     * parses each session file, and returns array of successfully parsed sessions.
+     * Returns empty array if chatSessions directory doesn't exist. Logs errors for
+     * failed parses but continues processing remaining files.
+     *
+     * @param workspacePath - Path to workspace directory containing chatSessions
+     * @param workspaceHash - Workspace hash for the workspace
+     * @returns Promise resolving to array of parsed RawCopilotRawSession objects
+     */
+    private parseWorkspaceDirectory;
+}