@pi-unipi/updater 0.1.1 → 0.1.2

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": "0.1.2",
   "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");
 }
 
 /**

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,

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";
@@ -44,8 +44,9 @@ export function renderChangelogOverlay() {
     _kb: any,
     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 = {