pi-mega-compact 0.8.0 → 0.8.2

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;
@@ -490,6 +496,18 @@ export async function launchDashboardServer(stateDir) {
                 log("server running", { url });
                 // eslint-disable-next-line no-console
                 console.log(`[mega-compact] dashboard server running: ${url}`);
+                // v0.8.2: also bind the IPv6 loopback (::1). On many systems `localhost`
+                // resolves to ::1 first (see /etc/hosts), so an IPv4-only bind makes the
+                // browser hit ::1:port and get connection refused. PREVENT-PI-004
+                // (loopback-only) means BOTH 127.0.0.1 and ::1. Non-fatal: IPv4-only
+                // hosts or a ::1 already in use just skip the mirror.
+                let v6;
+                const v4Handler = server.listeners("request")[0];
+                if (v4Handler) {
+                    v6 = createServer((r, s) => v4Handler.call(server, r, s));
+                    v6.on("error", (e) => log("ipv6 loopback bind skipped", { port, code: e.code, message: e.message }));
+                    v6.listen(port, "::1", () => log("ipv6 loopback bound", { port })); // guardrails-allow PREVENT-PI-004: IPv6 loopback (::1) mirror of the localhost dashboard server
+                }
                 // Write port.pid
                 try {
                     writeFileSync(portFile, JSON.stringify({ port, pid: process.pid }));
@@ -504,6 +522,10 @@ export async function launchDashboardServer(stateDir) {
                     }
                     catch { /* already gone */ }
                     server.close();
+                    try {
+                        v6?.close();
+                    }
+                    catch { /* not bound */ }
                     process.exit(0);
                 };
                 process.on("SIGTERM", cleanup);

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,216 @@
  * 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. */
-export function registerGameCommands(pi, runtime) {
-    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);
+/** 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  → interactive in-app menu (ctx.ui.select picker). Falls back to a
+    // static status print when there's no interactive UI (RPC/print mode, or a
+    // test harness stubbing only notify). CLI subcommands below still work for
+    // power users + scripts.
+    if (parts.length === 0) {
+        if (typeof ctx.ui.select === "function") {
+            try {
+                await runInteractiveMenu(ctx, runtime, stateDir);
                 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;
+            catch {
+                // select threw (non-interactive impl) → fall through to status print
             }
-            // /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;
+        }
+        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}`);
             }
-            ctx.ui.notify(`[mega-game] usage: /mega-game [on|off|theme [id|next]|tui [full|minimal]|achievements]`);
-        },
+            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]`);
+}
+/** Interactive in-app menu for bare `/mega-compact-settings`. Uses ctx.ui.select
+ * (a real TUI picker in interactive mode). Loops until the user cancels (or
+ * picks "Done"). Each action mutates the global game_state row + bumps the
+ * runtime cache so the widget/dashboard reflect it immediately.
+ *
+ * Guarded by the caller via `typeof ctx.ui.select === "function"`; if select is
+ * unavailable we fall back to the static fmtState notify print. */
+async function runInteractiveMenu(ctx, runtime, stateDir) {
+    for (;;) {
+        const s = getGameState(stateDir);
+        const toggleLabel = s.game_mode_on ? "Turn game mode OFF" : "Turn game mode ON";
+        const choice = await ctx.ui.select(`[${TAG}] settings · game mode: ${s.game_mode_on ? "ON" : "off"} · theme: ${s.theme} · tui: ${s.tui_display_mode}`, [toggleLabel, "Theme…", "TUI display mode…", "Achievements…", "Done"]);
+        if (choice === undefined || choice === "Done")
+            return;
+        if (choice === toggleLabel) {
+            const next = !s.game_mode_on;
+            setGameState({ game_mode_on: next }, stateDir);
+            runtime.bumpGameState();
+            ctx.ui.notify(`[${TAG}] game mode ${next ? "ON" : "off"}`, "info");
+            continue;
+        }
+        if (choice === "Theme…") {
+            await themeSubmenu(ctx, runtime, stateDir);
+            continue;
+        }
+        if (choice === "TUI display mode…") {
+            await tuiSubmenu(ctx, runtime, stateDir);
+            continue;
+        }
+        if (choice === "Achievements…") {
+            await achievementsView(ctx, stateDir);
+            continue;
+        }
+    }
+}
+/** Theme picker submenu — lists all themes (current marked ✓) + a cycle option. */
+async function themeSubmenu(ctx, runtime, stateDir) {
+    const s = getGameState(stateDir);
+    const opts = THEMES.map((t) => {
+        const mark = t.id === s.theme ? " ✓" : "";
+        return `${t.id}${mark}  ${t.label}`;
+    });
+    opts.push("next (cycle to next theme)");
+    opts.push("Back");
+    const choice = await ctx.ui.select(`[${TAG}] theme (current: ${s.theme})`, opts);
+    if (choice === undefined || choice === "Back")
+        return;
+    const first = choice.split(/\s+/)[0];
+    let id;
+    if (first === "next") {
+        id = nextTheme(s.theme);
+    }
+    else if (isValidTheme(first)) {
+        id = first;
+    }
+    if (id && id !== s.theme) {
+        setGameState({ theme: id }, stateDir);
+        runtime.bumpGameState();
+        ctx.ui.notify(`[${TAG}] theme → ${id} (${getTheme(id)?.label ?? ""})`, "info");
+    }
+}
+/** TUI display-mode submenu — full vs minimal (current marked ✓). */
+async function tuiSubmenu(ctx, runtime, stateDir) {
+    const s = getGameState(stateDir);
+    const mark = (m) => (s.tui_display_mode === m ? " ✓" : "");
+    const choice = await ctx.ui.select(`[${TAG}] TUI display mode (current: ${s.tui_display_mode})`, [
+        `full${mark("full")}  — bars, stats, flair`,
+        `minimal${mark("minimal")}  — one-line level + cache %`,
+        "Back",
+    ]);
+    if (choice === undefined || choice === "Back")
+        return;
+    const mode = choice.split(/\s+/)[0];
+    if (mode === "full" || mode === "minimal") {
+        setGameState({ tui_display_mode: mode }, stateDir);
+        runtime.bumpGameState();
+        ctx.ui.notify(`[${TAG}] tui → ${mode}`, "info");
+    }
+}
+/** Achievements view — terse notify list + a read-only select viewer. */
+async function achievementsView(ctx, stateDir) {
+    const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
+    ctx.ui.notify(`[${TAG}] achievements unlocked (${rows.length}/9):`, "info");
+    for (const r of rows)
+        ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`, "info");
+    const lines = rows.length
+        ? rows.map((r) => `${r.icon ?? ""} ${r.title}`)
+        : ["(none unlocked yet — keep compacting!)"];
+    // select() as a read-only viewer; any selection / cancel returns to the menu.
+    await ctx.ui.select(`[${TAG}] achievements (${rows.length}/9 unlocked)`, lines);
+}
+/** 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: "(alias for /mega-compact-settings) " + description,
+        handler,
     });
 }

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

@@ -16,13 +16,13 @@ import { THEME_IDS } from "../src/config/themes.js";
 // that wires the command against a fake pi without binding to the real pi
 // module at load time.
 const require = createRequire(import.meta.url);
-function makeHarness(stateDir) {
+function makeHarness(stateDir, select) {
     const commands = {};
     const notifies = [];
     const runtime = { bindRepo: () => { }, currentStateDir: stateDir, bumpGameState: () => { } };
     const ctx = {
         cwd: stateDir,
-        ui: { notify: (s) => notifies.push(s) },
+        ui: { notify: (s) => notifies.push(s), ...(select ? { select } : {}) },
     };
     const fakePi = {
         registerCommand: (name, opts) => {
@@ -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,12 +52,46 @@ 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")));
         assert.ok(lines.some((l) => l.includes("transparent")));
         assert.ok(lines.some((l) => l.includes("tui:")));
     });
+    it("bare command opens interactive menu (select) and toggles game mode", async () => {
+        const seq = ["Turn game mode ON", "Done"];
+        let i = 0;
+        const h = makeHarness(dir, () => Promise.resolve(seq[i++] ?? undefined));
+        h.notifies.length = 0;
+        await h.commands["mega-compact-settings"].handler("", h.ctx);
+        assert.equal(getGameState().game_mode_on, true);
+        assert.ok(h.notifies.some((l) => l.includes("game mode ON")));
+        // toggle back off via the menu
+        const seq2 = ["Turn game mode OFF", "Done"];
+        let j = 0;
+        const h2 = makeHarness(dir, () => Promise.resolve(seq2[j++] ?? undefined));
+        await h2.commands["mega-compact-settings"].handler("", h2.ctx);
+        assert.equal(getGameState().game_mode_on, false);
+    });
+    it("bare command falls back to status print when select is unavailable", async () => {
+        // default harness has no select — mimics RPC/print mode
+        const lines = await run("");
+        assert.ok(lines.some((l) => l.includes("game mode: off")));
+    });
+    it("menu Theme… → picks a theme and persists", async () => {
+        const seq = ["Theme…", "retro  Retro Terminal", "Done"];
+        let i = 0;
+        const h = makeHarness(dir, () => Promise.resolve(seq[i++] ?? undefined));
+        h.notifies.length = 0;
+        await h.commands["mega-compact-settings"].handler("", h.ctx);
+        assert.equal(getGameState().theme, "retro");
+        assert.ok(h.notifies.some((l) => l.includes("theme → retro")));
+    });
     it("on enables game mode and persists", async () => {
         await run("on");
         assert.equal(getGameState().game_mode_on, true);

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"));
@@ -464,6 +470,21 @@ export async function launchDashboardServer(stateDir: string): Promise<{ port: n
         // eslint-disable-next-line no-console
         console.log(`[mega-compact] dashboard server running: ${url}`);
 
+        // v0.8.2: also bind the IPv6 loopback (::1). On many systems `localhost`
+        // resolves to ::1 first (see /etc/hosts), so an IPv4-only bind makes the
+        // browser hit ::1:port and get connection refused. PREVENT-PI-004
+        // (loopback-only) means BOTH 127.0.0.1 and ::1. Non-fatal: IPv4-only
+        // hosts or a ::1 already in use just skip the mirror.
+        let v6: ReturnType<typeof createServer> | undefined;
+        const v4Handler = server.listeners("request")[0];
+        if (v4Handler) {
+          v6 = createServer((r, s) => (v4Handler as (a: IncomingMessage, b: ServerResponse) => void).call(server, r, s));
+          v6.on("error", (e: NodeJS.ErrnoException) =>
+            log("ipv6 loopback bind skipped", { port, code: e.code, message: e.message }),
+          );
+          v6.listen(port, "::1", () => log("ipv6 loopback bound", { port })); // guardrails-allow PREVENT-PI-004: IPv6 loopback (::1) mirror of the localhost dashboard server
+        }
+
         // Write port.pid
         try {
           writeFileSync(portFile, JSON.stringify({ port, pid: process.pid }));
@@ -475,6 +496,7 @@ export async function launchDashboardServer(stateDir: string): Promise<{ port: n
         const cleanup = () => {
           try { unlinkSync(portFile); } catch { /* already gone */ }
           server.close();
+          try { v6?.close(); } catch { /* not bound */ }
           process.exit(0);
         };
         process.on("SIGTERM", cleanup);

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

@@ -26,13 +26,16 @@ type Harness = {
   ctx: any;
 };
 
-function makeHarness(stateDir: string): Harness {
+function makeHarness(
+  stateDir: string,
+  select?: (title: string, options: string[]) => Promise<string | undefined>,
+): Harness {
   const commands: Record<string, Cmd> = {};
   const notifies: string[] = [];
   const runtime = { bindRepo: () => {}, currentStateDir: stateDir, bumpGameState: () => {} };
   const ctx = {
     cwd: stateDir,
-    ui: { notify: (s: string) => notifies.push(s) },
+    ui: { notify: (s: string) => notifies.push(s), ...(select ? { select } : {}) },
   };
   const fakePi = {
     registerCommand: (name: string, opts: Cmd) => {
@@ -48,7 +51,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 +70,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")));
@@ -74,6 +83,38 @@ describe("/mega-game (S30)", () => {
     assert.ok(lines.some((l) => l.includes("tui:")));
   });
 
+  it("bare command opens interactive menu (select) and toggles game mode", async () => {
+    const seq = ["Turn game mode ON", "Done"];
+    let i = 0;
+    const h = makeHarness(dir, () => Promise.resolve(seq[i++] ?? undefined));
+    h.notifies.length = 0;
+    await h.commands["mega-compact-settings"].handler("", h.ctx);
+    assert.equal(getGameState().game_mode_on, true);
+    assert.ok(h.notifies.some((l) => l.includes("game mode ON")));
+    // toggle back off via the menu
+    const seq2 = ["Turn game mode OFF", "Done"];
+    let j = 0;
+    const h2 = makeHarness(dir, () => Promise.resolve(seq2[j++] ?? undefined));
+    await h2.commands["mega-compact-settings"].handler("", h2.ctx);
+    assert.equal(getGameState().game_mode_on, false);
+  });
+
+  it("bare command falls back to status print when select is unavailable", async () => {
+    // default harness has no select — mimics RPC/print mode
+    const lines = await run("");
+    assert.ok(lines.some((l) => l.includes("game mode: off")));
+  });
+
+  it("menu Theme… → picks a theme and persists", async () => {
+    const seq = ["Theme…", "retro  Retro Terminal", "Done"];
+    let i = 0;
+    const h = makeHarness(dir, () => Promise.resolve(seq[i++] ?? undefined));
+    h.notifies.length = 0;
+    await h.commands["mega-compact-settings"].handler("", h.ctx);
+    assert.equal(getGameState().theme, "retro");
+    assert.ok(h.notifies.some((l) => l.includes("theme → retro")));
+  });
+
   it("on enables game mode and persists", async () => {
     await run("on");
     assert.equal(getGameState().game_mode_on, true);

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,226 @@ 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);
-
-      // /mega-game  → print current state.
-      if (parts.length === 0) {
-        const s = getGameState(stateDir);
-        for (const line of fmtState(s)) ctx.ui.notify(line);
+/** 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);
+
+  // bare  → interactive in-app menu (ctx.ui.select picker). Falls back to a
+  // static status print when there's no interactive UI (RPC/print mode, or a
+  // test harness stubbing only notify). CLI subcommands below still work for
+  // power users + scripts.
+  if (parts.length === 0) {
+    if (typeof ctx.ui.select === "function") {
+      try {
+        await runInteractiveMenu(ctx, runtime, stateDir);
         return;
+      } catch {
+        // select threw (non-interactive impl) → fall through to status print
       }
+    }
+    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]`,
-      );
-    },
+/** Interactive in-app menu for bare `/mega-compact-settings`. Uses ctx.ui.select
+ * (a real TUI picker in interactive mode). Loops until the user cancels (or
+ * picks "Done"). Each action mutates the global game_state row + bumps the
+ * runtime cache so the widget/dashboard reflect it immediately.
+ *
+ * Guarded by the caller via `typeof ctx.ui.select === "function"`; if select is
+ * unavailable we fall back to the static fmtState notify print. */
+async function runInteractiveMenu(
+  ctx: ExtensionContext,
+  runtime: MegaRuntime,
+  stateDir: string,
+): Promise<void> {
+  for (;;) {
+    const s = getGameState(stateDir);
+    const toggleLabel = s.game_mode_on ? "Turn game mode OFF" : "Turn game mode ON";
+    const choice = await ctx.ui.select(
+      `[${TAG}] settings · game mode: ${s.game_mode_on ? "ON" : "off"} · theme: ${s.theme} · tui: ${s.tui_display_mode}`,
+      [toggleLabel, "Theme…", "TUI display mode…", "Achievements…", "Done"],
+    );
+    if (choice === undefined || choice === "Done") return;
+    if (choice === toggleLabel) {
+      const next = !s.game_mode_on;
+      setGameState({ game_mode_on: next }, stateDir);
+      runtime.bumpGameState();
+      ctx.ui.notify(`[${TAG}] game mode ${next ? "ON" : "off"}`, "info");
+      continue;
+    }
+    if (choice === "Theme…") {
+      await themeSubmenu(ctx, runtime, stateDir);
+      continue;
+    }
+    if (choice === "TUI display mode…") {
+      await tuiSubmenu(ctx, runtime, stateDir);
+      continue;
+    }
+    if (choice === "Achievements…") {
+      await achievementsView(ctx, stateDir);
+      continue;
+    }
+  }
+}
+
+/** Theme picker submenu — lists all themes (current marked ✓) + a cycle option. */
+async function themeSubmenu(
+  ctx: ExtensionContext,
+  runtime: MegaRuntime,
+  stateDir: string,
+): Promise<void> {
+  const s = getGameState(stateDir);
+  const opts = THEMES.map((t) => {
+    const mark = t.id === s.theme ? " ✓" : "";
+    return `${t.id}${mark}  ${t.label}`;
+  });
+  opts.push("next (cycle to next theme)");
+  opts.push("Back");
+  const choice = await ctx.ui.select(`[${TAG}] theme (current: ${s.theme})`, opts);
+  if (choice === undefined || choice === "Back") return;
+  const first = choice.split(/\s+/)[0]!;
+  let id: string | undefined;
+  if (first === "next") {
+    id = nextTheme(s.theme);
+  } else if (isValidTheme(first)) {
+    id = first;
+  }
+  if (id && id !== s.theme) {
+    setGameState({ theme: id }, stateDir);
+    runtime.bumpGameState();
+    ctx.ui.notify(`[${TAG}] theme → ${id} (${getTheme(id)?.label ?? ""})`, "info");
+  }
+}
+
+/** TUI display-mode submenu — full vs minimal (current marked ✓). */
+async function tuiSubmenu(
+  ctx: ExtensionContext,
+  runtime: MegaRuntime,
+  stateDir: string,
+): Promise<void> {
+  const s = getGameState(stateDir);
+  const mark = (m: string) => (s.tui_display_mode === m ? " ✓" : "");
+  const choice = await ctx.ui.select(`[${TAG}] TUI display mode (current: ${s.tui_display_mode})`, [
+    `full${mark("full")}  — bars, stats, flair`,
+    `minimal${mark("minimal")}  — one-line level + cache %`,
+    "Back",
+  ]);
+  if (choice === undefined || choice === "Back") return;
+  const mode = choice.split(/\s+/)[0];
+  if (mode === "full" || mode === "minimal") {
+    setGameState({ tui_display_mode: mode }, stateDir);
+    runtime.bumpGameState();
+    ctx.ui.notify(`[${TAG}] tui → ${mode}`, "info");
+  }
+}
+
+/** Achievements view — terse notify list + a read-only select viewer. */
+async function achievementsView(ctx: ExtensionContext, stateDir: string): Promise<void> {
+  const rows = listAchievements(stateDir).filter((r) => r.unlocked_at != null);
+  ctx.ui.notify(`[${TAG}] achievements unlocked (${rows.length}/9):`, "info");
+  for (const r of rows) ctx.ui.notify(`  ${r.icon ?? ""} ${r.title}`, "info");
+  const lines = rows.length
+    ? rows.map((r) => `${r.icon ?? ""} ${r.title}`)
+    : ["(none unlocked yet — keep compacting!)"];
+  // select() as a read-only viewer; any selection / cancel returns to the menu.
+  await ctx.ui.select(`[${TAG}] achievements (${rows.length}/9 unlocked)`, lines);
+}
+
+/** 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.2",
   "description": "Layered, local, vector-backed context compressor for pi — supersede/collapse/cluster compaction with deduped inline recall.",
   "type": "module",
   "license": "BSD-2-Clause",