claude-mem/scripts/transcript-to-markdown.ts

#!/usr/bin/env tsx
/**
 * Transcript to Markdown - Complete 1:1 representation
 * Shows ALL available context data from a Claude Code transcript
 */

import { TranscriptParser } from '../src/utils/transcript-parser.js';
import type { UserTranscriptEntry, AssistantTranscriptEntry, ToolResultContent } from '../types/transcript.js';
import { writeFileSync } from 'fs';
import { basename } from 'path';

const transcriptPath = process.argv[2];
const maxTurns = process.argv[3] ? parseInt(process.argv[3]) : 20;

if (!transcriptPath) {
  console.error('Usage: tsx scripts/transcript-to-markdown.ts <path-to-transcript.jsonl> [max-turns]');
  process.exit(1);
}

/**
 * Truncate string to max length, adding ellipsis if needed
 */
function truncate(str: string, maxLen: number = 500): string {
  if (str.length <= maxLen) return str;
  return str.substring(0, maxLen) + '\n... [truncated]';
}

/**
 * Format tool result content for display
 */
function formatToolResult(result: ToolResultContent): string {
  if (typeof result.content === 'string') {
    // Try to parse as JSON for better formatting
    try {
      const parsed = JSON.parse(result.content);
      return JSON.stringify(parsed, null, 2);
    } catch {
      return truncate(result.content);
    }
  }

  if (Array.isArray(result.content)) {
    // Handle array of content items - extract text and parse if JSON
    const formatted = result.content.map((item: any) => {
      if (item.type === 'text' && item.text) {
        try {
          const parsed = JSON.parse(item.text);
          return JSON.stringify(parsed, null, 2);
        } catch {
          return item.text;
        }
      }
      return JSON.stringify(item, null, 2);
    }).join('\n\n');

    return formatted;
  }

  return '[unknown result type]';
}

const parser = new TranscriptParser(transcriptPath);
const entries = parser.getAllEntries();
const stats = parser.getParseStats();

let output = `# Transcript: ${basename(transcriptPath)}\n\n`;
output += `**Generated:** ${new Date().toLocaleString()}\n`;
output += `**Total Entries:** ${stats.parsedEntries}\n`;
output += `**Entry Types:** ${JSON.stringify(stats.entriesByType, null, 2)}\n`;
output += `**Showing:** First ${maxTurns} conversation turns\n\n`;

output += `---\n\n`;

let turnNumber = 0;
let inTurn = false;

for (const entry of entries) {
  // Skip summary and file-history-snapshot entries
  if (entry.type === 'summary' || entry.type === 'file-history-snapshot') continue;

  // USER MESSAGE
  if (entry.type === 'user') {
    const userEntry = entry as UserTranscriptEntry;

    turnNumber++;
    if (turnNumber > maxTurns) break;

    inTurn = true;
    output += `## Turn ${turnNumber}\n\n`;
    output += `### 👤 User\n`;
    output += `**Timestamp:** ${userEntry.timestamp}\n`;
    output += `**UUID:** ${userEntry.uuid}\n`;
    output += `**Session ID:** ${userEntry.sessionId}\n`;
    output += `**CWD:** ${userEntry.cwd}\n\n`;

    // Extract user message text
    if (typeof userEntry.message.content === 'string') {
      output += userEntry.message.content + '\n\n';
    } else if (Array.isArray(userEntry.message.content)) {
      const textBlocks = userEntry.message.content.filter((c) => c.type === 'text');
      if (textBlocks.length > 0) {
        const text = textBlocks.map((b: any) => b.text).join('\n');
        output += text + '\n\n';
      }

      // Show ACTUAL tool results with their data
      const toolResults = userEntry.message.content.filter((c): c is ToolResultContent => c.type === 'tool_result');
      if (toolResults.length > 0) {
        output += `**Tool Results Submitted (${toolResults.length}):**\n\n`;
        for (const result of toolResults) {
          output += `- **Tool Use ID:** \`${result.tool_use_id}\`\n`;
          if (result.is_error) {
            output += `  **ERROR:**\n`;
          }
          output += `  \`\`\`json\n`;
          output += `  ${formatToolResult(result)}\n`;
          output += `  \`\`\`\n\n`;
        }
      }
    }
  }

  // ASSISTANT MESSAGE
  if (entry.type === 'assistant' && inTurn) {
    const assistantEntry = entry as AssistantTranscriptEntry;

    output += `### 🤖 Assistant\n`;
    output += `**Timestamp:** ${assistantEntry.timestamp}\n`;
    output += `**UUID:** ${assistantEntry.uuid}\n`;
    output += `**Model:** ${assistantEntry.message.model}\n`;
    output += `**Stop Reason:** ${assistantEntry.message.stop_reason || 'N/A'}\n\n`;

    if (!Array.isArray(assistantEntry.message.content)) {
      output += `*[No content]*\n\n`;
      continue;
    }

    const content = assistantEntry.message.content;

    // 1. Thinking blocks (show first, as they happen first in reasoning)
    const thinkingBlocks = content.filter((c) => c.type === 'thinking');
    if (thinkingBlocks.length > 0) {
      output += `**💭 Thinking:**\n\n`;
      for (const block of thinkingBlocks) {
        const thinking = (block as any).thinking;
        // Format thinking with proper line breaks and indentation
        const formattedThinking = thinking
          .split('\n')
          .map((line: string) => line.trimEnd())
          .join('\n');

        output += '> ';
        output += formattedThinking.replace(/\n/g, '\n> ');
        output += '\n\n';
      }
    }

    // 2. Text responses
    const textBlocks = content.filter((c) => c.type === 'text');
    if (textBlocks.length > 0) {
      output += `**Response:**\n\n`;
      for (const block of textBlocks) {
        output += (block as any).text + '\n\n';
      }
    }

    // 3. Tool uses - show complete input
    const toolUseBlocks = content.filter((c) => c.type === 'tool_use');
    if (toolUseBlocks.length > 0) {
      output += `**🔧 Tools Used (${toolUseBlocks.length}):**\n\n`;
      for (const tool of toolUseBlocks) {
        const t = tool as any;
        output += `- **${t.name}** (ID: \`${t.id}\`)\n`;
        output += `  \`\`\`json\n`;
        output += `  ${JSON.stringify(t.input, null, 2)}\n`;
        output += `  \`\`\`\n\n`;
      }
    }

    // 4. Token usage
    if (assistantEntry.message.usage) {
      const usage = assistantEntry.message.usage;
      output += `**📊 Token Usage:**\n`;
      output += `- Input: ${usage.input_tokens || 0}\n`;
      output += `- Output: ${usage.output_tokens || 0}\n`;
      if (usage.cache_creation_input_tokens) {
        output += `- Cache creation: ${usage.cache_creation_input_tokens}\n`;
      }
      if (usage.cache_read_input_tokens) {
        output += `- Cache read: ${usage.cache_read_input_tokens}\n`;
      }
      output += '\n';
    }

    output += `---\n\n`;
    inTurn = false;
  }
}

if (turnNumber < (stats.entriesByType['user'] || 0)) {
  output += `\n*... ${(stats.entriesByType['user'] || 0) - turnNumber} more turns not shown*\n`;
}

// Write output
const outputPath = transcriptPath.replace('.jsonl', '-complete.md');
writeFileSync(outputPath, output, 'utf-8');

console.log(`\nComplete transcript written to: ${outputPath}`);
console.log(`Turns shown: ${Math.min(turnNumber, maxTurns)} of ${stats.entriesByType['user'] || 0}\n`);