pi-mega-compact 0.11.12 → 0.11.13

package/dist/extensions/dashboard-server/dashboard-client-repos.js

@@ -63,7 +63,7 @@ function renderByModel(repos) {
   var rows = document.getElementById('bm-rows');
   if (!rows) return;
   if (!repos || !repos.length) {
-    rows.innerHTML = '<tr><td colspan="14" class="repo-none">No repositories registered yet.</td></tr>';
+    rows.innerHTML = '<tr><td colspan="16" class="repo-none">No repositories registered yet.</td></tr>';
     return;
   }
   var groups = {};
@@ -106,11 +106,35 @@ function renderByModel(repos) {
     var fmt = function(v) { return '$' + v.toFixed(6); };
     return lo === hi ? fmt(lo) : fmt(lo) + '–' + fmt(hi);
   }
+  // Helper: compute cache hit % from providerCacheRead/Write tokens
+  function cacheHitPct(cr, cw, inp) {
+    var denom = cr + cw + (inp || 0);
+    return denom > 0 ? ((cr / denom) * 100).toFixed(1) + '%' : '—';
+  }
+  // Helper: compute cache $ saved (read = 0.9 * inputRate, write = 0.25 * inputRate)
+  function cacheDollar(cr, cw, rate) {
+    if (!cr || !rate) return '—';
+    var saved = cr * rate * 0.9 - cw * rate * 0.25;
+    return '$' + saved.toFixed(4);
+  }
+  // Aggregate providerCacheRead/Write across repos in this group
+  var groupCacheRead = 0, groupCacheWrite = 0, groupTokensIn = 0;
+  for (var ii = 0; ii < repos.length; ii++) {
+    var rr = repos[ii];
+    var key2 = (rr.modelName && String(rr.modelName).trim()) || '(unknown)';
+    if (key2 === g.model) {
+      groupCacheRead += (rr.providerCacheRead || 0);
+      groupCacheWrite += (rr.providerCacheWrite || 0);
+      groupTokensIn += (rr.tokensDropped || 0);
+    }
+  }
   rows.innerHTML = arr.map(function(g) {
     var freed = (g.tokensIn || 0) - (g.tokensOut || 0);
-    var usd = g.usd > 0 ? '$' + g.usd.toFixed(4) : '—';
+    // B: always show a dollar value (including $0.0000) — do not use '—' when usd is 0
+    var usd = '$' + (g.usd || 0).toFixed(4);
     var when = g.lastAt ? new Date(g.lastAt).toLocaleString() : '—';
     var reas = g.reasoning == null ? '—' : (g.reasoning ? 'yes' : 'no');
+    var rate0 = g.inRates && g.inRates.length ? g.inRates[0] : 0;
     return '<tr>' +
       '<td><span class="repo-model">' + sanitize(g.model) + '</span></td>' +
       '<td>' + sanitize(g.provider) + '</td>' +
@@ -125,6 +149,8 @@ function renderByModel(repos) {
       '<td class="num">' + collapseRate(g.inRates) + '</td>' +
       '<td class="num">' + collapseRate(g.outRates) + '</td>' +
       '<td class="num">' + sanitize(usd) + '</td>' +
+      '<td class="num">' + cacheHitPct(groupCacheRead, groupCacheWrite, groupTokensIn) + '</td>' +
+      '<td class="num">' + cacheDollar(groupCacheRead, groupCacheWrite, rate0) + '</td>' +
       '<td class="num">' + sanitize(when) + '</td>' +
     '</tr>';
   }).join('');

package/dist/extensions/dashboard-server/index-reader.js

@@ -12,6 +12,7 @@ import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
+import { readProviderCacheForRepo, } from "../../src/store/sqlite/perf-samples.js";
 export function getIndexDir() {
     const override = process.env.MEGACOMPACT_INDEX_DIR;
     if (override && override.trim() !== "")
@@ -89,21 +90,21 @@ export function readIndex() {
                             repo.maxTokens = Number(mrow.max_tokens ?? 0) || null;
                             repo.reasoning = Number(mrow.reasoning ?? 0) === 1;
                         }
-                        // Provider prompt-cache stats (E.3)
+                        // Provider prompt-cache stats (E.3 / F4)
+                        // Use readProviderCacheForRepo which correctly reads cache token
+                        // counts from the meta JSON column (cacheRead/cacheWrite), not
+                        // from non-existent table columns cache_read/cache_write.
                         try {
-                            const pRow = sdb
-                                .prepare(`SELECT
-                    SUM(cache_read) AS totalRead,
-                    SUM(cache_write) AS totalWrite,
-                    SUM(cache_read + cache_write) * 1.0 / MAX(SUM(cache_read + cache_write + tokens_in), 1) AS hitPct
-                   FROM perf_samples
-                   WHERE cache_read > 0 OR cache_write > 0`)
-                                .get();
-                            if (pRow && pRow.totalRead > 0) {
-                                repo.providerCacheRead = Number(pRow.totalRead);
-                                repo.providerCacheWrite = Number(pRow.totalWrite);
-                                repo.providerCachePct = Number((pRow.hitPct * 100).toFixed(1));
+                            const pc = readProviderCacheForRepo(repo.stateDir);
+                            if (pc.totalCacheRead > 0) {
+                                repo.providerCacheRead = pc.totalCacheRead;
+                                repo.providerCacheWrite = pc.totalCacheWrite;
+                                repo.providerCachePct = Number(pc.avgHitPct.toFixed(1));
                             }
+                            // Also enrich contextWindow/maxTokens/reasoning from the
+                            // latest model_snapshots row (was already read above, but
+                            // when latestModelSnapshot was used above we get the same
+                            // data from the per-repo store — keep as-is).
                         }
                         catch {
                             /* best-effort — perf_samples may not exist */

package/dist/extensions/dashboard-server/routes-topics.js

@@ -7,6 +7,8 @@
  */
 import { openTurnStore } from "../../src/store/turns/connection.js";
 import { createTopicStore } from "../../src/topics/store.js";
+import { openStore } from "../../src/store/sqlite.js";
+import { buildTopicModel } from "../../src/topics/cluster.js";
 export function handleTopics(req, res, ctx) {
     const url = req.url ?? "";
     // ── GET /api/topics/:topicId/memories — wiki topic drill-down (S52) ──
@@ -42,6 +44,22 @@ export function handleTopics(req, res, ctx) {
         return false;
     try {
         const tdb = openTurnStore(ctx.stateDir);
+        // Lazy build: when the topics table is empty, attempt a one-shot build
+        // from available context_chunks embeddings so the wiki is useful even
+        // before the first compaction fires.
+        const topicCount = tdb.prepare("SELECT COUNT(*) AS c FROM topics").get().c;
+        if (topicCount === 0) {
+            try {
+                const mainDb = openStore(ctx.stateDir);
+                const model = buildTopicModel(mainDb);
+                if (model.k > 0 && model.totalChunks > 0) {
+                    createTopicStore(ctx.stateDir).replaceTopicModel(model);
+                }
+            }
+            catch {
+                /* non-fatal: lazy wiki build is best-effort */
+            }
+        }
         const topics = tdb
             .prepare(`SELECT id, label, term_scores, memory_count, last_updated
            FROM topics ORDER BY memory_count DESC, id ASC`)

package/dist/extensions/mega-events/context-handler.js

@@ -278,6 +278,11 @@ export function registerContextHandler(pi, runtime, config) {
                 // S51B: auto-categorizing wiki rebuild — every Nth compaction, derived
                 // from real context_chunks embeddings. Isolated-store only, gated on
                 // AUTO_WIKI_ENABLED; best-effort + non-fatal (never breaks compaction).
+                // Fire regardless of dbMirror — context_chunks is the isolated store.
+                // Uses the already-open db when inside the dbMirror block; opens its own
+                // connection otherwise.
+                // from real context_chunks embeddings. Isolated-store only, gated on
+                // AUTO_WIKI_ENABLED; best-effort + non-fatal (never breaks compaction).
                 try {
                     if (config.autoWikiEnabled && config.turnsDbEnabled) {
                         const every = Math.max(1, TurnsConfig.WIKI_REBUILD_EVERY_N_COMPACTS);
@@ -323,11 +328,11 @@ export function registerContextHandler(pi, runtime, config) {
                         if (chunkCount < floor) {
                             const transcriptRows = db
                                 .prepare(`SELECT DISTINCT content_bytes
-			       FROM raw_transcript
-			       WHERE session_id = ?
-			         AND length(content_bytes) > 10
-			       ORDER BY seq ASC
-			       LIMIT 200`)
+	       FROM raw_transcript
+	       WHERE session_id = ?
+	         AND length(content_bytes) > 10
+	       ORDER BY seq ASC
+	       LIMIT 200`)
                                 .all(runtime.rt.sessionId);
                             if (transcriptRows.length > 0) {
                                 const embedder = new TrigramEmbedder();

package/dist/extensions/mega-runtime/reset-runtime.js

@@ -11,7 +11,11 @@
 import { normalizeSessionId } from "../../src/store.js";
 // --------------------------------------------------------------- resetRuntime
 export function resetRuntimeImpl(self, sessionId) {
-    const sid = normalizeSessionId(sessionId);
+    // Only call normalizeSessionId when a real sessionId string is passed.
+    // When undefined, keep the existing self.rt.sessionId (set by the real
+    // session-start / compact pipeline) so the early-return guard can fire and
+    // dashboard stats keyed by sessionId are not silently orphaned.
+    const sid = sessionId ? normalizeSessionId(sessionId) : self.rt.sessionId;
     if (self.rt.sessionId === sid && self.rt.persistedThisSession)
         return; // same session, keep checkpoint memory
     self.rt = {

package/dist/src/memoryGraph/gates.js

@@ -89,7 +89,7 @@ export function gatePromotionGuard(ws) {
             continue;
         }
         const epochId = n.epochId;
-        if (epochId && checkpointIds.has(epochId)) {
+        if (epochId && checkpointIds.size > 0 && checkpointIds.has(epochId)) {
             droppedIds.add(n.id);
             dropped++;
             log.warn("graph_orphaned_epoch", {

package/dist/src/memoryGraph/sources.js

@@ -27,14 +27,22 @@ export function areMemoriesEnabled() {
 // Source: checkpoints (from context_chunks table)
 // ---------------------------------------------------------------------------
 export function buildCheckpointNodes(db, sessionId, nodes, edges) {
-    const rows = db
-        .prepare(`SELECT id, session_id, summary, token_estimate, timestamp,
-              dedup_status, topic_summary, key_decisions,
-              normalized_text, embedding_blob
-       FROM context_chunks
-       WHERE session_id = ?
-       ORDER BY timestamp ASC`)
-        .all(sessionId);
+    const rows = sessionId
+        ? db
+            .prepare(`SELECT id, session_id, summary, token_estimate, timestamp,
+                  dedup_status, topic_summary, key_decisions,
+                  normalized_text, embedding_blob
+           FROM context_chunks
+           WHERE session_id = ?
+           ORDER BY timestamp ASC`)
+            .all(sessionId)
+        : db
+            .prepare(`SELECT id, session_id, summary, token_estimate, timestamp,
+                  dedup_status, topic_summary, key_decisions,
+                  normalized_text, embedding_blob
+           FROM context_chunks
+           ORDER BY timestamp ASC`)
+            .all();
     if (rows.length === 0)
         return;
     let prevId = null;
@@ -97,13 +105,20 @@ function addCheckpointSemanticEdges(rows, edges) {
 // ---------------------------------------------------------------------------
 export function buildTurnNodes(db, sessionId, nodes, edges) {
     const existingIds = new Set(nodes.map((n) => n.id));
-    const rows = db
-        .prepare(`SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
-              epoch_id, ended_at
-       FROM turns
-       WHERE session_id = ?
-       ORDER BY turn_index ASC`)
-        .all(sessionId);
+    const rows = sessionId
+        ? db
+            .prepare(`SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
+                  epoch_id, ended_at
+           FROM turns
+           WHERE session_id = ?
+           ORDER BY turn_index ASC`)
+            .all(sessionId)
+        : db
+            .prepare(`SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
+                  epoch_id, ended_at
+           FROM turns
+           ORDER BY turn_index ASC`)
+            .all();
     if (rows.length === 0)
         return;
     let prevId = null;
@@ -146,13 +161,20 @@ export function buildTurnContentNodes(db, sessionId, nodes, edges) {
     // (identity_merge) merges them with the richest nodeType winning. Using the
     // global nodes array here would skip every node (Source A already added them).
     const seen = new Set();
-    const rows = db
-        .prepare(`SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
-       FROM turns t
-       JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
-       WHERE t.session_id = ?
-       ORDER BY t.turn_index ASC`)
-        .all(sessionId);
+    const rows = sessionId
+        ? db
+            .prepare(`SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
+           FROM turns t
+           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
+           WHERE t.session_id = ?
+           ORDER BY t.turn_index ASC`)
+            .all(sessionId)
+        : db
+            .prepare(`SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
+           FROM turns t
+           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
+           ORDER BY t.turn_index ASC`)
+            .all();
     if (rows.length === 0)
         return;
     const turnContentNodes = [];

package/dist/src/store/turns/sqlite-store.js

@@ -176,9 +176,9 @@ export class SqliteTurnStore {
         try {
             this.db
                 .prepare(`INSERT INTO turns (conversation_id, session_id, turn_index, role, ended_at,
-                                   ctx_tokens, ctx_percent, pressure_band, model)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-                .run(entry.conversationId, sid, entry.turnIndex, entry.role, entry.endedAt, entry.ctxTokens ?? null, entry.ctxPercent ?? null, entry.pressureBand ?? null, entry.model ?? null);
+                                   ctx_tokens, ctx_percent, pressure_band, model, epoch_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(entry.conversationId, sid, entry.turnIndex, entry.role, entry.endedAt, entry.ctxTokens ?? null, entry.ctxPercent ?? null, entry.pressureBand ?? null, entry.model ?? null, entry.epochId ?? null);
         }
         catch (e) {
             if (e instanceof Error &&
@@ -364,8 +364,8 @@ export class SqliteTurnStore {
     restore(from) {
         this.clear();
         const insertTurn = this.db.prepare(`INSERT INTO turns (conversation_id, session_id, turn_index, role, ended_at,
-                               ctx_tokens, ctx_percent, pressure_band, model)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`);
+                               ctx_tokens, ctx_percent, pressure_band, model, epoch_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`);
         const insertRecall = this.db.prepare(`INSERT INTO turn_recall (turn_id, checkpoint_id, score, source, raptor_level)
        VALUES (?, ?, ?, ?, ?)`);
         const insertFork = this.db.prepare(`INSERT INTO conversation_forks (parent_conversation_id, child_conversation_id, fork_turn_index, created_at)
@@ -376,7 +376,7 @@ export class SqliteTurnStore {
             const posToNewId = new Map();
             for (let i = 0; i < from.turns.length; i++) {
                 const t = from.turns[i];
-                insertTurn.run(t.conversationId, normalizeSessionId(t.sessionId), t.turnIndex, t.role, t.endedAt, t.ctxTokens ?? null, t.ctxPercent ?? null, t.pressureBand ?? null, t.model ?? null);
+                insertTurn.run(t.conversationId, normalizeSessionId(t.sessionId), t.turnIndex, t.role, t.endedAt, t.ctxTokens ?? null, t.ctxPercent ?? null, t.pressureBand ?? null, t.model ?? null, t.epochId ?? null);
                 const row = this.db
                     .prepare("SELECT id FROM turns WHERE conversation_id = ? AND turn_index = ?")
                     .get(t.conversationId, t.turnIndex);

package/extensions/dashboard-server/dashboard-client-repos.ts

@@ -64,7 +64,7 @@ function renderByModel(repos) {
   var rows = document.getElementById('bm-rows');
   if (!rows) return;
   if (!repos || !repos.length) {
-    rows.innerHTML = '<tr><td colspan="14" class="repo-none">No repositories registered yet.</td></tr>';
+    rows.innerHTML = '<tr><td colspan="16" class="repo-none">No repositories registered yet.</td></tr>';
     return;
   }
   var groups = {};
@@ -107,11 +107,35 @@ function renderByModel(repos) {
     var fmt = function(v) { return '$' + v.toFixed(6); };
     return lo === hi ? fmt(lo) : fmt(lo) + '–' + fmt(hi);
   }
+  // Helper: compute cache hit % from providerCacheRead/Write tokens
+  function cacheHitPct(cr, cw, inp) {
+    var denom = cr + cw + (inp || 0);
+    return denom > 0 ? ((cr / denom) * 100).toFixed(1) + '%' : '—';
+  }
+  // Helper: compute cache $ saved (read = 0.9 * inputRate, write = 0.25 * inputRate)
+  function cacheDollar(cr, cw, rate) {
+    if (!cr || !rate) return '—';
+    var saved = cr * rate * 0.9 - cw * rate * 0.25;
+    return '$' + saved.toFixed(4);
+  }
+  // Aggregate providerCacheRead/Write across repos in this group
+  var groupCacheRead = 0, groupCacheWrite = 0, groupTokensIn = 0;
+  for (var ii = 0; ii < repos.length; ii++) {
+    var rr = repos[ii];
+    var key2 = (rr.modelName && String(rr.modelName).trim()) || '(unknown)';
+    if (key2 === g.model) {
+      groupCacheRead += (rr.providerCacheRead || 0);
+      groupCacheWrite += (rr.providerCacheWrite || 0);
+      groupTokensIn += (rr.tokensDropped || 0);
+    }
+  }
   rows.innerHTML = arr.map(function(g) {
     var freed = (g.tokensIn || 0) - (g.tokensOut || 0);
-    var usd = g.usd > 0 ? '$' + g.usd.toFixed(4) : '—';
+    // B: always show a dollar value (including $0.0000) — do not use '—' when usd is 0
+    var usd = '$' + (g.usd || 0).toFixed(4);
     var when = g.lastAt ? new Date(g.lastAt).toLocaleString() : '—';
     var reas = g.reasoning == null ? '—' : (g.reasoning ? 'yes' : 'no');
+    var rate0 = g.inRates && g.inRates.length ? g.inRates[0] : 0;
     return '<tr>' +
       '<td><span class="repo-model">' + sanitize(g.model) + '</span></td>' +
       '<td>' + sanitize(g.provider) + '</td>' +
@@ -126,6 +150,8 @@ function renderByModel(repos) {
       '<td class="num">' + collapseRate(g.inRates) + '</td>' +
       '<td class="num">' + collapseRate(g.outRates) + '</td>' +
       '<td class="num">' + sanitize(usd) + '</td>' +
+      '<td class="num">' + cacheHitPct(groupCacheRead, groupCacheWrite, groupTokensIn) + '</td>' +
+      '<td class="num">' + cacheDollar(groupCacheRead, groupCacheWrite, rate0) + '</td>' +
       '<td class="num">' + sanitize(when) + '</td>' +
     '</tr>';
   }).join('');

package/extensions/dashboard-server/index-reader.ts

@@ -14,6 +14,9 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
 import type { IndexRepo, IndexIndex } from "./types.js";
+import {
+	readProviderCacheForRepo,
+} from "../../src/store/sqlite/perf-samples.js";
 
 export function getIndexDir(): string {
 	const override = process.env.MEGACOMPACT_INDEX_DIR;
@@ -100,25 +103,21 @@ export function readIndex(): IndexIndex | null {
 							repo.maxTokens = Number(mrow.max_tokens ?? 0) || null;
 							repo.reasoning = Number(mrow.reasoning ?? 0) === 1;
 						}
-						// Provider prompt-cache stats (E.3)
+						// Provider prompt-cache stats (E.3 / F4)
+						// Use readProviderCacheForRepo which correctly reads cache token
+						// counts from the meta JSON column (cacheRead/cacheWrite), not
+						// from non-existent table columns cache_read/cache_write.
 						try {
-							const pRow = sdb
-								.prepare(
-									`SELECT
-                    SUM(cache_read) AS totalRead,
-                    SUM(cache_write) AS totalWrite,
-                    SUM(cache_read + cache_write) * 1.0 / MAX(SUM(cache_read + cache_write + tokens_in), 1) AS hitPct
-                   FROM perf_samples
-                   WHERE cache_read > 0 OR cache_write > 0`,
-								)
-								.get() as
-								| { totalRead: number; totalWrite: number; hitPct: number }
-								| undefined;
-							if (pRow && pRow.totalRead > 0) {
-								repo.providerCacheRead = Number(pRow.totalRead);
-								repo.providerCacheWrite = Number(pRow.totalWrite);
-								repo.providerCachePct = Number((pRow.hitPct * 100).toFixed(1));
+							const pc = readProviderCacheForRepo(repo.stateDir);
+							if (pc.totalCacheRead > 0) {
+								repo.providerCacheRead = pc.totalCacheRead;
+								repo.providerCacheWrite = pc.totalCacheWrite;
+								repo.providerCachePct = Number(pc.avgHitPct.toFixed(1));
 							}
+							// Also enrich contextWindow/maxTokens/reasoning from the
+							// latest model_snapshots row (was already read above, but
+							// when latestModelSnapshot was used above we get the same
+							// data from the per-repo store — keep as-is).
 						} catch {
 							/* best-effort — perf_samples may not exist */
 						}

package/extensions/dashboard-server/routes-topics.ts

@@ -10,6 +10,8 @@ import type { IncomingMessage, ServerResponse } from "node:http";
 import type { RouteContext } from "./routes-core.js";
 import { openTurnStore } from "../../src/store/turns/connection.js";
 import { createTopicStore } from "../../src/topics/store.js";
+import { openStore } from "../../src/store/sqlite.js";
+import { buildTopicModel } from "../../src/topics/cluster.js";
 import type { TopicsResponse, TopicRow } from "./api-contracts/game-types.js";
 import type { TopicMemoriesResponse } from "./api-contracts/turns.js";
 
@@ -53,6 +55,25 @@ export function handleTopics(
 
 	try {
 		const tdb = openTurnStore(ctx.stateDir);
+
+		// Lazy build: when the topics table is empty, attempt a one-shot build
+		// from available context_chunks embeddings so the wiki is useful even
+		// before the first compaction fires.
+		const topicCount = (
+			tdb.prepare("SELECT COUNT(*) AS c FROM topics").get() as { c: number }
+		).c;
+		if (topicCount === 0) {
+			try {
+				const mainDb = openStore(ctx.stateDir);
+				const model = buildTopicModel(mainDb);
+				if (model.k > 0 && model.totalChunks > 0) {
+					createTopicStore(ctx.stateDir).replaceTopicModel(model);
+				}
+			} catch {
+				/* non-fatal: lazy wiki build is best-effort */
+			}
+		}
+
 		const topics: TopicRow[] = (
 			tdb
 				.prepare(

package/extensions/mega-events/context-handler.ts

@@ -333,120 +333,127 @@ export function registerContextHandler(
 				} catch {
 					/* non-fatal: epoch stamping never breaks compaction */
 				}
-				// S51B: auto-categorizing wiki rebuild — every Nth compaction, derived
-				// from real context_chunks embeddings. Isolated-store only, gated on
-				// AUTO_WIKI_ENABLED; best-effort + non-fatal (never breaks compaction).
-				try {
-					if (config.autoWikiEnabled && config.turnsDbEnabled) {
-						const every = Math.max(
-							1,
-							TurnsConfig.WIKI_REBUILD_EVERY_N_COMPACTS,
-						);
-						const tdb = openTurnStore(runtime.currentStateDir);
-						const n = bumpWikiCompactCounter(tdb);
-						if (n % every === 0) {
-							const model = buildTopicModel(db, {
-								kRange: [TurnsConfig.WIKI_K_MIN, TurnsConfig.WIKI_K_MAX],
-								labelTopTerms: TurnsConfig.WIKI_LABEL_TOP_TERMS,
-								restarts: 5,
-								seed: 0x9e3779b9,
+
+		// S51B: auto-categorizing wiki rebuild — every Nth compaction, derived
+		// from real context_chunks embeddings. Isolated-store only, gated on
+		// AUTO_WIKI_ENABLED; best-effort + non-fatal (never breaks compaction).
+		// Fire regardless of dbMirror — context_chunks is the isolated store.
+		// Uses the already-open db when inside the dbMirror block; opens its own
+		// connection otherwise.
+		// from real context_chunks embeddings. Isolated-store only, gated on
+		// AUTO_WIKI_ENABLED; best-effort + non-fatal (never breaks compaction).
+		try {
+			if (config.autoWikiEnabled && config.turnsDbEnabled) {
+				const every = Math.max(
+					1,
+					TurnsConfig.WIKI_REBUILD_EVERY_N_COMPACTS,
+				);
+				const tdb = openTurnStore(runtime.currentStateDir);
+				const n = bumpWikiCompactCounter(tdb);
+				if (n % every === 0) {
+					const model = buildTopicModel(db, {
+						kRange: [TurnsConfig.WIKI_K_MIN, TurnsConfig.WIKI_K_MAX],
+						labelTopTerms: TurnsConfig.WIKI_LABEL_TOP_TERMS,
+						restarts: 5,
+						seed: 0x9e3779b9,
+					});
+					createTopicStore(runtime.currentStateDir).replaceTopicModel(
+						model,
+					);
+					runtime.logger.info("wiki_rebuild", {
+						clusterCount: model.k,
+						totalChunks: model.totalChunks,
+						method: "kmeans+tfidf",
+						criterion: model.criterion,
+						silhouetteScore: model.silhouetteScore,
+						uncalibrated: false,
+					});
+				}
+			}
+		} catch (wikiErr) {
+			runtime.logger.warn("wiki_rebuild_failed", {
+				error: String(wikiErr),
+			});
+		}
+
+		// D1: seed the topic model from raw_transcript when context_chunks is
+		// thin (pre-compaction). Gated on WIKI_SEED_FROM_TURNS; non-fatal.
+		// Seeds buildTopicModel with on-the-fly trigram embeddings from
+		// recent raw_transcript rows for the current session.
+		try {
+			if (
+				config.autoWikiEnabled &&
+				config.turnsDbEnabled &&
+				TurnsConfig.WIKI_SEED_FROM_TURNS
+			) {
+				const floor = 50;
+				const countRow = db
+					.prepare(
+						`SELECT COUNT(*) AS cnt FROM context_chunks WHERE session_id = ?`,
+					)
+					.get(runtime.rt.sessionId) as { cnt: number } | undefined;
+				const chunkCount = countRow?.cnt ?? 0;
+				if (chunkCount < floor) {
+					const transcriptRows = db
+						.prepare(
+							`SELECT DISTINCT content_bytes
+	       FROM raw_transcript
+	       WHERE session_id = ?
+	         AND length(content_bytes) > 10
+	       ORDER BY seq ASC
+	       LIMIT 200`,
+						)
+						.all(runtime.rt.sessionId) as Array<{
+						content_bytes: string;
+					}>;
+					if (transcriptRows.length > 0) {
+						const embedder = new TrigramEmbedder();
+						const seedChunks: EmbeddedChunk[] = [];
+						for (let i = 0; i < transcriptRows.length; i++) {
+							const text = transcriptRows[i].content_bytes.trim();
+							if (text.length === 0) continue;
+							const vec = embedder.embed(text);
+							seedChunks.push({
+								chunkId: `seed_transcript_${i}`,
+								sessionId: runtime.rt.sessionId,
+								vec,
+								text,
 							});
-							createTopicStore(runtime.currentStateDir).replaceTopicModel(
-								model,
+						}
+						if (seedChunks.length > 0) {
+							const model = buildTopicModel(
+								db,
+								{
+									kRange: [
+										TurnsConfig.WIKI_K_MIN,
+										TurnsConfig.WIKI_K_MAX,
+									],
+									labelTopTerms:
+										TurnsConfig.WIKI_LABEL_TOP_TERMS,
+									restarts: 5,
+									seed: 0x9e3779b9,
+								},
+								seedChunks,
 							);
-							runtime.logger.info("wiki_rebuild", {
+							createTopicStore(
+								runtime.currentStateDir,
+							).replaceTopicModel(model);
+							runtime.logger.info("wiki_seed", {
 								clusterCount: model.k,
+								sourceChunks: seedChunks.length,
 								totalChunks: model.totalChunks,
 								method: "kmeans+tfidf",
-								criterion: model.criterion,
-								silhouetteScore: model.silhouetteScore,
-								uncalibrated: false,
 							});
 						}
 					}
-				} catch (wikiErr) {
-					runtime.logger.warn("wiki_rebuild_failed", {
-						error: String(wikiErr),
-					});
 				}
+			}
+		} catch (seedErr) {
+			runtime.logger.warn("wiki_seed_failed", {
+				error: String(seedErr),
+			});
+		}
 
-				// D1: seed the topic model from raw_transcript when context_chunks is
-				// thin (pre-compaction). Gated on WIKI_SEED_FROM_TURNS; non-fatal.
-				// Seeds buildTopicModel with on-the-fly trigram embeddings from
-				// recent raw_transcript rows for the current session.
-				try {
-					if (
-						config.autoWikiEnabled &&
-						config.turnsDbEnabled &&
-						TurnsConfig.WIKI_SEED_FROM_TURNS
-					) {
-						const floor = 50;
-						const countRow = db
-							.prepare(
-								`SELECT COUNT(*) AS cnt FROM context_chunks WHERE session_id = ?`,
-							)
-							.get(runtime.rt.sessionId) as { cnt: number } | undefined;
-						const chunkCount = countRow?.cnt ?? 0;
-						if (chunkCount < floor) {
-							const transcriptRows = db
-								.prepare(
-									`SELECT DISTINCT content_bytes
-			       FROM raw_transcript
-			       WHERE session_id = ?
-			         AND length(content_bytes) > 10
-			       ORDER BY seq ASC
-			       LIMIT 200`,
-								)
-								.all(runtime.rt.sessionId) as Array<{
-								content_bytes: string;
-							}>;
-							if (transcriptRows.length > 0) {
-								const embedder = new TrigramEmbedder();
-								const seedChunks: EmbeddedChunk[] = [];
-								for (let i = 0; i < transcriptRows.length; i++) {
-									const text = transcriptRows[i].content_bytes.trim();
-									if (text.length === 0) continue;
-									const vec = embedder.embed(text);
-									seedChunks.push({
-										chunkId: `seed_transcript_${i}`,
-										sessionId: runtime.rt.sessionId,
-										vec,
-										text,
-									});
-								}
-								if (seedChunks.length > 0) {
-									const model = buildTopicModel(
-										db,
-										{
-											kRange: [
-												TurnsConfig.WIKI_K_MIN,
-												TurnsConfig.WIKI_K_MAX,
-											],
-											labelTopTerms:
-												TurnsConfig.WIKI_LABEL_TOP_TERMS,
-											restarts: 5,
-											seed: 0x9e3779b9,
-										},
-										seedChunks,
-									);
-									createTopicStore(
-										runtime.currentStateDir,
-									).replaceTopicModel(model);
-									runtime.logger.info("wiki_seed", {
-										clusterCount: model.k,
-										sourceChunks: seedChunks.length,
-										totalChunks: model.totalChunks,
-										method: "kmeans+tfidf",
-									});
-								}
-							}
-						}
-					}
-				} catch (seedErr) {
-					runtime.logger.warn("wiki_seed_failed", {
-						error: String(seedErr),
-					});
-				}
 				// S27 Task 6: Fire-and-forget dedup pipeline.
 				// Deduplicates raw_transcript rows for the compacted range.
 				try {

package/extensions/mega-runtime/reset-runtime.ts

@@ -42,7 +42,11 @@ export function resetRuntimeImpl(
 	self: ResetRuntimeContext,
 	sessionId: string | undefined,
 ): void {
-	const sid = normalizeSessionId(sessionId);
+	// Only call normalizeSessionId when a real sessionId string is passed.
+	// When undefined, keep the existing self.rt.sessionId (set by the real
+	// session-start / compact pipeline) so the early-return guard can fire and
+	// dashboard stats keyed by sessionId are not silently orphaned.
+	const sid = sessionId ? normalizeSessionId(sessionId) : self.rt.sessionId;
 	if (self.rt.sessionId === sid && self.rt.persistedThisSession) return; // same session, keep checkpoint memory
 	self.rt = {
 		sessionId: sid,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.11.12",
+  "version": "0.11.13",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-3-Clause",

package/src/memoryGraph/gates.ts

@@ -112,7 +112,7 @@ export function gatePromotionGuard(ws: GraphWorkingSet): GateResult {
       continue;
     }
     const epochId = n.epochId;
-    if (epochId && checkpointIds.has(epochId)) {
+    if (epochId && checkpointIds.size > 0 && checkpointIds.has(epochId)) {
       droppedIds.add(n.id);
       dropped++;
       log.warn("graph_orphaned_epoch", {

package/src/memoryGraph/sources.ts

@@ -51,16 +51,26 @@ export function buildCheckpointNodes(
   nodes: MemoryGraphNode[],
   edges: MemoryGraphEdge[],
 ): void {
-  const rows = db
-    .prepare(
-      `SELECT id, session_id, summary, token_estimate, timestamp,
-              dedup_status, topic_summary, key_decisions,
-              normalized_text, embedding_blob
-       FROM context_chunks
-       WHERE session_id = ?
-       ORDER BY timestamp ASC`,
-    )
-    .all(sessionId) as Array<Record<string, unknown>>;
+  const rows = sessionId
+    ? (db
+        .prepare(
+          `SELECT id, session_id, summary, token_estimate, timestamp,
+                  dedup_status, topic_summary, key_decisions,
+                  normalized_text, embedding_blob
+           FROM context_chunks
+           WHERE session_id = ?
+           ORDER BY timestamp ASC`,
+        )
+        .all(sessionId) as Array<Record<string, unknown>>)
+    : (db
+        .prepare(
+          `SELECT id, session_id, summary, token_estimate, timestamp,
+                  dedup_status, topic_summary, key_decisions,
+                  normalized_text, embedding_blob
+           FROM context_chunks
+           ORDER BY timestamp ASC`,
+        )
+        .all() as Array<Record<string, unknown>>);
 
   if (rows.length === 0) return;
 
@@ -136,15 +146,24 @@ export function buildTurnNodes(
   edges: MemoryGraphEdge[],
 ): void {
   const existingIds = new Set(nodes.map((n) => n.id));
-  const rows = db
-    .prepare(
-      `SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
-              epoch_id, ended_at
-       FROM turns
-       WHERE session_id = ?
-       ORDER BY turn_index ASC`,
-    )
-    .all(sessionId) as Array<Record<string, unknown>>;
+  const rows = sessionId
+    ? (db
+        .prepare(
+          `SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
+                  epoch_id, ended_at
+           FROM turns
+           WHERE session_id = ?
+           ORDER BY turn_index ASC`,
+        )
+        .all(sessionId) as Array<Record<string, unknown>>)
+    : (db
+        .prepare(
+          `SELECT turn_index, role, pressure_band, ctx_tokens, ctx_percent,
+                  epoch_id, ended_at
+           FROM turns
+           ORDER BY turn_index ASC`,
+        )
+        .all() as Array<Record<string, unknown>>);
 
   if (rows.length === 0) return;
 
@@ -197,15 +216,24 @@ export function buildTurnContentNodes(
   // (identity_merge) merges them with the richest nodeType winning. Using the
   // global nodes array here would skip every node (Source A already added them).
   const seen = new Set<string>();
-  const rows = db
-    .prepare(
-      `SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
-       FROM turns t
-       JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
-       WHERE t.session_id = ?
-       ORDER BY t.turn_index ASC`,
-    )
-    .all(sessionId) as Array<Record<string, unknown>>;
+  const rows = sessionId
+    ? (db
+        .prepare(
+          `SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
+           FROM turns t
+           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
+           WHERE t.session_id = ?
+           ORDER BY t.turn_index ASC`,
+        )
+        .all(sessionId) as Array<Record<string, unknown>>)
+    : (db
+        .prepare(
+          `SELECT t.turn_index, t.role, t.ended_at, r.content_bytes
+           FROM turns t
+           JOIN raw_transcript r ON r.session_id = t.session_id AND r.turn_index = t.turn_index
+           ORDER BY t.turn_index ASC`,
+        )
+        .all() as Array<Record<string, unknown>>);
 
   if (rows.length === 0) return;
 

package/src/store/turns/sqlite-store.ts

@@ -242,8 +242,8 @@ export class SqliteTurnStore implements TurnStore {
 			this.db
 				.prepare(
 					`INSERT INTO turns (conversation_id, session_id, turn_index, role, ended_at,
-                                   ctx_tokens, ctx_percent, pressure_band, model)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+                                   ctx_tokens, ctx_percent, pressure_band, model, epoch_id)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
 				)
 				.run(
 					entry.conversationId,
@@ -255,6 +255,7 @@ export class SqliteTurnStore implements TurnStore {
 					entry.ctxPercent ?? null,
 					entry.pressureBand ?? null,
 					entry.model ?? null,
+					entry.epochId ?? null,
 				);
 		} catch (e) {
 			if (
@@ -524,8 +525,8 @@ export class SqliteTurnStore implements TurnStore {
 		this.clear();
 		const insertTurn = this.db.prepare(
 			`INSERT INTO turns (conversation_id, session_id, turn_index, role, ended_at,
-                               ctx_tokens, ctx_percent, pressure_band, model)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+                               ctx_tokens, ctx_percent, pressure_band, model, epoch_id)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
 		);
 		const insertRecall = this.db.prepare(
 			`INSERT INTO turn_recall (turn_id, checkpoint_id, score, source, raptor_level)
@@ -553,6 +554,7 @@ export class SqliteTurnStore implements TurnStore {
 					t.ctxPercent ?? null,
 					t.pressureBand ?? null,
 					t.model ?? null,
+					t.epochId ?? null,
 				);
 				const row = this.db
 					.prepare(