pi-mega-compact 0.8.1 → 0.8.2

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

@@ -496,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 }));
@@ -510,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-game-cmds.js

@@ -40,8 +40,20 @@ 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.
+    // 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);
@@ -105,6 +117,97 @@ async function handleSettings(args, ctx, runtime) {
     }
     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]";

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) => {
@@ -63,6 +63,35 @@ describe("/mega-compact-settings (S30; /mega-game alias)", () => {
         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/extensions/dashboard-server/server.ts

@@ -470,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 }));
@@ -481,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-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) => {
@@ -80,6 +83,38 @@ describe("/mega-compact-settings (S30; /mega-game alias)", () => {
     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

@@ -55,8 +55,19 @@ async function handleSettings(
   const stateDir = runtime.currentStateDir;
   const parts = args.trim().split(/\s+/).filter(Boolean);
 
-  // bare  → print current state.
+  // 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;
@@ -126,6 +137,111 @@ async function handleSettings(
   );
 }
 
+/** 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 =

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-mega-compact",
-  "version": "0.8.1",
+  "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",