npm - pi-mega-compact - Versions diffs - 0.8.15 → 0.8.17 - Mend

pi-mega-compact 0.8.15 → 0.8.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (52) hide show

package/extensions/dashboard-client/dist/index.html CHANGED Viewed

@@ -4,7 +4,7 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>mega-compact dashboard</title>
-    <script type="module" crossorigin src="./assets/index-DMntLu-8.js"></script>
+    <script type="module" crossorigin src="./assets/index-B2JJExE9.js"></script>
     <link rel="stylesheet" crossorigin href="./assets/index-Cfxniu2R.css">
   </head>
   <body>

package/extensions/dashboard-client/src/tabs/ConfigTab.tsx CHANGED Viewed

@@ -17,7 +17,7 @@ import type React from "react";
 import { useState, useEffect, useCallback } from "react";
 import type { SnapshotResponse, GameStatePatch } from "@contracts";
 import { fetchSnapshot, fetchGameState, putGameState } from "../api/client";
-import { THEMES } from "../../../../src/config/themes";
+import { THEMES, THEME_IDS } from "../../../../src/config/themes";
 /** Actual flat game state returned by the server (the server returns a flat
  *  { game_mode_on, theme, tui_display_mode } shape, NOT the contract's nested
@@ -168,6 +168,20 @@ export default function ConfigTab(): React.ReactElement {
 								</option>
 							))}
 						</select>
+						<button
+							type="button"
+							disabled={saving}
+							className="theme-cycle-btn"
+							title="Cycle to the next theme (P3)"
+							onClick={() => {
+								const i = THEME_IDS.indexOf(themeVal);
+								const next =
+									THEME_IDS[(i < 0 ? 0 : i + 1) % THEME_IDS.length];
+								if (next) void handlePatch({ theme: next });
+							}}
+						>
+							Next theme →
+						</button>
 					</label>
 				</div>
 				<div className="settings-row">
@@ -184,7 +198,10 @@ export default function ConfigTab(): React.ReactElement {
 						>
 							<option value="full">Full</option>
 							<option value="minimal">Minimal</option>
-						</select>
+						</select>{" "}
+							<span className="tui-mode-hint">
+								(affects the in-app TUI widget; not shown here)
+							</span>
 					</label>
 				</div>
 			</section>

package/extensions/dashboard-server/html.ts CHANGED Viewed

@@ -179,8 +179,8 @@ export function dashboardHtml(tierName: string): string {
 <div class="settings-strip">
   <label title="Turn game mode on/off (themes the widget + dashboard)"><input type="checkbox" id="set-game-mode"> Game mode</label>
-  <label title="Visual theme (applies instantly)">Theme <select id="set-theme">${THEME_OPTIONS}</select></label>
-  <label title="TUI widget display density">TUI <select id="set-tui-mode"><option value="full">Full</option><option value="minimal">Minimal</option></select></label>
+  <label title="Visual theme (applies instantly)">Theme <select id="set-theme">${THEME_OPTIONS}</select> <button type="button" id="set-theme-next" title="Cycle to the next theme (P3)">Next theme →</button></label>
+  <label title="TUI widget display density">TUI <select id="set-tui-mode"><option value="full">Full</option><option value="minimal">Minimal</option></select> <span class="tui-mode-hint">(affects the in-app TUI widget; not shown here)</span></label>
 </div>
 <nav class="tabs">
@@ -872,6 +872,19 @@ export function dashboardHtml(tierName: string): string {
   }
   if (gmCheckbox) gmCheckbox.addEventListener('change', function() { putGameState({ game_mode_on: gmCheckbox.checked }); });
   if (gmTheme) gmTheme.addEventListener('change', function() { putGameState({ theme: gmTheme.value }); });
+  // P3: client-side theme cycling (no new endpoint). Reads the already-fetched
+  // <option> values from the theme select, so it stays in sync with the server's
+  // THEMES list without a second fetch.
+  var gmThemeNext = document.getElementById('set-theme-next');
+  if (gmThemeNext) gmThemeNext.addEventListener('click', function() {
+    var opts = gmTheme ? gmTheme.options : [];
+    var n = opts.length;
+    var cur = gmTheme ? gmTheme.value : 'transparent';
+    var idx = -1;
+    for (var i = 0; i < n; i++) { if (opts[i].value === cur) { idx = i; break; } }
+    var next = n > 0 ? opts[(idx < 0 ? 0 : (idx + 1) % n)].value : 'transparent';
+    putGameState({ theme: next });
+  });
   if (gmTui) gmTui.addEventListener('change', function() { putGameState({ tui_display_mode: gmTui.value }); });
   pollGameState();
   setInterval(pollGameState, 5000);

package/extensions/mega-compact-s38.test.ts CHANGED Viewed

@@ -191,6 +191,69 @@ test("S38: classifyError returns 'compaction-noop' for 'Auto compaction failed'
 	assert.equal(classifyErrorFn("Auto-compaction failed"), "compaction-noop");
 });
+// ---- context-overflow classifier (S38.8: 400 "too long... even after compaction") ----
+test("S38: classifyError returns 'context-overflow' for the literal user 400 string", () => {
+	assert.equal(
+		classifyErrorFn("Your conversation is too long for this model's context window even after compaction. Reduce the conversation length or enable/allow compaction."),
+		"context-overflow",
+	);
+});
+test("S38: classifyError returns 'context-overflow' for 'All targets failed' wrapper", () => {
+	assert.equal(
+		classifyErrorFn("All targets failed: ... Last error: ... too long ... context window even after compaction"),
+		"context-overflow",
+	);
+});
+test("S38: classifyError returns 'context-overflow' for invalid_request_error JSON shape", () => {
+	assert.equal(
+		classifyErrorFn('{"type":"invalid_request_error","message":"... too long for context window ..."}'),
+		"context-overflow",
+	);
+});
+test("S38: classifyError returns 'context-overflow' for OpenRouter 'All targets failed' max-context 400 (FAIL-20260725)", () => {
+	// Regression: the OpenAI/OpenRouter provider-side phrasing
+	// "maximum context length is N tokens ... requires at least M tokens ...
+	// reduce your input or max_tokens" does NOT contain "too long" / "context
+	// window" / "reduce the conversation", so it slipped past the original S38.8
+	// regex and fell through to the generic transient branch, firing 5 blind
+	// retry nudges that re-submitted the same oversized prompt -> re-400 ->
+	// busy-loop. The exact user-facing wrapper string from the router:
+	assert.equal(
+		classifyErrorFn('Error: 400: {"message":"All targets failed: neuralwatt/glm-5.2-short. Last error: This model\'s maximum context length is 200000 tokens. Your request requires at least 201070 tokens (201070 prompt + 0 max_tokens). Please reduce your input or max_tokens.","type":"invalid_request_error"}'),
+		"context-overflow",
+	);
+});
+test("S38: classifyError returns 'context-overflow' for bare 'maximum context length' phrasing", () => {
+	assert.equal(
+		classifyErrorFn("This model's maximum context length is 128000 tokens. Your request requires at least 130000 tokens. Please reduce your input or max_tokens."),
+		"context-overflow",
+	);
+});
+test("S38: classifyError returns 'context-overflow' for 'context length exceeded' phrasing", () => {
+	assert.equal(
+		classifyErrorFn("This model's context length exceeded: 200000 tokens"),
+		"context-overflow",
+	);
+});
+test("S38: context-overflow fires NO blind retry nudge and logs 'context_overflow'", async () => {
+	const h = harness();
+	await s38TurnEnd(
+		h,
+		"error",
+		"Your conversation is too long for this model's context window even after compaction. Reduce the conversation length or enable/allow compaction.",
+	);
+	const ev = eventTypes(h.stateDir);
+	assert.equal(h.sendUserMessages.length, 0, "context-overflow: NO blind retry nudge fired");
+	assert.ok(ev.includes("context_overflow"), "context-overflow: 'context_overflow' event logged");
+});
 // ---- integration tests (fire turn_end through the real extension) ----
 test("S38: compaction-noop logs 'compaction_noop_diagnostic' + resets counter + no retry fired", async () => {

package/extensions/mega-events/agent-handlers.ts CHANGED Viewed

@@ -19,6 +19,7 @@ import { evaluateAndUnlockAchievements } from "../../src/store/sqlite/game-achie
 import { isMegaCache } from "../../src/game/scoring.js";
 import { resolveRepoRoot } from "../mega-config.js";
 import { classifyError } from "./error-classifier.js";
+import { safeSendUserMessage } from "./send-safe.js";
 /** Register agent/turn tracking event handlers. */
 export function registerAgentHandlers(
@@ -215,7 +216,7 @@ export function registerAgentHandlers(
 					const nudgeMsg = lengthStop && !didDurableTrim
 						? "[mega-compact] the last response hit the output-token cap; continue from where it stopped."
 						: "[mega-compact] continue from the compacted context above.";
-					pi.sendUserMessage(nudgeMsg);
+					await safeSendUserMessage(pi, nudgeMsg);
 				}
 			} catch {
 				/* non-fatal: a failed nudge never blocks */
@@ -346,6 +347,48 @@ export function registerAgentHandlers(
 						sessionId: runtime.rt.sessionId,
 						turnIndex: event.turnIndex,
 					});
+				} else if (category === 'context-overflow') {
+					// (4b) context-window overflow 400 ("too long... even after compaction").
+					// NOT a blind retry: re-submitting the same oversized prompt would just
+					// re-400 and busy-loop. Reset the counters (this turn is terminal, not
+					// retryable in the S38 sense) and force ONE best-effort re-compact with
+					// the debounce bypassed + the same race-guard (lastNativeCompactAt
+					// cooldown + deferred setTimeout re-check) as the agent_end durable
+					// trim. Resume after that forced compact is handled by the existing
+					// nudgeResume() inside session_before_compact (it fires after
+					// driveNativeCompaction supplies the compaction) — do NOT add a
+					// separate nudge here.
+					runtime.rt.errorRetryCount = 0;
+					runtime.rt.consecutiveErrors = 0;
+					runtime.dashboard.event('context_overflow', {
+						turnIndex: event.turnIndex,
+						sessionId: runtime.rt.sessionId,
+					});
+					runtime.logger.warn('context-overflow', {
+						sessionId: runtime.rt.sessionId,
+						turnIndex: event.turnIndex,
+					});
+					if (config.auto) {
+						const now2 = Date.now();
+						const cooldownMs2 = config.raceGuardStrict ? 30_000 : 10_000;
+						const sinceCompact2 = now2 - (runtime.rt.lastNativeCompactAt ?? 0);
+						if (sinceCompact2 >= cooldownMs2 && !piCompactWouldNoop(ctx)) {
+							runtime.debounceUntil = now2 + 0;
+							const stamp2 = runtime.rt.lastNativeCompactAt;
+							const liveSid2 = runtime.rt.sessionId;
+							setTimeout(() => {
+								try {
+									if (runtime.rt.sessionId !== liveSid2) return; // session reset
+									const since3 = Date.now() - (runtime.rt.lastNativeCompactAt ?? 0);
+									if (runtime.rt.lastNativeCompactAt !== stamp2 && since3 < cooldownMs2) return;
+									if (piCompactWouldNoop(ctx)) return;
+									ctx.compact({ customInstructions: undefined }); // guardrails-allow PREVENT-PI-004: local ctx.compact() — no network; deferred + re-validated. Forced re-compact after a context-overflow 400.
+								} catch {
+									/* non-fatal */
+								}
+							}, 500);
+						}
+					}
 				} else {
 					// (5) transient or permanent — retry with exponential backoff.
 					// S38.7: hard-stop switch — bypass ALL retry logic when set.
@@ -421,8 +464,9 @@ export function registerAgentHandlers(
 									count: runtime.rt.errorRetryCount,
 									max,
 								});
-								// PREVENT-PI-003: user-role sendUserMessage only.
-								pi.sendUserMessage(
+								// PREVENT-PI-003: user-role sendUserMessage only (queued + catch-guarded).
+								await safeSendUserMessage(
+									pi,
 									'[mega-compact] the last turn ended with an error; please retry.',
 								);
 							}

package/extensions/mega-events/compact-handlers.ts CHANGED Viewed

@@ -22,6 +22,7 @@ import type { MegaConfig } from "../mega-config.js";
 import { recordScore, getDedupStats } from "../../src/store/sqlite.js";
 import { evaluateAndUnlockAchievements } from "../../src/store/sqlite/game-achievements.js";
 import { resolveRepoRoot } from "../mega-config.js";
+import { safeSendUserMessage } from "./send-safe.js";
 /**
  * Build a minimal fallback compaction so pi never runs its throwing compact().
@@ -57,13 +58,19 @@ function fallbackCompaction(
 /**
  * Debounced resume-nudge: restart the agent loop after a compaction (which
  * may have stopped it). Idempotent — one nudge per 30s, never blocks.
+ *
+ * Uses safeSendUserMessage ({ deliverAs: 'followUp' } + catch-guard) so that a
+ * nudge fired during session_before_compact (which is mid-prompt-submission,
+ * so the agent can be busy) QUEUES instead of throwing
+ * "Agent is already processing. Specify streamingBehavior (steer or followUp)".
  */
-function nudgeResume(pi: ExtensionAPI, runtime: MegaRuntime): void {
+async function nudgeResume(pi: ExtensionAPI, runtime: MegaRuntime): Promise<void> {
 	try {
 		const now = Date.now();
 		if (now >= runtime.resumeNudgeUntil) {
 			runtime.resumeNudgeUntil = now + 30_000;
-			pi.sendUserMessage(
+			await safeSendUserMessage(
+				pi,
 				"[mega-compact] continue from the compacted context above.",
 			);
 		}
@@ -113,7 +120,7 @@ export function registerCompactHandlers(
 						tokensBefore: result.compaction.tokensBefore,
 						summaryTokens: result.compaction.estimatedTokensAfter,
 					});
-					nudgeResume(pi, runtime);
+					await nudgeResume(pi, runtime);
 					return { compaction: result.compaction };
 				}
 				// FIX "compacts but doesn't resume" + "Nothing to compact" regression:
@@ -134,7 +141,7 @@ export function registerCompactHandlers(
 						tokensBefore: fb.compaction.tokensBefore,
 						reason: event.reason,
 					});
-					nudgeResume(pi, runtime);
+					await nudgeResume(pi, runtime);
 					return { compaction: fb.compaction };
 				}
 			} catch (err) {

package/extensions/mega-events/error-classifier.ts CHANGED Viewed

@@ -12,12 +12,13 @@
  * exclusively (its agent_end nudge path is separate and must not be doubled).
  *
  * @param message  the event.message (a pi AgentMessage) or an error string
- * @returns 'transient' | 'permanent' | 'compaction-noop' | null (success/unknown)
+ * @returns 'transient' | 'permanent' | 'compaction-noop' | 'context-overflow' | null (success/unknown)
  */
 export function classifyError(message: unknown):
 	| 'transient'
 	| 'permanent'
 	| 'compaction-noop'
+	| 'context-overflow'
 	| null {
 	// Resolve a searchable text blob from a pi AgentMessage or raw string.
 	let text = '';
@@ -81,6 +82,29 @@ export function classifyError(message: unknown):
 	if (/compaction failed/.test(s)) return 'compaction-noop';
 	if (/nothing to compact/.test(s)) return 'compaction-noop';
 	if (/auto[\s-]?compaction failed/.test(s)) return 'compaction-noop';
+	// --- context-overflow (ORDER BEFORE generic transient!) ---
+	// A 400 from the model meaning "the prompt is bigger than the context window."
+	// Catches BOTH provider phrasings so the classification does not depend on
+	// which backend the router landed on:
+	//   - pi/Anthropic wrapper: "too long for this model's context window even
+	//     after compaction. Reduce the conversation length..." ->
+	//     too long | context window | even after compaction | reduce the conversation
+	//   - OpenAI/OpenRouter provider-side (often wrapped in "All targets failed:
+	//     <model>. Last error: ..."): "This model's maximum context length is N
+	//     tokens. Your request requires at least M tokens. Please reduce your
+	//     input or max_tokens." -> maximum context length | context length
+	//     exceeded | requires at least N tokens | reduce your input
+	// All of these carry `invalid_request_error` (UNDERSCORE, not 'invalid
+	// request' space) and would otherwise fall through to the generic
+	// `s.includes('error')` transient branch below, misclassifying as
+	// 'transient' and firing up to 5 blind retry nudges that re-submit the same
+	// oversized prompt -> re-400 -> busy-loop. 'context-overflow' instead forces
+	// ONE deferred re-compact (debounce-bypassed, race-guarded) and fires NO
+	// blind retry nudge. The forced re-compact is shaped by the existing
+	// session_before_compact durable trim (it cannot lower pi's firstKeptEntryId).
+	if (/too long|context window|maximum context length|context length exceeded|requires at least \d+ tokens|even after compaction|reduce the conversation|reduce your input/.test(s)) {
+		return 'context-overflow';
+	}
 	// --- transient (retryable) ---
 	if (s.includes('error') && !/\b(permanent|invalid request|malformed|bad request|auth|unauthorized|invalid (api )?key|permission)\b/.test(s)) {
 		return 'transient'; // generic pi stopReason 'error' / 'aborted'

package/extensions/mega-events/send-safe.ts ADDED Viewed

@@ -0,0 +1,37 @@
+/**
+ * send-safe.ts — queue-safe wrapper for pi.sendUserMessage.
+ *
+ * All extension-initiated user-role nudges (resume after compaction, length-stop
+ * continue, error-retry) MUST go through this wrapper. It:
+ *   1. Passes { deliverAs: 'followUp' } so that when the agent is busy (e.g. a
+ *      resume nudge fired during session_before_compact, which is mid-prompt
+ *      submission) pi QUEUES the message instead of throwing
+ *      "Agent is already processing. Specify streamingBehavior (steer or
+ *      followUp) to queue the message" (pi agent-session.js:830).
+ *   2. Awaits the call and catch-guards it so a failed/queued nudge never throws
+ *      or produces an unhandled rejection — it must never block the agent loop.
+ *
+ * PREVENT-PI-003: user-role sendUserMessage only (no role:'system' injection).
+ * PREVENT-PI-004: local pi ctx call, no network.
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+/**
+ * safeSendUserMessage — await + catch-guard + queue-safe wrapper for
+ * pi.sendUserMessage. Never throws; never produces an unhandled rejection.
+ */
+export async function safeSendUserMessage(
+	pi: ExtensionAPI,
+	content: string,
+): Promise<void> {
+	try {
+		await (
+			pi.sendUserMessage as (
+				c: string,
+				o?: { deliverAs?: "steer" | "followUp" },
+			) => Promise<void> | void
+		)(content, { deliverAs: "followUp" });
+	} catch {
+		/* non-fatal: a failed/queued nudge never blocks the agent loop */
+	}
+}

package/extensions/mega-events.ts CHANGED Viewed

@@ -17,3 +17,4 @@ export * from "./mega-events/context-handler.js";
 export * from "./mega-events/compact-handlers.js";
 export * from "./mega-events/perf-handler.js";
 export * from "./mega-events/error-classifier.js";
+export * from "./mega-events/send-safe.js";

package/extensions/mega-runtime/state.test.ts CHANGED Viewed

@@ -116,6 +116,39 @@ describe("MegaRuntime setEffect lifecycle (v0.8.3)", () => {
 	});
 });
+describe("MegaRuntime pushTicker dedupe (P1)", () => {
+  const dirs: string[] = [];
+  after(() => {
+    for (const d of dirs) {
+      try { closeStore(d); } catch { /* */ }
+    }
+    delete process.env.MEGACOMPACT_STATE_DIR;
+    for (const d of dirs) rmSync(d, { recursive: true, force: true });
+  });
+  it("pushTicker skips consecutive identical entries (keeps ring at capacity for variety)", () => {
+    const dir = freshDir(); dirs.push(dir);
+    process.env.MEGACOMPACT_STATE_DIR = dir;
+    const rt = new MegaRuntime(minimalConfig(dir));
+    rt.pushTicker("compact");
+    rt.pushTicker("compact"); // dedup — skipped
+    rt.pushTicker("compact"); // dedup — skipped
+    rt.pushTicker("recall");
+    assert.equal(rt.ticker.length, 2, "only 2 unique entries kept");
+    assert.equal(rt.ticker[0].text, "compact");
+    assert.equal(rt.ticker[1].text, "recall");
+  });
+  it("pushTicker keeps distinct entries and respects TICKER_MAX", () => {
+    const dir = freshDir(); dirs.push(dir);
+    process.env.MEGACOMPACT_STATE_DIR = dir;
+    const rt = new MegaRuntime(minimalConfig(dir));
+    for (let i = 0; i < rt.TICKER_MAX + 3; i++) rt.pushTicker(`t${i}`);
+    assert.equal(rt.ticker.length, rt.TICKER_MAX, "capped at TICKER_MAX");
+    assert.equal(rt.ticker[rt.TICKER_MAX - 1].text, `t${rt.TICKER_MAX + 2}`);
+  });
+});
 describe("MegaRuntime game-state cache (S31)", () => {
 	const dirs: string[] = [];
 	after(() => {

package/extensions/mega-runtime/state.ts CHANGED Viewed

@@ -213,6 +213,11 @@ export class MegaRuntime {
 	// getCachedGameState() snapshot re-queries the DB anyway.
 	private gameStateWatcher?: FSWatcher;
 	private gameStateWatchDir?: string;
+	// P2: the last ExtensionContext handed to snapshot()/renderWidget(), stashed
+	// so the fs.watch game-state callback can force a widget re-render without
+	// a context event (cross-process dashboard edits while pi is idle). Cleared
+	// implicitly on construction (undefined → watcher skips until first snap).
+	private lastWidgetCtx?: ExtensionContext;
 	/**
 	 * DIAG counters for the "team run doesn't relieve context" investigation.
@@ -379,6 +384,7 @@ export class MegaRuntime {
 	/** Collect live state and write it to disk (+ paint the above-editor widget). */
 	snapshot(ctx?: ExtensionContext): void {
+		if (ctx) this.lastWidgetCtx = ctx;
 		if (ctx) this.bindRepo(ctx.cwd);
 		// v0.8.5: gate the expensive body (6 sync SQLite opens +
 		// writeFileSync(dashboard.json)) behind a cheap material-change signature.
@@ -999,6 +1005,29 @@ export class MegaRuntime {
 					if (typeof filename === "string" && filename.startsWith("sqlite.db")) {
 						this.cachedGameState = undefined;
 						this.gameStateBump++;
+						// P2: force a widget re-render so a dashboard-made theme/toggle/
+						// tui-mode change reflects in the live TUI immediately, even when
+						// pi is idle (no context event to drive snapshot()). Use the
+						// LIGHTWEIGHT refreshWidgetGameState() — NOT the full snapshot():
+						// snapshot() recomputes 6 sync SQLite opens + writes dashboard.json
+						// + writes to the store, and those store writes RETRIGGER this
+						// same fs.watch callback (it fires on every sqlite.db* write) →
+						// re-entrant thrash → 190s test timeout under mega-compact.test.js
+						// / mega-teamrun.test.js. The lightweight path re-reads ONLY the
+						// game_state row and patches the three game-mode fields on the
+						// existing widgetData, then re-registers the factory via
+						// renderWidget() — it writes nothing to the store or
+						// dashboard.json, so it cannot retrigger itself. Guard: skip until
+						// the first snapshot stashed a ctx (no widget registered yet →
+						// nothing to refresh). Non-fatal: next context event re-snapshots.
+						const ctx = this.lastWidgetCtx;
+						if (ctx) {
+							try {
+								this.refreshWidgetGameState(ctx);
+							} catch {
+								/* non-fatal */
+							}
+						}
 					}
 				},
 			);
@@ -1076,6 +1105,33 @@ export class MegaRuntime {
 		return this.cachedGameState;
 	}
+	/** P2 cross-process re-render: lightweight game-state refresh for the
+	 *  fs.watch callback. Eviction of cachedGameState + gameStateBump++ happens
+	 *  in the caller BEFORE this runs. Here we re-read ONLY the game_state row
+	 *  via getCachedGameState() (one SELECT; the cache is already evicted) and
+	 *  patch ONLY the three game-mode fields on the EXISTING widgetData, then
+	 *  re-register the widget factory via renderWidget() so pi redraws next
+	 *  frame.
+	 *
+	 *  WHY a lightweight path: the full snapshot(ctx) recomputes 6 synchronous
+	 *  SQLite opens + writeFileSync(dashboard.json) + store writes, and those
+	 *  store writes RETRIGGER this same fs.watch callback → re-entrant thrash
+	 *  (the watcher fires on every sqlite.db* write, including context-event
+	 *  checkpoint writes) → 190s test timeout under mega-compact.test.js /
+	 *  mega-teamrun.test.js. This path writes NOTHING to the store or
+	 *  dashboard.json, so it cannot retrigger itself.
+	 *
+	 *  Guard: no-op when widgetData is null (no snapshot has run yet → nothing
+	 *  to patch) or ctx is undefined. Field values mirror snapshot() exactly. */
+	refreshWidgetGameState(ctx: ExtensionContext): void {
+		if (!this.widgetData || !ctx) return;
+		const gs = this.getCachedGameState();
+		this.widgetData.gameMode = gs.game_mode_on;
+		this.widgetData.theme = getTheme(gs.theme) ? gs.theme : "transparent";
+		this.widgetData.tuiMode = gs.tui_display_mode;
+		this.renderWidget(ctx);
+	}
 	/** S31: evict the cached game-mode state so the next widget render re-reads
 	 *  the game_state row. Called by /mega-game after every setGameState() so
 	 *  the panel picks up theme/mode/toggle changes live. */
@@ -1164,6 +1220,14 @@ export class MegaRuntime {
 	// Phase 3 — recall/activity ticker ring buffer.
 	pushTicker(text: string): void {
+		// P1: dedupe consecutive identical entries — skip the append when the
+		// last entry's text matches, so a re-fired compact/recall/dedup event
+		// doesn't flood the ring (keeps it at TICKER_MAX for real variety).
+		// `at` is NOT refreshed on a skip (the original event time stands).
+		if (this.ticker[this.ticker.length - 1]?.text === text) {
+			this.lastActivityAt = Date.now();
+			return;
+		}
 		this.ticker.push({ text, at: Date.now() });
 		while (this.ticker.length > this.TICKER_MAX) this.ticker.shift();
 		this.lastActivityAt = Date.now();

package/extensions/mega-runtime/widget.test.ts CHANGED Viewed

@@ -212,6 +212,54 @@ describe("buildWidgetLines ambient border effect (v0.8.3)", () => {
   });
 });
+describe("buildWidgetLines footer stability (P1 — no 250ms rotation)", () => {
+  // P1: the L5 ticker branch used to re-pick the head text every 250ms via
+  // `step = floor(Date.now()/250)`, flipping the footer line on a 250·N ms
+  // cycle. After the fix it pins to the most-recent entry, so two renders of
+  // the SAME WidgetData at t and t+500ms (well past one rotation slot) must
+  // produce byte-identical footer lines. Proves the metronome is gone.
+  const stabBase = (overrides: Partial<WidgetData> = {}): WidgetData => baseWd({
+    theme: DEFAULT_THEME, tuiMode: "full", gameMode: false, level: 1, cachePct: 42, ...overrides,
+  });
+  it("ticker footer is byte-identical across simulated frames 500ms apart", () => {
+    const wd = stabBase({
+      ticker: [
+        { text: "first", at: 1000 },
+        { text: "second", at: 2000 },
+        { text: "third", at: 3000 },
+      ],
+      lastWhy: "because",
+    });
+    const realNow = Date.now;
+    try {
+      Date.now = () => 1_000_000; // t
+      const a = buildWidgetLines(wd, WIDTH, 0);
+      Date.now = () => 1_000_500; // t+500ms (would have rotated twice under the old code)
+      const b = buildWidgetLines(wd, WIDTH, 0);
+      assert.deepEqual(a, b, "footer byte-identical across 500ms with no state change");
+      // And the pinned head is the most-recent entry (third), not a rotation:
+      assert.ok(a.some((l) => l.includes("third")), "shows most-recent ticker entry");
+      assert.ok(a.some((l) => l.includes("(+2 more)")), "(+N more) suffix preserved");
+      assert.ok(a.some((l) => l.includes("because")), "lastWhy preserved");
+    } finally {
+      Date.now = realNow;
+    }
+  });
+  it("footer still flips when the ticker actually changes (new pushTicker)", () => {
+    const realNow = Date.now;
+    try {
+      Date.now = () => 1_000_000;
+      const before = buildWidgetLines(stabBase({ ticker: [{ text: "a", at: 1 }] }), WIDTH, 0);
+      const after = buildWidgetLines(stabBase({ ticker: [{ text: "a", at: 1 }, { text: "b", at: 2 }] }), WIDTH, 0);
+      assert.notDeepEqual(before, after, "footer changes when ticker grows");
+    } finally {
+      Date.now = realNow;
+    }
+  });
+});
 describe("buildWidgetLines achievement flare (S35)", () => {
   const achBase = (overrides: Partial<WidgetData> = {}): WidgetData => baseWd({
     theme: DEFAULT_THEME, tuiMode: "full", gameMode: true, level: 1, cachePct: 42, ...overrides,

package/extensions/mega-runtime/widget.ts CHANGED Viewed

@@ -388,8 +388,12 @@ export function buildWidgetLines(
 	if (wd.tierTrace && wd.fresh) {
 		lines.push(panelLine(`   ${pulse}${wd.tierTrace}`, width, panelBg));
 	} else if (wd.ticker.length > 0) {
-		const step = Math.floor(Date.now() / 250);
-		const idx = wd.ticker.length - 1 - (step % wd.ticker.length);
+		// P1: pin to the most-recent entry (no 250ms rotation). The old
+		// `step = floor(Date.now()/250)` re-picked the head every TUI frame,
+		// flipping the footer line on a 250·N ms cycle. Pinning makes the
+		// footer hold stable until a real state change (new pushTicker /
+		// tierTrace / pulsing transition). (+N more) + lastWhy are preserved.
+		const idx = wd.ticker.length - 1;
 		const head = wd.ticker[idx].text;
 		const why = wd.lastWhy ? ` ${C.gray}· ${wd.lastWhy}${C.reset}` : "";
 		const more =

package/package.json CHANGED Viewed

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

package/extensions/dashboard-client/dist/assets/ConfigTab-C3g3smRL.js DELETED Viewed

	@@ -1,2 +0,0 @@
1	- import{r as i,p as j,j as e,b as N,c as w}from"./index-DMntLu-8.js";const u=[{id:"transparent",label:"Transparent (accents only)",css:{bg:null,fg:"#c9d1d9",accent:"#3fb950",mega:"#f0883e"},ansi:{bg:null,fg:"39",accent:"32",mega:"33"}},{id:"retro",label:"Retro 8-bit green",css:{bg:"#003300",fg:"#33ff33",accent:"#00ff41",mega:"#39ff14"},ansi:{bg:"40",fg:"92",accent:"92",mega:"1;92"}},{id:"orange-bold",label:"Orange bold",css:{bg:"#1a0f00",fg:"#ff8c00",accent:"#ff6b00",mega:"#ff4500"},ansi:{bg:"48;5;52",fg:"38;5;208",accent:"38;5;208",mega:"1;38;5;202"}},{id:"cyan-neon",label:"Cyan neon",css:{bg:"#001a1a",fg:"#00ffff",accent:"#22d3ee",mega:"#7df9ff"},ansi:{bg:"48;5;23",fg:"38;5;51",accent:"38;5;51",mega:"1;38;5;51"}},{id:"amber-mono",label:"Amber phosphor",css:{bg:"#1a1200",fg:"#ffb000",accent:"#ff8c00",mega:"#ff5500"},ansi:{bg:"48;5;58",fg:"38;5;214",accent:"38;5;214",mega:"1;38;5;208"}},{id:"grayscale",label:"Grayscale minimal",css:{bg:"#161616",fg:"#b0b0b0",accent:"#8b949e",mega:"#e6edf3"},ansi:{bg:"48;5;235",fg:"38;5;249",accent:"38;5;249",mega:"1;38;5;255"}}];u.map(a=>a.id);const c={gameMode:"Turn game mode on/off (themes the widget + dashboard)",theme:"Visual theme (applies instantly)",tuiMode:"TUI widget display density",tier:"Live pressure band — climbs low→mega as context fills the window.",preset:"The env-resolved base compaction preset (low/medium/high/ultra/mega) that set the token threshold.",pressure:"Live pressure = currentTokens / threshold — % of the model context window (threshold fires at the tier's % of window).",threshold:"Compaction threshold = tierPct × model context window — mega-compact trims BELOW pi's native ~80% auto-compact for any model size.",fastGate:"Fast-gate arming floor — the live trim arms once context passes this % of the window."};function y(a,d,l){let o=a.toLocaleString();return d!=null&&l>0&&(o+=` (${Math.round(d100)}% of ${l.toLocaleString()})`),o}function T(a){return`${Math.round((a\|\|0)100)}%`}function M(){const[a,d]=i.useState(null),[l,o]=i.useState(null),[m,g]=i.useState(!1);i.useEffect(()=>{let s=!0;const t=async()=>{try{const r=await N();s&&d(r)}catch{}};t();const f=setInterval(()=>void t(),5e3);return()=>{s=!1,clearInterval(f)}},[]),i.useEffect(()=>{let s=!0;const t=async()=>{try{const r=await w();s&&(o(r),r.theme&&(document.documentElement.dataset.theme=r.theme))}catch{}};t();const f=setInterval(()=>void t(),5e3);return()=>{s=!1,clearInterval(f)}},[]);const h=i.useCallback(async s=>{g(!0);try{const t=await j(s);o(t),t.theme&&(document.documentElement.dataset.theme=t.theme)}catch{}g(!1)},[]),p=l?.game_mode_on??!1,b=l?.theme??"transparent",x=l?.tui_display_mode??"full",n=a?.config,v=a?.context.contextWindow??0;return e.jsxs("div",{className:"config-tab",children:[e.jsxs("section",{className:"config-settings",children:[e.jsx("h3",{children:"Settings"}),e.jsx("div",{className:"settings-row",children:e.jsxs("label",{title:c.gameMode,children:[e.jsx("input",{type:"checkbox",checked:p,onChange:s=>h({game_mode_on:s.currentTarget.checked}),disabled:m}),"Game Mode"]})}),e.jsx("div",{className:"settings-row",children:e.jsxs("label",{title:c.theme,children:["Theme",e.jsx("select",{value:b,onChange:s=>h({theme:s.currentTarget.value}),disabled:m,children:u.map(s=>e.jsx("option",{value:s.id,children:s.label},s.id))})]})}),e.jsx("div",{className:"settings-row",children:e.jsxs("label",{title:c.tuiMode,children:["TUI Mode",e.jsxs("select",{value:x,onChange:s=>h({tui_display_mode:s.currentTarget.value}),disabled:m,children:[e.jsx("option",{value:"full",children:"Full"}),e.jsx("option",{value:"minimal",children:"Minimal"})]})]})})]}),e.jsxs("section",{className:"config-display",children:[e.jsx("h3",{children:"Configuration"}),e.jsxs("div",{className:"config-grid",children:[e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",title:c.tier,children:"Tier"}),e.jsx("span",{className:"config-value",children:a?`${a.tier} (live)`:"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",title:c.preset,children:"Preset"}),e.jsx("span",{className:"config-value",children:a?.presetTier??"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",title:c.pressure,children:"Pressure"}),e.jsx("span",{className:"config-value",children:a?T(a.pressure):"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",title:c.threshold,children:"Threshold"}),e.jsx("span",{className:"config-value",children:n?y(n.thresholdTokens,n.tierPct,v):"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",title:c.fastGate,children:"Fast Gate"}),e.jsx("span",{className:"config-value",children:n?`${n.fastGatePct}%`:"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",children:"Auto"}),e.jsx("span",{className:"config-value",children:n?n.auto?"enabled":"disabled":"—"})]}),e.jsxs("div",{className:"config-item",children:[e.jsx("span",{className:"config-label",children:"Anchor"}),e.jsx("span",{className:"config-value",children:n?.anchorUserMessages??"—"})]})]})]})]})}export{M as default};
2	- //# sourceMappingURL=ConfigTab-C3g3smRL.js.map