pi-extmgr 0.1.25 → 0.1.27

package/README.md

@@ -38,10 +38,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)
@@ -159,7 +160,7 @@ Examples:
   - **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.25",
+  "version": "0.1.27",
   "description": "Enhanced UX for managing local Pi extensions and community packages",
   "keywords": [
     "pi-package",
@@ -42,8 +42,8 @@
     "@mariozechner/pi-tui": "*"
   },
   "devDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.52.6",
-    "@mariozechner/pi-tui": "^0.52.6",
+    "@mariozechner/pi-coding-agent": "^0.62.0",
+    "@mariozechner/pi-tui": "^0.62.0",
     "@types/node": "^22.13.10",
     "@typescript-eslint/eslint-plugin": "^8.42.0",
     "@typescript-eslint/parser": "^8.42.0",

package/src/constants.ts

@@ -68,8 +68,6 @@ export type CacheLimitKey = keyof typeof CACHE_LIMITS;
 export const UI = {
   /** Maximum height for scrollable lists in terminal rows */
   maxListHeight: 16,
-  /** Minimum number of items before enabling search functionality */
-  searchThreshold: 8,
   /** Default confirmation dialog timeout: 30 seconds */
   confirmTimeout: 30_000,
   /** Extended confirmation timeout for destructive operations: 1 minute */

package/src/packages/catalog.ts

@@ -0,0 +1,162 @@
+import {
+  DefaultPackageManager,
+  getAgentDir,
+  SettingsManager,
+  type PackageSource,
+  type ProgressEvent,
+} from "@mariozechner/pi-coding-agent";
+import type { InstalledPackage, 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[]): InstalledPackage[] {
+  const byIdentity = new Map<string, InstalledPackage>();
+
+  for (const pkg of packages) {
+    const identity = normalizePackageIdentity(
+      pkg.source,
+      pkg.resolvedPath ? { resolvedPath: pkg.resolvedPath } : undefined
+    );
+
+    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)
+      );
+    },
+
+    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;
+}

package/src/packages/discovery.ts

@@ -12,12 +12,8 @@ import type { InstalledPackage, NpmPackage, SearchCache } from "../types/index.j
 import { CACHE_TTL, TIMEOUTS } from "../constants.js";
 import { readSummary } from "../utils/fs.js";
 import { parseNpmSource } from "../utils/format.js";
-import {
-  getPackageSourceKind,
-  normalizePackageIdentity,
-  splitGitRepoAndRef,
-  stripGitSourcePrefix,
-} from "../utils/package-source.js";
+import { normalizePackageIdentity } from "../utils/package-source.js";
+import { getPackageCatalog } from "./catalog.js";
 import { execNpm } from "../utils/npm-exec.js";
 import { fetchWithTimeout } from "../utils/network.js";
 
@@ -41,6 +37,18 @@ interface NpmSearchResponse {
 
 let searchCache: SearchCache | null = null;
 
+function createAbortError(): Error {
+  const error = new Error("Operation cancelled");
+  error.name = "AbortError";
+  return error;
+}
+
+function throwIfAborted(signal?: AbortSignal): void {
+  if (signal?.aborted) {
+    throw createAbortError();
+  }
+}
+
 export function getSearchCache(): SearchCache | null {
   return searchCache;
 }
@@ -88,7 +96,8 @@ function toNpmPackage(entry: NpmSearchResultObject): NpmPackage | undefined {
 
 async function fetchNpmSearchPage(
   query: string,
-  from: number
+  from: number,
+  signal?: AbortSignal
 ): Promise<{
   total: number;
   resultCount: number;
@@ -101,7 +110,8 @@ async function fetchNpmSearchPage(
   });
   const response = await fetchWithTimeout(
     `${NPM_SEARCH_API}?${params.toString()}`,
-    TIMEOUTS.npmSearch
+    TIMEOUTS.npmSearch,
+    signal
   );
 
   if (!response.ok) {
@@ -120,13 +130,16 @@ async function fetchNpmSearchPage(
   };
 }
 
-export async function fetchNpmRegistrySearchResults(query: string): Promise<NpmPackage[]> {
+export async function fetchNpmRegistrySearchResults(
+  query: string,
+  signal?: AbortSignal
+): Promise<NpmPackage[]> {
   const packagesByName = new Map<string, NpmPackage>();
   let from = 0;
   let total = Infinity;
 
   while (from < total) {
-    const page = await fetchNpmSearchPage(query, from);
+    const page = await fetchNpmSearchPage(query, from, signal);
     total = page.total;
 
     if (page.resultCount === 0) {
@@ -148,11 +161,10 @@ export async function fetchNpmRegistrySearchResults(query: string): Promise<NpmP
 export async function searchNpmPackages(
   query: string,
   ctx: ExtensionCommandContext,
-  _pi: ExtensionAPI
+  options?: { signal?: AbortSignal }
 ): Promise<NpmPackage[]> {
-  // Check persistent cache first
   const cached = await getCachedSearch(query);
-  if (cached && cached.length > 0) {
+  if (cached) {
     if (ctx.hasUI) {
       ctx.ui.notify(`Using ${cached.length} cached results`, "info");
     }
@@ -163,7 +175,7 @@ export async function searchNpmPackages(
     ctx.ui.notify(`Searching npm for "${query}"...`, "info");
   }
 
-  const packages = await fetchNpmRegistrySearchResults(query);
+  const packages = await fetchNpmRegistrySearchResults(query, options?.signal);
 
   // Cache the results
   await setCachedSearch(query, packages);
@@ -174,31 +186,21 @@ export async function searchNpmPackages(
 export async function getInstalledPackages(
   ctx: ExtensionCommandContext | ExtensionContext,
   pi: ExtensionAPI,
-  onProgress?: (current: number, total: number) => void
+  onProgress?: (current: number, total: number) => void,
+  signal?: AbortSignal
 ): Promise<InstalledPackage[]> {
-  const res = await pi.exec("pi", ["list"], { timeout: TIMEOUTS.listPackages, cwd: ctx.cwd });
-  if (res.code !== 0) return [];
+  throwIfAborted(signal);
 
-  const text = res.stdout || "";
-  if (!text.trim() || /No packages installed/i.test(text)) {
+  const packages = await getPackageCatalog(ctx.cwd).listInstalledPackages();
+  if (packages.length === 0) {
     return [];
   }
 
-  const packages = parseInstalledPackagesOutput(text);
-
-  // Fetch metadata (descriptions and sizes) for packages in parallel
-  await addPackageMetadata(packages, ctx, pi, onProgress);
-
+  await addPackageMetadata(packages, ctx, pi, onProgress, signal);
+  throwIfAborted(signal);
   return packages;
 }
 
-function sanitizeListSourceSuffix(source: string): string {
-  return source
-    .trim()
-    .replace(/\s+\((filtered|pinned)\)$/i, "")
-    .trim();
-}
-
 function getInstalledPackageIdentity(pkg: InstalledPackage): string {
   return normalizePackageIdentity(
     pkg.source,
@@ -206,224 +208,26 @@ function getInstalledPackageIdentity(pkg: InstalledPackage): string {
   );
 }
 
-function isScopeHeader(lowerTrimmed: string, scope: "global" | "project"): boolean {
-  if (scope === "global") {
-    return (
-      lowerTrimmed === "global" ||
-      lowerTrimmed === "user" ||
-      lowerTrimmed.startsWith("global packages") ||
-      lowerTrimmed.startsWith("global:") ||
-      lowerTrimmed.startsWith("user packages") ||
-      lowerTrimmed.startsWith("user:")
-    );
-  }
-
-  return (
-    lowerTrimmed === "project" ||
-    lowerTrimmed === "local" ||
-    lowerTrimmed.startsWith("project packages") ||
-    lowerTrimmed.startsWith("project:") ||
-    lowerTrimmed.startsWith("local packages") ||
-    lowerTrimmed.startsWith("local:")
-  );
-}
-
-function looksLikePackageSource(source: string): boolean {
-  return getPackageSourceKind(source) !== "unknown";
-}
-
-function parseResolvedPathLine(line: string): string | undefined {
-  const resolvedMatch = line.match(/^resolved\s*:\s*(.+)$/i);
-  if (resolvedMatch?.[1]) {
-    return resolvedMatch[1].trim();
-  }
-
-  if (
-    line.startsWith("/") ||
-    line.startsWith("./") ||
-    line.startsWith("../") ||
-    line.startsWith(".\\") ||
-    line.startsWith("..\\") ||
-    line.startsWith("~/") ||
-    line.startsWith("file://") ||
-    /^[a-zA-Z]:[\\/]/.test(line) ||
-    line.startsWith("\\\\")
-  ) {
-    return line;
-  }
-
-  return undefined;
-}
-
-function parseInstalledPackagesOutputInternal(text: string): InstalledPackage[] {
-  const packages: InstalledPackage[] = [];
-
-  const lines = text.split("\n");
-  let currentScope: "global" | "project" = "global";
-  let currentPackage: InstalledPackage | undefined;
-
-  for (const rawLine of lines) {
-    if (!rawLine.trim()) continue;
-
-    const isIndented = /^(?:\t+|\s{4,})/.test(rawLine);
-    const trimmed = rawLine.trim();
-
-    if (isIndented && currentPackage) {
-      const resolved = parseResolvedPathLine(trimmed);
-      if (resolved) {
-        currentPackage.resolvedPath = resolved;
-      }
-      continue;
-    }
-
-    const lowerTrimmed = trimmed.toLowerCase();
-    if (isScopeHeader(lowerTrimmed, "global")) {
-      currentScope = "global";
-      currentPackage = undefined;
-      continue;
-    }
-    if (isScopeHeader(lowerTrimmed, "project")) {
-      currentScope = "project";
-      currentPackage = undefined;
-      continue;
-    }
-
-    const candidate = trimmed.replace(/^[-•]?\s*/, "").trim();
-    if (!looksLikePackageSource(candidate)) continue;
-
-    const source = sanitizeListSourceSuffix(candidate);
-    const { name, version } = parsePackageNameAndVersion(source);
-
-    const pkg: InstalledPackage = { source, name, scope: currentScope };
-    if (version !== undefined) {
-      pkg.version = version;
-    }
-    packages.push(pkg);
-    currentPackage = pkg;
-  }
-
-  return packages;
-}
-
-function shouldReplaceInstalledPackage(
-  current: InstalledPackage | undefined,
-  candidate: InstalledPackage
-): boolean {
-  if (!current) {
-    return true;
-  }
-
-  if (current.scope !== candidate.scope) {
-    return candidate.scope === "project";
-  }
-
-  return false;
-}
-
-export function parseInstalledPackagesOutput(text: string): InstalledPackage[] {
-  const parsed = parseInstalledPackagesOutputInternal(text);
-  const deduped = new Map<string, InstalledPackage>();
-
-  for (const pkg of parsed) {
-    const identity = getInstalledPackageIdentity(pkg);
-    const current = deduped.get(identity);
-    if (shouldReplaceInstalledPackage(current, pkg)) {
-      deduped.set(identity, pkg);
-    }
-  }
-
-  return Array.from(deduped.values());
-}
-
-/**
- * Check whether a specific package source is installed.
- * Matches on normalized package source and optional scope.
- */
 export async function isSourceInstalled(
   source: string,
   ctx: ExtensionCommandContext | ExtensionContext,
-  pi: ExtensionAPI,
   options?: { scope?: "global" | "project" }
 ): Promise<boolean> {
-  try {
-    const res = await pi.exec("pi", ["list"], { timeout: TIMEOUTS.listPackages, cwd: ctx.cwd });
-    if (res.code !== 0) return false;
-
-    const installed = parseInstalledPackagesOutputAllScopes(res.stdout || "");
-    const expected = normalizePackageIdentity(source);
-
-    return installed.some((pkg) => {
-      if (getInstalledPackageIdentity(pkg) !== expected) {
-        return false;
-      }
-      return options?.scope ? pkg.scope === options.scope : true;
-    });
-  } catch {
-    return false;
-  }
-}
-
-/**
- * parseInstalledPackagesOutputAllScopes returns the raw parsed entries from
- * parseInstalledPackagesOutputInternal without deduplication or scope merging.
- * Prefer parseInstalledPackagesOutput for user-facing lists, since it applies
- * deduplication and normalized scope selection.
- */
-export function parseInstalledPackagesOutputAllScopes(text: string): InstalledPackage[] {
-  return parseInstalledPackagesOutputInternal(text);
-}
-
-function extractGitPackageName(repoSpec: string): string {
-  // git@github.com:user/repo(.git)
-  if (repoSpec.startsWith("git@")) {
-    const afterColon = repoSpec.split(":").slice(1).join(":");
-    if (afterColon) {
-      const last = afterColon.split("/").pop() || afterColon;
-      return last.replace(/\.git$/i, "") || repoSpec;
-    }
-  }
+  const installed = await getPackageCatalog(ctx.cwd).listInstalledPackages({ dedupe: false });
+  const expected = normalizePackageIdentity(source);
 
-  // https://..., ssh://..., git://...
-  try {
-    const url = new URL(repoSpec);
-    const last = url.pathname.split("/").filter(Boolean).pop();
-    if (last) {
-      return last.replace(/\.git$/i, "") || repoSpec;
+  return installed.some((pkg) => {
+    if (getInstalledPackageIdentity(pkg) !== expected) {
+      return false;
     }
-  } catch {
-    // Fallback below
-  }
-
-  const last = repoSpec.split(/[/:]/).filter(Boolean).pop();
-  return (last ? last.replace(/\.git$/i, "") : repoSpec) || repoSpec;
+    return options?.scope ? pkg.scope === options.scope : true;
+  });
 }
 
-function parsePackageNameAndVersion(fullSource: string): {
-  name: string;
-  version?: string | undefined;
-} {
-  const parsedNpm = parseNpmSource(fullSource);
-  if (parsedNpm) {
-    return parsedNpm;
-  }
-
-  const sourceKind = getPackageSourceKind(fullSource);
-  if (sourceKind === "git") {
-    const gitSpec = stripGitSourcePrefix(fullSource);
-    const { repo } = splitGitRepoAndRef(gitSpec);
-    return { name: extractGitPackageName(repo) };
-  }
-
-  if (fullSource.includes("node_modules/")) {
-    const nmMatch = fullSource.match(/node_modules\/(.+)$/);
-    if (nmMatch?.[1]) {
-      return { name: nmMatch[1] };
-    }
-  }
-
-  const pathParts = fullSource.split(/[\\/]/);
-  const fileName = pathParts[pathParts.length - 1];
-  return { name: fileName || fullSource };
+export async function getInstalledPackagesAllScopes(
+  ctx: ExtensionCommandContext | ExtensionContext
+): Promise<InstalledPackage[]> {
+  return getPackageCatalog(ctx.cwd).listInstalledPackages({ dedupe: false });
 }
 
 async function hydratePackageFromResolvedPath(pkg: InstalledPackage): Promise<void> {
@@ -471,7 +275,8 @@ async function hydratePackageFromResolvedPath(pkg: InstalledPackage): Promise<vo
 async function fetchPackageSize(
   pkgName: string,
   ctx: ExtensionCommandContext | ExtensionContext,
-  pi: ExtensionAPI
+  pi: ExtensionAPI,
+  signal?: AbortSignal
 ): Promise<number | undefined> {
   // Check cache first
   const cachedSize = await getCachedPackageSize(pkgName);
@@ -481,6 +286,7 @@ async function fetchPackageSize(
     // Try to get unpacked size from npm view
     const res = await execNpm(pi, ["view", pkgName, "dist.unpackedSize", "--json"], ctx, {
       timeout: TIMEOUTS.npmView,
+      ...(signal ? { signal } : {}),
     });
     if (res.code === 0) {
       try {
@@ -503,25 +309,29 @@ async function addPackageMetadata(
   packages: InstalledPackage[],
   ctx: ExtensionCommandContext | ExtensionContext,
   pi: ExtensionAPI,
-  onProgress?: (current: number, total: number) => void
+  onProgress?: (current: number, total: number) => void,
+  signal?: AbortSignal
 ): Promise<void> {
-  // First, try to get descriptions from cache
+  throwIfAborted(signal);
+
   const cachedDescriptions = await getPackageDescriptions(packages);
   for (const [source, description] of cachedDescriptions) {
     const pkg = packages.find((p) => p.source === source);
     if (pkg) pkg.description = description;
   }
 
-  // Process remaining packages in batches
   const batchSize = 5;
   for (let i = 0; i < packages.length; i += batchSize) {
+    throwIfAborted(signal);
+
     const batch = packages.slice(i, i + batchSize);
 
-    // Report progress
     onProgress?.(i, packages.length);
 
     await Promise.all(
       batch.map(async (pkg) => {
+        throwIfAborted(signal);
+
         await hydratePackageFromResolvedPath(pkg);
 
         const needsDescription = !pkg.description;
@@ -546,6 +356,7 @@ async function addPackageMetadata(
                 } else {
                   const res = await execNpm(pi, ["view", pkgName, "description", "--json"], ctx, {
                     timeout: TIMEOUTS.npmView,
+                    ...(signal ? { signal } : {}),
                   });
                   if (res.code === 0) {
                     try {
@@ -565,7 +376,7 @@ async function addPackageMetadata(
               }
 
               if (needsSize) {
-                pkg.size = await fetchPackageSize(pkgName, ctx, pi);
+                pkg.size = await fetchPackageSize(pkgName, ctx, pi, signal);
               }
             }
           } else if (pkg.source.startsWith("git:")) {
@@ -578,8 +389,9 @@ async function addPackageMetadata(
         }
       })
     );
+
+    throwIfAborted(signal);
   }
 
-  // Final progress update
   onProgress?.(packages.length, packages.length);
 }