pi-extmgr 0.1.26 → 0.1.28

package/README.md

@@ -6,6 +6,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 A better way to manage Pi extensions. Browse, install, enable/disable, and remove extensions from one place.
+Built on top of Pi's native package install, update, and config flows, so extmgr stays aligned with current upstream behavior.
 
 **🌐 [pi-extmgr landing page](https://ayagmar.github.io/pi-extmgr)**
 
@@ -15,9 +16,9 @@ A better way to manage Pi extensions. Browse, install, enable/disable, and remov
 pi install npm:pi-extmgr
 ```
 
-Then reload Pi.
+If Pi is already running, use `/reload`.
 
-Requires Node.js `>=22.5.0`.
+Requires Node.js `>=22`.
 
 ## Features
 
@@ -38,10 +39,11 @@ Requires Node.js `>=22.5.0`.
   - npm search/browse with pagination
   - Install by source (`npm:`, `git:`, `https://`, `ssh://`, `git@...`, local path)
   - Supports direct GitHub `.ts` installs and standalone local install for self-contained packages
+  - Long-running discovery/detail screens now show dedicated loading UI, and cancellable reads can be aborted with `Esc`
 - **Auto-update**
   - Interactive wizard (`t` in manager, or `/extensions auto-update`)
   - Persistent schedule restored on startup and session switch
-  - Background checks + status bar updates for installed npm packages
+  - Background checks + status bar updates for installed npm + git packages
 - **Operational visibility**
   - Session history (`/extensions history`)
   - Cache controls (`/extensions clear-cache` clears persistent + runtime extmgr caches)
@@ -154,12 +156,12 @@ Examples:
 
 - **Staged local changes**: Toggle local extensions on/off, then press `S` to apply all at once.
 - **Package extension config**: Select a package and press `c` (or Enter/A → Configure) to enable/disable individual package entrypoints.
-  - After saving package extension config, restart pi to fully apply changes.
+  - After saving package extension config, run /reload to apply changes.
 - **Two install modes**:
   - **Managed** (npm): Auto-updates with `pi update`, stored in pi's package cache, supports Pi package manifest/convention loading
   - **Local** (standalone): Copies to `~/.pi/agent/extensions/{package}/`, so it only accepts runnable standalone layouts (manifest-declared/root entrypoints), requires `tar` on `PATH`, and rejects packages whose runtime `dependencies` are not already bundled with the package contents
 - **Auto-update schedule is persistent**: `/extensions auto-update 1d` stays active across future Pi sessions and is restored when switching sessions.
-- **Auto-update coverage is npm-only today**: extmgr checks update availability for managed npm packages; git/local installs are not included in the background update badge yet.
+- **Auto-update/update badges cover npm + git packages**: extmgr now uses pi's package manager APIs for structured update detection instead of parsing `pi list` output.
 - **Settings/cache writes are hardened**: extmgr serializes writes and uses safe file replacement to reduce JSON corruption issues.
 - **Invalid JSON is handled safely**: malformed `auto-update.json` / metadata cache files are backed up and reset; invalid `.pi/settings.json` is not overwritten during package-extension toggles.
 - **Reload is built-in**: When extmgr asks to reload, it calls `ctx.reload()` directly.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extmgr",
-  "version": "0.1.26",
+  "version": "0.1.28",
   "description": "Enhanced UX for managing local Pi extensions and community packages",
   "keywords": [
     "pi-package",
@@ -19,14 +19,14 @@
     "README.md"
   ],
   "scripts": {
-    "lint": "eslint . --max-warnings=0",
-    "lint:fix": "eslint . --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
+    "lint": "biome lint . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "smoke-test": "node --import=tsx ./scripts/smoke-test.mjs",
     "test": "node --import=tsx --test ./test/*.test.ts",
-    "check": "pnpm run typecheck && pnpm run smoke-test && pnpm run test && pnpm run lint && pnpm run format:check",
+    "check": "tsc --noEmit -p tsconfig.json && node --import=tsx ./scripts/smoke-test.mjs && node --import=tsx --test ./test/*.test.ts && pnpm run lint && pnpm run format:check",
     "prepublishOnly": "pnpm run check",
     "prepare": "husky"
   },
@@ -42,22 +42,19 @@
     "@mariozechner/pi-tui": "*"
   },
   "devDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.52.6",
-    "@mariozechner/pi-tui": "^0.52.6",
-    "@types/node": "^22.13.10",
-    "@typescript-eslint/eslint-plugin": "^8.42.0",
-    "@typescript-eslint/parser": "^8.42.0",
-    "eslint": "^9.38.0",
-    "eslint-config-prettier": "^10.1.8",
+    "@biomejs/biome": "^2.4.9",
+    "@mariozechner/pi-coding-agent": "^0.63.1",
+    "@mariozechner/pi-tui": "^0.63.1",
+    "@types/node": "^22.19.10",
     "husky": "^9.1.7",
-    "prettier": "^3.8.1",
-    "tsx": "^4.19.3",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
   "author": "ayagmar",
   "license": "MIT",
+  "packageManager": "pnpm@10.33.0",
   "engines": {
-    "node": ">=22.5.0"
+    "node": ">=22"
   },
   "repository": {
     "type": "git",

package/src/commands/auto-update.ts

@@ -1,7 +1,7 @@
-import type {
-  ExtensionAPI,
-  ExtensionCommandContext,
-  ExtensionContext,
+import {
+  type ExtensionAPI,
+  type ExtensionCommandContext,
+  type ExtensionContext,
 } from "@mariozechner/pi-coding-agent";
 import {
   disableAutoUpdate,

package/src/commands/cache.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { type ExtensionAPI, type ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
 import { clearSearchCache } from "../packages/discovery.js";
 import { clearRemotePackageInfoCache } from "../ui/remote.js";
 import { clearCache } from "../utils/cache.js";

package/src/commands/history.ts

@@ -1,10 +1,10 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { type ExtensionAPI, type ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
 import {
+  type ChangeAction,
   formatChangeEntry,
+  type HistoryFilters,
   queryGlobalHistory,
   querySessionChanges,
-  type ChangeAction,
-  type HistoryFilters,
 } from "../utils/history.js";
 import { notify } from "../utils/notify.js";
 import { formatListOutput } from "../utils/ui-helpers.js";

package/src/commands/install.ts

@@ -1,5 +1,5 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import { installPackage, type InstallScope } from "../packages/install.js";
+import { type ExtensionAPI, type ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { type InstallScope, installPackage } from "../packages/install.js";
 import { notify } from "../utils/notify.js";
 
 export const INSTALL_USAGE = "Usage: /extensions install <source> [--project|--global]";

package/src/commands/registry.ts

@@ -1,7 +1,5 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
-import type { AutocompleteItem } from "@mariozechner/pi-tui";
-import { showInteractive, showInstalledPackagesLegacy, showListOnly } from "../ui/unified.js";
-import { showRemote } from "../ui/remote.js";
+import { type ExtensionAPI, type ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { type AutocompleteItem } from "@mariozechner/pi-tui";
 import {
   promptRemove,
   removePackage,
@@ -9,12 +7,14 @@ import {
   updatePackage,
   updatePackages,
 } from "../packages/management.js";
+import { showRemote } from "../ui/remote.js";
+import { showInstalledPackagesLegacy, showInteractive, showListOnly } from "../ui/unified.js";
 import { notify } from "../utils/notify.js";
-import { handleInstallSubcommand, INSTALL_USAGE } from "./install.js";
-import { handleHistorySubcommand } from "./history.js";
 import { handleAutoUpdateSubcommand } from "./auto-update.js";
 import { clearMetadataCacheCommand } from "./cache.js";
-import type { CommandDefinition, CommandId } from "./types.js";
+import { handleHistorySubcommand } from "./history.js";
+import { handleInstallSubcommand, INSTALL_USAGE } from "./install.js";
+import { type CommandDefinition, type CommandId } from "./types.js";
 
 const REMOVE_USAGE = "Usage: /extensions remove <npm:package|git:url|path>";
 

package/src/commands/types.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import { type ExtensionAPI, type ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
 
 export type CommandId =
   | "local"

package/src/extensions/discovery.ts

@@ -4,12 +4,13 @@
  * This module handles discovery and management of local Pi extensions
  * in both global (~/.pi/agent/extensions) and project (.pi/extensions) scopes.
  */
+
+import { type Dirent } from "node:fs";
 import { readdir, rename, rm } from "node:fs/promises";
-import { basename, dirname, join, relative } from "node:path";
 import { homedir } from "node:os";
-import type { Dirent } from "node:fs";
-import type { ExtensionEntry, Scope, State } from "../types/index.js";
+import { basename, dirname, join, relative } from "node:path";
 import { DISABLED_SUFFIX } from "../constants.js";
+import { type ExtensionEntry, type Scope, type State } from "../types/index.js";
 import { fileExists, readSummary } from "../utils/fs.js";
 
 interface RootConfig {

package/src/index.ts

@@ -3,21 +3,12 @@
  *
  * Entry point - exports the main extension function
  */
-import type {
-  ExtensionAPI,
-  ExtensionCommandContext,
-  ExtensionContext,
-} from "@mariozechner/pi-coding-agent";
-import { isPackageSource } from "./utils/format.js";
-import { installPackage } from "./packages/install.js";
-import { tokenizeArgs } from "./utils/command.js";
-import { updateExtmgrStatus } from "./utils/status.js";
 import {
-  startAutoUpdateTimer,
-  stopAutoUpdateTimer,
-  type ContextProvider,
-} from "./utils/auto-update.js";
-import { hydrateAutoUpdateConfig, getAutoUpdateConfig } from "./utils/settings.js";
+  type ExtensionAPI,
+  type ExtensionCommandContext,
+  type ExtensionContext,
+} from "@mariozechner/pi-coding-agent";
+import { createAutoUpdateNotificationHandler } from "./commands/auto-update.js";
 import {
   getExtensionsAutocompleteItems,
   resolveCommand,
@@ -25,7 +16,16 @@ import {
   showNonInteractiveHelp,
   showUnknownCommandMessage,
 } from "./commands/registry.js";
-import { createAutoUpdateNotificationHandler } from "./commands/auto-update.js";
+import { installPackage } from "./packages/install.js";
+import {
+  type ContextProvider,
+  startAutoUpdateTimer,
+  stopAutoUpdateTimer,
+} from "./utils/auto-update.js";
+import { tokenizeArgs } from "./utils/command.js";
+import { isPackageSource } from "./utils/format.js";
+import { getAutoUpdateConfig, hydrateAutoUpdateConfig } from "./utils/settings.js";
+import { updateExtmgrStatus } from "./utils/status.js";
 
 async function executeExtensionsCommand(
   args: string,

package/src/packages/catalog.ts

@@ -0,0 +1,163 @@
+import {
+  DefaultPackageManager,
+  getAgentDir,
+  type PackageSource,
+  type ProgressEvent,
+  SettingsManager,
+} from "@mariozechner/pi-coding-agent";
+import { type InstalledPackage, type Scope } from "../types/index.js";
+import { normalizePackageIdentity, parsePackageNameAndVersion } from "../utils/package-source.js";
+
+type PiScope = "user" | "project";
+type PiPackageUpdate = Awaited<
+  ReturnType<DefaultPackageManager["checkForAvailableUpdates"]>
+>[number];
+
+export interface AvailablePackageUpdate {
+  source: string;
+  displayName: string;
+  type: "npm" | "git";
+  scope: Scope;
+}
+
+export interface PackageCatalog {
+  listInstalledPackages(options?: { dedupe?: boolean }): Promise<InstalledPackage[]>;
+  checkForAvailableUpdates(): Promise<AvailablePackageUpdate[]>;
+  install(source: string, scope: Scope, onProgress?: (event: ProgressEvent) => void): Promise<void>;
+  remove(source: string, scope: Scope, onProgress?: (event: ProgressEvent) => void): Promise<void>;
+  update(source?: string, onProgress?: (event: ProgressEvent) => void): Promise<void>;
+}
+
+type PackageCatalogFactory = (cwd: string) => PackageCatalog;
+
+let packageCatalogFactory: PackageCatalogFactory = createDefaultPackageCatalog;
+
+function toScope(scope: PiScope): Scope {
+  return scope === "project" ? "project" : "global";
+}
+
+function getPackageSource(pkg: PackageSource): string {
+  return typeof pkg === "string" ? pkg : pkg.source;
+}
+
+function createPackageRecord(
+  source: string,
+  scope: PiScope,
+  packageManager: DefaultPackageManager
+): InstalledPackage {
+  const resolvedPath = packageManager.getInstalledPath(source, scope);
+  const { name, version } = parsePackageNameAndVersion(source);
+
+  return {
+    source,
+    name,
+    scope: toScope(scope),
+    ...(version ? { version } : {}),
+    ...(resolvedPath ? { resolvedPath } : {}),
+  };
+}
+
+function dedupeInstalledPackages(packages: InstalledPackage[], cwd: string): InstalledPackage[] {
+  const byIdentity = new Map<string, InstalledPackage>();
+
+  for (const pkg of packages) {
+    const baseCwd = pkg.scope === "project" ? cwd : getAgentDir();
+    const identity = normalizePackageIdentity(pkg.source, {
+      ...(pkg.resolvedPath ? { resolvedPath: pkg.resolvedPath } : {}),
+      cwd: baseCwd,
+    });
+
+    if (!byIdentity.has(identity)) {
+      byIdentity.set(identity, pkg);
+    }
+  }
+
+  return [...byIdentity.values()];
+}
+
+function setProgressCallback(
+  packageManager: DefaultPackageManager,
+  onProgress?: (event: ProgressEvent) => void
+): void {
+  packageManager.setProgressCallback(onProgress);
+}
+
+function createDefaultPackageCatalog(cwd: string): PackageCatalog {
+  const agentDir = getAgentDir();
+  const settingsManager = SettingsManager.create(cwd, agentDir);
+  const packageManager = new DefaultPackageManager({ cwd, agentDir, settingsManager });
+
+  return {
+    listInstalledPackages(options) {
+      const projectPackages = (settingsManager.getProjectSettings().packages ?? []).map((pkg) =>
+        createPackageRecord(getPackageSource(pkg), "project", packageManager)
+      );
+      const globalPackages = (settingsManager.getGlobalSettings().packages ?? []).map((pkg) =>
+        createPackageRecord(getPackageSource(pkg), "user", packageManager)
+      );
+
+      const installed = [...projectPackages, ...globalPackages];
+      return Promise.resolve(
+        options?.dedupe === false ? installed : dedupeInstalledPackages(installed, cwd)
+      );
+    },
+
+    async checkForAvailableUpdates() {
+      const updates = await packageManager.checkForAvailableUpdates();
+      return updates.map((update: PiPackageUpdate) => ({
+        source: update.source,
+        displayName: update.displayName,
+        type: update.type,
+        scope: toScope(update.scope),
+      }));
+    },
+
+    async install(source, scope, onProgress) {
+      setProgressCallback(packageManager, onProgress);
+
+      try {
+        await packageManager.install(source, { local: scope === "project" });
+        packageManager.addSourceToSettings(source, { local: scope === "project" });
+        await settingsManager.flush();
+      } finally {
+        setProgressCallback(packageManager, undefined);
+      }
+    },
+
+    async remove(source, scope, onProgress) {
+      setProgressCallback(packageManager, onProgress);
+
+      try {
+        await packageManager.remove(source, { local: scope === "project" });
+        const removed = packageManager.removeSourceFromSettings(source, {
+          local: scope === "project",
+        });
+        await settingsManager.flush();
+
+        if (!removed) {
+          throw new Error(`No matching package found for ${source}`);
+        }
+      } finally {
+        setProgressCallback(packageManager, undefined);
+      }
+    },
+
+    async update(source, onProgress) {
+      setProgressCallback(packageManager, onProgress);
+
+      try {
+        await packageManager.update(source);
+      } finally {
+        setProgressCallback(packageManager, undefined);
+      }
+    },
+  };
+}
+
+export function getPackageCatalog(cwd: string): PackageCatalog {
+  return packageCatalogFactory(cwd);
+}
+
+export function setPackageCatalogFactory(factory?: PackageCatalogFactory): void {
+  packageCatalogFactory = factory ?? createDefaultPackageCatalog;
+}