@pi-unipi/info-screen 0.1.21 → 2.0.0

package/README.md

@@ -1,17 +1,8 @@
 # @pi-unipi/info-screen
 
-Dashboard and module registry for [Unipi](https://github.com/Neuron-Mr-White/unipi). Shows a configurable info overlay on boot with tabbed groups from all registered modules.
+Dashboard overlay that shows what's running. Displays module status, registered tools, custom data groups, and load times in a tabbed interface.
 
-## Install
-
-```bash
-pi install npm:@pi-unipi/info-screen
-```
-
-Or as part of the full suite:
-```bash
-pi install npm:unipi
-```
+Every Unipi module registers itself via `MODULE_READY` events. Info-screen picks these up and builds a live dashboard. Other packages add their own data groups — ralph shows active loops, memory shows counts, compactor shows token savings.
 
 ## Commands
 
@@ -20,18 +11,11 @@ pi install npm:unipi
 | `/unipi:info` | Show info screen dashboard |
 | `/unipi:info-settings` | Configure info display (groups, stats, visibility) |
 
-## Features
+## Special Triggers
 
-- **Module discovery** — listens for `MODULE_READY` events, tracks all registered modules
-- **Tabbed groups** — each module registers info groups with custom data providers
-- **Configurable** — per-group and per-stat visibility via settings
-- **Boot overlay** — shows dashboard on session start (configurable)
-- **Styled dialog chrome** — uses pi-tui theme API for consistent borders, scrollable content, and navigation hints (matching the overlay style used by @pi-unipi/btw)
-- **Core groups** — modules, tools, load time, session info out of the box
+Info-screen listens for `MODULE_READY` events from `@pi-unipi/core`. When a module loads, info-screen adds it to the modules group automatically. No registration needed for basic module tracking.
 
-## Registering a Group
-
-Other modules register info groups via the global registry:
+Packages that want custom data groups use the registry API:
 
 ```typescript
 import { infoRegistry } from "@pi-unipi/info-screen";
@@ -55,11 +39,9 @@ infoRegistry.registerGroup({
 });
 ```
 
-## API
-
-### `infoRegistry`
+The footer package reads info-screen data for its extension status segment.
 
-Singleton registry instance. Also available globally via `globalThis.__unipi_info_registry`.
+## Registry API
 
 | Method | Description |
 |--------|-------------|
@@ -72,12 +54,13 @@ Singleton registry instance. Also available globally via `globalThis.__unipi_inf
 | `getVisibleStats(id)` | Get enabled stats for a group |
 | `invalidateCache(id)` | Invalidate cached data |
 
+The registry is a singleton, also available globally via `globalThis.__unipi_info_registry`.
+
 ### Load Tracking
 
 ```typescript
 import { startLoadTracking, recordLoadTime, finishLoadTracking, recordModuleStart } from "@pi-unipi/info-screen";
 
-// Track module load times
 startLoadTracking();
 recordModuleStart("@pi-unipi/memory");
 // ... module loads ...
@@ -85,9 +68,9 @@ recordLoadTime("@pi-unipi/memory", "module", 150);
 finishLoadTracking();
 ```
 
-## Settings
+## Configurables
 
-Configure in pi `settings.json`:
+Settings in pi `settings.json`:
 
 ```json
 {
@@ -106,9 +89,12 @@ Configure in pi `settings.json`:
 }
 ```
 
-## Dependencies
-
-- `@pi-unipi/core` — shared constants and events
+| Setting | Default | What It Does |
+|---------|---------|--------------|
+| `showOnBoot` | true | Show dashboard when session starts |
+| `bootTimeoutMs` | 8000 | How long to wait for modules before showing |
+| `groups.{id}.show` | true | Toggle group visibility |
+| `groupOrder` | priority sort | Custom group ordering |
 
 ## License
 

package/core-groups.ts

@@ -8,6 +8,7 @@
 import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
 import { join, basename } from "node:path";
 import { homedir } from "node:os";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { infoRegistry } from "./registry.js";
 import { parseUsageStats, formatTokens, formatCost } from "./usage-parser.js";
 import type { InfoGroup } from "./types.js";
@@ -309,12 +310,12 @@ const registeredTools: Array<{ name: string; source: string }> = [];
 /**
  * Reference to pi API for getting tools.
  */
-let piApi: any = null;
+let piApi: ExtensionAPI | null = null;
 
 /**
  * Set the pi API reference.
  */
-export function setPiApi(api: any): void {
+export function setPiApi(api: ExtensionAPI): void {
   piApi = api;
 }
 

package/index.ts

@@ -9,8 +9,8 @@
  *   /unipi:info-settings - Configure info display
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
-import { UNIPI_EVENTS, MODULES, UNIPI_PREFIX, emitEvent, getPackageVersion } from "@pi-unipi/core";
+import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { UNIPI_EVENTS, MODULES, UNIPI_PREFIX, emitEvent, getPackageVersion, type UnipiModuleEvent, type UnipiInfoGroupEvent } from "@pi-unipi/core";
 import { infoRegistry } from "./registry.js";
 import { registerCoreGroups, trackModule, trackTool, setPiApi, registerSkillDir, startLoadTracking, recordLoadTime, finishLoadTracking, recordModuleStart } from "./core-groups.js";
 
@@ -69,7 +69,8 @@ export default function (pi: ExtensionAPI) {
   }
 
   // Listen for module announcements — track and trigger reactive updates
-  pi.events.on(UNIPI_EVENTS.MODULE_READY, (event: any) => {
+  pi.events.on(UNIPI_EVENTS.MODULE_READY, (data) => {
+    const event = data as UnipiModuleEvent;
     if (event.name && event.name !== MODULES.INFO_SCREEN) {
       moduleReadyBatch.push({
         name: event.name,
@@ -84,7 +85,7 @@ export default function (pi: ExtensionAPI) {
     }
   });
 
-  pi.events.on(UNIPI_EVENTS.INFO_GROUP_REGISTERED, (_event: any) => {
+  pi.events.on(UNIPI_EVENTS.INFO_GROUP_REGISTERED, (_data) => {
     // Group already registered via globalThis in registerGroup()
   });
 
@@ -104,9 +105,9 @@ export default function (pi: ExtensionAPI) {
    * Cache-first: opens with whatever data is cached (even empty).
    * Background: each group fetches independently, overlay re-renders reactively.
    */
-  function showOverlay(ctx: any): void {
-    ctx.ui.custom(
-      (tui: any, theme: any, _keybindings: any, done: () => void) => {
+  function showOverlay(ctx: ExtensionContext): void {
+    ctx.ui.custom<void>(
+      (tui, theme, _keybindings, done) => {
         const overlay = new InfoOverlay();
         overlay.setTheme(theme);
         overlay.onClose = () => {
@@ -126,9 +127,9 @@ export default function (pi: ExtensionAPI) {
       {
         overlay: true,
         overlayOptions: {
-          width: "80%",
+          width: "80%" as const,
           minWidth: 60,
-          anchor: "center",
+          anchor: "center" as const,
           margin: 2,
         },
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "0.1.21",
+  "version": "2.0.0",
   "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "license": "MIT",

package/registry.ts

@@ -263,10 +263,9 @@ class InfoRegistry {
 export const infoRegistry = new InfoRegistry();
 
 // Expose globally so other modules can access without direct imports
-const globalObj = globalThis as any;
-if (!globalObj.__unipi_info_registry) {
-  globalObj.__unipi_info_registry = infoRegistry;
+if (!globalThis.__unipi_info_registry) {
+  globalThis.__unipi_info_registry = infoRegistry;
 }
 export const getGlobalRegistry = (): InfoRegistry => {
-  return globalObj.__unipi_info_registry || infoRegistry;
+  return (globalThis.__unipi_info_registry as InfoRegistry | undefined) ?? infoRegistry;
 };