@arcreflex/agent-transcripts 0.1.14 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcreflex/agent-transcripts",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Transform AI coding agent session files into readable transcripts",
   "type": "module",
   "repository": {

package/src/archive.ts

@@ -10,6 +10,7 @@ import { homedir } from "os";
 import { mkdir, readdir, rename, unlink } from "fs/promises";
 import type { Adapter, DiscoveredSession, Transcript } from "./types.ts";
 import { extractSessionId } from "./utils/naming.ts";
+import { renderTranscript } from "./render.ts";
 
 export const DEFAULT_ARCHIVE_DIR = join(
   process.env.XDG_DATA_HOME || join(homedir(), ".local/share"),
@@ -119,6 +120,35 @@ export async function saveEntry(
   }
 }
 
+function renderEntryMarkdown(entry: ArchiveEntry): string {
+  return entry.transcripts
+    .map((t, i) =>
+      renderTranscript(t, {
+        sourcePath: i === 0 ? entry.sourcePath : undefined,
+      }),
+    )
+    .join("\n\n---\n\n");
+}
+
+async function saveMarkdown(
+  archiveDir: string,
+  entry: ArchiveEntry,
+): Promise<void> {
+  const filePath = join(archiveDir, `${entry.sessionId}.md`);
+  const tmpPath = `${filePath}.${process.pid}.${Date.now()}.tmp`;
+  const content = renderEntryMarkdown(entry);
+
+  await Bun.write(tmpPath, content);
+  try {
+    await rename(tmpPath, filePath);
+  } catch (err) {
+    try {
+      await unlink(tmpPath);
+    } catch {}
+    throw err;
+  }
+}
+
 export function isFresh(
   entry: ArchiveEntry,
   sourceHash: string,
@@ -146,8 +176,16 @@ export async function archiveSession(
     if (session.summary && existing.title !== session.summary) {
       existing.title = session.summary;
       await saveEntry(archiveDir, existing);
+      await saveMarkdown(archiveDir, existing);
       return { entry: existing, updated: true };
     }
+
+    // Backfill .md if missing (upgrade path for pre-markdown archives)
+    const mdPath = join(archiveDir, `${sessionId}.md`);
+    if (!(await Bun.file(mdPath).exists())) {
+      await saveMarkdown(archiveDir, existing);
+    }
+
     return { entry: existing, updated: false };
   }
 
@@ -166,6 +204,7 @@ export async function archiveSession(
   };
 
   await saveEntry(archiveDir, entry);
+  await saveMarkdown(archiveDir, entry);
   return { entry, updated: true };
 }
 

package/test/archive.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it, beforeEach, afterEach } from "bun:test";
 import { join } from "path";
-import { mkdtemp, rm } from "fs/promises";
+import { mkdtemp, readdir, rm, unlink } from "fs/promises";
 import { tmpdir } from "os";
 import {
   archiveSession,
@@ -176,6 +176,49 @@ describe("archiveSession", () => {
     expect(loaded?.title).toBe("New harness title");
   });
 
+  it("writes .md alongside .json", async () => {
+    const fixturePath = join(fixturesDir, "basic-conversation.input.jsonl");
+    const session = {
+      path: fixturePath,
+      relativePath: "basic-conversation.input.jsonl",
+      mtime: Date.now(),
+    };
+
+    const { entry } = await archiveSession(tmpDir, session, claudeCodeAdapter);
+
+    const mdPath = join(tmpDir, `${entry.sessionId}.md`);
+    const md = await Bun.file(mdPath).text();
+    expect(md).toContain("# Transcript");
+    expect(md).toContain(fixturePath);
+  });
+
+  it("backfills .md when json is fresh but .md is missing", async () => {
+    const fixturePath = join(fixturesDir, "basic-conversation.input.jsonl");
+    const session = {
+      path: fixturePath,
+      relativePath: "basic-conversation.input.jsonl",
+      mtime: Date.now(),
+    };
+
+    // Archive once (creates both .json and .md)
+    const { entry } = await archiveSession(tmpDir, session, claudeCodeAdapter);
+
+    // Delete the .md to simulate a pre-markdown archive
+    const mdPath = join(tmpDir, `${entry.sessionId}.md`);
+    await unlink(mdPath);
+
+    // Re-archive — json is fresh, but .md should be backfilled
+    const { updated } = await archiveSession(
+      tmpDir,
+      session,
+      claudeCodeAdapter,
+    );
+    expect(updated).toBe(false);
+
+    const md = await Bun.file(mdPath).text();
+    expect(md).toContain("# Transcript");
+  });
+
   it("preserves existing title when re-archiving", async () => {
     const fixturePath = join(fixturesDir, "basic-conversation.input.jsonl");
     const session = {