byterover-cli 0.2.1 → 0.3.0

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

@@ -0,0 +1,567 @@
+/**
+ * Centralized parser types for both raw and clean parsers
+ * Single source of truth for all parser-related data structures
+ *
+ * Organization:
+ * 1. TARGET LAYER - Final normalized output types (CleanSession, CleanMessage, etc.)
+ * 2. RAW LAYER - Types used by raw parsers, organized by IDE
+ * 3. CLEAN LAYER - Helper types for clean parsers
+ */
+/**
+ * Workspace information type
+ * Used across raw parsers for workspace validation and identification
+ */
+export type WorkspaceInfo = {
+    isValid: boolean;
+    name: string;
+    path: string;
+    reason?: string;
+    type: 'claude' | 'codex' | 'copilot' | 'cursor';
+};
+/**
+ * Session type union for all supported IDEs
+ */
+export type SessionType = 'Claude' | 'Codex' | 'Copilot' | 'Cursor';
+/**
+ * Content block types - Unified representation across all IDEs
+ */
+export type TextContentBlock = {
+    text: string;
+    type: 'text';
+};
+export type ThinkingContentBlock = {
+    thinking: string;
+    type: 'thinking';
+};
+export type ToolUseContentBlock = {
+    id: string;
+    input: Record<string, unknown>;
+    name: string;
+    tool_use_id?: string;
+    type: 'tool_use';
+};
+export type ToolResultContentBlock = {
+    content: Record<string, unknown> | string;
+    tool_use_id: string;
+    type: 'tool_result';
+};
+export type ContentBlock = Record<string, unknown> | TextContentBlock | ThinkingContentBlock | ToolResultContentBlock | ToolUseContentBlock;
+/**
+ * Clean message type - Normalized message format across all IDEs
+ */
+export type CleanMessage = {
+    [key: string]: unknown;
+    attachments?: string[];
+    content: ContentBlock[];
+    timestamp: string;
+    turn_id?: number;
+    type: 'assistant' | 'user';
+};
+/**
+ * Clean session type - Final normalized session format
+ */
+export type CleanSession = {
+    id: string;
+    messages: CleanMessage[];
+    metadata?: unknown;
+    timestamp: number;
+    title: string;
+    type: SessionType;
+    workspacePaths: string[];
+};
+export type RawClaudeTranscriptEntry = {
+    content?: string;
+    cwd?: string;
+    message?: {
+        content: (ContentBlock | string)[];
+        role: 'assistant' | 'user';
+        usage?: {
+            cache_creation_input_tokens?: number;
+            cache_read_input_tokens?: number;
+            input_tokens?: number;
+            output_tokens?: number;
+        };
+    };
+    sessionId?: string;
+    timestamp?: string;
+    type: 'assistant' | 'summary' | 'system' | 'user';
+    uuid?: string;
+};
+export type RawClaudeTokenUsage = {
+    cacheTokens?: number;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+};
+export type RawClaudeWorkspaceMetadata = {
+    path: string;
+    repository?: {
+        name: string;
+        url?: string;
+    };
+};
+export type RawClaudeSessionMetadata = {
+    assistantMessageCount: number;
+    cwd?: string;
+    duration: number;
+    endedAt?: string;
+    messageCount: number;
+    sessionId: string;
+    startedAt: string;
+    tokenUsage: RawClaudeTokenUsage;
+    userMessageCount: number;
+    workspace: RawClaudeWorkspaceMetadata;
+};
+export type RawClaudeRawMessage = {
+    content: ContentBlock[] | string;
+    cwd?: string;
+    timestamp: string;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    type: 'assistant' | 'system' | 'user';
+};
+export type RawClaudeRawSession = {
+    id: string;
+    messages: RawClaudeRawMessage[];
+    metadata: RawClaudeSessionMetadata;
+    timestamp: number;
+    title: string;
+};
+export type RawClaudeTimestamps = {
+    endedAt?: string;
+    startedAt: string;
+};
+export type RawCodexTokenUsage = {
+    cached_input_tokens?: number;
+    input_tokens?: number;
+    output_tokens?: number;
+};
+export type RawCodexEventPayload = {
+    info?: {
+        total_token_usage: RawCodexTokenUsage;
+    };
+    text?: string;
+    type: 'agent_reasoning' | 'token_count';
+};
+export type RawCodexResponsePayload = {
+    arguments?: Record<string, unknown> | string;
+    content?: RawCodexContentBlock[] | string;
+    name?: string;
+    output?: unknown;
+    role?: 'assistant' | 'user';
+    summary?: Array<{
+        text: string;
+        type: string;
+    }>;
+    type: 'function_call' | 'function_call_output' | 'message' | 'reasoning';
+};
+export type RawCodexSessionMetaPayload = {
+    cli_version?: string;
+    cwd?: string;
+    git?: {
+        repository_url?: string;
+    };
+    model_provider?: string;
+    originator?: string;
+    source?: string;
+    timestamp?: string;
+};
+export type RawCodexSessionMeta = {
+    cli_version?: string;
+    cwd?: string;
+    git?: {
+        repository_url?: string;
+    };
+    model_provider?: string;
+    originator?: string;
+    source?: string;
+    timestamp?: string;
+};
+export type RawCodexTranscriptEntry = {
+    payload?: Record<string, unknown>;
+    timestamp?: string;
+    type: 'event_msg' | 'response_item' | 'session_meta' | string;
+};
+export type RawCodexContentBlock = {
+    input?: Record<string, unknown>;
+    name?: string;
+    output?: unknown;
+    text?: string;
+    type: 'input_text' | 'output_text' | 'tool_use';
+};
+export type RawCodexSessionMetadata = {
+    assistantMessageCount: number;
+    cliVersion?: string;
+    duration: number;
+    endedAt?: string;
+    messageCount: number;
+    model?: string;
+    modelProvider?: string;
+    originator?: string;
+    sessionId: string;
+    source?: string;
+    startedAt: string;
+    tokenUsage: RawClaudeTokenUsage;
+    userMessageCount: number;
+    workspace: RawClaudeWorkspaceMetadata;
+};
+export type RawCodexRawEntry = {
+    payload: Record<string, unknown>;
+    timestamp: number;
+    type: 'event_msg' | 'response_item' | 'session_meta' | 'turn_context';
+};
+export type RawCodexRawMessage = {
+    content: ContentBlock[] | string | undefined;
+    reasoning?: string;
+    timestamp: string;
+    tokens?: {
+        input: number;
+        output: number;
+    };
+    type: 'assistant' | 'user';
+};
+export type RawCodexRawSession = {
+    id: string;
+    messages: RawCodexRawMessage[];
+    metadata: RawCodexSessionMetadata;
+    rawEntries: RawCodexRawEntry[];
+    timestamp: number;
+    title: string;
+};
+export type RawCopilotDatabaseRow = {
+    value?: string;
+};
+export type RawCopilotResponseBlock = {
+    [key: string]: unknown;
+    kind?: string;
+    text?: string;
+};
+export type RawCopilotVariableData = {
+    variables?: Array<{
+        kind?: string;
+        name: string;
+    }>;
+};
+export type RawCopilotContentBlock = {
+    [key: string]: RawCopilotContentBlock | RawCopilotContentBlock[] | string | undefined;
+    kind?: string;
+    text?: string;
+};
+export type RawCopilotRequestData = {
+    message?: {
+        text?: string;
+    };
+    requestId?: string;
+    response?: Record<string, unknown> | Record<string, unknown>[];
+    responseId?: string;
+    result?: {
+        [key: string]: unknown;
+        timings?: {
+            totalElapsed?: number;
+        };
+    };
+    variableData?: RawCopilotVariableData;
+};
+export type RawCopilotSessionFileData = {
+    [key: string]: unknown;
+    baseUri?: {
+        path?: string;
+    };
+    initialLocation?: string;
+    requesterUsername?: string;
+    requests?: RawCopilotRequestData[];
+    responderUsername?: string;
+};
+export type RawCopilotSessionMetadata = {
+    initialLocation?: string;
+    messageCount: number;
+    requestCount: number;
+    requesterUsername: string;
+    responderUsername: string;
+    sessionId: string;
+    totalDuration: number;
+    workspace: {
+        path: string;
+    };
+};
+export type RawCopilotResponseItem = {
+    [key: string]: unknown;
+    invocationMessage?: {
+        value: unknown;
+    };
+    kind?: string;
+    output?: unknown;
+    toolCallId?: string;
+    toolId?: string;
+    value?: string;
+};
+export type RawCopilotToolCallRound = {
+    toolCalls: Array<{
+        arguments?: Record<string, unknown> | string;
+        id: string;
+    }>;
+};
+export type RawCopilotParsedRequest = {
+    message?: {
+        text?: string;
+    };
+    requestId: string;
+    response?: RawCopilotResponseItem[];
+    responseId: string;
+    result?: {
+        metadata?: {
+            toolCallResults?: Record<string, unknown>;
+            toolCallRounds?: RawCopilotToolCallRound[];
+        };
+        timings?: {
+            totalElapsed?: number;
+        };
+    };
+    variableData?: {
+        variables?: Array<{
+            kind?: string;
+            name: string;
+        }>;
+    };
+};
+export type RawCopilotRawMessage = {
+    attachments?: string[];
+    content: ContentBlock[] | string;
+    type: 'assistant' | 'user';
+};
+export type RawCopilotRawSession = {
+    id: string;
+    messages: RawCopilotRawMessage[];
+    metadata: RawCopilotSessionMetadata;
+    requests?: RawCopilotParsedRequest[];
+    timestamp: number;
+    title: string;
+    workspaceHash: string;
+    workspacePath?: string | string[];
+};
+export type RawCursorComposerData = {
+    [key: string]: unknown;
+    composerId: string;
+};
+export type RawCursorDatabaseQueryResult = {
+    [key: string]: unknown;
+    value: Buffer | string;
+};
+export type RawCursorRule = {
+    [key: string]: unknown;
+    content?: string;
+    id?: string;
+    name?: string;
+};
+export type RawCursorTerminalFile = {
+    [key: string]: unknown;
+    name: string;
+    path: string;
+};
+export type RawCursorKnowledgeItem = {
+    [key: string]: unknown;
+    content?: string;
+    id?: string;
+    title?: string;
+};
+export type RawCursorTodoItem = {
+    [key: string]: unknown;
+    completed?: boolean;
+    id?: string;
+    text?: string;
+};
+export type RawCursorDeletedFile = {
+    [key: string]: unknown;
+    deletedAt?: number;
+    path: string;
+};
+export type RawCursorAttachedFolderListDirResult = {
+    [key: string]: unknown;
+    contents: string[];
+    path: string;
+};
+export type RawCursorBubbleRaw = {
+    [key: string]: unknown;
+    attachedFoldersListDirResults?: RawCursorAttachedFolderListDirResult[];
+    codeBlocks?: Record<string, string>;
+    consoleLogs?: string[];
+    cursorRules?: RawCursorRule[];
+    text?: string;
+    timestamp?: number;
+    toolFormerData?: Record<string, unknown>;
+};
+export type RawCursorToolResult = {
+    additionalData?: Record<string, unknown>;
+    modelCallId: string;
+    name: string;
+    params: Record<string, unknown> | string;
+    rawArgs: Record<string, unknown> | string;
+    result: Record<string, unknown> | string;
+    status: string;
+    tool: number;
+    toolCallId: string;
+    toolIndex: number;
+};
+export type RawCursorContextInfo = {
+    attachedFolders?: Record<string, unknown>[];
+    attachedFoldersListDirResults?: RawCursorAttachedFolderListDirResult[];
+    cursorRules?: RawCursorRule[];
+    deletedFiles?: RawCursorDeletedFile[];
+    gitStatus?: string;
+    knowledgeItems?: RawCursorKnowledgeItem[];
+    terminalFiles?: RawCursorTerminalFile[];
+    todos?: RawCursorTodoItem[];
+};
+export type RawCursorCodeDiff = {
+    [key: string]: unknown;
+    diffId: string;
+    filePath?: string;
+    newModelDiffWrtV0?: Array<unknown>;
+    originalModelDiffWrtV0?: Array<unknown>;
+};
+export type RawCursorFileCheckpoint = {
+    activeInlineDiffs: string[];
+    files: string[];
+    inlineDiffNewlyCreatedResources?: {
+        files: string[];
+        folders: string[];
+    };
+    newlyCreatedFolders: string[];
+    nonExistentFiles: string[];
+};
+export type RawCursorMessageRequestContext = {
+    [key: string]: unknown;
+    attachedFoldersListDirResults?: RawCursorAttachedFolderListDirResult[];
+    bubbleId?: string;
+    contextId?: string;
+    cursorRules?: RawCursorRule[];
+    deletedFiles?: RawCursorDeletedFile[];
+    gitStatusRaw?: string;
+    knowledgeItems?: RawCursorKnowledgeItem[];
+    terminalFiles?: RawCursorTerminalFile[];
+    todos?: RawCursorTodoItem[];
+};
+export type RawCursorEnhancedChatBubble = {
+    codeBlocks?: Record<string, string>;
+    codeDiffs?: RawCursorCodeDiff[];
+    consoleLogs?: string[];
+    context?: RawCursorContextInfo;
+    fileCheckpoint?: RawCursorFileCheckpoint;
+    text: string;
+    timestamp: number;
+    toolResults?: RawCursorToolResult;
+    type: 'ai' | 'user';
+};
+export type RawCursorBubbleLoadResult = {
+    bubbleMap: Record<string, RawCursorBubbleRaw>;
+    bubbleWorkspaceMap: Record<string, string>;
+    uniqueWorkspaces: Set<string>;
+};
+export type RawCursorBubbleProcessResult = {
+    bubbles: RawCursorEnhancedChatBubble[];
+    usedWorkspaces: Set<string>;
+};
+export type RawCursorConversation = {
+    bubbles: RawCursorEnhancedChatBubble[];
+    composerId: string;
+    name: string;
+    timestamp: number;
+    workspacePath?: string | string[];
+};
+export type RawCursorParseResult = {
+    errors?: Array<{
+        error: string;
+        path: string;
+    }>;
+    totalBubbles: number;
+    totalSessions: number;
+    totalToolInvocations: number;
+    totalWorkspaces: number;
+    workspaces: Array<{
+        metadata: {
+            totalBubbles: number;
+            totalSessions: number;
+            totalToolInvocations: number;
+        };
+        sessions: RawCursorRawSession[];
+        workspaceHash: string;
+        workspacePath: string | string[];
+    }>;
+};
+export type CursorToolResult = {
+    content?: unknown;
+    name: string;
+    output?: string;
+    params?: Record<string, unknown>;
+    result?: Record<string, unknown>;
+    toolCallId: string;
+};
+export type CursorCodeBlock = {
+    content: string;
+    languageId?: string;
+};
+export type CursorContextInfo = {
+    [key: string]: unknown;
+    attachedFoldersListDirResults?: unknown[];
+    cursorRules?: unknown[];
+    deletedFiles?: unknown[];
+    gitStatus?: string;
+    knowledgeItems?: unknown[];
+    terminalFiles?: unknown[];
+    todos?: unknown[];
+};
+export type CursorBubble = {
+    codeBlocks?: CursorCodeBlock[];
+    context?: CursorContextInfo;
+    text: string;
+    timestamp: number;
+    toolResults?: CursorToolResult;
+    type: 'ai' | 'user';
+};
+export type RawCursorSessionMetadata = {
+    aiBubbles: number;
+    bubbleCount: number;
+    codeBlockLanguages: string[];
+    createdAt?: number;
+    hasCodeBlocks: boolean;
+    lastUpdatedAt?: number;
+    toolInvocations: number;
+    userBubbles: number;
+    workspacePath?: string;
+};
+export type RawCursorRawSession = {
+    bubbles: CursorBubble[];
+    id: string;
+    metadata?: RawCursorSessionMetadata;
+    timestamp: number;
+    title: string;
+    workspaceHash: string;
+    workspacePath: string | string[];
+};
+/**
+ * Union type for all raw sessions from different IDEs
+ */
+export type RawSession = RawClaudeRawSession | RawCodexRawSession | RawCopilotRawSession | RawCursorRawSession;
+export type CleanClaudeSessionLoadResult = {
+    agentSessions: Map<string, RawClaudeRawSession>;
+    allSessions: Map<string, RawClaudeRawSession>;
+};
+export type CleanCopilotProcessResult = {
+    invalid: number;
+    total: number;
+    valid: number;
+};
+export type CleanCursorToolUseBlock = {
+    id: string;
+    input?: Record<string, unknown>;
+    name: string;
+    output?: Record<string, unknown> | string;
+    tool_use_id: string;
+    type: 'tool_use';
+};
+export type CleanCursorToolResultBlock = {
+    content: Record<string, unknown> | string;
+    type: 'tool_result';
+};

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

@@ -0,0 +1,10 @@
+/**
+ * Centralized parser types for both raw and clean parsers
+ * Single source of truth for all parser-related data structures
+ *
+ * Organization:
+ * 1. TARGET LAYER - Final normalized output types (CleanSession, CleanMessage, etc.)
+ * 2. RAW LAYER - Types used by raw parsers, organized by IDE
+ * 3. CLEAN LAYER - Helper types for clean parsers
+ */
+export {};

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

@@ -1,5 +1,3 @@
-import type { IBulletContentStore } from '../../interfaces/i-bullet-content-store.js';
-import type { DeltaBatch } from './delta-batch.js';
 import { Bullet, type BulletJson, type BulletMetadata } from './bullet.js';
 export interface PlaybookJson {
     bullets: Record<string, BulletJson>;
@@ -13,28 +11,14 @@ export interface PlaybookStats {
 }
 /**
  * The central knowledge repository that stores and manages bullets.
- * Playbooks are organized into sections and support delta operations.
- * Playbooks are used as an temporary notes then will be pushed to byterover for usage
+ * Playbooks are organized into sections.
+ * Playbooks are used as temporary notes then will be pushed to byterover for usage.
  */
 export declare class Playbook {
     private readonly bullets;
     private nextId;
     private readonly sections;
     constructor(bullets?: Map<string, Bullet>, sections?: Map<string, string[]>, nextId?: number);
-    /**
-     * Creates a Playbook instance from a JSON object
-     * @param json The playbook JSON data
-     * @param contentStore Optional content store for loading bullet content from files
-     * @param directory Optional directory for loading content files
-     */
-    static fromJson(json: PlaybookJson, contentStore: IBulletContentStore, directory?: string): Promise<Playbook>;
-    /**
-     * Deserializes from JSON string
-     * @param data The JSON string
-     * @param contentStore Optional content store for loading bullet content from files
-     * @param directory Optional directory for loading content files
-     */
-    static loads(data: string, contentStore: IBulletContentStore, directory?: string): Promise<Playbook>;
     /**
      * Adds a new bullet to the playbook
      */
@@ -43,10 +27,6 @@ export declare class Playbook {
      * Adds a tag to a bullet
      */
     addTagToBullet(bulletId: string, tag: string): Bullet | undefined;
-    /**
-     * Applies a batch of delta operations to the playbook
-     */
-    applyDelta(delta: DeltaBatch): void;
     /**
      * Converts playbook to markdown format for LLM prompts
      */
@@ -96,6 +76,5 @@ export declare class Playbook {
         content?: string;
         metadata?: BulletMetadata;
     }): Bullet | undefined;
-    private _applyOperation;
     private _generateId;
 }