@unbrained/pm-cli 2026.7.6 → 2026.7.8

package/dist/cli/commands/extension/bundled-catalog.d.ts

@@ -14,6 +14,9 @@ export declare function isBundledPackageInstallAllTarget(input: string): boolean
 export declare function listBundledPackageAliases(): Promise<string[]>;
 /**
  * Implements resolve bundled package root for the public runtime surface of this module.
+ * Accepts every spelling agents naturally reach for: the catalog alias
+ * ("kanban"), the package directory ("pm-kanban"), and the published npm name
+ * ("@unbrained/pm-kanban").
  */
 export declare function resolveBundledPackageRoot(alias: string): Promise<string | null>;
 /**

package/dist/cli/commands/extension/bundled-catalog.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Bundled Catalog.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ce7070ac-9aa5-56b7-b6dd-80ff19b24553")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d4026cdd-6e38-5550-b33e-94d5c7b97e58")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { collectPackageExtensionDirectories, PM_PACKAGE_RESOURCE_KINDS, readPmPackageManifest } from "../../../core/packages/manifest.js";
@@ -74,6 +74,34 @@ export function isBundledPackageInstallAllTarget(input) {
 function derivePackageAlias(packageDirectory) {
     return packageDirectory.replace(/^pm-/i, "").trim().toLowerCase();
 }
+async function collectManifestPackageEntries(packagesRoot, entriesByAlias) {
+    const entries = await fs.readdir(packagesRoot, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isDirectory() || !entry.name.startsWith("pm-")) {
+            continue;
+        }
+        const candidateRoot = path.join(packagesRoot, entry.name);
+        if (!(await pathExists(path.join(candidateRoot, "package.json")))) {
+            continue;
+        }
+        const manifest = await readPmPackageManifest(candidateRoot);
+        const aliases = manifest.aliases && manifest.aliases.length > 0
+            ? manifest.aliases
+            : [derivePackageAlias(entry.name)];
+        for (const alias of aliases) {
+            const normalizedAlias = alias.trim().toLowerCase();
+            if (normalizedAlias.length === 0 || entriesByAlias.has(normalizedAlias)) {
+                continue;
+            }
+            entriesByAlias.set(normalizedAlias, {
+                alias: normalizedAlias,
+                package_directory: entry.name,
+                package_root: candidateRoot,
+                package_name: manifest.package_name ?? null,
+            });
+        }
+    }
+}
 async function collectBundledPackageEntries() {
     const entriesByAlias = new Map();
     for (const packageRoot of resolvePackageRootCandidates()) {
@@ -81,31 +109,7 @@ async function collectBundledPackageEntries() {
         if (!(await pathExists(packagesRoot))) {
             continue;
         }
-        const entries = await fs.readdir(packagesRoot, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory() || !entry.name.startsWith("pm-")) {
-                continue;
-            }
-            const candidateRoot = path.join(packagesRoot, entry.name);
-            if (!(await pathExists(path.join(candidateRoot, "package.json")))) {
-                continue;
-            }
-            const manifest = await readPmPackageManifest(candidateRoot);
-            const aliases = manifest.aliases && manifest.aliases.length > 0
-                ? manifest.aliases
-                : [derivePackageAlias(entry.name)];
-            for (const alias of aliases) {
-                const normalizedAlias = alias.trim().toLowerCase();
-                if (normalizedAlias.length === 0 || entriesByAlias.has(normalizedAlias)) {
-                    continue;
-                }
-                entriesByAlias.set(normalizedAlias, {
-                    alias: normalizedAlias,
-                    package_directory: entry.name,
-                    package_root: candidateRoot,
-                });
-            }
-        }
+        await collectManifestPackageEntries(packagesRoot, entriesByAlias);
     }
     for (const [alias, legacy] of Object.entries(LEGACY_BUNDLED_PACKAGE_ALIASES)) {
         /* c8 ignore start -- canonical aliases are present in bundled package manifests */
@@ -121,6 +125,7 @@ async function collectBundledPackageEntries() {
                     alias,
                     package_directory: legacy.package_directory,
                     package_root: packagePath,
+                    package_name: null,
                 });
                 break;
             }
@@ -137,10 +142,15 @@ export async function listBundledPackageAliases() {
 }
 /**
  * Implements resolve bundled package root for the public runtime surface of this module.
+ * Accepts every spelling agents naturally reach for: the catalog alias
+ * ("kanban"), the package directory ("pm-kanban"), and the published npm name
+ * ("@unbrained/pm-kanban").
  */
 export async function resolveBundledPackageRoot(alias) {
     const normalized = alias.trim().toLowerCase();
-    const entry = (await collectBundledPackageEntries()).find((candidate) => candidate.alias === normalized);
+    const entry = (await collectBundledPackageEntries()).find((candidate) => candidate.alias === normalized ||
+        candidate.package_directory.toLowerCase() === normalized ||
+        candidate.package_name?.toLowerCase() === normalized);
     return entry?.package_root ?? null;
 }
 /**
@@ -319,4 +329,4 @@ export const _testOnlyBundledCatalog = {
     projectPackageCatalogEntry,
 };
 //# sourceMappingURL=bundled-catalog.js.map
-//# debugId=ce7070ac-9aa5-56b7-b6dd-80ff19b24553
+//# debugId=d4026cdd-6e38-5550-b33e-94d5c7b97e58

package/dist/cli/commands/extension/bundled-catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundled-catalog.js","sources":["cli/commands/extension/bundled-catalog.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/bundled-catalog\n *\n * Implements extension package-management support for Bundled Catalog.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { collectPackageExtensionDirectories, PM_PACKAGE_RESOURCE_KINDS, readPmPackageManifest } from \"../../../core/packages/manifest.js\";\nimport { resolvePmPackageRootFromModule } from \"../../../core/packages/root.js\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../../core/shared/split-comma-list.js\";\nimport { resolveExtensionRoots } from \"../../../core/extensions/loader.js\";\nimport { resolvePmRoot } from \"../../../core/store/paths.js\";\nimport { validateExtensionDirectory } from \"./shared.js\";\nimport { readManagedExtensionState } from \"./managed-state.js\";\nimport type { ExtensionCommandOptions, ExtensionScope } from \"../extension.js\";\n\nconst PM_PACKAGE_ROOT_ENV = \"PM_CLI_PACKAGE_ROOT\";\nconst LEGACY_BUNDLED_PACKAGE_ALIASES: Record<string, { package_directory: string; legacy_extension_directory: string }> = {\n  beads: {\n    package_directory: \"pm-beads\",\n    legacy_extension_directory: \"beads\",\n  },\n  todos: {\n    package_directory: \"pm-todos\",\n    legacy_extension_directory: \"todos\",\n  },\n};\nconst BUNDLED_PACKAGE_INSTALL_ALL_TARGETS = new Set([\"*\", \"all\"]);\n\ninterface BundledPackageEntry {\n  alias: string;\n  package_directory: string;\n  package_root: string;\n}\n\nfunction resolvePackageRootCandidates(): string[] {\n  const candidates: string[] = [];\n  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];\n  /* c8 ignore start -- env-root override branch is exercised by package-root integration tests */\n  if (typeof envRoot === \"string\" && envRoot.trim().length > 0) {\n    candidates.push(path.resolve(envRoot.trim()));\n  }\n  /* c8 ignore stop */\n  candidates.push(resolvePmPackageRootFromModule(import.meta.url, [\"../../../..\"]));\n  return [...new Set(candidates)];\n}\n\n/**\n * Implements resolve bundled extension alias source for the public runtime surface of this module.\n */\nexport async function resolveBundledExtensionAliasSource(input: string): Promise<string | null> {\n  const normalized = input.trim().toLowerCase();\n  const packageRoot = await resolveBundledPackageRoot(normalized);\n  if (packageRoot) {\n    return packageRoot;\n  }\n\n  const alias = LEGACY_BUNDLED_PACKAGE_ALIASES[normalized];\n  /* c8 ignore start -- known aliases resolve through package manifests in normal runtime */\n  if (!alias) {\n    return null;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- exercised only when legacy extension paths exist without package manifests */\n  for (const packageRoot of resolvePackageRootCandidates()) {\n    const legacyExtensionPath = path.join(packageRoot, \".agents\", \"pm\", \"extensions\", alias.legacy_extension_directory);\n    if (await pathExists(path.join(legacyExtensionPath, \"manifest.json\"))) {\n      return legacyExtensionPath;\n    }\n  }\n  return null;\n  /* c8 ignore stop */\n}\n\n/**\n * Implements check whether bundled package install all target for the public runtime surface of this module.\n */\nexport function isBundledPackageInstallAllTarget(input: string): boolean {\n  return BUNDLED_PACKAGE_INSTALL_ALL_TARGETS.has(input.trim().toLowerCase());\n}\n\nfunction derivePackageAlias(packageDirectory: string): string {\n  return packageDirectory.replace(/^pm-/i, \"\").trim().toLowerCase();\n}\n\nasync function collectBundledPackageEntries(): Promise<BundledPackageEntry[]> {\n  const entriesByAlias = new Map<string, BundledPackageEntry>();\n  for (const packageRoot of resolvePackageRootCandidates()) {\n    const packagesRoot = path.join(packageRoot, \"packages\");\n    if (!(await pathExists(packagesRoot))) {\n      continue;\n    }\n    const entries = await fs.readdir(packagesRoot, { withFileTypes: true });\n    for (const entry of entries) {\n      if (!entry.isDirectory() || !entry.name.startsWith(\"pm-\")) {\n        continue;\n      }\n      const candidateRoot = path.join(packagesRoot, entry.name);\n      if (!(await pathExists(path.join(candidateRoot, \"package.json\")))) {\n        continue;\n      }\n      const manifest = await readPmPackageManifest(candidateRoot);\n      const aliases = manifest.aliases && manifest.aliases.length > 0\n        ? manifest.aliases\n        : [derivePackageAlias(entry.name)];\n      for (const alias of aliases) {\n        const normalizedAlias = alias.trim().toLowerCase();\n        if (normalizedAlias.length === 0 || entriesByAlias.has(normalizedAlias)) {\n          continue;\n        }\n        entriesByAlias.set(normalizedAlias, {\n          alias: normalizedAlias,\n          package_directory: entry.name,\n          package_root: candidateRoot,\n        });\n      }\n    }\n  }\n\n  for (const [alias, legacy] of Object.entries(LEGACY_BUNDLED_PACKAGE_ALIASES)) {\n    /* c8 ignore start -- canonical aliases are present in bundled package manifests */\n    if (entriesByAlias.has(alias)) {\n      continue;\n    }\n    /* c8 ignore stop */\n    /* c8 ignore start -- compatibility fallback when only legacy package layout exists */\n    for (const packageRoot of resolvePackageRootCandidates()) {\n      const packagePath = path.join(packageRoot, \"packages\", legacy.package_directory);\n      if (await pathExists(path.join(packagePath, \"package.json\"))) {\n        entriesByAlias.set(alias, {\n          alias,\n          package_directory: legacy.package_directory,\n          package_root: packagePath,\n        });\n        break;\n      }\n    }\n    /* c8 ignore stop */\n  }\n\n  return [...entriesByAlias.values()].sort((left, right) => left.alias.localeCompare(right.alias));\n}\n\n/**\n * Implements list bundled package aliases for the public runtime surface of this module.\n */\nexport async function listBundledPackageAliases(): Promise<string[]> {\n  return (await collectBundledPackageEntries()).map((entry) => entry.alias);\n}\n\n/**\n * Implements resolve bundled package root for the public runtime surface of this module.\n */\nexport async function resolveBundledPackageRoot(alias: string): Promise<string | null> {\n  const normalized = alias.trim().toLowerCase();\n  const entry = (await collectBundledPackageEntries()).find((candidate) => candidate.alias === normalized);\n  return entry?.package_root ?? null;\n}\n\n/**\n * Resolve the published npm package name for a bundled alias so install flows\n * can persist it as managed-source provenance (`source.package`). Returns null\n * when the alias is unknown or the bundled package manifest lacks a name.\n */\nexport async function resolveBundledPackageNpmName(alias: string): Promise<string | null> {\n  const packageRoot = await resolveBundledPackageRoot(alias);\n  if (!packageRoot) {\n    return null;\n  }\n  const manifest = await readPmPackageManifest(packageRoot);\n  return manifest.package_name ?? null;\n}\n\n/**\n * Implements resolve bundled alias manifest name for the public runtime surface of this module.\n */\nexport async function resolveBundledAliasManifestName(input: string): Promise<string | null> {\n  const bundledAliasSource = await resolveBundledExtensionAliasSource(input);\n  if (!bundledAliasSource) {\n    return null;\n  }\n  try {\n    const extensionDirectories = await collectPackageExtensionDirectories(bundledAliasSource);\n    if (extensionDirectories.length !== 1) {\n      return null;\n    }\n    const validated = await validateExtensionDirectory(extensionDirectories[0]);\n    return validated.manifest.name;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the catalog link block for a bundled package, preferring the explicit\n * `catalog.links.*` manifest fields and falling back to the package's\n * repository/bugs/homepage/npm metadata. The npm link is synthesized from the\n * package name unless the package is private or unnamed.\n */\nfunction buildBundledCatalogLinks(manifest: Awaited<ReturnType<typeof readPmPackageManifest>>): {\n  docs: string | undefined;\n  npm: string | undefined;\n  repository: string | undefined;\n  report: string | undefined;\n} {\n  return {\n    docs: manifest.catalog?.links?.docs ?? manifest.package_homepage,\n    npm:\n      manifest.catalog?.links?.npm ??\n      (manifest.package_name && manifest.package_private !== true\n        ? `https://www.npmjs.com/package/${encodeURIComponent(manifest.package_name)}`\n        : undefined),\n    repository: manifest.catalog?.links?.repository ?? manifest.package_repository_url,\n    report: manifest.catalog?.links?.report ?? manifest.package_bugs_url,\n  };\n}\n\n/**\n * Build one bundled-package catalog entry from its manifest, marking it\n * `installed` when the managed state for `scope` already records the package by\n * built-in alias or resolved location, and projecting the metadata-only resource\n * kinds (everything except installable `extensions`) that the package ships.\n */\nfunction buildBundledCatalogPackageEntry(\n  manifest: Awaited<ReturnType<typeof readPmPackageManifest>>,\n  bundledEntry: BundledPackageEntry,\n  scope: ExtensionScope,\n  installedBuiltinAliases: Set<string>,\n  installedLocations: Set<string>,\n): Record<string, unknown> {\n  const installScopeFlag = scope === \"global\" ? \"--global\" : \"--project\";\n  const metadataOnlyResources = Object.fromEntries(\n    PM_PACKAGE_RESOURCE_KINDS\n      .filter((resourceKind) => resourceKind !== \"extensions\")\n      .map((resourceKind) => [resourceKind, manifest.resources[resourceKind] ?? []])\n      .filter(([, entries]) => Array.isArray(entries) && entries.length > 0),\n  );\n  return {\n    alias: bundledEntry.alias,\n    bundled: true,\n    available: true,\n    installed:\n      installedBuiltinAliases.has(bundledEntry.alias) ||\n      installedLocations.has(path.resolve(bundledEntry.package_root)),\n    install_target: bundledEntry.alias,\n    install_command: `pm install ${bundledEntry.alias} ${installScopeFlag}`,\n    package_name: manifest.package_name,\n    package_version: manifest.package_version,\n    description: manifest.catalog?.summary ?? manifest.package_description,\n    keywords: manifest.package_keywords ?? [],\n    resources: manifest.resources,\n    installable_resources: {\n      extensions: manifest.resources.extensions ?? [],\n    },\n    metadata_only_resources: metadataOnlyResources,\n    catalog: {\n      display_name: manifest.catalog?.display_name,\n      category: manifest.catalog?.category,\n      tags: manifest.catalog?.tags ?? manifest.package_keywords ?? [],\n      links: buildBundledCatalogLinks(manifest),\n      media: manifest.catalog?.media,\n    },\n  };\n}\n\n/**\n * Implements build bundled package catalog for the public runtime surface of this module.\n */\nexport async function buildBundledPackageCatalog(scope: ExtensionScope, global: GlobalOptions, options: ExtensionCommandOptions = {}): Promise<{\n  total: number;\n  scope: ExtensionScope;\n  installable_resource_kinds: string[];\n  metadata_only_resource_kinds: string[];\n  packages: Array<Record<string, unknown>>;\n}> {\n  const roots = resolveExtensionRoots(resolvePmRoot(process.cwd(), global.path), process.cwd());\n  const selectedRoot = scope === \"global\" ? roots.global : roots.project;\n  const managedStateRead = await readManagedExtensionState(selectedRoot);\n  const installedLocations = new Set(\n    managedStateRead.state.entries\n      .filter((entry) => entry.scope === scope)\n      .filter((entry) => entry.source.kind !== \"builtin\")\n      .map((entry) => path.resolve(entry.source.location)),\n  );\n  const installedBuiltinAliases = new Set(\n    managedStateRead.state.entries\n      .filter((entry) => entry.scope === scope && entry.source.kind === \"builtin\")\n      .flatMap((entry) => [entry.source.name, entry.source.input, entry.source.location])\n      .filter((value): value is string => typeof value === \"string\" && value.trim().length > 0)\n      .map((value) => value.trim().toLowerCase()),\n  );\n  const packages: Array<Record<string, unknown>> = [];\n\n  for (const bundledEntry of await collectBundledPackageEntries()) {\n    const manifest = await readPmPackageManifest(bundledEntry.package_root);\n    packages.push(\n      buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations),\n    );\n  }\n\n  const fields = parsePackageCatalogFields(options.fields);\n  const outputPackages = fields ? packages.map((entry) => projectPackageCatalogEntry(entry, fields)) : packages;\n  return {\n    total: outputPackages.length,\n    scope,\n    installable_resource_kinds: [\"extensions\"],\n    metadata_only_resource_kinds: PM_PACKAGE_RESOURCE_KINDS.filter((resourceKind) => resourceKind !== \"extensions\"),\n    packages: outputPackages,\n  };\n}\n\nconst PACKAGE_CATALOG_FIELD_KEYS = new Set([\n  \"alias\",\n  \"bundled\",\n  \"available\",\n  \"installed\",\n  \"install_target\",\n  \"install_command\",\n  \"package_name\",\n  \"package_version\",\n  \"description\",\n  \"keywords\",\n  \"resources\",\n  \"installable_resources\",\n  \"metadata_only_resources\",\n  \"catalog\",\n  \"category\",\n  \"display_name\",\n]);\n\nfunction parsePackageCatalogFields(raw: string | undefined): string[] | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const fields = splitCommaList(raw);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Package catalog --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  const unknown = fields.filter((field) => !PACKAGE_CATALOG_FIELD_KEYS.has(field));\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown package catalog --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      examples: [\n        \"pm package list --project --fields alias,installed,install_command\",\n        \"pm package catalog --project --fields alias,package_name,category\",\n      ],\n    });\n  }\n  return fields;\n}\n\nfunction projectPackageCatalogEntry(entry: Record<string, unknown>, fields: string[]): Record<string, unknown> {\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    if (field === \"category\") {\n      projected[field] = (entry.catalog as { category?: unknown } | undefined)?.category ?? null;\n    } else if (field === \"display_name\") {\n      projected[field] = (entry.catalog as { display_name?: unknown } | undefined)?.display_name ?? null;\n    } else {\n      projected[field] = entry[field] ?? null;\n    }\n  }\n  return projected;\n}\n\nexport const _testOnlyBundledCatalog = {\n  parsePackageCatalogFields,\n  projectPackageCatalogEntry,\n};\n"],"names":[],"mappings":"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","debugId":"ce7070ac-9aa5-56b7-b6dd-80ff19b24553"}
+{"version":3,"file":"bundled-catalog.js","sources":["cli/commands/extension/bundled-catalog.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/bundled-catalog\n *\n * Implements extension package-management support for Bundled Catalog.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { collectPackageExtensionDirectories, PM_PACKAGE_RESOURCE_KINDS, readPmPackageManifest } from \"../../../core/packages/manifest.js\";\nimport { resolvePmPackageRootFromModule } from \"../../../core/packages/root.js\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport type { GlobalOptions } from \"../../../core/shared/command-types.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { splitCommaList } from \"../../../core/shared/split-comma-list.js\";\nimport { resolveExtensionRoots } from \"../../../core/extensions/loader.js\";\nimport { resolvePmRoot } from \"../../../core/store/paths.js\";\nimport { validateExtensionDirectory } from \"./shared.js\";\nimport { readManagedExtensionState } from \"./managed-state.js\";\nimport type { ExtensionCommandOptions, ExtensionScope } from \"../extension.js\";\n\nconst PM_PACKAGE_ROOT_ENV = \"PM_CLI_PACKAGE_ROOT\";\nconst LEGACY_BUNDLED_PACKAGE_ALIASES: Record<string, { package_directory: string; legacy_extension_directory: string }> = {\n  beads: {\n    package_directory: \"pm-beads\",\n    legacy_extension_directory: \"beads\",\n  },\n  todos: {\n    package_directory: \"pm-todos\",\n    legacy_extension_directory: \"todos\",\n  },\n};\nconst BUNDLED_PACKAGE_INSTALL_ALL_TARGETS = new Set([\"*\", \"all\"]);\n\ninterface BundledPackageEntry {\n  alias: string;\n  package_directory: string;\n  package_root: string;\n  package_name: string | null;\n}\n\nfunction resolvePackageRootCandidates(): string[] {\n  const candidates: string[] = [];\n  const envRoot = process.env[PM_PACKAGE_ROOT_ENV];\n  /* c8 ignore start -- env-root override branch is exercised by package-root integration tests */\n  if (typeof envRoot === \"string\" && envRoot.trim().length > 0) {\n    candidates.push(path.resolve(envRoot.trim()));\n  }\n  /* c8 ignore stop */\n  candidates.push(resolvePmPackageRootFromModule(import.meta.url, [\"../../../..\"]));\n  return [...new Set(candidates)];\n}\n\n/**\n * Implements resolve bundled extension alias source for the public runtime surface of this module.\n */\nexport async function resolveBundledExtensionAliasSource(input: string): Promise<string | null> {\n  const normalized = input.trim().toLowerCase();\n  const packageRoot = await resolveBundledPackageRoot(normalized);\n  if (packageRoot) {\n    return packageRoot;\n  }\n\n  const alias = LEGACY_BUNDLED_PACKAGE_ALIASES[normalized];\n  /* c8 ignore start -- known aliases resolve through package manifests in normal runtime */\n  if (!alias) {\n    return null;\n  }\n  /* c8 ignore stop */\n  /* c8 ignore start -- exercised only when legacy extension paths exist without package manifests */\n  for (const packageRoot of resolvePackageRootCandidates()) {\n    const legacyExtensionPath = path.join(packageRoot, \".agents\", \"pm\", \"extensions\", alias.legacy_extension_directory);\n    if (await pathExists(path.join(legacyExtensionPath, \"manifest.json\"))) {\n      return legacyExtensionPath;\n    }\n  }\n  return null;\n  /* c8 ignore stop */\n}\n\n/**\n * Implements check whether bundled package install all target for the public runtime surface of this module.\n */\nexport function isBundledPackageInstallAllTarget(input: string): boolean {\n  return BUNDLED_PACKAGE_INSTALL_ALL_TARGETS.has(input.trim().toLowerCase());\n}\n\nfunction derivePackageAlias(packageDirectory: string): string {\n  return packageDirectory.replace(/^pm-/i, \"\").trim().toLowerCase();\n}\n\nasync function collectManifestPackageEntries(\n  packagesRoot: string,\n  entriesByAlias: Map<string, BundledPackageEntry>,\n): Promise<void> {\n  const entries = await fs.readdir(packagesRoot, { withFileTypes: true });\n  for (const entry of entries) {\n    if (!entry.isDirectory() || !entry.name.startsWith(\"pm-\")) {\n      continue;\n    }\n    const candidateRoot = path.join(packagesRoot, entry.name);\n    if (!(await pathExists(path.join(candidateRoot, \"package.json\")))) {\n      continue;\n    }\n    const manifest = await readPmPackageManifest(candidateRoot);\n    const aliases = manifest.aliases && manifest.aliases.length > 0\n      ? manifest.aliases\n      : [derivePackageAlias(entry.name)];\n    for (const alias of aliases) {\n      const normalizedAlias = alias.trim().toLowerCase();\n      if (normalizedAlias.length === 0 || entriesByAlias.has(normalizedAlias)) {\n        continue;\n      }\n      entriesByAlias.set(normalizedAlias, {\n        alias: normalizedAlias,\n        package_directory: entry.name,\n        package_root: candidateRoot,\n        package_name: manifest.package_name ?? null,\n      });\n    }\n  }\n}\n\nasync function collectBundledPackageEntries(): Promise<BundledPackageEntry[]> {\n  const entriesByAlias = new Map<string, BundledPackageEntry>();\n  for (const packageRoot of resolvePackageRootCandidates()) {\n    const packagesRoot = path.join(packageRoot, \"packages\");\n    if (!(await pathExists(packagesRoot))) {\n      continue;\n    }\n    await collectManifestPackageEntries(packagesRoot, entriesByAlias);\n  }\n\n  for (const [alias, legacy] of Object.entries(LEGACY_BUNDLED_PACKAGE_ALIASES)) {\n    /* c8 ignore start -- canonical aliases are present in bundled package manifests */\n    if (entriesByAlias.has(alias)) {\n      continue;\n    }\n    /* c8 ignore stop */\n    /* c8 ignore start -- compatibility fallback when only legacy package layout exists */\n    for (const packageRoot of resolvePackageRootCandidates()) {\n      const packagePath = path.join(packageRoot, \"packages\", legacy.package_directory);\n      if (await pathExists(path.join(packagePath, \"package.json\"))) {\n        entriesByAlias.set(alias, {\n          alias,\n          package_directory: legacy.package_directory,\n          package_root: packagePath,\n          package_name: null,\n        });\n        break;\n      }\n    }\n    /* c8 ignore stop */\n  }\n\n  return [...entriesByAlias.values()].sort((left, right) => left.alias.localeCompare(right.alias));\n}\n\n/**\n * Implements list bundled package aliases for the public runtime surface of this module.\n */\nexport async function listBundledPackageAliases(): Promise<string[]> {\n  return (await collectBundledPackageEntries()).map((entry) => entry.alias);\n}\n\n/**\n * Implements resolve bundled package root for the public runtime surface of this module.\n * Accepts every spelling agents naturally reach for: the catalog alias\n * (\"kanban\"), the package directory (\"pm-kanban\"), and the published npm name\n * (\"@unbrained/pm-kanban\").\n */\nexport async function resolveBundledPackageRoot(alias: string): Promise<string | null> {\n  const normalized = alias.trim().toLowerCase();\n  const entry = (await collectBundledPackageEntries()).find(\n    (candidate) =>\n      candidate.alias === normalized ||\n      candidate.package_directory.toLowerCase() === normalized ||\n      candidate.package_name?.toLowerCase() === normalized,\n  );\n  return entry?.package_root ?? null;\n}\n\n/**\n * Resolve the published npm package name for a bundled alias so install flows\n * can persist it as managed-source provenance (`source.package`). Returns null\n * when the alias is unknown or the bundled package manifest lacks a name.\n */\nexport async function resolveBundledPackageNpmName(alias: string): Promise<string | null> {\n  const packageRoot = await resolveBundledPackageRoot(alias);\n  if (!packageRoot) {\n    return null;\n  }\n  const manifest = await readPmPackageManifest(packageRoot);\n  return manifest.package_name ?? null;\n}\n\n/**\n * Implements resolve bundled alias manifest name for the public runtime surface of this module.\n */\nexport async function resolveBundledAliasManifestName(input: string): Promise<string | null> {\n  const bundledAliasSource = await resolveBundledExtensionAliasSource(input);\n  if (!bundledAliasSource) {\n    return null;\n  }\n  try {\n    const extensionDirectories = await collectPackageExtensionDirectories(bundledAliasSource);\n    if (extensionDirectories.length !== 1) {\n      return null;\n    }\n    const validated = await validateExtensionDirectory(extensionDirectories[0]);\n    return validated.manifest.name;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Resolve the catalog link block for a bundled package, preferring the explicit\n * `catalog.links.*` manifest fields and falling back to the package's\n * repository/bugs/homepage/npm metadata. The npm link is synthesized from the\n * package name unless the package is private or unnamed.\n */\nfunction buildBundledCatalogLinks(manifest: Awaited<ReturnType<typeof readPmPackageManifest>>): {\n  docs: string | undefined;\n  npm: string | undefined;\n  repository: string | undefined;\n  report: string | undefined;\n} {\n  return {\n    docs: manifest.catalog?.links?.docs ?? manifest.package_homepage,\n    npm:\n      manifest.catalog?.links?.npm ??\n      (manifest.package_name && manifest.package_private !== true\n        ? `https://www.npmjs.com/package/${encodeURIComponent(manifest.package_name)}`\n        : undefined),\n    repository: manifest.catalog?.links?.repository ?? manifest.package_repository_url,\n    report: manifest.catalog?.links?.report ?? manifest.package_bugs_url,\n  };\n}\n\n/**\n * Build one bundled-package catalog entry from its manifest, marking it\n * `installed` when the managed state for `scope` already records the package by\n * built-in alias or resolved location, and projecting the metadata-only resource\n * kinds (everything except installable `extensions`) that the package ships.\n */\nfunction buildBundledCatalogPackageEntry(\n  manifest: Awaited<ReturnType<typeof readPmPackageManifest>>,\n  bundledEntry: BundledPackageEntry,\n  scope: ExtensionScope,\n  installedBuiltinAliases: Set<string>,\n  installedLocations: Set<string>,\n): Record<string, unknown> {\n  const installScopeFlag = scope === \"global\" ? \"--global\" : \"--project\";\n  const metadataOnlyResources = Object.fromEntries(\n    PM_PACKAGE_RESOURCE_KINDS\n      .filter((resourceKind) => resourceKind !== \"extensions\")\n      .map((resourceKind) => [resourceKind, manifest.resources[resourceKind] ?? []])\n      .filter(([, entries]) => Array.isArray(entries) && entries.length > 0),\n  );\n  return {\n    alias: bundledEntry.alias,\n    bundled: true,\n    available: true,\n    installed:\n      installedBuiltinAliases.has(bundledEntry.alias) ||\n      installedLocations.has(path.resolve(bundledEntry.package_root)),\n    install_target: bundledEntry.alias,\n    install_command: `pm install ${bundledEntry.alias} ${installScopeFlag}`,\n    package_name: manifest.package_name,\n    package_version: manifest.package_version,\n    description: manifest.catalog?.summary ?? manifest.package_description,\n    keywords: manifest.package_keywords ?? [],\n    resources: manifest.resources,\n    installable_resources: {\n      extensions: manifest.resources.extensions ?? [],\n    },\n    metadata_only_resources: metadataOnlyResources,\n    catalog: {\n      display_name: manifest.catalog?.display_name,\n      category: manifest.catalog?.category,\n      tags: manifest.catalog?.tags ?? manifest.package_keywords ?? [],\n      links: buildBundledCatalogLinks(manifest),\n      media: manifest.catalog?.media,\n    },\n  };\n}\n\n/**\n * Implements build bundled package catalog for the public runtime surface of this module.\n */\nexport async function buildBundledPackageCatalog(scope: ExtensionScope, global: GlobalOptions, options: ExtensionCommandOptions = {}): Promise<{\n  total: number;\n  scope: ExtensionScope;\n  installable_resource_kinds: string[];\n  metadata_only_resource_kinds: string[];\n  packages: Array<Record<string, unknown>>;\n}> {\n  const roots = resolveExtensionRoots(resolvePmRoot(process.cwd(), global.path), process.cwd());\n  const selectedRoot = scope === \"global\" ? roots.global : roots.project;\n  const managedStateRead = await readManagedExtensionState(selectedRoot);\n  const installedLocations = new Set(\n    managedStateRead.state.entries\n      .filter((entry) => entry.scope === scope)\n      .filter((entry) => entry.source.kind !== \"builtin\")\n      .map((entry) => path.resolve(entry.source.location)),\n  );\n  const installedBuiltinAliases = new Set(\n    managedStateRead.state.entries\n      .filter((entry) => entry.scope === scope && entry.source.kind === \"builtin\")\n      .flatMap((entry) => [entry.source.name, entry.source.input, entry.source.location])\n      .filter((value): value is string => typeof value === \"string\" && value.trim().length > 0)\n      .map((value) => value.trim().toLowerCase()),\n  );\n  const packages: Array<Record<string, unknown>> = [];\n\n  for (const bundledEntry of await collectBundledPackageEntries()) {\n    const manifest = await readPmPackageManifest(bundledEntry.package_root);\n    packages.push(\n      buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations),\n    );\n  }\n\n  const fields = parsePackageCatalogFields(options.fields);\n  const outputPackages = fields ? packages.map((entry) => projectPackageCatalogEntry(entry, fields)) : packages;\n  return {\n    total: outputPackages.length,\n    scope,\n    installable_resource_kinds: [\"extensions\"],\n    metadata_only_resource_kinds: PM_PACKAGE_RESOURCE_KINDS.filter((resourceKind) => resourceKind !== \"extensions\"),\n    packages: outputPackages,\n  };\n}\n\nconst PACKAGE_CATALOG_FIELD_KEYS = new Set([\n  \"alias\",\n  \"bundled\",\n  \"available\",\n  \"installed\",\n  \"install_target\",\n  \"install_command\",\n  \"package_name\",\n  \"package_version\",\n  \"description\",\n  \"keywords\",\n  \"resources\",\n  \"installable_resources\",\n  \"metadata_only_resources\",\n  \"catalog\",\n  \"category\",\n  \"display_name\",\n]);\n\nfunction parsePackageCatalogFields(raw: string | undefined): string[] | undefined {\n  if (raw === undefined) {\n    return undefined;\n  }\n  const fields = splitCommaList(raw);\n  if (fields.length === 0) {\n    throw new PmCliError(\"Package catalog --fields requires a comma-separated list of field names\", EXIT_CODE.USAGE);\n  }\n  const unknown = fields.filter((field) => !PACKAGE_CATALOG_FIELD_KEYS.has(field));\n  if (unknown.length > 0) {\n    throw new PmCliError(`Unknown package catalog --fields value(s): ${unknown.join(\", \")}`, EXIT_CODE.USAGE, {\n      examples: [\n        \"pm package list --project --fields alias,installed,install_command\",\n        \"pm package catalog --project --fields alias,package_name,category\",\n      ],\n    });\n  }\n  return fields;\n}\n\nfunction projectPackageCatalogEntry(entry: Record<string, unknown>, fields: string[]): Record<string, unknown> {\n  const projected: Record<string, unknown> = {};\n  for (const field of fields) {\n    if (field === \"category\") {\n      projected[field] = (entry.catalog as { category?: unknown } | undefined)?.category ?? null;\n    } else if (field === \"display_name\") {\n      projected[field] = (entry.catalog as { display_name?: unknown } | undefined)?.display_name ?? null;\n    } else {\n      projected[field] = entry[field] ?? null;\n    }\n  }\n  return projected;\n}\n\nexport const _testOnlyBundledCatalog = {\n  parsePackageCatalogFields,\n  projectPackageCatalogEntry,\n};\n"],"names":[],"mappings":"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","debugId":"d4026cdd-6e38-5550-b33e-94d5c7b97e58"}

package/dist/cli/commands/extension/install-sources.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Install Sources.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="eab3d475-6769-535e-96a9-6bc5153c9627")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="cc53d374-129f-5ffe-9949-85ed5b45c268")}catch(e){}}();
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -17,8 +17,10 @@ import { pathExists } from "../../../core/fs/fs-utils.js";
 import { isPathWithinDirectory } from "../../../core/fs/path-utils.js";
 import { EXIT_CODE } from "../../../core/shared/constants.js";
 import { PmCliError } from "../../../core/shared/errors.js";
+import { listBundledPackageAliases } from "./bundled-catalog.js";
 const execFileAsync = promisify(execFile);
 const PM_CLI_PACKAGE_NAME = "@unbrained/pm-cli";
+let bundledPackageAliasesCache;
 function parseGithubPathSpec(pathSpec, input, refOverride) {
     const segments = pathSpec
         .split("/")
@@ -55,6 +57,23 @@ function parseGithubPathSpec(pathSpec, input, refOverride) {
         subpath: subpath && subpath.length > 0 ? subpath : undefined,
     };
 }
+function parseNpmInstallSource(normalizedInput, forceGithub, refOverride) {
+    const spec = normalizedInput.slice("npm:".length).trim();
+    if (spec.length === 0) {
+        throw new PmCliError('npm package source must include a package spec after "npm:".', EXIT_CODE.USAGE);
+    }
+    if (forceGithub) {
+        throw new PmCliError('Options "--gh/--github" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
+    }
+    if (refOverride) {
+        throw new PmCliError('Option "--ref" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
+    }
+    return {
+        kind: "npm",
+        input: normalizedInput,
+        spec,
+    };
+}
 /**
  * Implements parse extension install source for the public runtime surface of this module.
  */
@@ -65,21 +84,7 @@ export function parseExtensionInstallSource(input, options = {}) {
     }
     const refOverride = typeof options.ref === "string" && options.ref.trim().length > 0 ? options.ref.trim() : undefined;
     if (normalizedInput.startsWith("npm:")) {
-        const spec = normalizedInput.slice("npm:".length).trim();
-        if (spec.length === 0) {
-            throw new PmCliError('npm package source must include a package spec after "npm:".', EXIT_CODE.USAGE);
-        }
-        if (options.forceGithub) {
-            throw new PmCliError('Options "--gh/--github" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
-        }
-        if (refOverride) {
-            throw new PmCliError('Option "--ref" cannot be combined with npm: package sources.', EXIT_CODE.USAGE);
-        }
-        return {
-            kind: "npm",
-            input: normalizedInput,
-            spec,
-        };
+        return parseNpmInstallSource(normalizedInput, options.forceGithub === true, refOverride);
     }
     const maybeGithubByUrl = (() => {
         try {
@@ -556,6 +561,64 @@ async function resolveGithubSourceDirectory(cloneDirectory, source) {
         resolved_subpath: path.relative(cloneDirectory, discoveredDirectory).replaceAll(path.sep, "/"),
     };
 }
+/**
+ * Bare package-ish names (no path separators, or a single-scope npm name) that
+ * miss local resolution are almost always intended as npm or bundled installs,
+ * so the not-found error must route agents to those sources instead of dead-ending.
+ */
+function looksLikeBarePackageName(input) {
+    const trimmed = input.trim();
+    if (trimmed.length === 0 || trimmed.startsWith(".") || trimmed.startsWith("~")) {
+        return false;
+    }
+    if (trimmed.startsWith("@")) {
+        return trimmed.split("/").length === 2;
+    }
+    return !trimmed.includes("/") && !trimmed.includes("\\");
+}
+async function buildLocalSourceNotFoundError(source) {
+    const baseMessage = `Local extension source does not exist: "${source.absolute_path}".`;
+    const input = source.input.trim();
+    if (!looksLikeBarePackageName(input)) {
+        return new PmCliError(baseMessage, EXIT_CODE.NOT_FOUND);
+    }
+    let bundledAliases = [];
+    try {
+        const envPackageRoot = process.env.PM_CLI_PACKAGE_ROOT;
+        const cacheKey = typeof envPackageRoot === "string" && envPackageRoot.trim().length > 0
+            ? path.resolve(envPackageRoot.trim())
+            : "";
+        if (bundledPackageAliasesCache?.key !== cacheKey) {
+            bundledPackageAliasesCache = {
+                key: cacheKey,
+                aliases: await listBundledPackageAliases(),
+            };
+        }
+        bundledAliases = bundledPackageAliasesCache.aliases;
+    }
+    catch {
+        // Alias discovery is best-effort; the npm: hint alone still unblocks agents.
+    }
+    const nextSteps = [
+        `Retry with pm install npm:${input} if the package is published to npm.`,
+        `Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${bundledAliases.join(", ")}`,
+    ];
+    return new PmCliError(`${baseMessage} "${input}" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as "npm:${input}".`, EXIT_CODE.NOT_FOUND, {
+        code: "local_source_not_found_bare_name",
+        required: `Use "npm:${input}" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,
+        why: "Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.",
+        examples: [
+            `pm install npm:${input}`,
+            "pm package catalog --project --json",
+        ],
+        nextSteps,
+        recovery: {
+            attempted_command: `pm install ${input}`,
+            normalized_args: ["install", input],
+            next_best_command: `pm install npm:${input}`,
+        },
+    });
+}
 /**
  * Implements resolve install source for the public runtime surface of this module.
  */
@@ -566,7 +629,7 @@ export async function resolveInstallSource(source) {
             localStats = await fs.stat(source.absolute_path);
         }
         catch {
-            throw new PmCliError(`Local extension source does not exist: "${source.absolute_path}".`, EXIT_CODE.NOT_FOUND);
+            throw await buildLocalSourceNotFoundError(source);
         }
         if (!localStats.isDirectory()) {
             throw new PmCliError(`Local extension source must be a directory: "${source.absolute_path}".`, EXIT_CODE.USAGE);
@@ -639,4 +702,4 @@ export const _testOnlyInstallSources = {
     runNpmCommand,
 };
 //# sourceMappingURL=install-sources.js.map
-//# debugId=eab3d475-6769-535e-96a9-6bc5153c9627
+//# debugId=cc53d374-129f-5ffe-9949-85ed5b45c268