elepha 0.1.0

package/dist/storage/session-fields-backfill.js

@@ -0,0 +1,196 @@
+// Backfill: re-derives surface/git_branch/kind/trailing_branch/
+// trailing_files (sessions) and has_external_content (memories) for rows
+// that predate capture-at-ingestion, from transcripts
+// still on disk. Structural only - re-walks each session's file through its
+// adapter's parseTurns(), which never calls a SummarizationProvider. This is
+// NOT `elepha reingest`: no model call, no decisions/pending_items rewrite.
+//
+// Destructive-operation shape: preview (the list, not a
+// count) -> --apply gate -> DB backup -> single transaction -> re-verify.
+// A session whose source_path is outside its provider store, no longer exists,
+// or exists but cannot actually be read (corrupted, permission-denied, deleted
+// in a race after the readability check, a path pointing at a directory, ...), keeps every
+// new field NULL - never a manufactured value. Both cases collapse into the
+// same `transcriptMissing: true` outcome: the caller-facing behavior (NULL,
+// shown in preview, exempted from the CLI verify check) is identical either
+// way, and distinguishing "absent" from "present but unreadable" for
+// reporting isn't worth the extra surface.
+import { claudeCodeSurface, codexSurface, toSessionRowKind } from '../adapters/discriminators.js';
+import { TRAILING_FILES_CAP } from '../config/constants.js';
+import { dedupePaths, isReadableProviderSource } from '../config/paths.js';
+import { applyBackfill, planBackfill } from './backfill-runner.js';
+/** The NULL-preserving result: reused for both "doesn't exist" and "exists but couldn't actually be read". */
+function unreadableResult(session) {
+    return {
+        transcriptMissing: true,
+        turns: [],
+        after: {
+            surface: session.surface,
+            git_branch: session.git_branch,
+            kind: session.kind,
+            trailing_branch: session.trailing_branch,
+            trailing_files: session.trailing_files,
+        },
+    };
+}
+async function deriveForSession(session, adapter) {
+    if (!isReadableProviderSource(session.tool, session.source_path)) {
+        return unreadableResult(session);
+    }
+    // The guarded file exists, but "exists" is not "readable":
+    // classifySession/parseTurns can still throw - EISDIR (source_path points
+    // at a directory), EACCES (permission denied), or a delete-after-exists
+    // race. base.ts's parseTurns opens the file with `fs.promises.open`
+    // outside any try/catch, so that throw is uncaught and would otherwise
+    // propagate out of this async generator loop, out of buildPlan's
+    // per-session loop, and abort the entire plan/apply run for every other
+    // session in the batch - not just this one. Treat it exactly like a
+    // missing file: NULL-preserving, reported, never a manufactured value.
+    let classification;
+    const turns = [];
+    try {
+        classification = await adapter.classifySession(session.source_path);
+        for await (const turn of adapter.parseTurns(session.source_path, undefined, { closeTrailingOnIdle: true })) {
+            turns.push(turn);
+        }
+    }
+    catch {
+        return unreadableResult(session);
+    }
+    const kind = toSessionRowKind(classification.kind);
+    const firstWithSurface = turns.find((t) => t.surface !== undefined);
+    const firstWithBranch = turns.find((t) => t.gitBranch !== undefined);
+    const lastWithBranch = [...turns].reverse().find((t) => t.gitBranch !== undefined);
+    const rawSurface = firstWithSurface?.surface;
+    const surface = session.tool === 'claude-code' ? claudeCodeSurface(rawSurface) : codexSurface(rawSurface);
+    // trailing_files: most-recent-first across the re-parsed turns, same cap
+    // and dedupe as the live updateTrailingState path (MemoryStore.recordTurn).
+    const filesNewestFirst = [...turns].reverse().flatMap((t) => t.toolCalls.flatMap((c) => c.filePaths));
+    const trailingFiles = dedupePaths(filesNewestFirst).slice(0, TRAILING_FILES_CAP);
+    return {
+        transcriptMissing: false,
+        turns,
+        after: {
+            surface,
+            git_branch: firstWithBranch?.gitBranch ?? null,
+            kind,
+            trailing_branch: lastWithBranch?.gitBranch ?? null,
+            trailing_files: JSON.stringify(trailingFiles),
+        },
+    };
+}
+const deriver = {
+    load(db) {
+        return {
+            sessions: db
+                .prepare('SELECT id, tool, native_id, source_path, surface, git_branch, kind, trailing_branch, trailing_files FROM sessions')
+                .all(),
+            state: undefined,
+        };
+    },
+    async derive({ db, adapters, session }) {
+        const { after, turns, transcriptMissing } = await deriveForSession(session, adapters[session.tool]);
+        const before = {
+            surface: session.surface,
+            git_branch: session.git_branch,
+            kind: session.kind,
+            trailing_branch: session.trailing_branch,
+            trailing_files: session.trailing_files,
+        };
+        let memoryFlagsChanged = 0;
+        if (!transcriptMissing) {
+            const existingMemories = db
+                .prepare('SELECT turn_index, has_external_content FROM memories WHERE session_id = ?')
+                .all(session.id);
+            const byIndex = new Map(existingMemories.map((memory) => [memory.turn_index, memory.has_external_content]));
+            for (const turn of turns) {
+                const want = turn.hasExternalContent ? 1 : 0;
+                const have = byIndex.get(turn.turnIndex);
+                if (have !== undefined && have !== want) {
+                    memoryFlagsChanged++;
+                }
+            }
+        }
+        // transcriptMissing sessions are always reported, even though `after`
+        // mirrors `before` verbatim (there's nothing to derive without the
+        // file) - the operator needs visibility into "this session can never
+        // be backfilled from disk" as distinct from "nothing to do here".
+        // deriveForSession's NULL-preserving branch is what keeps the actual
+        // apply() a no-op for these rows; this only affects what gets listed.
+        const changed = before.surface !== after.surface ||
+            before.git_branch !== after.git_branch ||
+            before.kind !== after.kind ||
+            before.trailing_branch !== after.trailing_branch ||
+            before.trailing_files !== after.trailing_files ||
+            memoryFlagsChanged > 0 ||
+            transcriptMissing;
+        if (!changed) {
+            return undefined;
+        }
+        return {
+            sessionId: session.id,
+            nativeId: session.native_id,
+            tool: session.tool,
+            sourcePath: session.source_path,
+            transcriptMissing,
+            before,
+            after,
+            memoryFlagsChanged,
+        };
+    },
+    shouldWrite: () => true,
+    write(db, change) {
+        db.prepare('UPDATE sessions SET surface = ?, git_branch = ?, kind = ?, trailing_branch = ?, trailing_files = ? WHERE id = ?').run(change.after.surface, change.after.git_branch, change.after.kind, change.after.trailing_branch, change.after.trailing_files, change.sessionId);
+        return {};
+    },
+    async afterApply({ db, adapters, plan }) {
+        // has_external_content flips need the actual per-turn values, not just a
+        // count - re-derive per changed session inside its own pass rather than
+        // carrying every ParsedTurn through the plan object (memory footprint on
+        // a large corpus). Still one DB transaction per session's memory rows.
+        for (const change of plan.changes) {
+            if (change.memoryFlagsChanged === 0 || change.transcriptMissing) {
+                continue;
+            }
+            const session = db
+                .prepare('SELECT id, tool, native_id, source_path FROM sessions WHERE id = ?')
+                .get(change.sessionId);
+            const adapter = adapters[session.tool];
+            const updateFlag = db.prepare('UPDATE memories SET has_external_content = ? WHERE session_id = ? AND turn_index = ?');
+            const writeFlags = db.transaction((turns) => {
+                for (const turn of turns) {
+                    updateFlag.run(turn.hasExternalContent ? 1 : 0, change.sessionId, turn.turnIndex);
+                }
+            });
+            // Same failure mode as deriveForSession's parseTurns call - a file
+            // that became unreadable between phase 1 (buildPlan, above) and this
+            // second pass (a delete/permission race, or a directory path) must
+            // not abort the rest of the batch. The sessions-table fields for this
+            // session were already written by apply() above; skipping just this
+            // session's has_external_content flips leaves them stale rather than
+            // manufacturing anything.
+            const turns = [];
+            if (!isReadableProviderSource(session.tool, session.source_path)) {
+                continue;
+            }
+            try {
+                for await (const turn of adapter.parseTurns(session.source_path, undefined, { closeTrailingOnIdle: true })) {
+                    turns.push(turn);
+                }
+            }
+            catch {
+                continue;
+            }
+            writeFlags(turns);
+        }
+    },
+};
+/** What the backfill would change, without changing anything. */
+export async function planSessionFieldsBackfill(db, adapters) {
+    return planBackfill(db, adapters, deriver);
+}
+/** Applies the plan in a single transaction. Re-derives turns a second time inside the transaction closure is avoided by computing the plan first, then writing it - matches planPurge/applyPurge's shape. */
+export async function applySessionFieldsBackfill(db, adapters) {
+    return applyBackfill(db, adapters, deriver);
+}
+//# sourceMappingURL=session-fields-backfill.js.map

package/dist/storage/session-fields-backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-fields-backfill.js","sourceRoot":"","sources":["../../src/storage/session-fields-backfill.ts"],"names":[],"mappings":"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"}

package/dist/storage/session-read-model.js

@@ -0,0 +1,130 @@
+// Canonical hydrated read model for served sessions. SQL storage details stay
+// here so serving consumers share one shape instead of re-declaring row types.
+const warnedDegradedFields = new WeakMap();
+export function safeStringArray(value, onDropped) {
+    try {
+        const parsed = JSON.parse(value);
+        if (!Array.isArray(parsed)) {
+            onDropped?.();
+            return [];
+        }
+        const strings = parsed.filter((item) => typeof item === 'string');
+        if (strings.length !== parsed.length) {
+            onDropped?.();
+        }
+        return strings;
+    }
+    catch {
+        onDropped?.();
+        return [];
+    }
+}
+function warnDegradedField(db, sessionId, column) {
+    let warned = warnedDegradedFields.get(db);
+    if (warned === undefined) {
+        warned = new Set();
+        warnedDegradedFields.set(db, warned);
+    }
+    const key = `${sessionId}:${column}`;
+    if (warned.has(key)) {
+        return;
+    }
+    warned.add(key);
+    console.warn(`[elepha] degraded session read: session ${sessionId} ${column} contained invalid data; dropped invalid values`);
+}
+function hydrateServedSession(db, row) {
+    return {
+        ...row,
+        trailing_files: safeStringArray(row.trailing_files, () => warnDegradedField(db, row.id, 'trailing_files')),
+    };
+}
+export function jsonArrayLength(value) {
+    if (value === null) {
+        return null;
+    }
+    try {
+        const decoded = JSON.parse(value);
+        return Array.isArray(decoded) ? decoded.length : 0;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Canonical read-time substantive predicate. A rollup with decisions
+ * or files is substantive; otherwise stored capture is substantive from two
+ * turns onward or when a turn touched files.
+ */
+export function isSubstantive(session) {
+    if (session.rollup_state !== null) {
+        return (jsonArrayLength(session.rollup_decisions) ?? 0) > 0 || session.has_files_touched === 1;
+    }
+    return session.turn_count >= 2 || session.has_files_touched === 1;
+}
+// One SELECT shared by every served-session reader: a narrow lookup that
+// diverged from the project query would silently split the canonical shape.
+const SERVED_SESSION_SELECT = `SELECT s.*, r.title AS rollup_title, r.summary AS rollup_summary, r.decisions AS rollup_decisions,
+        r.pending_items AS rollup_pending_items, r.files_touched AS rollup_files_touched, r.rollup_state,
+        COUNT(m.id) AS turn_count, MAX(CASE WHEN m.files_touched <> '[]' THEN 1 ELSE 0 END) AS has_files_touched,
+        MAX(CASE WHEN m.has_external_content = 1 THEN 1 ELSE 0 END) AS has_external_content
+ FROM sessions s LEFT JOIN session_rollups r ON r.session_id = s.id LEFT JOIN memories m ON m.session_id = s.id`;
+/** The single project-session query used by serving readers, newest activity first. */
+export function readProjectSessions(db, projectIds) {
+    const placeholders = projectIds.map(() => '?').join(',');
+    const rows = db
+        .prepare(`${SERVED_SESSION_SELECT}
+             WHERE s.project_id IN (${placeholders}) GROUP BY s.id
+             ORDER BY COALESCE(s.last_turn_at, s.last_ingested_at, s.started_at) DESC, s.id DESC`)
+        .all(...projectIds);
+    return rows.map((row) => hydrateServedSession(db, row));
+}
+/** One grouped read for list-project aggregate inputs, ordered like the canonical session list. */
+export function readProjectSessionAggregates(db, projectIds) {
+    if (projectIds.length === 0) {
+        return [];
+    }
+    const placeholders = projectIds.map(() => '?').join(',');
+    const rows = db
+        .prepare(`WITH ranked AS (
+                 SELECT s.project_id, s.tool, s.surface, s.last_ingested_at,
+                        COALESCE(s.last_turn_at, s.last_ingested_at, s.started_at) AS activity, s.id,
+                        ROW_NUMBER() OVER (
+                            PARTITION BY s.project_id, s.tool, s.surface
+                            ORDER BY COALESCE(s.last_turn_at, s.last_ingested_at, s.started_at) DESC, s.id DESC
+                        ) AS activity_rank
+                 FROM sessions s
+                 WHERE s.project_id IN (${placeholders})
+             )
+             SELECT project_id, tool, surface, MAX(last_ingested_at) AS last_ingested_at,
+                    COUNT(*) AS work_episodes,
+                    MAX(CASE WHEN activity_rank = 1 THEN activity END) AS newest_activity,
+                    MAX(CASE WHEN activity_rank = 1 THEN id END) AS newest_id
+             FROM ranked
+             GROUP BY project_id, tool, surface
+             ORDER BY newest_activity DESC, newest_id DESC`)
+        .all(...projectIds);
+    return rows.map(({ project_id, tool, surface, last_ingested_at, work_episodes }) => ({
+        project_id,
+        tool,
+        surface,
+        last_ingested_at,
+        work_episodes,
+    }));
+}
+/** Indexed session-id lookup sharing the exact hydrated shape used by project reads. */
+export function readSessionById(db, id) {
+    const row = db.prepare(`${SERVED_SESSION_SELECT} WHERE s.id = ? GROUP BY s.id`).get(id);
+    return row === undefined ? undefined : hydrateServedSession(db, row);
+}
+/**
+ * Indexed lookup on sessions.UNIQUE(tool, native_id, segment_index), for
+ * callers that need exactly one session. Consent-independent by design; the
+ * caller owns any consent gate.
+ */
+export function readSessionByNaturalKey(db, key) {
+    const row = db
+        .prepare(`${SERVED_SESSION_SELECT} WHERE s.tool = ? AND s.native_id = ? AND s.segment_index = ? GROUP BY s.id`)
+        .get(key.tool, key.nativeId, key.segmentIndex);
+    return row === undefined ? undefined : hydrateServedSession(db, row);
+}
+//# sourceMappingURL=session-read-model.js.map

package/dist/storage/session-read-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-read-model.js","sourceRoot":"","sources":["../../src/storage/session-read-model.ts"],"names":[],"mappings":"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"}

package/dist/storage/session-store.js

@@ -0,0 +1,200 @@
+import { TRAILING_FILES_CAP } from '../config/constants.js';
+import { dedupePaths } from '../config/paths.js';
+import { gitRevListCountHead } from '../security/subprocess-allowlist.js';
+import { titleForTurn } from './session-title.js';
+/**
+ * `trailing_files` is stored as JSON text in SQLite but exposed as
+ * `string[]` on SessionRow, matching how MemoryRow.decisions/files_touched
+ * already hydrate JSON columns (see listMemoriesForSession). Every read path
+ * for SessionRow must route through this.
+ */
+export function hydrateSessionRow(raw) {
+    return {
+        ...raw,
+        trailing_files: typeof raw.trailing_files === 'string' ? JSON.parse(raw.trailing_files) : [],
+    };
+}
+/** Recent-files window kept on sessions.trailing_files: boundary evaluation needs "recent enough to signal overlap", not full history. */
+export class SessionStore {
+    db;
+    getProjectById;
+    resolveGitCommitCount;
+    stmts;
+    constructor(db, getProjectById, resolveGitCommitCount = gitRevListCountHead) {
+        this.db = db;
+        this.getProjectById = getProjectById;
+        this.resolveGitCommitCount = resolveGitCommitCount;
+        this.stmts = {
+            findSession: db.prepare('SELECT * FROM sessions WHERE tool = ? AND native_id = ? ORDER BY segment_index DESC LIMIT 1'),
+            findSessionSegment: db.prepare('SELECT * FROM sessions WHERE tool = ? AND native_id = ? AND segment_index = ?'),
+            insertSession: db.prepare(`INSERT INTO sessions (tool, native_id, segment_index, project_id, source_path, cursor, started_at, last_ingested_at, surface, git_branch, kind, last_turn_at, trailing_branch, trailing_files, title, custom_title, git_commit_count)
+         VALUES (@tool, @native_id, @segment_index, @project_id, @source_path, NULL, @now, @now, @surface, @git_branch, @kind, NULL, NULL, '[]', NULL, @custom_title, @git_commit_count)`),
+            updateSessionCursor: db.prepare('UPDATE sessions SET cursor = ?, last_ingested_at = ? WHERE id = ?'),
+            listSessionsWithMemoriesSince: db.prepare(`SELECT DISTINCT s.* FROM sessions s
+         JOIN memories m ON m.session_id = s.id
+         WHERE m.turn_started_at >= ?`),
+        };
+    }
+    upsertSession(tool, nativeId, projectId, sourcePath, meta, gitCommitCount) {
+        const existing = this.stmts.findSession.get(tool, nativeId);
+        if (existing) {
+            if (meta?.customTitle !== undefined) {
+                this.updateCustomTitle(tool, nativeId, meta.customTitle);
+                return { ...hydrateSessionRow(existing), custom_title: meta.customTitle };
+            }
+            return hydrateSessionRow(existing);
+        }
+        const now = new Date().toISOString();
+        const project = this.getProjectById(projectId);
+        const info = this.stmts.insertSession.run({
+            tool,
+            native_id: nativeId,
+            project_id: projectId,
+            source_path: sourcePath,
+            segment_index: 0,
+            now,
+            surface: meta?.surface ?? null,
+            git_branch: meta?.gitBranch ?? null,
+            kind: meta?.kind ?? null,
+            custom_title: meta?.customTitle ?? null,
+            git_commit_count: gitCommitCount !== undefined
+                ? gitCommitCount
+                : project === undefined
+                    ? null
+                    : this.resolveGitCommitCount(project.git_root ?? project.path),
+        });
+        return hydrateSessionRow(this.db.prepare('SELECT * FROM sessions WHERE id = ?').get(info.lastInsertRowid));
+    }
+    findSession(tool, nativeId) {
+        const row = this.stmts.findSession.get(tool, nativeId);
+        return row ? hydrateSessionRow(row) : undefined;
+    }
+    /** User-set custom titles remain native-transcript metadata; list_sessions uses the per-segment title field. */
+    updateCustomTitle(tool, nativeId, customTitle) {
+        this.db.prepare('UPDATE sessions SET custom_title = ? WHERE tool = ? AND native_id = ?').run(customTitle, tool, nativeId);
+    }
+    /**
+     * Opens the segment immediately after `previous`. Its trailing window and
+     * cursor start empty by construction; recordTurn() fills them only after
+     * the resuming turn has actually been stored. The exact-index lookup makes
+     * this safe if an already-decided cut is retried after a partial failure.
+     */
+    startNextSegment(previous, projectId, sourcePath, meta, gitCommitCount) {
+        const segmentIndex = previous.segment_index + 1;
+        const existing = this.stmts.findSessionSegment.get(previous.tool, previous.native_id, segmentIndex);
+        if (existing) {
+            return hydrateSessionRow(existing);
+        }
+        const now = new Date().toISOString();
+        const project = this.getProjectById(projectId);
+        const info = this.stmts.insertSession.run({
+            tool: previous.tool,
+            native_id: previous.native_id,
+            segment_index: segmentIndex,
+            project_id: projectId,
+            source_path: sourcePath,
+            now,
+            surface: meta?.surface ?? null,
+            git_branch: meta?.gitBranch ?? null,
+            kind: meta?.kind ?? null,
+            custom_title: meta?.customTitle ?? previous.custom_title,
+            git_commit_count: gitCommitCount !== undefined
+                ? gitCommitCount
+                : project === undefined
+                    ? null
+                    : this.resolveGitCommitCount(project.git_root ?? project.path),
+        });
+        return hydrateSessionRow(this.db.prepare('SELECT * FROM sessions WHERE id = ?').get(info.lastInsertRowid));
+    }
+    gitCommitCount(projectPath) {
+        return this.resolveGitCommitCount(projectPath);
+    }
+    /**
+     * Sessions whose rollup is missing or was written by an older
+     * `rollup_version` - the `elepha rollup --rebuild` target set.
+     *
+     * Distinct from listOpenSessions() on purpose: that one deliberately skips
+     * `final` rollups, which is right for the idle-close sweep and wrong for a
+     * version bump. A rebuild that silently cannot reach finalized rollups
+     * would rebuild the 14 rollups nobody cared about and leave the 62 that
+     * matter untouched, while reporting success.
+     */
+    listSessionsForRollupRebuild(currentVersion) {
+        return this.db
+            .prepare(`SELECT s.* FROM sessions s
+         LEFT JOIN session_rollups r ON r.session_id = s.id
+         WHERE r.session_id IS NULL OR r.rollup_version <> ?
+         ORDER BY s.id`)
+            .all(currentVersion)
+            .map((row) => hydrateSessionRow(row));
+    }
+    /** Sessions with no rollup yet, or whose rollup is still 'live' - the idle-close sweep candidates. */
+    listOpenSessions() {
+        return this.db
+            .prepare(`SELECT s.* FROM sessions s
+         LEFT JOIN session_rollups r ON r.session_id = s.id
+         WHERE r.session_id IS NULL OR r.rollup_state = 'live'`)
+            .all()
+            .map((row) => hydrateSessionRow(row));
+    }
+    getSessionCursor(tool, nativeId) {
+        const row = this.stmts.findSession.get(tool, nativeId);
+        return row ? (hydrateSessionRow(row).cursor ?? undefined) : undefined;
+    }
+    /** Advances an already-known session after a deliberately dropped turn. */
+    advanceSessionCursor(sessionDbId, cursor) {
+        this.advanceSessionCursorAt(sessionDbId, cursor, new Date().toISOString());
+    }
+    advanceSessionCursorAt(sessionDbId, cursor, now) {
+        this.stmts.updateSessionCursor.run(cursor, now, sessionDbId);
+    }
+    /** Quote-back runs before project/session persistence, so it can only advance an existing session. */
+    advanceExistingSessionCursor(tool, nativeId, cursor) {
+        const session = this.findSession(tool, nativeId);
+        if (!session) {
+            return false;
+        }
+        this.advanceSessionCursor(session.id, cursor);
+        return true;
+    }
+    /** Writes a sanitized title in the same transaction as the turn that establishes it. */
+    updateSessionTitle(sessionDbId, turn) {
+        const row = this.db.prepare('SELECT title, segment_index FROM sessions WHERE id = ?').get(sessionDbId);
+        if (!row) {
+            return;
+        }
+        const title = titleForTurn(row.title, turn, row.segment_index === 0);
+        if (title !== row.title) {
+            this.db.prepare('UPDATE sessions SET title = ? WHERE id = ?').run(title, sessionDbId);
+        }
+    }
+    /**
+     * Denormalized "recent state" on the session row, refreshed on every
+     * turn close: this exists
+     * so boundary evaluation is one row read per closed turn, not a query
+     * into turn history on a 200-turn rollout. trailing_branch is the raw
+     * per-turn value (drifts freely, unlike sessions.git_branch which is the
+     * creation-time anchor); trailing_files is capped, most-recent-first,
+     * case-insensitively deduped the same way memories.files_touched already is.
+     * last_turn_at is the prior-close timestamp used for the next gap test;
+     * unlike last_ingested_at it is transcript time, not daemon wall time.
+     */
+    updateTrailingState(sessionDbId, turn) {
+        const current = this.db.prepare('SELECT trailing_branch, trailing_files FROM sessions WHERE id = ?').get(sessionDbId);
+        if (!current) {
+            return;
+        }
+        const newBranch = turn.gitBranch ?? current.trailing_branch;
+        const existingFiles = JSON.parse(current.trailing_files);
+        const turnFiles = turn.toolCalls.flatMap((c) => c.filePaths);
+        const merged = dedupePaths([...turnFiles, ...existingFiles]).slice(0, TRAILING_FILES_CAP);
+        this.db
+            .prepare('UPDATE sessions SET last_turn_at = ?, trailing_branch = ?, trailing_files = ? WHERE id = ?')
+            .run(turn.endedAt, newBranch, JSON.stringify(merged), sessionDbId);
+    }
+    /** Sessions with at least one memory row in [sinceIso, now) - the reingest target set. Returned rows carry source_path + tool so the caller can re-walk each file with the right adapter. */
+    listSessionsWithMemoriesSince(sinceIso) {
+        return this.stmts.listSessionsWithMemoriesSince.all(sinceIso).map((row) => hydrateSessionRow(row));
+    }
+}
+//# sourceMappingURL=session-store.js.map

package/dist/storage/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/storage/session-store.ts"],"names":[],"mappings":"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"}

package/dist/storage/session-title-backfill.js

@@ -0,0 +1,75 @@
+// Re-derives the stored list_sessions title for every existing segment from
+// its already-persisted turn indexes. This never changes segment boundaries,
+// memories, rollups, rendered statistics, or custom-title metadata.
+import { isReadableProviderSource } from '../config/paths.js';
+import { applyBackfill, planBackfill } from './backfill-runner.js';
+import { titleForSegment } from './session-title.js';
+async function turnsForSession(db, session, adapter) {
+    if (!isReadableProviderSource(session.tool, session.source_path)) {
+        return undefined;
+    }
+    const indexes = new Set(db.prepare('SELECT turn_index FROM memories WHERE session_id = ? ORDER BY turn_index').all(session.id).map((row) => row.turn_index));
+    const turns = [];
+    try {
+        for await (const turn of adapter.parseTurns(session.source_path, undefined, { closeTrailingOnIdle: true })) {
+            if (indexes.has(turn.turnIndex)) {
+                turns.push(turn);
+            }
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return turns;
+}
+const deriver = {
+    load(db) {
+        return {
+            sessions: db
+                .prepare('SELECT id, tool, native_id, source_path, segment_index, title FROM sessions ORDER BY id')
+                .all(),
+            state: undefined,
+        };
+    },
+    async derive({ db, adapters, session }) {
+        const turns = await turnsForSession(db, session, adapters[session.tool]);
+        if (turns === undefined) {
+            return {
+                sessionId: session.id,
+                nativeId: session.native_id,
+                tool: session.tool,
+                sourcePath: session.source_path,
+                before: session.title,
+                after: session.title,
+                transcriptMissing: true,
+            };
+        }
+        const after = titleForSegment(turns, session.segment_index === 0);
+        if (session.title === after) {
+            return undefined;
+        }
+        return {
+            sessionId: session.id,
+            nativeId: session.native_id,
+            tool: session.tool,
+            sourcePath: session.source_path,
+            before: session.title,
+            after,
+            transcriptMissing: false,
+        };
+    },
+    shouldWrite: (change) => !change.transcriptMissing,
+    write(db, change) {
+        db.prepare('UPDATE sessions SET title = ? WHERE id = ?').run(change.after, change.sessionId);
+        return {};
+    },
+};
+/** Shows title changes without writing. */
+export async function planSessionTitleBackfill(db, adapters) {
+    return planBackfill(db, adapters, deriver);
+}
+/** Applies only readable sessions' derived titles in one transaction. */
+export async function applySessionTitleBackfill(db, adapters) {
+    return applyBackfill(db, adapters, deriver);
+}
+//# sourceMappingURL=session-title-backfill.js.map

package/dist/storage/session-title-backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-title-backfill.js","sourceRoot":"","sources":["../../src/storage/session-title-backfill.ts"],"names":[],"mappings":"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"}