@pi-unipi/updater 0.1.1 → 2.0.0

package/README.md

@@ -1,22 +1,44 @@
 # @pi-unipi/updater
 
-Auto-updater, changelog browser, and readme browser for the Unipi extension suite.
+Checks npm for new versions on session start, shows a changelog diff, and lets you update with one keypress. Also provides TUI browsers for package READMEs and the changelog.
 
-## Features
-
-- **Auto-updater** — Periodically checks npm registry for new versions, shows update prompt with changelog diff
-- **Changelog browser** — TUI overlay listing all versions with dates and status labels (✓ Current, ↑ New)
-- **Readme browser** — TUI overlay listing all packages with versions, opens rendered README content
+The update overlay appears automatically when a newer version is found. Press `Y` to update, `n` to skip. Skipped versions are cached — you only get re-prompted when an even newer version appears.
 
 ## Commands
 
 | Command | Description |
 |---------|-------------|
-| `/unipi:readme [package]` | Browse package README files. No arg opens list, with arg opens directly. |
+| `/unipi:readme [package]` | Browse package README files in TUI overlay |
 | `/unipi:changelog` | Browse CHANGELOG.md with version list and detail view |
 | `/unipi:updater-settings` | Configure check interval and auto-update mode |
 
-## Configuration
+### TUI Controls
+
+| Key | Action |
+|-----|--------|
+| `j/k` or Up/Down | Navigate |
+| `Enter` | Select/open |
+| `q/Esc` | Back/close |
+| `g/G` | Jump to top/bottom |
+| `Space` | Cycle options (settings) |
+| `h/l` or Left/Right | Cycle options (settings) |
+
+## Special Triggers
+
+On session start, updater checks the npm registry for `@pi-unipi/unipi`. If a newer version exists and wasn't previously skipped, it shows the update overlay with changelog diff. This runs once per session, respecting the check interval config.
+
+Updater registers with the info-screen dashboard, showing installed version, latest version, update status, and last check time.
+
+## How Updates Work
+
+1. Session start triggers npm registry check
+2. Compare latest version with installed version
+3. If newer and not skipped, show update overlay
+4. User views changelog diff, presses `Y` to update or `n` to skip
+5. Update runs `pi install npm:@pi-unipi/unipi`
+6. Skipped version cached — re-prompted only for newer versions
+
+## Configurables
 
 Config stored at `~/.unipi/config/updater/config.json`:
 
@@ -27,41 +49,21 @@ Config stored at `~/.unipi/config/updater/config.json`:
 }
 ```
 
-### Options
-
 | Option | Values | Default |
 |--------|--------|---------|
-| `checkIntervalMs` | `1800000` (30min), `3600000` (1h), `21600000` (6h), `86400000` (1d) | `3600000` (1h) |
-| `autoUpdate` | `disabled`, `notify`, `auto` | `notify` |
+| `checkIntervalMs` | 1800000 (30min), 3600000 (1h), 21600000 (6h), 86400000 (1d) | 3600000 (1h) |
+| `autoUpdate` | disabled, notify, auto | notify |
 
-### Auto-update modes
+### Auto-update Modes
 
 - **disabled** — No update checks on session start
-- **notify** — Show update overlay with changelog diff, user chooses [Y] Update or [n] Skip
-- **auto** — Show countdown overlay, auto-install after 5 seconds unless cancelled
-
-## How it works
-
-1. On session start, checks npm registry for `@pi-unipi/unipi` latest version
-2. Compares with installed version from `package.json`
-3. If newer version found and not previously skipped, shows update overlay
-4. User can view changelog diff, update with `[Y]`, or skip with `[n]`
-5. Skipped versions are cached — only re-prompted when an even newer version appears
-6. Update installs via `pi install npm:@pi-unipi/unipi`
+- **notify** — Show overlay with changelog, user chooses Y/n
+- **auto** — Show countdown, auto-install after 5 seconds unless cancelled
 
-## TUI Overlays
+### Cache
 
-All overlays use keyboard navigation:
-- `j`/`k` or ↑/↓ — navigate
-- `Enter` — select/open
-- `q`/`Esc` — back/close
-- `g`/`G` — jump to top/bottom
-- `Space` — cycle options (settings overlay)
-- `h`/`l` or ←/→ — cycle options (settings overlay)
+Last-check cache at `~/.unipi/cache/updater/last-check.json`:
 
-## Cache
-
-Last-check cache stored at `~/.unipi/cache/updater/last-check.json`:
 ```json
 {
   "lastCheck": "2026-05-01T12:00:00.000Z",
@@ -69,3 +71,7 @@ Last-check cache stored at `~/.unipi/cache/updater/last-check.json`:
   "skippedVersion": "0.1.16"
 }
 ```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "0.1.1",
+  "version": "2.0.0",
   "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "license": "MIT",

package/src/checker.ts

@@ -5,7 +5,7 @@
  * respects check interval from config/cache.
  */
 
-import { getPackageVersion } from "@pi-unipi/core";
+import { getInstalledPackageVersion } from "@pi-unipi/core";
 import { loadConfig } from "./settings.js";
 import { readLastCheck, writeLastCheck, isCheckDue } from "./cache.js";
 import type { UpdateCheckResult } from "../types.js";
@@ -15,9 +15,9 @@ const NPM_REGISTRY_URL = "https://registry.npmjs.org/@pi-unipi/unipi";
 
 /** Resolve the installed version of @pi-unipi/unipi */
 function getInstalledVersion(): string {
-  // Walk up from this file to find the monorepo root
-  const dir = new URL("../../..", import.meta.url).pathname;
-  return getPackageVersion(dir);
+  // Walk up from this file to find the @pi-unipi/unipi package by name
+  const dir = new URL("..", import.meta.url).pathname;
+  return getInstalledPackageVersion(dir, "@pi-unipi/unipi");
 }
 
 /**
@@ -71,14 +71,14 @@ export async function checkForUpdates(): Promise<UpdateCheckResult> {
       latestVersion,
       currentVersion,
     };
-  } catch (err: any) {
+  } catch (err: unknown) {
     // Network error — return cached info if available
     const cache = readLastCheck();
     return {
       updateAvailable: false,
       latestVersion: cache?.latestVersion ?? "",
       currentVersion,
-      error: err.message ?? "Unknown error",
+      error: err instanceof Error ? err.message : String(err) || "Unknown error",
     };
   }
 }

package/src/commands.ts

@@ -4,7 +4,7 @@
  * Registers /unipi:readme [package], /unipi:changelog, /unipi:updater-settings
  */
 
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
 import { UNIPI_PREFIX, UPDATER_COMMANDS } from "@pi-unipi/core";
 import { renderReadmeOverlay } from "./tui/readme-overlay.js";
 import { renderChangelogOverlay } from "./tui/changelog-overlay.js";
@@ -14,9 +14,9 @@ import { renderSettingsOverlay } from "./tui/settings-overlay.js";
 const OVERLAY_OPTIONS = {
   overlay: true,
   overlayOptions: {
-    width: "80%",
+    width: "80%" as const,
     minWidth: 60,
-    anchor: "center",
+    anchor: "center" as const,
     margin: 2,
   },
 };
@@ -28,7 +28,7 @@ export function registerCommands(pi: ExtensionAPI): void {
     `${UNIPI_PREFIX}${UPDATER_COMMANDS.README}`,
     {
       description: "Browse package README files",
-      handler: async (args: string, ctx: any) => {
+      handler: async (args: string, ctx: ExtensionCommandContext) => {
         const packageName = args.trim() || undefined;
         try {
           await ctx.ui.custom(
@@ -47,7 +47,7 @@ export function registerCommands(pi: ExtensionAPI): void {
     `${UNIPI_PREFIX}${UPDATER_COMMANDS.CHANGELOG}`,
     {
       description: "Browse changelog (Keep a Changelog format)",
-      handler: async (_args: string, ctx: any) => {
+      handler: async (_args: string, ctx: ExtensionCommandContext) => {
         try {
           await ctx.ui.custom(
             renderChangelogOverlay(),
@@ -65,7 +65,7 @@ export function registerCommands(pi: ExtensionAPI): void {
     `${UNIPI_PREFIX}${UPDATER_COMMANDS.UPDATER_SETTINGS}`,
     {
       description: "Configure updater — check interval and auto-update mode",
-      handler: async (_args: string, ctx: any) => {
+      handler: async (_args: string, ctx: ExtensionCommandContext) => {
         try {
           const result = await ctx.ui.custom(
             renderSettingsOverlay(),

package/src/index.ts

@@ -16,6 +16,7 @@ import {
   UNIPI_PREFIX,
   emitEvent,
   getPackageVersion,
+  type UnipiUpdateCheckEvent,
 } from "@pi-unipi/core";
 import { registerCommands } from "./commands.js";
 import { loadConfig } from "./settings.js";
@@ -41,7 +42,7 @@ export default function updaterExtension(pi: ExtensionAPI): void {
   // Session lifecycle — check for updates and announce module
   pi.on("session_start", async (_event, ctx) => {
     // Emit MODULE_READY
-    emitEvent(pi as any, UNIPI_EVENTS.MODULE_READY, {
+    emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
       name: MODULES.UPDATER,
       version: VERSION,
       commands: [
@@ -53,7 +54,7 @@ export default function updaterExtension(pi: ExtensionAPI): void {
     });
 
     // Register info-screen group
-    const infoRegistry = (globalThis as any).__unipi_info_registry;
+    const infoRegistry = globalThis.__unipi_info_registry;
     if (infoRegistry) {
       let cachedResult: { currentVersion: string; latestVersion: string; updateAvailable: boolean; lastCheck: string } | null = null;
 
@@ -90,34 +91,35 @@ export default function updaterExtension(pi: ExtensionAPI): void {
       });
 
       // Subscribe to events to update cached data
-      pi.events.on(UNIPI_EVENTS.UPDATE_CHECK, (payload: any) => {
+      pi.events.on(UNIPI_EVENTS.UPDATE_CHECK, (data) => {
+        const payload = data as UnipiUpdateCheckEvent;
         cachedResult = {
           currentVersion: payload.currentVersion,
           latestVersion: payload.latestVersion,
           updateAvailable: payload.updateAvailable,
           lastCheck: new Date().toLocaleTimeString(),
         };
-        emitEvent(pi as any, UNIPI_EVENTS.INFO_DATA_UPDATED, {
+        emitEvent(pi, UNIPI_EVENTS.INFO_DATA_UPDATED, {
           groupId: "updater",
           keys: ["current", "latest", "status", "lastCheck"],
         });
       });
 
-      pi.events.on(UNIPI_EVENTS.UPDATE_AVAILABLE, (_payload: any) => {
+      pi.events.on(UNIPI_EVENTS.UPDATE_AVAILABLE, (_data: unknown) => {
         if (cachedResult) {
           cachedResult.updateAvailable = true;
         }
-        emitEvent(pi as any, UNIPI_EVENTS.INFO_DATA_UPDATED, {
+        emitEvent(pi, UNIPI_EVENTS.INFO_DATA_UPDATED, {
           groupId: "updater",
           keys: ["status"],
         });
       });
 
-      pi.events.on(UNIPI_EVENTS.UPDATE_APPLIED, (_payload: any) => {
+      pi.events.on(UNIPI_EVENTS.UPDATE_APPLIED, (_data: unknown) => {
         if (cachedResult) {
           cachedResult.updateAvailable = false;
         }
-        emitEvent(pi as any, UNIPI_EVENTS.INFO_DATA_UPDATED, {
+        emitEvent(pi, UNIPI_EVENTS.INFO_DATA_UPDATED, {
           groupId: "updater",
           keys: ["status"],
         });
@@ -132,7 +134,7 @@ export default function updaterExtension(pi: ExtensionAPI): void {
       const result = await checkForUpdates();
 
       // Emit check event
-      emitEvent(pi as any, UNIPI_EVENTS.UPDATE_CHECK, result);
+      emitEvent(pi, UNIPI_EVENTS.UPDATE_CHECK, result);
 
       if (!result.updateAvailable || result.error) return;
 
@@ -140,7 +142,7 @@ export default function updaterExtension(pi: ExtensionAPI): void {
       if (isVersionSkipped(result.latestVersion)) return;
 
       // Emit available event
-      emitEvent(pi as any, UNIPI_EVENTS.UPDATE_AVAILABLE, {
+      emitEvent(pi, UNIPI_EVENTS.UPDATE_AVAILABLE, {
         currentVersion: result.currentVersion,
         latestVersion: result.latestVersion,
       });

package/src/installer.ts

@@ -7,7 +7,7 @@
 
 import { exec } from "child_process";
 import { promisify } from "util";
-import { getPackageVersion, emitEvent, UNIPI_EVENTS } from "@pi-unipi/core";
+import { getInstalledPackageVersion, emitEvent, UNIPI_EVENTS } from "@pi-unipi/core";
 import type { InstallResult } from "../types.js";
 
 const execAsync = promisify(exec);
@@ -23,9 +23,8 @@ const INSTALL_TIMEOUT_MS = 60000;
 export async function installUpdate(
   pi?: { events: { emit: (name: string, payload: unknown) => void } },
 ): Promise<InstallResult> {
-  const installedBefore = getPackageVersion(
-    new URL("../../..", import.meta.url).pathname,
-  );
+  const thisDir = new URL("..", import.meta.url).pathname;
+  const installedBefore = getInstalledPackageVersion(thisDir, "@pi-unipi/unipi");
 
   try {
     const { stdout, stderr } = await execAsync(
@@ -37,9 +36,7 @@ export async function installUpdate(
     );
 
     // Get new version after install
-    const installedAfter = getPackageVersion(
-      new URL("../../..", import.meta.url).pathname,
-    );
+    const installedAfter = getInstalledPackageVersion(thisDir, "@pi-unipi/unipi");
 
     const result: InstallResult = {
       success: true,
@@ -55,8 +52,11 @@ export async function installUpdate(
     }
 
     return result;
-  } catch (err: any) {
-    const errorMessage = err.stderr || err.message || "Unknown install error";
+  } catch (err: unknown) {
+    const errorMessage = (err instanceof Error && 'stderr' in err ? String((err as Error & { stderr?: string }).stderr) : undefined)
+      || (err instanceof Error ? err.message : undefined)
+      || String(err)
+      || "Unknown install error";
 
     // Emit error event
     if (pi) {

package/src/readme.ts

@@ -7,7 +7,8 @@
  */
 
 import { existsSync, readFileSync } from "fs";
-import { join, resolve } from "path";
+import { join } from "path";
+import { findPackageRoot } from "@pi-unipi/core";
 import { MODULES } from "@pi-unipi/core";
 import type { ReadmeEntry } from "../types.js";
 
@@ -35,14 +36,12 @@ const PACKAGE_MAP: Record<string, string> = {
   updater: MODULES.UPDATER,
 };
 
-/** Resolve the unipi monorepo root directory */
+/** Resolve the unipi package root directory */
 function resolveUnipiRoot(): string {
-  // Walk up from this file to find the monorepo root (has package.json with @pi-unipi/unipi)
-  let dir = new URL(".", import.meta.url).pathname;
-  // From src/updater/src/ → go up 4 levels to reach monorepo root
-  // Actually: packages/updater/src/readme.ts → ../../.. = monorepo root
-  dir = resolve(dir, "../../..");
-  return dir;
+  // Walk up from this file to find @pi-unipi/unipi by name
+  const dir = new URL(".", import.meta.url).pathname;
+  const root = findPackageRoot(dir, "@pi-unipi/unipi");
+  return root ?? join(dir, ".."); // fallback to parent
 }
 
 /** Get version from a package.json at the given directory */

package/src/tui/changelog-overlay.ts

@@ -11,7 +11,7 @@ import { Key, matchesKey, truncateToWidth, visibleWidth } from "@mariozechner/pi
 import type { Theme } from "@mariozechner/pi-coding-agent";
 import { parseChangelog } from "../changelog.js";
 import { renderMarkdown } from "../markdown.js";
-import { getPackageVersion } from "@pi-unipi/core";
+import { getInstalledPackageVersion } from "@pi-unipi/core";
 import type { ChangelogEntry } from "../../types.js";
 
 type View = "list" | "detail";
@@ -39,13 +39,14 @@ function padVisible(content: string, targetWidth: number): string {
  */
 export function renderChangelogOverlay() {
   return (
-    tui: any,
+    tui: import("@mariozechner/pi-tui").TUI,
     theme: Theme,
-    _kb: any,
+    _kb: import("@mariozechner/pi-coding-agent").KeybindingsManager,
     done: (result: { viewed: boolean } | null) => void,
   ) => {
-    const installedVersion = getPackageVersion(
-      new URL("../../..", import.meta.url).pathname,
+    const installedVersion = getInstalledPackageVersion(
+      new URL("..", import.meta.url).pathname,
+      "@pi-unipi/unipi",
     );
 
     const state: ChangelogState = {

package/src/tui/readme-overlay.ts

@@ -38,9 +38,9 @@ function padVisible(content: string, targetWidth: number): string {
  */
 export function renderReadmeOverlay(params?: { openDirect?: string }) {
   return (
-    tui: any,
+    tui: import("@mariozechner/pi-tui").TUI,
     theme: Theme,
-    _kb: any,
+    _kb: import("@mariozechner/pi-coding-agent").KeybindingsManager,
     done: (result: { viewed: boolean } | null) => void,
   ) => {
     const state: ReadmeState = {
@@ -61,7 +61,7 @@ export function renderReadmeOverlay(params?: { openDirect?: string }) {
         const readmePath = resolveReadmePath(params.openDirect);
         if (readmePath) {
           const content = readFileSync(readmePath, "utf-8");
-          state.contentLines = renderMarkdown(content, (tui.width ?? 80) - 4, theme);
+          state.contentLines = renderMarkdown(content, (tui.terminal?.columns ?? 80) - 4, theme);
           state.view = "content";
         }
       }
@@ -203,7 +203,7 @@ export function renderReadmeOverlay(params?: { openDirect?: string }) {
             const entry = state.entries[state.listIndex]!;
             try {
               const content = readFileSync(entry.path, "utf-8");
-              state.contentLines = renderMarkdown(content, (tui.width ?? 80) - 4, theme);
+              state.contentLines = renderMarkdown(content, (tui.terminal?.columns ?? 80) - 4, theme);
               state.contentScroll = 0;
               state.view = "content";
             } catch {

package/src/tui/settings-overlay.ts

@@ -42,9 +42,9 @@ function trunc(text: string, width: number): string {
  */
 export function renderSettingsOverlay() {
   return (
-    tui: any,
-    _theme: any,
-    _kb: any,
+    tui: import("@mariozechner/pi-tui").TUI,
+    _theme: import("@mariozechner/pi-coding-agent").Theme,
+    _kb: import("@mariozechner/pi-coding-agent").KeybindingsManager,
     done: (result: { saved: boolean } | null) => void,
   ) => {
     const state = {

package/src/tui/update-overlay.ts

@@ -41,9 +41,9 @@ interface UpdateState {
  */
 export function renderUpdateOverlay(checkResult: UpdateCheckResult) {
   return (
-    tui: any,
+    tui: import("@mariozechner/pi-tui").TUI,
     theme: Theme,
-    _kb: any,
+    _kb: import("@mariozechner/pi-coding-agent").KeybindingsManager,
     done: (result: { updated: boolean } | null) => void,
   ) => {
     const config = loadConfig();
@@ -66,7 +66,7 @@ export function renderUpdateOverlay(checkResult: UpdateCheckResult) {
         : `${theme.bold(entry.version)} — ${theme.fg("muted", "Unreleased")}`;
       contentLines.push(`  ${title}`);
       // Use markdown renderer for the body content
-      const bodyLines = renderMarkdown(entry.body, (tui.width ?? 80) - 6, theme);
+      const bodyLines = renderMarkdown(entry.body, (tui.terminal?.columns ?? 80) - 6, theme);
       for (const line of bodyLines) {
         contentLines.push(`  ${line}`);
       }