pi-extmgr 0.1.27 → 0.2.0

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,27 +16,31 @@ 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.20.0`.
 
 ## Features
 
 - **Unified manager UI**
   - Local extensions (`~/.pi/agent/extensions`, `.pi/extensions`) and installed packages in one list
-  - Scope indicators (global/project), status indicators, update badges
+  - Grouped sections for local extensions vs installed packages
+  - Compact rows with selected-item details below the list, so large extension sets stay scannable
+  - Built-in search and filter shortcuts for large extension sets
+  - Scope indicators (global/project), status indicators, update badges, and package sizes when known
 - **Package extension configuration panel**
   - Configure individual extension entrypoints inside an installed package (`c` on package row)
   - Works with manifest-declared entrypoints and conventional `extensions/` package layouts
   - Persists to package filters in `settings.json` (no manual JSON editing)
 - **Safe staged local extension toggles**
-  - Toggle with `Space/Enter`, apply with `S`
+  - Toggle with `Space`, apply with `S`
   - Unsaved-change guard when leaving (save/discard/stay)
 - **Package management**
   - Install, update, remove from UI and command line
   - Quick actions (`A`, `u`, `X`) and bulk update (`U`)
 - **Remote discovery and install**
-  - npm search/browse with pagination
+  - npm search/browse with pagination, inline browse search, and keyboard page navigation
+  - Path- and git-like queries are handled explicitly instead of surfacing unrelated npm results
   - 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`
@@ -65,20 +70,26 @@ Open the manager:
 | Key           | Action                                                |
 | ------------- | ----------------------------------------------------- |
 | `↑↓`          | Navigate                                              |
-| `Space/Enter` | Toggle local extension on/off                         |
+| `PageUp/Down` | Jump through longer lists                             |
+| `Home/End`    | Jump to top or bottom                                 |
+| `Space`       | Toggle selected local extension on/off                |
 | `S`           | Save local extension changes                          |
-| `Enter` / `A` | Actions on selected package (configure/update/remove) |
+| `Enter` / `A` | Actions on selected item                              |
+| `/` / `Ctrl+F`| Search visible items                                  |
+| `Tab` / `Shift+Tab` | Cycle filters                                  |
+| `1-5`         | Filters: All / Local / Packages / Updates / Disabled  |
 | `c`           | Configure selected package extensions                 |
 | `u`           | Update selected package directly                      |
+| `V`           | View full details for selected item                   |
 | `X`           | Remove selected item (package/local extension)        |
 | `i`           | Quick install by source                               |
-| `f`           | Quick search                                          |
+| `f`           | Remote package search                                 |
 | `U`           | Update all packages                                   |
 | `t`           | Auto-update wizard                                    |
 | `P` / `M`     | Quick actions palette                                 |
 | `R`           | Browse remote packages                                |
 | `?` / `H`     | Help                                                  |
-| `Esc`         | Exit                                                  |
+| `Esc`         | Clear search or exit                                  |
 
 ### Commands
 
@@ -155,7 +166,7 @@ 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extmgr",
-  "version": "0.1.27",
+  "version": "0.2.0",
   "description": "Enhanced UX for managing local Pi extensions and community packages",
   "keywords": [
     "pi-package",
@@ -19,14 +19,20 @@
     "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",
+    "release": "release-it",
+    "release:patch": "release-it patch",
+    "release:minor": "release-it minor",
+    "release:major": "release-it major",
+    "release:first": "release-it --first-release",
+    "release:ci": "node --import=tsx ./scripts/release-ci.ts",
     "prepublishOnly": "pnpm run check",
     "prepare": "husky"
   },
@@ -42,22 +48,21 @@
     "@mariozechner/pi-tui": "*"
   },
   "devDependencies": {
-    "@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",
-    "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",
+    "@release-it/conventional-changelog": "^10.0.5",
+    "@types/node": "^22.19.10",
     "husky": "^9.1.7",
-    "prettier": "^3.8.1",
-    "tsx": "^4.19.3",
+    "release-it": "^19.2.4",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
   "author": "ayagmar",
   "license": "MIT",
+  "packageManager": "pnpm@10.33.0",
   "engines": {
-    "node": ">=22.5.0"
+    "node": ">=22.20.0"
   },
   "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,
@@ -54,7 +54,7 @@ export async function handleAutoUpdateSubcommand(
       "  3d      - Check every 3 days",
       "  1w      - Check weekly",
       "  2w      - Check every 2 weeks",
-      "  1mo     - Check monthly (1m also works)",
+      "  1mo     - Check monthly",
       "  daily   - Check daily (alias)",
       "  weekly  - Check weekly (alias)",
     ];

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,11 +1,12 @@
-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 { parseLookbackDuration } from "../utils/duration.js";
 import { notify } from "../utils/notify.js";
 import { formatListOutput } from "../utils/ui-helpers.js";
 
@@ -37,36 +38,6 @@ type HistoryOptionHandler = (tokens: string[], index: number, state: HistoryPars
 
 const HISTORY_ACTION_SET = new Set<ChangeAction>(HISTORY_ACTIONS);
 
-function parseHistorySinceDuration(input: string): number | undefined {
-  const normalized = input.toLowerCase().trim();
-  const match = normalized.match(
-    /^(\d+)\s*(m|min|mins|minute|minutes|h|hr|hrs|hour|hours|d|day|days|w|wk|wks|week|weeks|mo|mos|month|months)$/
-  );
-  if (!match) return undefined;
-
-  const value = Number.parseInt(match[1] ?? "", 10);
-  if (!Number.isFinite(value) || value <= 0) return undefined;
-
-  const unit = match[2] ?? "";
-  if (unit.startsWith("m") && !unit.startsWith("mo")) {
-    return value * 60 * 1000;
-  }
-  if (unit.startsWith("h")) {
-    return value * 60 * 60 * 1000;
-  }
-  if (unit.startsWith("d")) {
-    return value * 24 * 60 * 60 * 1000;
-  }
-  if (unit.startsWith("w")) {
-    return value * 7 * 24 * 60 * 60 * 1000;
-  }
-  if (unit.startsWith("mo")) {
-    return value * 30 * 24 * 60 * 60 * 1000;
-  }
-
-  return undefined;
-}
-
 const HISTORY_OPTION_HANDLERS: Record<string, HistoryOptionHandler> = {
   "--help": (_tokens, _index, state) => {
     state.showHelp = true;
@@ -142,7 +113,7 @@ const HISTORY_OPTION_HANDLERS: Record<string, HistoryOptionHandler> = {
       return 0;
     }
 
-    const ms = parseHistorySinceDuration(value);
+    const ms = parseLookbackDuration(value);
     if (!ms) {
       state.errors.push(`Invalid --since duration: ${value}`);
     } else {

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/constants.ts

@@ -26,14 +26,6 @@ export const TIMEOUTS = {
   npmView: 10_000,
   /** Full package installation timeout (3 minutes) */
   packageInstall: 180_000,
-  /** Package update timeout (2 minutes) */
-  packageUpdate: 120_000,
-  /** Bulk package update timeout (5 minutes) */
-  packageUpdateAll: 300_000,
-  /** Package removal timeout (1 minute) */
-  packageRemove: 60_000,
-  /** Package listing timeout */
-  listPackages: 10_000,
   /** Package metadata fetch timeout */
   fetchPackageInfo: 30_000,
   /** Package extraction timeout */

package/src/extensions/discovery.ts

@@ -4,13 +4,19 @@
  * 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 { readPackageManifest } from "../packages/extensions.js";
+import { type ExtensionEntry, type Scope, type State } from "../types/index.js";
 import { fileExists, readSummary } from "../utils/fs.js";
+import {
+  normalizeRelativePath,
+  resolveRelativePathSelection,
+} from "../utils/relative-path-selection.js";
 
 interface RootConfig {
   root: string;
@@ -93,8 +99,7 @@ async function discoverInRoot(
     }
 
     if (item.isDirectory()) {
-      const entry = await parseDirectoryIndex(root, label, scope, name);
-      if (entry) found.push(entry);
+      found.push(...(await parseDirectoryExtensions(root, label, scope, name)));
     }
   }
 
@@ -140,53 +145,131 @@ async function parseTopLevelFile(
   };
 }
 
+function stripDisabledSuffix(path: string): string {
+  return path.replace(/\.(ts|js)\.disabled$/i, ".$1");
+}
+
+function isExtensionEntrypointPath(path: string): boolean {
+  return /\.(ts|js)$/i.test(path);
+}
+
+function isLocalExtensionFile(path: string): boolean {
+  return /\.(ts|js)(?:\.disabled)?$/i.test(path);
+}
+
+async function collectLocalExtensionFiles(rootDir: string, startDir: string): Promise<string[]> {
+  const collected: string[] = [];
+
+  let entries: Dirent[];
+  try {
+    entries = await readdir(startDir, { withFileTypes: true });
+  } catch {
+    return collected;
+  }
+
+  for (const entry of entries) {
+    if (entry.name.startsWith(".")) {
+      continue;
+    }
+
+    const absolutePath = join(startDir, entry.name);
+    if (entry.isDirectory()) {
+      collected.push(...(await collectLocalExtensionFiles(rootDir, absolutePath)));
+      continue;
+    }
+
+    if (!entry.isFile()) {
+      continue;
+    }
+
+    const relativePath = normalizeRelativePath(relative(rootDir, absolutePath));
+    if (isLocalExtensionFile(relativePath)) {
+      collected.push(stripDisabledSuffix(relativePath));
+    }
+  }
+
+  return collected;
+}
+
+async function resolveManifestLocalEntrypoints(dir: string): Promise<string[] | undefined> {
+  const manifest = await readPackageManifest(dir);
+  const extensions = manifest?.pi?.extensions;
+  if (!Array.isArray(extensions)) {
+    return undefined;
+  }
+
+  const entries = extensions.filter((value): value is string => typeof value === "string");
+  const allFiles = await collectLocalExtensionFiles(dir, dir);
+  return resolveRelativePathSelection(
+    allFiles,
+    entries,
+    (path, files) => isExtensionEntrypointPath(path) && files.includes(path)
+  );
+}
+
+async function toDirectoryExtensionEntry(
+  root: string,
+  label: string,
+  scope: Scope,
+  dir: string,
+  extensionPath: string
+): Promise<ExtensionEntry | undefined> {
+  const normalizedPath = normalizeRelativePath(extensionPath);
+  const activePath = join(dir, normalizedPath);
+  const disabledPath = `${activePath}${DISABLED_SUFFIX}`;
+
+  let state: State;
+  let summaryPath: string;
+  if (await fileExists(activePath)) {
+    state = "enabled";
+    summaryPath = activePath;
+  } else if (await fileExists(disabledPath)) {
+    state = "disabled";
+    summaryPath = disabledPath;
+  } else {
+    return undefined;
+  }
+
+  return {
+    id: `${scope}:${activePath}`,
+    scope,
+    state,
+    activePath,
+    disabledPath,
+    displayName: `${label}/${normalizeRelativePath(relative(root, activePath))}`,
+    summary: await readSummary(summaryPath),
+  };
+}
+
 /**
- * Parse a directory containing an index.ts/js file as an extension entry.
- *
- * @param root - Root directory path
- * @param label - Display label for the root
- * @param scope - "global" or "project"
- * @param dirName - Name of the directory to parse
- * @returns ExtensionEntry if index file found, undefined otherwise
+ * Parse a directory containing a manifest-declared entrypoint or index.ts/js file as one or more
+ * extension entries.
  */
-async function parseDirectoryIndex(
+async function parseDirectoryExtensions(
   root: string,
   label: string,
   scope: Scope,
   dirName: string
-): Promise<ExtensionEntry | undefined> {
+): Promise<ExtensionEntry[]> {
   const dir = join(root, dirName);
+  const manifestEntrypoints = await resolveManifestLocalEntrypoints(dir);
 
-  for (const ext of [".ts", ".js"]) {
-    const activePath = join(dir, `index${ext}`);
-    const disabledPath = `${activePath}${DISABLED_SUFFIX}`;
-
-    if (await fileExists(activePath)) {
-      return {
-        id: `${scope}:${activePath}`,
-        scope,
-        state: "enabled",
-        activePath,
-        disabledPath,
-        displayName: `${label}/${dirName}/index${ext}`,
-        summary: await readSummary(activePath),
-      };
-    }
-
-    if (await fileExists(disabledPath)) {
-      return {
-        id: `${scope}:${activePath}`,
-        scope,
-        state: "disabled",
-        activePath,
-        disabledPath,
-        displayName: `${label}/${dirName}/index${ext}`,
-        summary: await readSummary(disabledPath),
-      };
-    }
+  if (manifestEntrypoints !== undefined) {
+    const entries = await Promise.all(
+      manifestEntrypoints.map((extensionPath) =>
+        toDirectoryExtensionEntry(root, label, scope, dir, extensionPath)
+      )
+    );
+    return entries.filter((entry): entry is ExtensionEntry => Boolean(entry));
   }
 
-  return undefined;
+  const fallbackEntries = await Promise.all(
+    ["index.ts", "index.js"].map((extensionPath) =>
+      toDirectoryExtensionEntry(root, label, scope, dir, extensionPath)
+    )
+  );
+
+  return fallbackEntries.filter((entry): entry is ExtensionEntry => Boolean(entry)).slice(0, 1);
 }
 
 /**

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

@@ -1,11 +1,11 @@
 import {
   DefaultPackageManager,
   getAgentDir,
-  SettingsManager,
   type PackageSource,
   type ProgressEvent,
+  SettingsManager,
 } from "@mariozechner/pi-coding-agent";
-import type { InstalledPackage, Scope } from "../types/index.js";
+import { type InstalledPackage, type Scope } from "../types/index.js";
 import { normalizePackageIdentity, parsePackageNameAndVersion } from "../utils/package-source.js";
 
 type PiScope = "user" | "project";
@@ -57,14 +57,15 @@ function createPackageRecord(
   };
 }
 
-function dedupeInstalledPackages(packages: InstalledPackage[]): InstalledPackage[] {
+function dedupeInstalledPackages(packages: InstalledPackage[], cwd: string): InstalledPackage[] {
   const byIdentity = new Map<string, InstalledPackage>();
 
   for (const pkg of packages) {
-    const identity = normalizePackageIdentity(
-      pkg.source,
-      pkg.resolvedPath ? { resolvedPath: pkg.resolvedPath } : undefined
-    );
+    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);
@@ -97,7 +98,7 @@ function createDefaultPackageCatalog(cwd: string): PackageCatalog {
 
       const installed = [...projectPackages, ...globalPackages];
       return Promise.resolve(
-        options?.dedupe === false ? installed : dedupeInstalledPackages(installed)
+        options?.dedupe === false ? installed : dedupeInstalledPackages(installed, cwd)
       );
     },