@unbrained/pm-cli 2026.6.24 → 2026.7.1

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]="706494dc-d2f2-520c-9845-71326ee5841e")}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]="0baef9c6-cdf9-5aea-89f0-088600d538e6")}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";
@@ -163,6 +163,61 @@ export async function resolveBundledAliasManifestName(input) {
         return null;
     }
 }
+/**
+ * Resolve the catalog link block for a bundled package, preferring the explicit
+ * `catalog.links.*` manifest fields and falling back to the package's
+ * repository/bugs/homepage/npm metadata. The npm link is synthesized from the
+ * package name unless the package is private or unnamed.
+ */
+function buildBundledCatalogLinks(manifest) {
+    return {
+        docs: manifest.catalog?.links?.docs ?? manifest.package_homepage,
+        npm: manifest.catalog?.links?.npm ??
+            (manifest.package_name && manifest.package_private !== true
+                ? `https://www.npmjs.com/package/${encodeURIComponent(manifest.package_name)}`
+                : undefined),
+        repository: manifest.catalog?.links?.repository ?? manifest.package_repository_url,
+        report: manifest.catalog?.links?.report ?? manifest.package_bugs_url,
+    };
+}
+/**
+ * Build one bundled-package catalog entry from its manifest, marking it
+ * `installed` when the managed state for `scope` already records the package by
+ * built-in alias or resolved location, and projecting the metadata-only resource
+ * kinds (everything except installable `extensions`) that the package ships.
+ */
+function buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations) {
+    const installScopeFlag = scope === "global" ? "--global" : "--project";
+    const metadataOnlyResources = Object.fromEntries(PM_PACKAGE_RESOURCE_KINDS
+        .filter((resourceKind) => resourceKind !== "extensions")
+        .map((resourceKind) => [resourceKind, manifest.resources[resourceKind] ?? []])
+        .filter(([, entries]) => Array.isArray(entries) && entries.length > 0));
+    return {
+        alias: bundledEntry.alias,
+        bundled: true,
+        available: true,
+        installed: installedBuiltinAliases.has(bundledEntry.alias) ||
+            installedLocations.has(path.resolve(bundledEntry.package_root)),
+        install_target: bundledEntry.alias,
+        install_command: `pm install ${bundledEntry.alias} ${installScopeFlag}`,
+        package_name: manifest.package_name,
+        package_version: manifest.package_version,
+        description: manifest.catalog?.summary ?? manifest.package_description,
+        keywords: manifest.package_keywords ?? [],
+        resources: manifest.resources,
+        installable_resources: {
+            extensions: manifest.resources.extensions ?? [],
+        },
+        metadata_only_resources: metadataOnlyResources,
+        catalog: {
+            display_name: manifest.catalog?.display_name,
+            category: manifest.catalog?.category,
+            tags: manifest.catalog?.tags ?? manifest.package_keywords ?? [],
+            links: buildBundledCatalogLinks(manifest),
+            media: manifest.catalog?.media,
+        },
+    };
+}
 /**
  * Implements build bundled package catalog for the public runtime surface of this module.
  */
@@ -181,50 +236,8 @@ export async function buildBundledPackageCatalog(scope, global, options = {}) {
         .map((value) => value.trim().toLowerCase()));
     const packages = [];
     for (const bundledEntry of await collectBundledPackageEntries()) {
-        const alias = bundledEntry.alias;
-        const packageRoot = bundledEntry.package_root;
-        const installScopeFlag = scope === "global" ? "--global" : "--project";
-        const manifest = await readPmPackageManifest(packageRoot);
-        const repository = manifest.catalog?.links?.repository ?? manifest.package_repository_url;
-        const report = manifest.catalog?.links?.report ?? manifest.package_bugs_url;
-        const docs = manifest.catalog?.links?.docs ?? manifest.package_homepage;
-        const npm = manifest.catalog?.links?.npm ??
-            (manifest.package_name && manifest.package_private !== true
-                ? `https://www.npmjs.com/package/${encodeURIComponent(manifest.package_name)}`
-                : undefined);
-        const metadataOnlyResources = Object.fromEntries(PM_PACKAGE_RESOURCE_KINDS
-            .filter((resourceKind) => resourceKind !== "extensions")
-            .map((resourceKind) => [resourceKind, manifest.resources[resourceKind] ?? []])
-            .filter(([, entries]) => Array.isArray(entries) && entries.length > 0));
-        packages.push({
-            alias,
-            bundled: true,
-            available: true,
-            installed: installedBuiltinAliases.has(alias) || installedLocations.has(path.resolve(packageRoot)),
-            install_target: alias,
-            install_command: `pm install ${alias} ${installScopeFlag}`,
-            package_name: manifest.package_name,
-            package_version: manifest.package_version,
-            description: manifest.catalog?.summary ?? manifest.package_description,
-            keywords: manifest.package_keywords ?? [],
-            resources: manifest.resources,
-            installable_resources: {
-                extensions: manifest.resources.extensions ?? [],
-            },
-            metadata_only_resources: metadataOnlyResources,
-            catalog: {
-                display_name: manifest.catalog?.display_name,
-                category: manifest.catalog?.category,
-                tags: manifest.catalog?.tags ?? manifest.package_keywords ?? [],
-                links: {
-                    docs,
-                    npm,
-                    repository,
-                    report,
-                },
-                media: manifest.catalog?.media,
-            },
-        });
+        const manifest = await readPmPackageManifest(bundledEntry.package_root);
+        packages.push(buildBundledCatalogPackageEntry(manifest, bundledEntry, scope, installedBuiltinAliases, installedLocations));
     }
     const fields = parsePackageCatalogFields(options.fields);
     const outputPackages = fields ? packages.map((entry) => projectPackageCatalogEntry(entry, fields)) : packages;
@@ -293,4 +306,4 @@ export const _testOnlyBundledCatalog = {
     projectPackageCatalogEntry,
 };
 //# sourceMappingURL=bundled-catalog.js.map
-//# debugId=706494dc-d2f2-520c-9845-71326ee5841e
+//# debugId=0baef9c6-cdf9-5aea-89f0-088600d538e6

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 * 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 * 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 alias = bundledEntry.alias;\n    const packageRoot = bundledEntry.package_root;\n    const installScopeFlag = scope === \"global\" ? \"--global\" : \"--project\";\n\n    const manifest = await readPmPackageManifest(packageRoot);\n    const repository = manifest.catalog?.links?.repository ?? manifest.package_repository_url;\n    const report = manifest.catalog?.links?.report ?? manifest.package_bugs_url;\n    const docs = manifest.catalog?.links?.docs ?? manifest.package_homepage;\n    const npm = 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    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    packages.push({\n      alias,\n      bundled: true,\n      available: true,\n      installed: installedBuiltinAliases.has(alias) || installedLocations.has(path.resolve(packageRoot)),\n      install_target: alias,\n      install_command: `pm install ${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: {\n          docs,\n          npm,\n          repository,\n          report,\n        },\n        media: manifest.catalog?.media,\n      },\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":"706494dc-d2f2-520c-9845-71326ee5841e"}
+{"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 * 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":"0baef9c6-cdf9-5aea-89f0-088600d538e6"}

package/dist/cli/commands/extension/describe.d.ts

@@ -68,3 +68,18 @@ export interface ExtensionDescribeResult {
  * whether that is a not-found error.
  */
 export declare function buildExtensionDescribeResult(target: string | undefined, loadResult: ExtensionLoadResult, activationResult: ExtensionActivationResult): ExtensionDescribeResult;
+/**
+ * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
+ * top-level title and scope line, one section per described extension (titled
+ * with its identity and activation status), and — only when more than one
+ * extension was described — a final union section spanning them all. Each
+ * extension and the union are rendered with the shared
+ * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the
+ * document nests cleanly under the level-1 title.
+ *
+ * `noun` is the lifecycle vocabulary (`"extension"` or `"package"`) so the prose
+ * matches the command the agent invoked. When no extensions match (an unmatched
+ * target is already a not-found error upstream, so this is the "nothing loaded"
+ * case) the document is the title plus a single explanatory note.
+ */
+export declare function renderExtensionDescribeMarkdown(result: ExtensionDescribeResult, noun: string): string;

package/dist/cli/commands/extension/describe.js

@@ -17,8 +17,9 @@
  * builder is trivially unit-testable against synthetic activations.
  */
 
-!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]="7a92163a-99b2-5969-acc2-e2b6b0336c2e")}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]="e32f1159-a3b3-5c1f-903f-c0ed2d4cf458")}catch(e){}}();
 import { describeExtensionActivation } from "../../../core/extensions/activation-summary.js";
+import { renderExtensionSurfaceMarkdown } from "../../../core/extensions/activation-summary-markdown.js";
 import { normalizeExtensionNameForMatch } from "./shared.js";
 /**
  * Compose a collision-free identity key for an extension from its layer and
@@ -72,5 +73,50 @@ export function buildExtensionDescribeResult(target, loadResult, activationResul
         union: describeExtensionActivation(activationResult, normalizedTarget === null ? {} : { extensionName: target }),
     };
 }
+/**
+ * Human-readable label for each {@link ExtensionDescribeActivationStatus}, used
+ * in the Markdown per-extension heading so a reader sees *why* an entry has no
+ * surfaces (activation failed / never loaded) rather than assuming it
+ * contributes nothing.
+ */
+const ACTIVATION_STATUS_LABELS = {
+    ok: "loaded",
+    failed: "activation failed",
+    not_loaded: "not loaded",
+};
+/**
+ * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
+ * top-level title and scope line, one section per described extension (titled
+ * with its identity and activation status), and — only when more than one
+ * extension was described — a final union section spanning them all. Each
+ * extension and the union are rendered with the shared
+ * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the
+ * document nests cleanly under the level-1 title.
+ *
+ * `noun` is the lifecycle vocabulary (`"extension"` or `"package"`) so the prose
+ * matches the command the agent invoked. When no extensions match (an unmatched
+ * target is already a not-found error upstream, so this is the "nothing loaded"
+ * case) the document is the title plus a single explanatory note.
+ */
+export function renderExtensionDescribeMarkdown(result, noun) {
+    const titleNoun = `${noun[0].toUpperCase()}${noun.slice(1)}`;
+    const lines = [`# ${titleNoun} surface reference`, ""];
+    lines.push(result.target === null ? `Scope: all loaded ${noun}s` : `Scope: \`${result.target}\``);
+    lines.push(`Described: ${result.total} ${noun}${result.total === 1 ? "" : "s"}`, "");
+    if (result.extensions.length === 0) {
+        lines.push(`_No ${noun}s are loaded._`, "");
+        return `${lines.join("\n").trimEnd()}\n`;
+    }
+    for (const entry of result.extensions) {
+        const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;
+        // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a
+        // single blank line between sections, so no extra "" separator is pushed.
+        lines.push(renderExtensionSurfaceMarkdown(entry.surfaces, { title, headingLevel: 2 }));
+    }
+    if (result.extensions.length > 1) {
+        lines.push(renderExtensionSurfaceMarkdown(result.union, { title: `Union across all described ${noun}s`, headingLevel: 2 }));
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
 //# sourceMappingURL=describe.js.map
-//# debugId=7a92163a-99b2-5969-acc2-e2b6b0336c2e
+//# debugId=e32f1159-a3b3-5c1f-903f-c0ed2d4cf458

package/dist/cli/commands/extension/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sources":["cli/commands/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/describe\n *\n * Builds the `pm extension describe` / `pm package describe` payload: a flat,\n * by-name map of every surface each loaded extension registered.\n *\n * The SDK already ships {@link describeExtensionActivation} -- the `describe`\n * (enumerate-all) verb that complements the `assert*` (verify-one) and `run*`\n * (invoke-one) testing helpers -- but until now it was reachable only from a test\n * that hand-built an {@link ExtensionActivationResult}. This module is the thin\n * orchestration that lets an agent at the CLI (or over MCP) ask \"what does this\n * installed extension add to my context?\" in one call, instead of stitching\n * together `doctor` (errors), `manage` (update metadata), and a manifest read.\n *\n * It is intentionally pure: the caller performs the load+activate cycle (exactly\n * as `explore`/`doctor` already do) and hands the results here, so the same\n * builder is trivially unit-testable against synthetic activations.\n */\nimport { describeExtensionActivation, type ExtensionActivationSummary } from \"../../../core/extensions/activation-summary.js\";\nimport type { ExtensionActivationResult, ExtensionLayer, ExtensionLoadResult } from \"../../../core/extensions/loader.js\";\nimport { normalizeExtensionNameForMatch } from \"./shared.js\";\n\n/**\n * Runtime state of a described extension. `ok` loaded and activated cleanly,\n * `failed` loaded but threw during `activate`, and `not_loaded` failed to import\n * at all -- the latter two register nothing, so their `surfaces` are empty and\n * the status explains why (rather than implying the extension contributes\n * nothing).\n */\nexport type ExtensionDescribeActivationStatus = \"ok\" | \"failed\" | \"not_loaded\";\n\n/**\n * One extension's contribution to the workspace: its identity plus the\n * {@link ExtensionActivationSummary} of every surface it registered.\n *\n * `surfaces` is matched by extension *name* (mirroring\n * {@link describeExtensionActivation}'s name filter), so when the same name is\n * loaded in both the project and global layers each entry reflects that name's\n * combined surfaces -- the `layer`/`version` fields still distinguish the\n * physical entries.\n */\nexport interface ExtensionSurfaceDescription {\n  name: string;\n  layer: ExtensionLayer;\n  version: string;\n  activation_status: ExtensionDescribeActivationStatus;\n  surfaces: ExtensionActivationSummary;\n}\n\n/**\n * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps\n * plus a deduplicated `union` across the described set. `target` echoes the\n * requested name filter (or `null` for the whole workspace) and `total` counts\n * the described entries so callers need not re-measure `extensions`.\n */\nexport interface ExtensionDescribeResult {\n  target: string | null;\n  total: number;\n  extensions: ExtensionSurfaceDescription[];\n  union: ExtensionActivationSummary;\n}\n\n/**\n * Compose a collision-free identity key for an extension from its layer and\n * normalized name. The two parts are joined with a colon; the layer prefix is\n * always a colon-free enum value, so distinct (layer, name) pairs never collide\n * even when a name itself contains a colon.\n */\nfunction layerNameKey(layer: ExtensionLayer, name: string): string {\n  return `${layer}:${normalizeExtensionNameForMatch(name)}`;\n}\n\n/**\n * Summarize, by name, every registration surface the loaded extensions exercised.\n *\n * Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is\n * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts\n * the entries by name then layer for deterministic output, and attaches each\n * extension's {@link describeExtensionActivation} summary. When `target` is\n * provided only the case-insensitively matching extensions are described and the\n * `union` is scoped to that name; otherwise every loaded extension contributes.\n * An unmatched `target` yields an empty `extensions` array -- the caller decides\n * whether that is a not-found error.\n */\nexport function buildExtensionDescribeResult(\n  target: string | undefined,\n  loadResult: ExtensionLoadResult,\n  activationResult: ExtensionActivationResult,\n): ExtensionDescribeResult {\n  const activationFailedKeys = new Set(activationResult.failed.map((entry) => layerNameKey(entry.layer, entry.name)));\n  const candidates: ExtensionSurfaceDescription[] = [\n    ...loadResult.loaded.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: entry.version,\n      activation_status: activationFailedKeys.has(layerNameKey(entry.layer, entry.name))\n        ? (\"failed\" as const)\n        : (\"ok\" as const),\n      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name }),\n    })),\n    ...loadResult.failed.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: \"unknown\",\n      activation_status: \"not_loaded\" as const,\n      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name }),\n    })),\n  ].sort((left, right) => left.name.localeCompare(right.name) || left.layer.localeCompare(right.layer));\n\n  const normalizedTarget = typeof target === \"string\" ? normalizeExtensionNameForMatch(target) : null;\n  const extensions =\n    normalizedTarget === null\n      ? candidates\n      : candidates.filter((entry) => normalizeExtensionNameForMatch(entry.name) === normalizedTarget);\n\n  return {\n    target: typeof target === \"string\" ? target.trim() : null,\n    total: extensions.length,\n    extensions,\n    union: describeExtensionActivation(activationResult, normalizedTarget === null ? {} : { extensionName: target }),\n  };\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AACH,OAAO,EAAE,2BAA2B,EAAmC,MAAM,gDAAgD,CAAC;AAE9H,OAAO,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AA0C7D;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAAqB,EAAE,IAAY;IACvD,OAAO,GAAG,KAAK,IAAI,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAA0B,EAC1B,UAA+B,EAC/B,gBAA2C;IAE3C,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpH,MAAM,UAAU,GAAkC;QAChD,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBAChF,CAAC,CAAE,QAAkB;gBACrB,CAAC,CAAE,IAAc;YACnB,QAAQ,EAAE,2BAA2B,CAAC,gBAAgB,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SACvF,CAAC,CAAC;QACH,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,SAAS;YAClB,iBAAiB,EAAE,YAAqB;YACxC,QAAQ,EAAE,2BAA2B,CAAC,gBAAgB,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SACvF,CAAC,CAAC;KACJ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtG,MAAM,gBAAgB,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpG,MAAM,UAAU,GACd,gBAAgB,KAAK,IAAI;QACvB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,8BAA8B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,gBAAgB,CAAC,CAAC;IAEpG,OAAO;QACL,MAAM,EAAE,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI;QACzD,KAAK,EAAE,UAAU,CAAC,MAAM;QACxB,UAAU;QACV,KAAK,EAAE,2BAA2B,CAAC,gBAAgB,EAAE,gBAAgB,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC","debugId":"7a92163a-99b2-5969-acc2-e2b6b0336c2e"}
+{"version":3,"file":"describe.js","sources":["cli/commands/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/describe\n *\n * Builds the `pm extension describe` / `pm package describe` payload: a flat,\n * by-name map of every surface each loaded extension registered.\n *\n * The SDK already ships {@link describeExtensionActivation} -- the `describe`\n * (enumerate-all) verb that complements the `assert*` (verify-one) and `run*`\n * (invoke-one) testing helpers -- but until now it was reachable only from a test\n * that hand-built an {@link ExtensionActivationResult}. This module is the thin\n * orchestration that lets an agent at the CLI (or over MCP) ask \"what does this\n * installed extension add to my context?\" in one call, instead of stitching\n * together `doctor` (errors), `manage` (update metadata), and a manifest read.\n *\n * It is intentionally pure: the caller performs the load+activate cycle (exactly\n * as `explore`/`doctor` already do) and hands the results here, so the same\n * builder is trivially unit-testable against synthetic activations.\n */\nimport { describeExtensionActivation, type ExtensionActivationSummary } from \"../../../core/extensions/activation-summary.js\";\nimport { renderExtensionSurfaceMarkdown } from \"../../../core/extensions/activation-summary-markdown.js\";\nimport type { ExtensionActivationResult, ExtensionLayer, ExtensionLoadResult } from \"../../../core/extensions/loader.js\";\nimport { normalizeExtensionNameForMatch } from \"./shared.js\";\n\n/**\n * Runtime state of a described extension. `ok` loaded and activated cleanly,\n * `failed` loaded but threw during `activate`, and `not_loaded` failed to import\n * at all -- the latter two register nothing, so their `surfaces` are empty and\n * the status explains why (rather than implying the extension contributes\n * nothing).\n */\nexport type ExtensionDescribeActivationStatus = \"ok\" | \"failed\" | \"not_loaded\";\n\n/**\n * One extension's contribution to the workspace: its identity plus the\n * {@link ExtensionActivationSummary} of every surface it registered.\n *\n * `surfaces` is matched by extension *name* (mirroring\n * {@link describeExtensionActivation}'s name filter), so when the same name is\n * loaded in both the project and global layers each entry reflects that name's\n * combined surfaces -- the `layer`/`version` fields still distinguish the\n * physical entries.\n */\nexport interface ExtensionSurfaceDescription {\n  name: string;\n  layer: ExtensionLayer;\n  version: string;\n  activation_status: ExtensionDescribeActivationStatus;\n  surfaces: ExtensionActivationSummary;\n}\n\n/**\n * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps\n * plus a deduplicated `union` across the described set. `target` echoes the\n * requested name filter (or `null` for the whole workspace) and `total` counts\n * the described entries so callers need not re-measure `extensions`.\n */\nexport interface ExtensionDescribeResult {\n  target: string | null;\n  total: number;\n  extensions: ExtensionSurfaceDescription[];\n  union: ExtensionActivationSummary;\n}\n\n/**\n * Compose a collision-free identity key for an extension from its layer and\n * normalized name. The two parts are joined with a colon; the layer prefix is\n * always a colon-free enum value, so distinct (layer, name) pairs never collide\n * even when a name itself contains a colon.\n */\nfunction layerNameKey(layer: ExtensionLayer, name: string): string {\n  return `${layer}:${normalizeExtensionNameForMatch(name)}`;\n}\n\n/**\n * Summarize, by name, every registration surface the loaded extensions exercised.\n *\n * Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is\n * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts\n * the entries by name then layer for deterministic output, and attaches each\n * extension's {@link describeExtensionActivation} summary. When `target` is\n * provided only the case-insensitively matching extensions are described and the\n * `union` is scoped to that name; otherwise every loaded extension contributes.\n * An unmatched `target` yields an empty `extensions` array -- the caller decides\n * whether that is a not-found error.\n */\nexport function buildExtensionDescribeResult(\n  target: string | undefined,\n  loadResult: ExtensionLoadResult,\n  activationResult: ExtensionActivationResult,\n): ExtensionDescribeResult {\n  const activationFailedKeys = new Set(activationResult.failed.map((entry) => layerNameKey(entry.layer, entry.name)));\n  const candidates: ExtensionSurfaceDescription[] = [\n    ...loadResult.loaded.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: entry.version,\n      activation_status: activationFailedKeys.has(layerNameKey(entry.layer, entry.name))\n        ? (\"failed\" as const)\n        : (\"ok\" as const),\n      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name }),\n    })),\n    ...loadResult.failed.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: \"unknown\",\n      activation_status: \"not_loaded\" as const,\n      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name }),\n    })),\n  ].sort((left, right) => left.name.localeCompare(right.name) || left.layer.localeCompare(right.layer));\n\n  const normalizedTarget = typeof target === \"string\" ? normalizeExtensionNameForMatch(target) : null;\n  const extensions =\n    normalizedTarget === null\n      ? candidates\n      : candidates.filter((entry) => normalizeExtensionNameForMatch(entry.name) === normalizedTarget);\n\n  return {\n    target: typeof target === \"string\" ? target.trim() : null,\n    total: extensions.length,\n    extensions,\n    union: describeExtensionActivation(activationResult, normalizedTarget === null ? {} : { extensionName: target }),\n  };\n}\n\n/**\n * Human-readable label for each {@link ExtensionDescribeActivationStatus}, used\n * in the Markdown per-extension heading so a reader sees *why* an entry has no\n * surfaces (activation failed / never loaded) rather than assuming it\n * contributes nothing.\n */\nconst ACTIVATION_STATUS_LABELS: Record<ExtensionDescribeActivationStatus, string> = {\n  ok: \"loaded\",\n  failed: \"activation failed\",\n  not_loaded: \"not loaded\",\n};\n\n/**\n * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a\n * top-level title and scope line, one section per described extension (titled\n * with its identity and activation status), and — only when more than one\n * extension was described — a final union section spanning them all. Each\n * extension and the union are rendered with the shared\n * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the\n * document nests cleanly under the level-1 title.\n *\n * `noun` is the lifecycle vocabulary (`\"extension\"` or `\"package\"`) so the prose\n * matches the command the agent invoked. When no extensions match (an unmatched\n * target is already a not-found error upstream, so this is the \"nothing loaded\"\n * case) the document is the title plus a single explanatory note.\n */\nexport function renderExtensionDescribeMarkdown(result: ExtensionDescribeResult, noun: string): string {\n  const titleNoun = `${noun[0]!.toUpperCase()}${noun.slice(1)}`;\n  const lines = [`# ${titleNoun} surface reference`, \"\"];\n  lines.push(result.target === null ? `Scope: all loaded ${noun}s` : `Scope: \\`${result.target}\\``);\n  lines.push(`Described: ${result.total} ${noun}${result.total === 1 ? \"\" : \"s\"}`, \"\");\n\n  if (result.extensions.length === 0) {\n    lines.push(`_No ${noun}s are loaded._`, \"\");\n    return `${lines.join(\"\\n\").trimEnd()}\\n`;\n  }\n\n  for (const entry of result.extensions) {\n    const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;\n    // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a\n    // single blank line between sections, so no extra \"\" separator is pushed.\n    lines.push(renderExtensionSurfaceMarkdown(entry.surfaces, { title, headingLevel: 2 }));\n  }\n\n  if (result.extensions.length > 1) {\n    lines.push(renderExtensionSurfaceMarkdown(result.union, { title: `Union across all described ${noun}s`, headingLevel: 2 }));\n  }\n\n  return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"e32f1159-a3b3-5c1f-903f-c0ed2d4cf458"}

package/dist/cli/commands/extension/doctor.js

@@ -4,7 +4,7 @@
  * Implements extension package-management support for Doctor.
  */
 
-!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]="52b725dc-48e3-5436-8136-47e5314b07eb")}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]="391a9e4b-f4b7-5176-970b-6de9523822e7")}catch(e){}}();
 import { reconcileExtensionCapabilityUsage, } from "../../../core/extensions/index.js";
 import { EXTENSION_CAPABILITY_CONTRACT, KNOWN_EXTENSION_CAPABILITIES, parseLegacyExtensionCapabilityAliasWarning, parseUnknownExtensionCapabilityWarning, } from "../../../core/extensions/loader.js";
 import { EXIT_CODE } from "../../../core/shared/constants.js";
@@ -303,6 +303,121 @@ export function classifyUnusedCapabilityWarnings(loadResult, activationResult) {
     }
     return [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
 }
+/**
+ * Ordered remediation rules evaluated while at least one warning is present. The
+ * order is load-bearing — it is the order remediation hints appear in doctor
+ * output — so new rules must be inserted at the intended position rather than
+ * appended.
+ */
+const TRIAGE_REMEDIATION_RULES = [
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_manifest_")),
+        build: (ctx) => `Run ${lifecycleFlagCommand(ctx.options, "explore")} ${ctx.scopeFlag} to inspect discovered manifests and directories.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_unknown:")),
+        build: () => `Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. ` +
+            "Review extension_capability_unknown warning details for suggested replacements.",
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_legacy_alias:")),
+        build: () => "Legacy extension capability aliases were auto-remapped to canonical capabilities. " +
+            "Update manifests to canonical names (migration/validation -> schema).",
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_missing:")),
+        build: (ctx) => `Extension activation failed because code registered a surface missing from manifest capabilities. ` +
+            `Run ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_unused:")),
+        build: (ctx) => "Extension manifests declare capabilities that are never registered against. " +
+            `Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag} --detail deep --trace for per-extension registration counts.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_command_definition_legacy_handler_alias:")),
+        build: () => "Extension command definitions using legacy handler were auto-remapped. " +
+            "Update command definitions to use run: (context) => ... for forward compatibility.",
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_output_service_override_global:") ||
+            warning.startsWith("extension_output_renderer_override_global:")),
+        build: () => "Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering.",
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_schema_narrow_activation:")),
+        build: () => "A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or — if the schema is intentionally command-scoped — knowingly ignore this advisory.",
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_load_failed_sdk_dependency_missing:")),
+        build: (ctx) => `Detected extension load failures caused by missing SDK dependency resolution. ` +
+            `Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_load_failed_module_mode_mismatch:")),
+        build: (ctx) => `Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" ` +
+            `or use an explicit .mjs entry and rerun ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_pm_min_version_") || warning.startsWith("extension_pm_max_version_")),
+        build: (ctx) => "Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version " +
+            `with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
+    },
+    {
+        matches: (_warnings, ctx) => ctx.updateCheckFailedTotal > 0,
+        build: (ctx) => `Run ${lifecycleFlagCommand(ctx.options, "manage")} ${ctx.scopeFlag} after validating network and repository access.`,
+    },
+    {
+        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_manager_state_")),
+        build: (ctx) => `Review and repair ${ctx.scope} managed extension state file if schema/read warnings persist.`,
+    },
+    {
+        matches: (_warnings, ctx) => ctx.policyWarningCount > 0,
+        build: () => "Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces.",
+    },
+];
+/**
+ * Build the ordered remediation hints for a triage summary. Warning-driven rules
+ * (collision remediation first, then {@link TRIAGE_REMEDIATION_RULES}) only run
+ * when at least one warning is present; the update-health coverage and
+ * availability hints always run; and a "no immediate action" fallback is
+ * appended when nothing else applied.
+ */
+function buildExtensionTriageRemediation(params) {
+    const { normalizedWarnings, options, scope, scopeFlag, updateCheckFailedTotal, policyWarningCount, updateHealthPartial, skippedUnmanagedTotal, skippedNonGithubTotal, updateAvailableTotal, } = params;
+    const remediation = [];
+    const ctx = { options, scope, scopeFlag, updateCheckFailedTotal, policyWarningCount };
+    if (normalizedWarnings.length > 0) {
+        const registrationCollisionRemediation = buildRegistrationCollisionRemediation(normalizedWarnings, {
+            deactivate: `${lifecycleFlagCommand(options, "deactivate")} <name> ${scopeFlag}`,
+            doctor: `${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace`,
+        });
+        if (registrationCollisionRemediation) {
+            remediation.push(registrationCollisionRemediation);
+        }
+        for (const rule of TRIAGE_REMEDIATION_RULES) {
+            if (rule.matches(normalizedWarnings, ctx)) {
+                remediation.push(rule.build(ctx));
+            }
+        }
+    }
+    if (updateHealthPartial) {
+        remediation.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state (or ${lifecycleFlagCommand(options, "adopt-all")} ${scopeFlag}, ${lifecycleFlagCommand(options, "adopt")} <name> ${scopeFlag}, or reinstall via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>).`);
+    }
+    else if (skippedUnmanagedTotal > 0) {
+        remediation.push(`Loaded unmanaged extensions are currently treated as informational. Use ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state to adopt them for update checks.`);
+    }
+    if (skippedNonGithubTotal > 0) {
+        remediation.push(`Non-GitHub managed extensions are skipped by update checks. Use doctor output for non-update diagnostics.`);
+    }
+    if (updateAvailableTotal > 0) {
+        remediation.push(`Update available managed extensions via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>.`);
+    }
+    if (remediation.length === 0) {
+        remediation.push(`No immediate action required. Re-run ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} after extension changes.`);
+    }
+    return remediation;
+}
 /**
  * Implements build extension triage summary for the public runtime surface of this module.
  */
@@ -343,80 +458,19 @@ export function buildExtensionTriageSummary(scope, warnings, extensions, options
     const warningCodes = [...new Set(effectiveWarnings.map((value) => warningCode(value)))].sort((left, right) => left.localeCompare(right));
     const policyWarnings = summarizePolicyWarnings(effectiveWarnings);
     const scopeFlag = scope === "global" ? "--global" : "--project";
-    const remediation = [];
-    if (normalizedWarnings.length > 0) {
-        const registrationCollisionRemediation = buildRegistrationCollisionRemediation(normalizedWarnings, {
-            deactivate: `${lifecycleFlagCommand(options, "deactivate")} <name> ${scopeFlag}`,
-            doctor: `${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace`,
-        });
-        if (registrationCollisionRemediation) {
-            remediation.push(registrationCollisionRemediation);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_manifest_"))) {
-            remediation.push(`Run ${lifecycleFlagCommand(options, "explore")} ${scopeFlag} to inspect discovered manifests and directories.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_capability_unknown:"))) {
-            remediation.push(`Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. ` +
-                "Review extension_capability_unknown warning details for suggested replacements.");
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_capability_legacy_alias:"))) {
-            remediation.push("Legacy extension capability aliases were auto-remapped to canonical capabilities. " +
-                "Update manifests to canonical names (migration/validation -> schema).");
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_capability_missing:"))) {
-            remediation.push(`Extension activation failed because code registered a surface missing from manifest capabilities. ` +
-                `Run ${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_capability_unused:"))) {
-            remediation.push("Extension manifests declare capabilities that are never registered against. " +
-                `Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace for per-extension registration counts.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_command_definition_legacy_handler_alias:"))) {
-            remediation.push("Extension command definitions using legacy handler were auto-remapped. " +
-                "Update command definitions to use run: (context) => ... for forward compatibility.");
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_output_service_override_global:") ||
-            warning.startsWith("extension_output_renderer_override_global:"))) {
-            remediation.push("Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering.");
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_load_failed_sdk_dependency_missing:"))) {
-            remediation.push(`Detected extension load failures caused by missing SDK dependency resolution. ` +
-                `Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${lifecycleFlagCommand(options, "doctor")} ${scopeFlag}.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_load_failed_module_mode_mismatch:"))) {
-            remediation.push(`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" ` +
-                `or use an explicit .mjs entry and rerun ${lifecycleFlagCommand(options, "doctor")} ${scopeFlag}.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_pm_min_version_") || warning.startsWith("extension_pm_max_version_"))) {
-            remediation.push("Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version " +
-                `with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${lifecycleFlagCommand(options, "doctor")} ${scopeFlag}.`);
-        }
-        if (updateCheckFailedTotal > 0) {
-            remediation.push(`Run ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} after validating network and repository access.`);
-        }
-        if (normalizedWarnings.some((warning) => warning.startsWith("extension_manager_state_"))) {
-            remediation.push(`Review and repair ${scope} managed extension state file if schema/read warnings persist.`);
-        }
-        if (policyWarnings.warning_count > 0) {
-            remediation.push("Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces.");
-        }
-    }
     const collisionPlan = buildRegistrationCollisionPlan(scope, normalizedWarnings, extensions, options);
-    if (updateHealthPartial) {
-        remediation.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state (or ${lifecycleFlagCommand(options, "adopt-all")} ${scopeFlag}, ${lifecycleFlagCommand(options, "adopt")} <name> ${scopeFlag}, or reinstall via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>).`);
-    }
-    else if (skippedUnmanagedTotal > 0) {
-        remediation.push(`Loaded unmanaged extensions are currently treated as informational. Use ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state to adopt them for update checks.`);
-    }
-    if (skippedNonGithubTotal > 0) {
-        remediation.push(`Non-GitHub managed extensions are skipped by update checks. Use doctor output for non-update diagnostics.`);
-    }
-    if (updateAvailableTotal > 0) {
-        remediation.push(`Update available managed extensions via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>.`);
-    }
-    if (remediation.length === 0) {
-        remediation.push(`No immediate action required. Re-run ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} after extension changes.`);
-    }
+    const remediation = buildExtensionTriageRemediation({
+        normalizedWarnings,
+        options,
+        scope,
+        scopeFlag,
+        updateCheckFailedTotal,
+        policyWarningCount: policyWarnings.warning_count,
+        updateHealthPartial,
+        skippedUnmanagedTotal,
+        skippedNonGithubTotal,
+        updateAvailableTotal,
+    });
     return {
         status: effectiveWarnings.length === 0 ? "ok" : "warn",
         warning_count: effectiveWarnings.length,
@@ -556,4 +610,4 @@ export function buildDoctorConsistencySummary(scope, installedExtensions, loaded
     };
 }
 //# sourceMappingURL=doctor.js.map
-//# debugId=52b725dc-48e3-5436-8136-47e5314b07eb
+//# debugId=391a9e4b-f4b7-5176-970b-6de9523822e7