Function parseClaudeSession

devctx/src/core/parser.ts:142–203

(
    sessionPath: string
)

}

async function parseClaudeSession(
    sessionPath: string
): Promise<ExtractedContext | null> {
    // Read ALL lines — we need both the first messages (intent) and last messages (state)
    const allLines = await readLastLines(sessionPath, 500);

    // Separate into first messages (intent) and last messages (current state)
    const firstUserMessages: string[] = [];
    const lastUserMessages: string[] = [];
    const lastAssistantMessages: string[] = [];

    for (const line of allLines) {
        try {
            const entry = JSON.parse(line);
            const text = extractMessageText(entry);
            if (!text || text.length < 5) continue;

            if (entry.type === "user") {
                // Collect first 3 user messages as intent
                if (firstUserMessages.length < 3) {
                    firstUserMessages.push(text);
                }
                lastUserMessages.push(text);
            } else if (entry.type === "assistant" && text.length > 20) {
                lastAssistantMessages.push(text);
            }
        } catch {
            // Skip malformed lines
        }
    }

    if (firstUserMessages.length === 0) return null;

    // The FIRST user message is the intent — what they wanted to do
    const intent = firstUserMessages[0];
    const intentFirstLine = intent.split("\n")[0].trim();
    // Use first line if short, or first 200 chars
    const task = intentFirstLine.length < 300 ? intentFirstLine : intent.slice(0, 200);

    // Later user messages show what else was requested
    const additionalRequests = firstUserMessages.slice(1).map((m) => {
        const line = m.split("\n")[0].trim();
        return line.length < 200 ? line : line.slice(0, 200);
    });

    // Use assistant messages for decisions/approaches/state
    const recentAssistant = lastAssistantMessages.slice(-10);
    const decisions = extractDecisions(recentAssistant);
    const approaches = extractApproaches(recentAssistant);
    const currentState = extractState(recentAssistant);
    const nextSteps = extractNextSteps(recentAssistant);

    return {
        task,
        approaches: [...additionalRequests.map(r => `User also asked: ${r}`), ...approaches],
        decisions,
        currentState: currentState || "Session data parsed from Claude Code",
        nextSteps,