pi-mega-compact 0.8.0 → 0.8.1

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

@@ -17,10 +17,16 @@ export async function launchDashboardServer(stateDir) {
     // upgrade instead of reuse it.
     let SERVER_VERSION = "0.0.0";
     try {
-        // dashboard-server.js lives at <pkg>/dist/extensions/, so package.json is
-        // two levels up. Guard each candidate so a dev-checkout layout still works.
+        // Since v0.7.9 (8821ef3) dashboard-server.js lives at
+        // <pkg>/dist/extensions/dashboard-server/, so package.json is THREE levels
+        // up. Keep the two- and one-level-up candidates as fallbacks for flatter
+        // dev-checkout layouts. Guard each candidate so a missing file is skipped.
         const here = dirname(fileURLToPath(import.meta.url));
-        const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
+        const candidates = [
+            join(here, "..", "..", "..", "package.json"),
+            join(here, "..", "..", "package.json"),
+            join(here, "..", "package.json"),
+        ];
         for (const p of candidates) {
             if (!existsSync(p))
                 continue;

package/dist/extensions/mega-compact.js

@@ -18,7 +18,7 @@
  *   - mega-runtime.ts       shared live state (MegaRuntime) + widget + model capture
  *   - mega-pipeline.ts      runCompact (Trident+persist) + doRecall (Layer 5)
  *   - mega-commands.ts      data/inspection slash commands
- *   - mega-game-cmds.ts     /mega-game toggle + theme + TUI display mode
+ *   - mega-game-cmds.ts     /mega-compact-settings (+ /mega-game alias) toggle + theme + TUI display mode
  *   - mega-dashboard-cmds.ts  localhost dashboard server lifecycle commands
  *   - mega-events.ts        pi lifecycle event handlers
  *

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

@@ -50,15 +50,17 @@ export function registerContextHandler(pi, runtime, config) {
     // Legacy: MEGACOMPACT_LEGACY_DURABLE_TRIM=true restores the v0.4.28 ctx.compact
     // path (kept one release as rollback).
     pi.on("context", async (event, ctx) => {
-        if (!config.auto)
-            return;
         const usage = ctx.getContextUsage();
         const pct = usage?.percent;
-        // Always track context for the dashboard, even if we return early below.
+        // Always track context for the dashboard/widget, even when auto is off.
+        // (v0.8 regression: !config.auto gate sat above this, leaving ctx stats
+        // null -> widget '?% / ?/?' when auto disabled. Track first, THEN gate.)
         runtime.lastCtxTokens = usage?.tokens ?? null;
         runtime.lastCtxPercent = pct ?? null;
         runtime.lastCtxWindow = usage?.contextWindow ?? 0;
         runtime.snapshot(ctx);
+        if (!config.auto)
+            return;
         const messages = event.messages;
         const view = runtime.engineView(messages);
         const currentTokens = usage?.tokens ??

package/dist/extensions/mega-game-cmds.js

@@ -1,5 +1,5 @@
 /**
- * mega-game-cmds.ts — /mega-game slash command (S30).
+ * mega-game-cmds.ts — /mega-compact-settings slash command (S30; renamed in v0.8.x).
  *
  * Backs the game-mode toggle + theme picker + TUI display mode. All state is
  * the global `game_state` SQLite row (src/store/sqlite/game-state.ts) — local
@@ -7,100 +7,113 @@
  * command touches no fetch/http). All SQL is parameterized (PREVENT-002) and
  * lives in the src/ submodule, not here.
  *
+ * The primary command is /mega-compact-settings. /mega-game is retained as a
+ * backward-compat alias (same handler) so existing muscle memory + docs keep
+ * working.
+ *
  * Usage:
- *   /mega-game                 print current state
- *   /mega-game on              enable game mode (scoring + level-up + MEGA CACHE)
- *   /mega-game off             disable game mode
- *   /mega-game theme           list available themes
- *   /mega-game theme <id>      set theme by id
- *   /mega-game theme next      cycle to next theme
- *   /mega-game tui full        full TUI widget (bars, stats, flair)
- *   /mega-game tui minimal     one-line TUI widget (level + cache %)
- *   /mega-game achievements     list unlocked achievements
+ *   /mega-compact-settings                 print current state
+ *   /mega-compact-settings on              enable game mode (scoring + level-up + MEGA CACHE)
+ *   /mega-compact-settings off             disable game mode
+ *   /mega-compact-settings theme           list available themes
+ *   /mega-compact-settings theme <id>      set theme by id
+ *   /mega-compact-settings theme next      cycle to next theme
+ *   /mega-compact-settings tui full        full TUI widget (bars, stats, flair)
+ *   /mega-compact-settings tui minimal     one-line TUI widget (level + cache %)
+ *   /mega-compact-settings achievements      list unlocked achievements
  */
 import { getGameState, setGameState, } from "../src/store/sqlite.js";
 import { listAchievements } from "../src/store/sqlite/game-achievements.js";
 import { THEMES, THEME_IDS, getTheme, isValidTheme, nextTheme, DEFAULT_THEME } from "../src/config/themes.js";
+/** Notify/usage tag + command name. Primary surface is /mega-compact-settings. */
+const TAG = "mega-compact-settings";
 /** Format the current state as a human-readable status line set. */
 function fmtState(s) {
     return [
-        `[mega-game] game mode: ${s.game_mode_on ? "ON" : "off"}`,
+        `[${TAG}] game mode: ${s.game_mode_on ? "ON" : "off"}`,
         `  theme: ${s.theme}${s.theme === DEFAULT_THEME ? " (default)" : ""}`,
         `  tui:   ${s.tui_display_mode}`,
     ];
 }
-/** Register the /mega-game command. */
+/** Shared handler for /mega-compact-settings (primary) + /mega-game (alias). */
+async function handleSettings(args, ctx, runtime) {
+    runtime.bindRepo(ctx.cwd);
+    const stateDir = runtime.currentStateDir;
+    const parts = args.trim().split(/\s+/).filter(Boolean);
+    // bare  → print current state.
+    if (parts.length === 0) {
+        const s = getGameState(stateDir);
+        for (const line of fmtState(s))
+            ctx.ui.notify(line);
+        return;
+    }
+    const sub = parts[0];
+    // achievements — terse list of unlocked (hidden only once unlocked).
+    if (sub === "achievements") {
+        const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
+        ctx.ui.notify(`[${TAG}] achievements unlocked (${rows.length}/9):`);
+        for (const r of rows) {
+            ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`);
+        }
+        return;
+    }
+    // on|off
+    if (sub === "on" || sub === "off") {
+        const s = setGameState({ game_mode_on: sub === "on" }, stateDir);
+        runtime.bumpGameState();
+        ctx.ui.notify(`[${TAG}] game mode ${s.game_mode_on ? "ON" : "off"}`);
+        return;
+    }
+    // theme [id|next]
+    if (sub === "theme") {
+        if (parts.length === 1) {
+            // list themes
+            ctx.ui.notify(`[${TAG}] themes:`);
+            for (const t of THEMES) {
+                ctx.ui.notify(`  ${t.id.padEnd(14)} ${t.label}`);
+            }
+            return;
+        }
+        const arg = parts[1];
+        let id;
+        if (arg === "next") {
+            id = nextTheme(getGameState(stateDir).theme);
+        }
+        else if (isValidTheme(arg)) {
+            id = arg;
+        }
+        else {
+            ctx.ui.notify(`[${TAG}] unknown theme "${arg}". Valid: ${THEME_IDS.join(", ")}`);
+            return;
+        }
+        const s = setGameState({ theme: id }, stateDir);
+        runtime.bumpGameState();
+        ctx.ui.notify(`[${TAG}] theme → ${s.theme} (${getTheme(s.theme)?.label ?? ""})`);
+        return;
+    }
+    // tui full|minimal
+    if (sub === "tui") {
+        const arg = parts[1];
+        if (arg !== "full" && arg !== "minimal") {
+            ctx.ui.notify(`[${TAG}] usage: /${TAG} tui full|minimal`);
+            return;
+        }
+        const s = setGameState({ tui_display_mode: arg }, stateDir);
+        runtime.bumpGameState();
+        ctx.ui.notify(`[${TAG}] tui → ${s.tui_display_mode}`);
+        return;
+    }
+    ctx.ui.notify(`[${TAG}] usage: /${TAG} [on|off|theme [id|next]|tui [full|minimal]|achievements]`);
+}
+/** Register /mega-compact-settings (primary) + /mega-game (backward-compat alias). */
 export function registerGameCommands(pi, runtime) {
+    const description = "Game mode toggle + theme picker + TUI display mode. Usage: /mega-compact-settings [on|off|theme [id|next]|tui [full|minimal]|achievements]";
+    const handler = (args, ctx) => handleSettings(args, ctx, runtime);
+    // Primary command (renamed in v0.8.x from /mega-game).
+    pi.registerCommand("mega-compact-settings", { description, handler });
+    // Backward-compat alias: /mega-game still resolves to the same settings UI.
     pi.registerCommand("mega-game", {
-        description: "Game mode toggle + theme picker + TUI display mode. Usage: /mega-game [on|off|theme [id|next]|tui [full|minimal]|achievements]",
-        handler: async (args, ctx) => {
-            runtime.bindRepo(ctx.cwd);
-            const stateDir = runtime.currentStateDir;
-            const parts = args.trim().split(/\s+/).filter(Boolean);
-            // /mega-game  → print current state.
-            if (parts.length === 0) {
-                const s = getGameState(stateDir);
-                for (const line of fmtState(s))
-                    ctx.ui.notify(line);
-                return;
-            }
-            const sub = parts[0];
-            // /mega-game achievements — terse list of unlocked (hidden only once unlocked).
-            if (sub === "achievements") {
-                const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
-                ctx.ui.notify(`[mega-game] achievements unlocked (${rows.length}/9):`);
-                for (const r of rows) {
-                    ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`);
-                }
-                return;
-            }
-            // /mega-game on|off
-            if (sub === "on" || sub === "off") {
-                const s = setGameState({ game_mode_on: sub === "on" }, stateDir);
-                runtime.bumpGameState();
-                ctx.ui.notify(`[mega-game] game mode ${s.game_mode_on ? "ON" : "off"}`);
-                return;
-            }
-            // /mega-game theme [id|next]
-            if (sub === "theme") {
-                if (parts.length === 1) {
-                    // list themes
-                    ctx.ui.notify("[mega-game] themes:");
-                    for (const t of THEMES) {
-                        ctx.ui.notify(`  ${t.id.padEnd(14)} ${t.label}`);
-                    }
-                    return;
-                }
-                const arg = parts[1];
-                let id;
-                if (arg === "next") {
-                    id = nextTheme(getGameState(stateDir).theme);
-                }
-                else if (isValidTheme(arg)) {
-                    id = arg;
-                }
-                else {
-                    ctx.ui.notify(`[mega-game] unknown theme "${arg}". Valid: ${THEME_IDS.join(", ")}`);
-                    return;
-                }
-                const s = setGameState({ theme: id }, stateDir);
-                runtime.bumpGameState();
-                ctx.ui.notify(`[mega-game] theme → ${s.theme} (${getTheme(s.theme)?.label ?? ""})`);
-                return;
-            }
-            // /mega-game tui full|minimal
-            if (sub === "tui") {
-                const arg = parts[1];
-                if (arg !== "full" && arg !== "minimal") {
-                    ctx.ui.notify(`[mega-game] usage: /mega-game tui full|minimal`);
-                    return;
-                }
-                const s = setGameState({ tui_display_mode: arg }, stateDir);
-                runtime.bumpGameState();
-                ctx.ui.notify(`[mega-game] tui → ${s.tui_display_mode}`);
-                return;
-            }
-            ctx.ui.notify(`[mega-game] usage: /mega-game [on|off|theme [id|next]|tui [full|minimal]|achievements]`);
-        },
+        description: "(alias for /mega-compact-settings) " + description,
+        handler,
     });
 }

package/dist/extensions/mega-game-cmds.test.js

@@ -35,7 +35,7 @@ function makeHarness(stateDir) {
     mod.registerGameCommands(fakePi, runtime);
     return { commands, notifies, ctx };
 }
-describe("/mega-game (S30)", () => {
+describe("/mega-compact-settings (S30; /mega-game alias)", () => {
     let dir;
     before(() => {
         dir = mkdtempSync(join(tmpdir(), "mc-megagame-"));
@@ -52,6 +52,11 @@ describe("/mega-game (S30)", () => {
         await h.commands["mega-game"].handler(args, h.ctx);
         return h.notifies;
     }
+    it("registers /mega-compact-settings as primary + /mega-game as alias", async () => {
+        const h = makeHarness(dir);
+        assert.ok(h.commands["mega-compact-settings"], "primary registered");
+        assert.ok(h.commands["mega-game"], "alias registered");
+    });
     it("bare command prints current (default) state", async () => {
         const lines = await run("");
         assert.ok(lines.some((l) => l.includes("game mode: off")));

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

@@ -767,11 +767,25 @@ export class MegaRuntime {
             this.gameStateWatchDir = undefined;
         }
         try {
-            this.gameStateWatcher = watch(join(this.currentStateDir, "sqlite.db"), () => { this.cachedGameState = undefined; });
+            // Watch the state DIR (not just sqlite.db) and filter by filename.
+            // Why: the store is WAL-mode (openStore sets PRAGMA journal_mode=WAL).
+            // Cross-process writes (dashboard server child) append to sqlite.db-wal
+            // and do NOT modify sqlite.db until a checkpoint — and a long-lived
+            // parent connection (VectorStore + dashboard readers) keeps the WAL
+            // uncheckpointed, so a watcher on sqlite.db alone never fires and
+            // cachedGameState stays stale (theme stuck after a dashboard edit).
+            // Watching the dir + matching sqlite.db* catches the main db, the -wal
+            // sidecar, and -shm, so the memo evicts on any cross-process write. The
+            // filter also excludes events.log / *.log noise in the same dir.
+            this.gameStateWatcher = watch(this.currentStateDir, (_eventType, filename) => {
+                if (typeof filename === "string" && filename.startsWith("sqlite.db")) {
+                    this.cachedGameState = undefined;
+                }
+            });
             this.gameStateWatchDir = this.currentStateDir;
         }
         catch {
-            /* non-fatal: missing file / platform issue — next snapshot re-queries */
+            /* non-fatal: missing dir / platform issue — next snapshot re-queries */
         }
     }
     /** S32: release the fs.watch game-state watcher. Called when the runtime is

package/extensions/dashboard-server/server.ts

@@ -22,10 +22,16 @@ export async function launchDashboardServer(stateDir: string): Promise<{ port: n
   // upgrade instead of reuse it.
   let SERVER_VERSION = "0.0.0";
   try {
-    // dashboard-server.js lives at <pkg>/dist/extensions/, so package.json is
-    // two levels up. Guard each candidate so a dev-checkout layout still works.
+    // Since v0.7.9 (8821ef3) dashboard-server.js lives at
+    // <pkg>/dist/extensions/dashboard-server/, so package.json is THREE levels
+    // up. Keep the two- and one-level-up candidates as fallbacks for flatter
+    // dev-checkout layouts. Guard each candidate so a missing file is skipped.
     const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [join(here, "..", "..", "package.json"), join(here, "..", "package.json")];
+    const candidates = [
+      join(here, "..", "..", "..", "package.json"),
+      join(here, "..", "..", "package.json"),
+      join(here, "..", "package.json"),
+    ];
     for (const p of candidates) {
       if (!existsSync(p)) continue;
       const pkg = JSON.parse(readFileSync(p, "utf-8"));

package/extensions/mega-compact.ts

@@ -18,7 +18,7 @@
  *   - mega-runtime.ts       shared live state (MegaRuntime) + widget + model capture
  *   - mega-pipeline.ts      runCompact (Trident+persist) + doRecall (Layer 5)
  *   - mega-commands.ts      data/inspection slash commands
- *   - mega-game-cmds.ts     /mega-game toggle + theme + TUI display mode
+ *   - mega-game-cmds.ts     /mega-compact-settings (+ /mega-game alias) toggle + theme + TUI display mode
  *   - mega-dashboard-cmds.ts  localhost dashboard server lifecycle commands
  *   - mega-events.ts        pi lifecycle event handlers
  *

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

@@ -83,14 +83,16 @@ export function registerContextHandler(
 	// Legacy: MEGACOMPACT_LEGACY_DURABLE_TRIM=true restores the v0.4.28 ctx.compact
 	// path (kept one release as rollback).
 	pi.on("context", async (event: ContextEvent, ctx: ExtensionContext) => {
-		if (!config.auto) return;
 		const usage = ctx.getContextUsage();
 		const pct = usage?.percent;
-		// Always track context for the dashboard, even if we return early below.
+		// Always track context for the dashboard/widget, even when auto is off.
+		// (v0.8 regression: !config.auto gate sat above this, leaving ctx stats
+		// null -> widget '?% / ?/?' when auto disabled. Track first, THEN gate.)
 		runtime.lastCtxTokens = usage?.tokens ?? null;
 		runtime.lastCtxPercent = pct ?? null;
 		runtime.lastCtxWindow = usage?.contextWindow ?? 0;
 		runtime.snapshot(ctx);
+		if (!config.auto) return;
 
 		const messages = event.messages;
 		const view = runtime.engineView(messages);

package/extensions/mega-game-cmds.test.ts

@@ -48,7 +48,7 @@ function makeHarness(stateDir: string): Harness {
   return { commands, notifies, ctx };
 }
 
-describe("/mega-game (S30)", () => {
+describe("/mega-compact-settings (S30; /mega-game alias)", () => {
   let dir: string;
   before(() => {
     dir = mkdtempSync(join(tmpdir(), "mc-megagame-"));
@@ -67,6 +67,12 @@ describe("/mega-game (S30)", () => {
     return h.notifies;
   }
 
+  it("registers /mega-compact-settings as primary + /mega-game as alias", async () => {
+    const h = makeHarness(dir);
+    assert.ok(h.commands["mega-compact-settings"], "primary registered");
+    assert.ok(h.commands["mega-game"], "alias registered");
+  });
+
   it("bare command prints current (default) state", async () => {
     const lines = await run("");
     assert.ok(lines.some((l) => l.includes("game mode: off")));

package/extensions/mega-game-cmds.ts

@@ -1,5 +1,5 @@
 /**
- * mega-game-cmds.ts — /mega-game slash command (S30).
+ * mega-game-cmds.ts — /mega-compact-settings slash command (S30; renamed in v0.8.x).
  *
  * Backs the game-mode toggle + theme picker + TUI display mode. All state is
  * the global `game_state` SQLite row (src/store/sqlite/game-state.ts) — local
@@ -7,16 +7,20 @@
  * command touches no fetch/http). All SQL is parameterized (PREVENT-002) and
  * lives in the src/ submodule, not here.
  *
+ * The primary command is /mega-compact-settings. /mega-game is retained as a
+ * backward-compat alias (same handler) so existing muscle memory + docs keep
+ * working.
+ *
  * Usage:
- *   /mega-game                 print current state
- *   /mega-game on              enable game mode (scoring + level-up + MEGA CACHE)
- *   /mega-game off             disable game mode
- *   /mega-game theme           list available themes
- *   /mega-game theme <id>      set theme by id
- *   /mega-game theme next      cycle to next theme
- *   /mega-game tui full        full TUI widget (bars, stats, flair)
- *   /mega-game tui minimal     one-line TUI widget (level + cache %)
- *   /mega-game achievements     list unlocked achievements
+ *   /mega-compact-settings                 print current state
+ *   /mega-compact-settings on              enable game mode (scoring + level-up + MEGA CACHE)
+ *   /mega-compact-settings off             disable game mode
+ *   /mega-compact-settings theme           list available themes
+ *   /mega-compact-settings theme <id>      set theme by id
+ *   /mega-compact-settings theme next      cycle to next theme
+ *   /mega-compact-settings tui full        full TUI widget (bars, stats, flair)
+ *   /mega-compact-settings tui minimal     one-line TUI widget (level + cache %)
+ *   /mega-compact-settings achievements      list unlocked achievements
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -29,94 +33,110 @@ import {
 import { listAchievements } from "../src/store/sqlite/game-achievements.js";
 import { THEMES, THEME_IDS, getTheme, isValidTheme, nextTheme, DEFAULT_THEME } from "../src/config/themes.js";
 
+/** Notify/usage tag + command name. Primary surface is /mega-compact-settings. */
+const TAG = "mega-compact-settings";
+
 /** Format the current state as a human-readable status line set. */
 function fmtState(s: GameState): string[] {
   return [
-    `[mega-game] game mode: ${s.game_mode_on ? "ON" : "off"}`,
+    `[${TAG}] game mode: ${s.game_mode_on ? "ON" : "off"}`,
     `  theme: ${s.theme}${s.theme === DEFAULT_THEME ? " (default)" : ""}`,
     `  tui:   ${s.tui_display_mode}`,
   ];
 }
 
-/** Register the /mega-game command. */
-export function registerGameCommands(pi: ExtensionAPI, runtime: MegaRuntime): void {
-  pi.registerCommand("mega-game", {
-    description:
-      "Game mode toggle + theme picker + TUI display mode. Usage: /mega-game [on|off|theme [id|next]|tui [full|minimal]|achievements]",
-    handler: async (args: string, ctx: ExtensionContext) => {
-      runtime.bindRepo(ctx.cwd);
-      const stateDir = runtime.currentStateDir;
-      const parts = args.trim().split(/\s+/).filter(Boolean);
+/** Shared handler for /mega-compact-settings (primary) + /mega-game (alias). */
+async function handleSettings(
+  args: string,
+  ctx: ExtensionContext,
+  runtime: MegaRuntime,
+): Promise<void> {
+  runtime.bindRepo(ctx.cwd);
+  const stateDir = runtime.currentStateDir;
+  const parts = args.trim().split(/\s+/).filter(Boolean);
 
-      // /mega-game  → print current state.
-      if (parts.length === 0) {
-        const s = getGameState(stateDir);
-        for (const line of fmtState(s)) ctx.ui.notify(line);
-        return;
-      }
+  // bare  → print current state.
+  if (parts.length === 0) {
+    const s = getGameState(stateDir);
+    for (const line of fmtState(s)) ctx.ui.notify(line);
+    return;
+  }
 
-      const sub = parts[0]!;
+  const sub = parts[0]!;
 
-      // /mega-game achievements — terse list of unlocked (hidden only once unlocked).
-      if (sub === "achievements") {
-        const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
-        ctx.ui.notify(`[mega-game] achievements unlocked (${rows.length}/9):`);
-        for (const r of rows) {
-          ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`);
-        }
-        return;
-      }
+  // achievements — terse list of unlocked (hidden only once unlocked).
+  if (sub === "achievements") {
+    const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
+    ctx.ui.notify(`[${TAG}] achievements unlocked (${rows.length}/9):`);
+    for (const r of rows) {
+      ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`);
+    }
+    return;
+  }
 
-      // /mega-game on|off
-      if (sub === "on" || sub === "off") {
-        const s = setGameState({ game_mode_on: sub === "on" }, stateDir);
-        runtime.bumpGameState();
-        ctx.ui.notify(`[mega-game] game mode ${s.game_mode_on ? "ON" : "off"}`);
-        return;
-      }
+  // on|off
+  if (sub === "on" || sub === "off") {
+    const s = setGameState({ game_mode_on: sub === "on" }, stateDir);
+    runtime.bumpGameState();
+    ctx.ui.notify(`[${TAG}] game mode ${s.game_mode_on ? "ON" : "off"}`);
+    return;
+  }
 
-      // /mega-game theme [id|next]
-      if (sub === "theme") {
-        if (parts.length === 1) {
-          // list themes
-          ctx.ui.notify("[mega-game] themes:");
-          for (const t of THEMES) {
-            ctx.ui.notify(`  ${t.id.padEnd(14)} ${t.label}`);
-          }
-          return;
-        }
-        const arg = parts[1]!;
-        let id: string;
-        if (arg === "next") {
-          id = nextTheme(getGameState(stateDir).theme);
-        } else if (isValidTheme(arg)) {
-          id = arg;
-        } else {
-          ctx.ui.notify(`[mega-game] unknown theme "${arg}". Valid: ${THEME_IDS.join(", ")}`);
-          return;
-        }
-        const s = setGameState({ theme: id }, stateDir);
-        runtime.bumpGameState();
-        ctx.ui.notify(`[mega-game] theme → ${s.theme} (${getTheme(s.theme)?.label ?? ""})`);
-        return;
+  // theme [id|next]
+  if (sub === "theme") {
+    if (parts.length === 1) {
+      // list themes
+      ctx.ui.notify(`[${TAG}] themes:`);
+      for (const t of THEMES) {
+        ctx.ui.notify(`  ${t.id.padEnd(14)} ${t.label}`);
       }
+      return;
+    }
+    const arg = parts[1]!;
+    let id: string;
+    if (arg === "next") {
+      id = nextTheme(getGameState(stateDir).theme);
+    } else if (isValidTheme(arg)) {
+      id = arg;
+    } else {
+      ctx.ui.notify(`[${TAG}] unknown theme "${arg}". Valid: ${THEME_IDS.join(", ")}`);
+      return;
+    }
+    const s = setGameState({ theme: id }, stateDir);
+    runtime.bumpGameState();
+    ctx.ui.notify(`[${TAG}] theme → ${s.theme} (${getTheme(s.theme)?.label ?? ""})`);
+    return;
+  }
 
-      // /mega-game tui full|minimal
-      if (sub === "tui") {
-        const arg = parts[1];
-        if (arg !== "full" && arg !== "minimal") {
-          ctx.ui.notify(`[mega-game] usage: /mega-game tui full|minimal`);
-          return;
-        }
-        const s = setGameState({ tui_display_mode: arg }, stateDir);
-        runtime.bumpGameState();
-        ctx.ui.notify(`[mega-game] tui → ${s.tui_display_mode}`);
-        return;
-      }
+  // tui full|minimal
+  if (sub === "tui") {
+    const arg = parts[1];
+    if (arg !== "full" && arg !== "minimal") {
+      ctx.ui.notify(`[${TAG}] usage: /${TAG} tui full|minimal`);
+      return;
+    }
+    const s = setGameState({ tui_display_mode: arg }, stateDir);
+    runtime.bumpGameState();
+    ctx.ui.notify(`[${TAG}] tui → ${s.tui_display_mode}`);
+    return;
+  }
+
+  ctx.ui.notify(
+    `[${TAG}] usage: /${TAG} [on|off|theme [id|next]|tui [full|minimal]|achievements]`,
+  );
+}
 
-      ctx.ui.notify(
-        `[mega-game] usage: /mega-game [on|off|theme [id|next]|tui [full|minimal]|achievements]`,
-      );
-    },
+/** Register /mega-compact-settings (primary) + /mega-game (backward-compat alias). */
+export function registerGameCommands(pi: ExtensionAPI, runtime: MegaRuntime): void {
+  const description =
+    "Game mode toggle + theme picker + TUI display mode. Usage: /mega-compact-settings [on|off|theme [id|next]|tui [full|minimal]|achievements]";
+  const handler = (args: string, ctx: ExtensionContext) => handleSettings(args, ctx, runtime);
+
+  // Primary command (renamed in v0.8.x from /mega-game).
+  pi.registerCommand("mega-compact-settings", { description, handler });
+  // Backward-compat alias: /mega-game still resolves to the same settings UI.
+  pi.registerCommand("mega-game", {
+    description: "(alias for /mega-compact-settings) " + description,
+    handler,
   });
 }

package/extensions/mega-runtime/state.ts

@@ -846,13 +846,27 @@ export class MegaRuntime {
 			this.gameStateWatchDir = undefined;
 		}
 		try {
+			// Watch the state DIR (not just sqlite.db) and filter by filename.
+			// Why: the store is WAL-mode (openStore sets PRAGMA journal_mode=WAL).
+			// Cross-process writes (dashboard server child) append to sqlite.db-wal
+			// and do NOT modify sqlite.db until a checkpoint — and a long-lived
+			// parent connection (VectorStore + dashboard readers) keeps the WAL
+			// uncheckpointed, so a watcher on sqlite.db alone never fires and
+			// cachedGameState stays stale (theme stuck after a dashboard edit).
+			// Watching the dir + matching sqlite.db* catches the main db, the -wal
+			// sidecar, and -shm, so the memo evicts on any cross-process write. The
+			// filter also excludes events.log / *.log noise in the same dir.
 			this.gameStateWatcher = watch(
-				join(this.currentStateDir, "sqlite.db"),
-				() => { this.cachedGameState = undefined; },
+				this.currentStateDir,
+				(_eventType, filename) => {
+					if (typeof filename === "string" && filename.startsWith("sqlite.db")) {
+						this.cachedGameState = undefined;
+					}
+				},
 			);
 			this.gameStateWatchDir = this.currentStateDir;
 		} catch {
-			/* non-fatal: missing file / platform issue — next snapshot re-queries */
+			/* non-fatal: missing dir / platform issue — next snapshot re-queries */
 		}
 	}
 

package/package.json

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