@arcreflex/agent-transcripts 0.1.8 → 0.1.9

package/CLAUDE.md

@@ -2,6 +2,10 @@
 
 @README.md
 
+## Architectural Notes
+
+- **Source paths are stable**: Session source paths (e.g., `~/.claude/projects/.../sessions/`) are standardized by the tools that create them. Don't over-engineer for path changes—use source paths as cache keys directly.
+
 ## Verification
 
 Before committing:

package/README.md

@@ -15,14 +15,22 @@ src/
   cli.ts          # CLI entry point, subcommand routing
   parse.ts        # Source → intermediate format
   render.ts       # Intermediate format → markdown
+  render-html.ts  # HTML transcript rendering
+  render-index.ts # Index page rendering
   convert.ts      # Full pipeline with provenance tracking
   sync.ts         # Batch sync sessions → markdown
+  serve.ts        # HTTP server for dynamic transcript serving
+  cache.ts        # Content-hash-based caching (~/.cache/agent-transcripts/)
+  title.ts        # LLM title generation
   types.ts        # Core types (Transcript, Message, Adapter)
   adapters/       # Source format adapters (currently: claude-code)
   utils/
     naming.ts     # Deterministic output file naming
     provenance.ts # Source tracking via transcripts.json + YAML front matter
     summary.ts    # Tool call summary extraction
+    openrouter.ts # OpenRouter API client for title generation
+    html.ts       # HTML escaping utility
+    tree.ts       # Tree navigation utilities
 test/
   fixtures/       # Snapshot test inputs/outputs
   snapshots.test.ts
@@ -43,6 +51,8 @@ bun run format       # auto-format
 agent-transcripts convert <file>              # Parse and render to stdout
 agent-transcripts convert <file> -o <dir>     # Parse and render to directory
 agent-transcripts sync <dir> -o <out>         # Batch sync sessions
+agent-transcripts serve <dir>                 # Serve transcripts via HTTP
+agent-transcripts serve <dir> -p 8080         # Serve on custom port
 
 # Use "-" for stdin
 cat session.jsonl | agent-transcripts -
@@ -58,11 +68,33 @@ Two-stage pipeline: Parse (source → intermediate) → Render (intermediate →
 - Provenance tracking via `transcripts.json` index + YAML front matter
 - Deterministic naming: `{datetime}-{sessionId}.md`
 - Sync uses sessions-index.json for discovery (claude-code), skipping subagent files
-- Sync uses mtime via index to skip unchanged sources
+- Sync uses content hash to skip unchanged sources (see Cache section)
+
+### Cache
+
+Derived content (rendered outputs, LLM-generated titles) is cached at `~/.cache/agent-transcripts/`:
+
+```
+~/.cache/agent-transcripts/
+  {source-path-hash}.json  →  CacheEntry
+```
+
+```typescript
+interface CacheEntry {
+  contentHash: string; // hash of source content (invalidation key)
+  segments: Array<{
+    title?: string; // LLM-generated title
+    html?: string; // rendered HTML
+    md?: string; // rendered markdown
+  }>;
+}
+```
+
+Cache is keyed by source path (hashed), invalidated by content hash. When source content changes, all cached data is invalidated and regenerated.
 
 ### transcripts.json
 
-The index file tracks the relationship between source files and outputs:
+The index file is a table of contents for the output directory:
 
 ```typescript
 interface TranscriptsIndex {
@@ -70,10 +102,15 @@ interface TranscriptsIndex {
   entries: {
     [outputFilename: string]: {
       source: string; // absolute path to source
-      sourceMtime: number; // ms since epoch
       sessionId: string; // full session ID from filename
       segmentIndex?: number; // for multi-transcript sources (1-indexed)
       syncedAt: string; // ISO timestamp
+      firstUserMessage: string; // first user message content
+      title?: string; // copied from cache for convenience
+      messageCount: number;
+      startTime: string; // ISO timestamp
+      endTime: string; // ISO timestamp
+      cwd?: string; // working directory
     };
   };
 }

package/bun.lock

@@ -6,6 +6,7 @@
       "name": "agent-transcripts",
       "dependencies": {
         "cmd-ts": "^0.13.0",
+        "shiki": "^3.21.0",
       },
       "devDependencies": {
         "@types/bun": "^1.1.14",
@@ -15,40 +16,128 @@
     },
   },
   "packages": {
+    "@shikijs/core": ["@shikijs/core@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4", "hast-util-to-html": "^9.0.5" } }, "sha512-AXSQu/2n1UIQekY8euBJlvFYZIw0PHY63jUzGbrOma4wPxzznJXTXkri+QcHeBNaFxiiOljKxxJkVSoB3PjbyA=="],
+
+    "@shikijs/engine-javascript": ["@shikijs/engine-javascript@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "oniguruma-to-es": "^4.3.4" } }, "sha512-ATwv86xlbmfD9n9gKRiwuPpWgPENAWCLwYCGz9ugTJlsO2kOzhOkvoyV/UD+tJ0uT7YRyD530x6ugNSffmvIiQ=="],
+
+    "@shikijs/engine-oniguruma": ["@shikijs/engine-oniguruma@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2" } }, "sha512-OYknTCct6qiwpQDqDdf3iedRdzj6hFlOPv5hMvI+hkWfCKs5mlJ4TXziBG9nyabLwGulrUjHiCq3xCspSzErYQ=="],
+
+    "@shikijs/langs": ["@shikijs/langs@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0" } }, "sha512-g6mn5m+Y6GBJ4wxmBYqalK9Sp0CFkUqfNzUy2pJglUginz6ZpWbaWjDB4fbQ/8SHzFjYbtU6Ddlp1pc+PPNDVA=="],
+
+    "@shikijs/themes": ["@shikijs/themes@3.21.0", "", { "dependencies": { "@shikijs/types": "3.21.0" } }, "sha512-BAE4cr9EDiZyYzwIHEk7JTBJ9CzlPuM4PchfcA5ao1dWXb25nv6hYsoDiBq2aZK9E3dlt3WB78uI96UESD+8Mw=="],
+
+    "@shikijs/types": ["@shikijs/types@3.21.0", "", { "dependencies": { "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-zGrWOxZ0/+0ovPY7PvBU2gIS9tmhSUUt30jAcNV0Bq0gb2S98gwfjIs1vxlmH5zM7/4YxLamT6ChlqqAJmPPjA=="],
+
+    "@shikijs/vscode-textmate": ["@shikijs/vscode-textmate@10.0.2", "", {}, "sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg=="],
+
     "@types/bun": ["@types/bun@1.3.6", "", { "dependencies": { "bun-types": "1.3.6" } }, "sha512-uWCv6FO/8LcpREhenN1d1b6fcspAB+cefwD7uti8C8VffIv0Um08TKMn98FynpTiU38+y2dUO55T11NgDt8VAA=="],
 
+    "@types/hast": ["@types/hast@3.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-WPs+bbQw5aCj+x6laNGWLH3wviHtoCv/P3+otBhbOhJgG8qtpdAMlTCxLtsTWA7LH1Oh/bFCHsBn0TPS5m30EQ=="],
+
+    "@types/mdast": ["@types/mdast@4.0.4", "", { "dependencies": { "@types/unist": "*" } }, "sha512-kGaNbPh1k7AFzgpud/gMdvIm5xuECykRR+JnWKQno9TAXVa6WIVCGTPvYGekIDL4uwCZQSYbUxNBSb1aUo79oA=="],
+
     "@types/node": ["@types/node@25.0.9", "", { "dependencies": { "undici-types": "~7.16.0" } }, "sha512-/rpCXHlCWeqClNBwUhDcusJxXYDjZTyE8v5oTO7WbL8eij2nKhUeU89/6xgjU7N4/Vh3He0BtyhJdQbDyhiXAw=="],
 
+    "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="],
+
+    "@ungap/structured-clone": ["@ungap/structured-clone@1.3.0", "", {}, "sha512-WmoN8qaIAo7WTYWbAZuG8PYEhn5fkz7dZrqTBZ7dtt//lL2Gwms1IcnQ5yHqjDfX8Ft5j4YzDM23f87zBfDe9g=="],
+
     "ansi-regex": ["ansi-regex@5.0.1", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],
 
     "ansi-styles": ["ansi-styles@4.3.0", "", { "dependencies": { "color-convert": "^2.0.1" } }, "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg=="],
 
     "bun-types": ["bun-types@1.3.6", "", { "dependencies": { "@types/node": "*" } }, "sha512-OlFwHcnNV99r//9v5IIOgQ9Uk37gZqrNMCcqEaExdkVq3Avwqok1bJFmvGMCkCE0FqzdY8VMOZpfpR3lwI+CsQ=="],
 
+    "ccount": ["ccount@2.0.1", "", {}, "sha512-eyrF0jiFpY+3drT6383f1qhkbGsLSifNAjA61IUjZjmLCWjItY6LB9ft9YhoDgwfmclB2zhu51Lc7+95b8NRAg=="],
+
     "chalk": ["chalk@4.1.2", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],
 
+    "character-entities-html4": ["character-entities-html4@2.1.0", "", {}, "sha512-1v7fgQRj6hnSwFpq1Eu0ynr/CDEw0rXo2B61qXrLNdHZmPKgb7fqS1a2JwF0rISo9q77jDI8VMEHoApn8qDoZA=="],
+
+    "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="],
+
     "cmd-ts": ["cmd-ts@0.13.0", "", { "dependencies": { "chalk": "^4.0.0", "debug": "^4.3.4", "didyoumean": "^1.2.2", "strip-ansi": "^6.0.0" } }, "sha512-nsnxf6wNIM/JAS7T/x/1JmbEsjH0a8tezXqqpaL0O6+eV0/aDEnRxwjxpu0VzDdRcaC1ixGSbRlUuf/IU59I4g=="],
 
     "color-convert": ["color-convert@2.0.1", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],
 
     "color-name": ["color-name@1.1.4", "", {}, "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="],
 
+    "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="],
+
     "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="],
 
+    "dequal": ["dequal@2.0.3", "", {}, "sha512-0je+qPKHEMohvfRTCEo3CrPG6cAzAYgmzKyxRiYSSDkS6eGJdyVJm7WaYA5ECaAD9wLB2T4EEeymA5aFVcYXCA=="],
+
+    "devlop": ["devlop@1.1.0", "", { "dependencies": { "dequal": "^2.0.0" } }, "sha512-RWmIqhcFf1lRYBvNmr7qTNuyCt/7/ns2jbpp1+PalgE/rDQcBT0fioSMUpJ93irlUhC5hrg4cYqe6U+0ImW0rA=="],
+
     "didyoumean": ["didyoumean@1.2.2", "", {}, "sha512-gxtyfqMg7GKyhQmb056K7M3xszy/myH8w+B4RT+QXBQsvAOdc3XymqDDPHx1BgPgsdAA5SIifona89YtRATDzw=="],
 
     "has-flag": ["has-flag@4.0.0", "", {}, "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="],
 
+    "hast-util-to-html": ["hast-util-to-html@9.0.5", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/unist": "^3.0.0", "ccount": "^2.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-whitespace": "^3.0.0", "html-void-elements": "^3.0.0", "mdast-util-to-hast": "^13.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0", "stringify-entities": "^4.0.0", "zwitch": "^2.0.4" } }, "sha512-OguPdidb+fbHQSU4Q4ZiLKnzWo8Wwsf5bZfbvu7//a9oTYoqD/fWpe96NuHkoS9h0ccGOTe0C4NGXdtS0iObOw=="],
+
+    "hast-util-whitespace": ["hast-util-whitespace@3.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-88JUN06ipLwsnv+dVn+OIYOvAuvBMy/Qoi6O7mQHxdPXpjy+Cd6xRkWwux7DKO+4sYILtLBRIKgsdpS2gQc7qw=="],
+
+    "html-void-elements": ["html-void-elements@3.0.0", "", {}, "sha512-bEqo66MRXsUGxWHV5IP0PUiAWwoEjba4VCzg0LjFJBpchPaTfyfCKTG6bc5F8ucKec3q5y6qOdGyYTSBEvhCrg=="],
+
+    "mdast-util-to-hast": ["mdast-util-to-hast@13.2.1", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/mdast": "^4.0.0", "@ungap/structured-clone": "^1.0.0", "devlop": "^1.0.0", "micromark-util-sanitize-uri": "^2.0.0", "trim-lines": "^3.0.0", "unist-util-position": "^5.0.0", "unist-util-visit": "^5.0.0", "vfile": "^6.0.0" } }, "sha512-cctsq2wp5vTsLIcaymblUriiTcZd0CwWtCbLvrOzYCDZoWyMNV8sZ7krj09FSnsiJi3WVsHLM4k6Dq/yaPyCXA=="],
+
+    "micromark-util-character": ["micromark-util-character@2.1.1", "", { "dependencies": { "micromark-util-symbol": "^2.0.0", "micromark-util-types": "^2.0.0" } }, "sha512-wv8tdUTJ3thSFFFJKtpYKOYiGP2+v96Hvk4Tu8KpCAsTMs6yi+nVmGh1syvSCsaxz45J6Jbw+9DD6g97+NV67Q=="],
+
+    "micromark-util-encode": ["micromark-util-encode@2.0.1", "", {}, "sha512-c3cVx2y4KqUnwopcO9b/SCdo2O67LwJJ/UyqGfbigahfegL9myoEFoDYZgkT7f36T0bLrM9hZTAaAyH+PCAXjw=="],
+
+    "micromark-util-sanitize-uri": ["micromark-util-sanitize-uri@2.0.1", "", { "dependencies": { "micromark-util-character": "^2.0.0", "micromark-util-encode": "^2.0.0", "micromark-util-symbol": "^2.0.0" } }, "sha512-9N9IomZ/YuGGZZmQec1MbgxtlgougxTodVwDzzEouPKo3qFWvymFHWcnDi2vzV1ff6kas9ucW+o3yzJK9YB1AQ=="],
+
+    "micromark-util-symbol": ["micromark-util-symbol@2.0.1", "", {}, "sha512-vs5t8Apaud9N28kgCrRUdEed4UJ+wWNvicHLPxCa9ENlYuAY31M0ETy5y1vA33YoNPDFTghEbnh6efaE8h4x0Q=="],
+
+    "micromark-util-types": ["micromark-util-types@2.0.2", "", {}, "sha512-Yw0ECSpJoViF1qTU4DC6NwtC4aWGt1EkzaQB8KPPyCRR8z9TWeV0HbEFGTO+ZY1wB22zmxnJqhPyTpOVCpeHTA=="],
+
     "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="],
 
+    "oniguruma-parser": ["oniguruma-parser@0.12.1", "", {}, "sha512-8Unqkvk1RYc6yq2WBYRj4hdnsAxVze8i7iPfQr8e4uSP3tRv0rpZcbGUDvxfQQcdwHt/e9PrMvGCsa8OqG9X3w=="],
+
+    "oniguruma-to-es": ["oniguruma-to-es@4.3.4", "", { "dependencies": { "oniguruma-parser": "^0.12.1", "regex": "^6.0.1", "regex-recursion": "^6.0.2" } }, "sha512-3VhUGN3w2eYxnTzHn+ikMI+fp/96KoRSVK9/kMTcFqj1NRDh2IhQCKvYxDnWePKRXY/AqH+Fuiyb7VHSzBjHfA=="],
+
     "prettier": ["prettier@3.8.0", "", { "bin": { "prettier": "bin/prettier.cjs" } }, "sha512-yEPsovQfpxYfgWNhCfECjG5AQaO+K3dp6XERmOepyPDVqcJm+bjyCVO3pmU+nAPe0N5dDvekfGezt/EIiRe1TA=="],
 
+    "property-information": ["property-information@7.1.0", "", {}, "sha512-TwEZ+X+yCJmYfL7TPUOcvBZ4QfoT5YenQiJuX//0th53DE6w0xxLEtfK3iyryQFddXuvkIk51EEgrJQ0WJkOmQ=="],
+
+    "regex": ["regex@6.1.0", "", { "dependencies": { "regex-utilities": "^2.3.0" } }, "sha512-6VwtthbV4o/7+OaAF9I5L5V3llLEsoPyq9P1JVXkedTP33c7MfCG0/5NOPcSJn0TzXcG9YUrR0gQSWioew3LDg=="],
+
+    "regex-recursion": ["regex-recursion@6.0.2", "", { "dependencies": { "regex-utilities": "^2.3.0" } }, "sha512-0YCaSCq2VRIebiaUviZNs0cBz1kg5kVS2UKUfNIx8YVs1cN3AV7NTctO5FOKBA+UT2BPJIWZauYHPqJODG50cg=="],
+
+    "regex-utilities": ["regex-utilities@2.3.0", "", {}, "sha512-8VhliFJAWRaUiVvREIiW2NXXTmHs4vMNnSzuJVhscgmGav3g9VDxLrQndI3dZZVVdp0ZO/5v0xmX516/7M9cng=="],
+
+    "shiki": ["shiki@3.21.0", "", { "dependencies": { "@shikijs/core": "3.21.0", "@shikijs/engine-javascript": "3.21.0", "@shikijs/engine-oniguruma": "3.21.0", "@shikijs/langs": "3.21.0", "@shikijs/themes": "3.21.0", "@shikijs/types": "3.21.0", "@shikijs/vscode-textmate": "^10.0.2", "@types/hast": "^3.0.4" } }, "sha512-N65B/3bqL/TI2crrXr+4UivctrAGEjmsib5rPMMPpFp1xAx/w03v8WZ9RDDFYteXoEgY7qZ4HGgl5KBIu1153w=="],
+
+    "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="],
+
+    "stringify-entities": ["stringify-entities@4.0.4", "", { "dependencies": { "character-entities-html4": "^2.0.0", "character-entities-legacy": "^3.0.0" } }, "sha512-IwfBptatlO+QCJUo19AqvrPNqlVMpW9YEL2LIVY+Rpv2qsjCGxaDLNRgeGsQWJhfItebuJhsGSLjaBbNSQ+ieg=="],
+
     "strip-ansi": ["strip-ansi@6.0.1", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],
 
     "supports-color": ["supports-color@7.2.0", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],
 
+    "trim-lines": ["trim-lines@3.0.1", "", {}, "sha512-kRj8B+YHZCc9kQYdWfJB2/oUl9rA99qbowYYBtr4ui4mZyAQ2JpvVBd/6U2YloATfqBhBTSMhTpgBHtU0Mf3Rg=="],
+
     "typescript": ["typescript@5.9.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw=="],
 
     "undici-types": ["undici-types@7.16.0", "", {}, "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw=="],
+
+    "unist-util-is": ["unist-util-is@6.0.1", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-LsiILbtBETkDz8I9p1dQ0uyRUWuaQzd/cuEeS1hoRSyW5E5XGmTzlwY1OrNzzakGowI9Dr/I8HVaw4hTtnxy8g=="],
+
+    "unist-util-position": ["unist-util-position@5.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-fucsC7HjXvkB5R3kTCO7kUjRdrS0BJt3M/FPxmHMBOm8JQi2BsHAHFsy27E0EolP8rp0NzXsJ+jNPyDWvOJZPA=="],
+
+    "unist-util-stringify-position": ["unist-util-stringify-position@4.0.0", "", { "dependencies": { "@types/unist": "^3.0.0" } }, "sha512-0ASV06AAoKCDkS2+xw5RXJywruurpbC4JZSm7nr7MOt1ojAzvyyaO+UxZf18j8FCF6kmzCZKcAgN/yu2gm2XgQ=="],
+
+    "unist-util-visit": ["unist-util-visit@5.1.0", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0", "unist-util-visit-parents": "^6.0.0" } }, "sha512-m+vIdyeCOpdr/QeQCu2EzxX/ohgS8KbnPDgFni4dQsfSCtpz8UqDyY5GjRru8PDKuYn7Fq19j1CQ+nJSsGKOzg=="],
+
+    "unist-util-visit-parents": ["unist-util-visit-parents@6.0.2", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-is": "^6.0.0" } }, "sha512-goh1s1TBrqSqukSc8wrjwWhL0hiJxgA8m4kFxGlQ+8FYQ3C/m11FcTs4YYem7V664AhHVvgoQLk890Ssdsr2IQ=="],
+
+    "vfile": ["vfile@6.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "vfile-message": "^4.0.0" } }, "sha512-KzIbH/9tXat2u30jf+smMwFCsno4wHVdNmzFyL+T/L3UGqqk6JKfVqOFOZEpZSHADH1k40ab6NUIXZq422ov3Q=="],
+
+    "vfile-message": ["vfile-message@4.0.3", "", { "dependencies": { "@types/unist": "^3.0.0", "unist-util-stringify-position": "^4.0.0" } }, "sha512-QTHzsGd1EhbZs4AsQ20JX1rC3cOlt/IWJruk893DfLRr57lcnOeMaWG4K0JrRta4mIJZKth2Au3mM3u03/JWKw=="],
+
+    "zwitch": ["zwitch@2.0.4", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcreflex/agent-transcripts",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Transform AI coding agent session files into readable transcripts",
   "type": "module",
   "repository": {
@@ -21,7 +21,8 @@
     "format": "prettier --write ."
   },
   "dependencies": {
-    "cmd-ts": "^0.13.0"
+    "cmd-ts": "^0.13.0",
+    "shiki": "^3.21.0"
   },
   "devDependencies": {
     "@types/bun": "^1.1.14",

package/src/adapters/claude-code.ts

@@ -44,6 +44,7 @@ interface ClaudeRecord {
   };
   content?: string;
   subtype?: string;
+  cwd?: string;
 }
 
 interface ContentBlock {
@@ -54,7 +55,7 @@ interface ContentBlock {
   name?: string;
   input?: Record<string, unknown>;
   tool_use_id?: string;
-  content?: string;
+  content?: unknown; // Can be string, array, or other structure
 }
 
 /**
@@ -86,11 +87,42 @@ function parseJsonl(content: string): {
   return { records, warnings };
 }
 
+/**
+ * Find the nearest message ancestor by walking up the parent chain.
+ * Returns undefined if no message ancestor exists.
+ */
+function findMessageAncestor(
+  parentUuid: string | null | undefined,
+  allByUuid: Map<string, ClaudeRecord>,
+  messageUuids: Set<string>,
+): string | undefined {
+  const visited = new Set<string>();
+  let current = parentUuid;
+  while (current) {
+    if (visited.has(current)) {
+      return undefined; // Cycle detected
+    }
+    visited.add(current);
+    if (messageUuids.has(current)) {
+      return current;
+    }
+    const rec = allByUuid.get(current);
+    current = rec?.parentUuid ?? null;
+  }
+  return undefined;
+}
+
+interface SplitResult {
+  conversations: ClaudeRecord[][];
+  /** Map from message UUID to its resolved parent (nearest message ancestor) */
+  resolvedParents: Map<string, string | undefined>;
+}
+
 /**
  * Build message graph and find conversation boundaries.
- * Returns array of conversation groups (each is array of records in order).
+ * Returns conversations and a map of resolved parent references.
  */
-function splitConversations(records: ClaudeRecord[]): ClaudeRecord[][] {
+function splitConversations(records: ClaudeRecord[]): SplitResult {
   // Filter to only message records (user, assistant, system with uuid)
   const messageRecords = records.filter(
     (r) =>
@@ -98,29 +130,52 @@ function splitConversations(records: ClaudeRecord[]): ClaudeRecord[][] {
       (r.type === "user" || r.type === "assistant" || r.type === "system"),
   );
 
-  if (messageRecords.length === 0) return [];
-
-  // Build parent → children map
-  const byUuid = new Map<string, ClaudeRecord>();
-  const children = new Map<string, string[]>();
+  if (messageRecords.length === 0) {
+    return { conversations: [], resolvedParents: new Map() };
+  }
 
-  for (const rec of messageRecords) {
+  // Build UUID lookup for ALL records to track parent chains through non-messages
+  const allByUuid = new Map<string, ClaudeRecord>();
+  for (const rec of records) {
     if (rec.uuid) {
-      byUuid.set(rec.uuid, rec);
-      const parent = rec.parentUuid;
-      if (parent) {
-        const existing = children.get(parent) || [];
-        existing.push(rec.uuid);
-        children.set(parent, existing);
-      }
+      allByUuid.set(rec.uuid, rec);
     }
   }
 
-  // Find roots (no parent or parent not in our set)
+  // Set of message UUIDs for quick lookup
+  const messageUuids = new Set<string>();
+  for (const rec of messageRecords) {
+    if (rec.uuid) messageUuids.add(rec.uuid);
+  }
+
+  // Build parent → children map, resolving through non-message records
+  // Also track resolved parents for use in transformation
+  const byUuid = new Map<string, ClaudeRecord>();
+  const children = new Map<string, string[]>();
+  const resolvedParents = new Map<string, string | undefined>();
   const roots: string[] = [];
+
   for (const rec of messageRecords) {
-    if (!rec.parentUuid || !byUuid.has(rec.parentUuid)) {
-      if (rec.uuid) roots.push(rec.uuid);
+    if (!rec.uuid) continue;
+    byUuid.set(rec.uuid, rec);
+
+    // Find nearest message ancestor (walking through non-message records)
+    const ancestor = findMessageAncestor(
+      rec.parentUuid,
+      allByUuid,
+      messageUuids,
+    );
+
+    // Store resolved parent for this message
+    resolvedParents.set(rec.uuid, ancestor);
+
+    if (ancestor) {
+      const existing = children.get(ancestor) || [];
+      existing.push(rec.uuid);
+      children.set(ancestor, existing);
+    } else {
+      // No message ancestor - this is a root
+      roots.push(rec.uuid);
     }
   }
 
@@ -160,7 +215,7 @@ function splitConversations(records: ClaudeRecord[]): ClaudeRecord[][] {
     return ta - tb;
   });
 
-  return conversations;
+  return { conversations, resolvedParents };
 }
 
 /**
@@ -189,16 +244,23 @@ function extractThinking(content: string | ContentBlock[]): string | undefined {
 
 /**
  * Extract tool calls from content blocks.
+ * Matches with results from the toolResults map.
  */
-function extractToolCalls(content: string | ContentBlock[]): ToolCall[] {
+function extractToolCalls(
+  content: string | ContentBlock[],
+  toolResults: Map<string, string>,
+): ToolCall[] {
   if (typeof content === "string") return [];
 
   return content.flatMap((b) => {
-    if (b.type === "tool_use" && b.name) {
+    if (b.type === "tool_use" && b.name && b.id) {
+      const result = toolResults.get(b.id);
       return [
         {
           name: b.name,
           summary: extractToolSummary(b.name, b.input || {}),
+          input: b.input,
+          result,
         },
       ];
     }
@@ -206,6 +268,39 @@ function extractToolCalls(content: string | ContentBlock[]): ToolCall[] {
   });
 }
 
+/**
+ * Safely convert tool result content to string.
+ * Content can be a string, array, or other structure.
+ */
+function stringifyToolResult(content: unknown): string {
+  if (typeof content === "string") return content;
+  if (content === null || content === undefined) return "";
+  // For arrays or objects, JSON stringify for display
+  try {
+    return JSON.stringify(content, null, 2);
+  } catch {
+    return String(content);
+  }
+}
+
+/**
+ * Extract tool results from content blocks.
+ * Returns a map of tool_use_id → result content.
+ */
+function extractToolResults(
+  content: string | ContentBlock[],
+): Map<string, string> {
+  const results = new Map<string, string>();
+  if (typeof content === "string") return results;
+
+  for (const b of content) {
+    if (b.type === "tool_result" && b.tool_use_id && b.content !== undefined) {
+      results.set(b.tool_use_id, stringifyToolResult(b.content));
+    }
+  }
+  return results;
+}
+
 /**
  * Check if a user message contains only tool results (no actual user text).
  */
@@ -230,8 +325,13 @@ function resolveParent(
   if (!parentUuid) return undefined;
 
   // Follow the chain through any skipped messages
+  const visited = new Set<string>();
   let current: string | undefined = parentUuid;
   while (current && skippedParents.has(current)) {
+    if (visited.has(current)) {
+      return undefined; // Cycle detected
+    }
+    visited.add(current);
     current = skippedParents.get(current);
   }
 
@@ -245,17 +345,36 @@ function transformConversation(
   records: ClaudeRecord[],
   sourcePath: string,
   warnings: Warning[],
+  resolvedParents: Map<string, string | undefined>,
 ): Transcript {
   const messages: Message[] = [];
-  // Track skipped message UUIDs → their parent UUIDs for chain repair
+  // Track skipped message UUIDs → their resolved parent UUIDs for chain repair
   const skippedParents = new Map<string, string | undefined>();
 
+  // Collect all tool results from user messages (tool_use_id → result)
+  const allToolResults = new Map<string, string>();
+  for (const rec of records) {
+    if (rec.type === "user" && rec.message) {
+      const results = extractToolResults(rec.message.content);
+      for (const [id, content] of results) {
+        allToolResults.set(id, content);
+      }
+    }
+  }
+
+  let cwd: string | undefined;
+
   // First pass: identify which messages will be skipped
   for (const rec of records) {
     if (!rec.uuid) continue;
 
     let willSkip = false;
 
+    // Take the first cwd we find.
+    if (!cwd && rec.cwd) {
+      cwd = rec.cwd;
+    }
+
     if (rec.type === "user" && rec.message) {
       if (isToolResultOnly(rec.message.content)) {
         willSkip = true;
@@ -266,7 +385,7 @@ function transformConversation(
     } else if (rec.type === "assistant" && rec.message) {
       const text = extractText(rec.message.content);
       const thinking = extractThinking(rec.message.content);
-      const toolCalls = extractToolCalls(rec.message.content);
+      const toolCalls = extractToolCalls(rec.message.content, allToolResults);
       // Only skip if no text, no thinking, AND no tool calls
       if (!text.trim() && !thinking && toolCalls.length === 0) {
         willSkip = true;
@@ -277,7 +396,8 @@ function transformConversation(
     }
 
     if (willSkip) {
-      skippedParents.set(rec.uuid, rec.parentUuid || undefined);
+      // Use the resolved parent (already walked through non-message records)
+      skippedParents.set(rec.uuid, resolvedParents.get(rec.uuid));
     }
   }
 
@@ -285,7 +405,12 @@ function transformConversation(
   for (const rec of records) {
     const sourceRef = rec.uuid || "";
     const timestamp = rec.timestamp || new Date().toISOString();
-    const parentMessageRef = resolveParent(rec.parentUuid, skippedParents);
+    // Start with the resolved parent (through non-message records),
+    // then walk through any skipped messages
+    const parentMessageRef = rec.uuid
+      ? resolveParent(resolvedParents.get(rec.uuid), skippedParents)
+      : undefined;
+    const rawJson = JSON.stringify(rec);
 
     if (rec.type === "user" && rec.message) {
       // Skip tool-result-only user messages (they're just tool responses)
@@ -298,13 +423,14 @@ function transformConversation(
           sourceRef,
           timestamp,
           parentMessageRef,
+          rawJson,
           content: text,
         });
       }
     } else if (rec.type === "assistant" && rec.message) {
       const text = extractText(rec.message.content);
       const thinking = extractThinking(rec.message.content);
-      const toolCalls = extractToolCalls(rec.message.content);
+      const toolCalls = extractToolCalls(rec.message.content, allToolResults);
 
       // Add assistant message if there's text or thinking
       if (text.trim() || thinking) {
@@ -313,6 +439,7 @@ function transformConversation(
           sourceRef,
           timestamp,
           parentMessageRef,
+          rawJson,
           content: text,
           thinking,
         });
@@ -325,6 +452,7 @@ function transformConversation(
           sourceRef,
           timestamp,
           parentMessageRef,
+          rawJson,
           calls: toolCalls,
         });
       }
@@ -336,18 +464,42 @@ function transformConversation(
           sourceRef,
           timestamp,
           parentMessageRef,
+          rawJson,
           content: text,
         });
       }
     }
   }
 
+  // Compute time bounds from min/max across all messages (not array order,
+  // which is BFS traversal order and may not be chronological for branches)
+  let minTime = Infinity;
+  let maxTime = -Infinity;
+  for (const msg of messages) {
+    const t = new Date(msg.timestamp).getTime();
+    if (t < minTime) minTime = t;
+    if (t > maxTime) maxTime = t;
+  }
+  const now = new Date().toISOString();
+  const startTime = Number.isFinite(minTime)
+    ? new Date(minTime).toISOString()
+    : now;
+  const endTime = Number.isFinite(maxTime)
+    ? new Date(maxTime).toISOString()
+    : startTime;
+
   return {
     source: {
       file: sourcePath,
       adapter: "claude-code",
     },
-    metadata: { warnings },
+    metadata: {
+      warnings,
+      messageCount: messages.length,
+      startTime,
+      endTime,
+      cwd,
+    },
     messages,
   };
 }
@@ -435,14 +587,21 @@ export const claudeCodeAdapter: Adapter = {
 
   parse(content: string, sourcePath: string): Transcript[] {
     const { records, warnings } = parseJsonl(content);
-    const conversations = splitConversations(records);
+    const { conversations, resolvedParents } = splitConversations(records);
 
     if (conversations.length === 0) {
       // Return single empty transcript with warnings
+      const now = new Date().toISOString();
       return [
         {
           source: { file: sourcePath, adapter: "claude-code" },
-          metadata: { warnings },
+          metadata: {
+            warnings,
+            messageCount: 0,
+            startTime: now,
+            endTime: now,
+            cwd: undefined,
+          },
           messages: [],
         },
       ];
@@ -450,12 +609,24 @@ export const claudeCodeAdapter: Adapter = {
 
     // For single conversation, include all warnings
     if (conversations.length === 1) {
-      return [transformConversation(conversations[0], sourcePath, warnings)];
+      return [
+        transformConversation(
+          conversations[0],
+          sourcePath,
+          warnings,
+          resolvedParents,
+        ),
+      ];
     }
 
     // For multiple conversations, only first gets warnings
     return conversations.map((conv, i) =>
-      transformConversation(conv, sourcePath, i === 0 ? warnings : []),
+      transformConversation(
+        conv,
+        sourcePath,
+        i === 0 ? warnings : [],
+        resolvedParents,
+      ),
     );
   },
 };