@mrclrchtr/supi-cache 1.12.1 → 1.13.0

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {
@@ -44,6 +44,7 @@
     "./config": "./src/config.ts",
     "./context": "./src/context.ts",
     "./debug": "./src/debug-registry.ts",
+    "./footer-registry": "./src/footer-registry.ts",
     "./llm": "./src/llm.ts",
     "./package.json": "./package.json",
     "./path": "./src/path.ts",

package/node_modules/@mrclrchtr/supi-core/src/api.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./llm.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";

package/node_modules/@mrclrchtr/supi-core/src/footer-registry.ts

@@ -0,0 +1,57 @@
+// Shared footer contribution registry for SuPi extensions.
+//
+// Extensions register pre-styled text chunks with a placement hint
+// ("stats" for the metrics line, "status" for the extension status line).
+// The custom footer in supi-extras (or PI's built-in footer) reads these
+// contributions and renders them alongside the built-in metrics.
+
+import { createRegistry } from "./registry-utils.ts";
+
+/** Where the contribution should appear in the footer. */
+export type FooterPlacement = "stats" | "status";
+
+/** A single footer contribution registered by an extension. */
+export interface FooterContribution {
+  /** Unique key for this contribution. Re-registering with the same key replaces it. */
+  key: string;
+  /** Which footer line this belongs on. */
+  placement: FooterPlacement;
+  /**
+   * Sort order within the placement (lower values render further left). Default: 100.
+   * Priority 0 is reserved for the turn cache-hit part so it stays adjacent to CH.
+   */
+  priority?: number;
+  /** Return the pre-styled text for this contribution. Called on every render. */
+  render: () => string;
+}
+
+const registry = createRegistry<FooterContribution>("footer-contributions");
+
+function sortByPriority(a: FooterContribution, b: FooterContribution): number {
+  return (a.priority ?? 100) - (b.priority ?? 100);
+}
+
+export const footerContributions = {
+  /** Register or replace a footer contribution. */
+  register(contribution: FooterContribution): void {
+    registry.register(contribution.key, contribution);
+  },
+
+  /** Remove a contribution (e.g. on session_shutdown or when disabled). */
+  unregister(key: string): void {
+    registry.unregister(key);
+  },
+
+  /** Get contributions for a specific placement, sorted by priority. */
+  getByPlacement(placement: FooterPlacement): FooterContribution[] {
+    return registry
+      .getAll()
+      .filter((c) => c.placement === placement)
+      .sort(sortByPriority);
+  },
+
+  /** Remove all contributions (primarily for tests). */
+  clear(): void {
+    registry.clear();
+  },
+};

package/node_modules/@mrclrchtr/supi-core/src/index.ts

@@ -13,6 +13,8 @@ export * from "./context.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./debug-registry.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
+export * from "./footer-registry.ts";
+// biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./path.ts";
 // biome-ignore lint/performance/noReExportAll: intentional convenience barrel
 export * from "./project.ts";

package/node_modules/@mrclrchtr/supi-core/src/registry-utils.ts

@@ -27,7 +27,7 @@ function getGlobalRegistryMap<T>(name: string): Map<string, T> {
  *
  * @typeParam T - The value type stored in the registry.
  * @param name - Unique registry name (used to construct the `Symbol.for` key).
- * @returns An object with `register`, `getAll`, and `clear` functions.
+ * @returns An object with `register`, `unregister`, `getAll`, and `clear` functions.
  */
 export function createRegistry<T>(name: string) {
   const getMap = (): Map<string, T> => getGlobalRegistryMap<T>(name);
@@ -40,6 +40,13 @@ export function createRegistry<T>(name: string) {
       getMap().set(id, value);
     },
 
+    /**
+     * Remove a registration by id. No-op if not registered.
+     */
+    unregister: (id: string): void => {
+      getMap().delete(id);
+    },
+
     /**
      * Get all registered values in registration order.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-cache",
-  "version": "1.12.1",
+  "version": "1.13.0",
   "description": "SuPi Cache — prompt cache health monitoring and cross-session forensics",
   "license": "MIT",
   "repository": {
@@ -20,7 +20,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@mrclrchtr/supi-core": "1.12.1"
+    "@mrclrchtr/supi-core": "1.13.0"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/src/monitor/monitor.ts

@@ -6,6 +6,7 @@
 import { StringEnum } from "@earendil-works/pi-ai";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { Container, Spacer, Text } from "@earendil-works/pi-tui";
+import { footerContributions } from "@mrclrchtr/supi-core/footer-registry";
 import { Type } from "typebox";
 import { loadCacheMonitorConfig } from "../config.ts";
 import { computePromptFingerprint, diffFingerprints, zeroFingerprint } from "../fingerprint.ts";
@@ -44,6 +45,22 @@ export default function cacheMonitorExtension(pi: ExtensionAPI) {
     return loadCacheMonitorConfig(ctx.cwd).regressionThreshold;
   }
 
+  // ── Helpers ──────────────────────────────────────────────
+
+  function updateFooterStatus(): void {
+    const statusText = formatCacheStatus(state);
+    if (statusText) {
+      footerContributions.register({
+        key: STATUS_KEY,
+        placement: "stats",
+        priority: 0,
+        render: () => statusText,
+      });
+    } else {
+      footerContributions.unregister(STATUS_KEY);
+    }
+  }
+
   // ── message_end: record turn + update status + check regression
 
   pi.on("message_end", async (event, ctx) => {
@@ -59,9 +76,8 @@ export default function cacheMonitorExtension(pi: ExtensionAPI) {
     // Persist turn record
     pi.appendEntry(ENTRY_TYPE, record);
 
-    // Update footer status
-    const statusText = formatCacheStatus(state);
-    ctx.ui.setStatus(STATUS_KEY, statusText);
+    // Update footer contribution
+    updateFooterStatus();
 
     // Check regression
     const regression = state.detectRegression(getThreshold(ctx));
@@ -106,22 +122,21 @@ export default function cacheMonitorExtension(pi: ExtensionAPI) {
     state.reset();
 
     if (!isEnabled(ctx)) {
-      ctx.ui.setStatus(STATUS_KEY, undefined);
+      footerContributions.unregister(STATUS_KEY);
       return;
     }
 
     const branch = ctx.sessionManager.getBranch();
     state.restoreFromEntries(branch);
 
-    const statusText = formatCacheStatus(state);
-    ctx.ui.setStatus(STATUS_KEY, statusText);
+    updateFooterStatus();
   });
 
   // ── session_shutdown: clear state ─────────────────────────
 
-  pi.on("session_shutdown", async (_event, ctx) => {
+  pi.on("session_shutdown", async (_event, _ctx) => {
     state.reset();
-    ctx.ui.setStatus(STATUS_KEY, undefined);
+    footerContributions.unregister(STATUS_KEY);
   });
 
   // ── /supi-cache-history command ──────────────────────────

package/src/monitor/status.ts

@@ -3,11 +3,11 @@
 import type { CacheMonitorState } from "./state.ts";
 
 /**
- * Format the compact footer status string.
+ * Format the compact footer status string for the stats line.
  *
- * - `cache: 87% ↑` — hit rate with trend arrow
- * - `cache: 0%` — first turn (no trend)
- * - `cache: —` — no cache data available
+ * - `TCH87%↑` — hit rate with trend arrow
+ * - `TCH100%` — first turn (no trend)
+ * - `undefined` — no cache data available (contribution suppressed)
  */
 export function formatCacheStatus(state: CacheMonitorState): string | undefined {
   const latest = state.getLatestTurn();
@@ -15,7 +15,7 @@ export function formatCacheStatus(state: CacheMonitorState): string | undefined
 
   // No cache data: unsupported provider or zero denominator
   if (!state.cacheSupported || latest.hitRate === undefined) {
-    return "cache: —";
+    return undefined;
   }
 
   const previous = state.getPreviousTurn();
@@ -23,11 +23,11 @@ export function formatCacheStatus(state: CacheMonitorState): string | undefined
 
   if (previous?.hitRate !== undefined) {
     if (latest.hitRate > previous.hitRate) {
-      trend = " ↑";
+      trend = "↑";
     } else if (latest.hitRate < previous.hitRate) {
-      trend = " ↓";
+      trend = "↓";
     }
   }
 
-  return `cache: ${latest.hitRate}%${trend}`;
+  return `TCH${latest.hitRate}%${trend}`;
 }