@unbrained/pm-cli 2026.5.27 → 2026.5.29

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

@@ -1,5 +1,5 @@
 
-!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]="04152268-96ba-51fa-abb6-2a662d2dd073")}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]="778dfce2-07e1-50c3-8e47-2c43f61a9a0f")}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";
@@ -7,6 +7,7 @@ import { resolvePmPackageRootFromModule } from "../../../core/packages/root.js";
 import { pathExists } from "../../../core/fs/fs-utils.js";
 import { EXIT_CODE } from "../../../core/shared/constants.js";
 import { PmCliError } from "../../../core/shared/errors.js";
+import { splitCommaList } from "../../../core/shared/split-comma-list.js";
 import { resolveExtensionRoots } from "../../../core/extensions/loader.js";
 import { resolvePmRoot } from "../../../core/store/paths.js";
 import { validateExtensionDirectory } from "./shared.js";
@@ -234,7 +235,7 @@ function parsePackageCatalogFields(raw) {
     if (raw === undefined) {
         return undefined;
     }
-    const fields = [...new Set(raw.split(",").map((entry) => entry.trim()).filter((entry) => entry.length > 0))];
+    const fields = splitCommaList(raw);
     if (fields.length === 0) {
         throw new PmCliError("Package catalog --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
     }
@@ -265,4 +266,4 @@ function projectPackageCatalogEntry(entry, fields) {
     return projected;
 }
 //# sourceMappingURL=bundled-catalog.js.map
-//# debugId=04152268-96ba-51fa-abb6-2a662d2dd073
+//# debugId=778dfce2-07e1-50c3-8e47-2c43f61a9a0f

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":["import 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 { 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  if (typeof envRoot === \"string\" && envRoot.trim().length > 0) {\n    candidates.push(path.resolve(envRoot.trim()));\n  }\n  candidates.push(resolvePmPackageRootFromModule(import.meta.url, [\"../../../..\"]));\n  return [...new Set(candidates)];\n}\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  if (!alias) {\n    return null;\n  }\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}\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    if (entriesByAlias.has(alias)) {\n      continue;\n    }\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  }\n\n  return [...entriesByAlias.values()].sort((left, right) => left.alias.localeCompare(right.alias));\n}\n\nexport async function listBundledPackageAliases(): Promise<string[]> {\n  return (await collectBundledPackageEntries()).map((entry) => entry.alias);\n}\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\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\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 alias of await listBundledPackageAliases()) {\n    const packageRoot = await resolveBundledPackageRoot(alias);\n    const installScopeFlag = scope === \"global\" ? \"--global\" : \"--project\";\n    if (!packageRoot) {\n      packages.push({\n        alias,\n        bundled: true,\n        available: false,\n        installed: false,\n        install_target: alias,\n        install_command: `pm install ${alias} ${installScopeFlag}`,\n      });\n      continue;\n    }\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 = [...new Set(raw.split(\",\").map((entry) => entry.trim()).filter((entry) => entry.length > 0))];\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"],"names":[],"mappings":"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","debugId":"04152268-96ba-51fa-abb6-2a662d2dd073"}
+{"version":3,"file":"bundled-catalog.js","sources":["cli/commands/extension/bundled-catalog.ts"],"sourceRoot":"/","sourcesContent":["import 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  if (typeof envRoot === \"string\" && envRoot.trim().length > 0) {\n    candidates.push(path.resolve(envRoot.trim()));\n  }\n  candidates.push(resolvePmPackageRootFromModule(import.meta.url, [\"../../../..\"]));\n  return [...new Set(candidates)];\n}\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  if (!alias) {\n    return null;\n  }\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}\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    if (entriesByAlias.has(alias)) {\n      continue;\n    }\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  }\n\n  return [...entriesByAlias.values()].sort((left, right) => left.alias.localeCompare(right.alias));\n}\n\nexport async function listBundledPackageAliases(): Promise<string[]> {\n  return (await collectBundledPackageEntries()).map((entry) => entry.alias);\n}\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\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\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 alias of await listBundledPackageAliases()) {\n    const packageRoot = await resolveBundledPackageRoot(alias);\n    const installScopeFlag = scope === \"global\" ? \"--global\" : \"--project\";\n    if (!packageRoot) {\n      packages.push({\n        alias,\n        bundled: true,\n        available: false,\n        installed: false,\n        install_target: alias,\n        install_command: `pm install ${alias} ${installScopeFlag}`,\n      });\n      continue;\n    }\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"],"names":[],"mappings":"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","debugId":"778dfce2-07e1-50c3-8e47-2c43f61a9a0f"}

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

@@ -1,5 +1,5 @@
 
-!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]="9c6ffbe2-7771-564a-8aac-0c77af41629b")}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]="6ba6d57e-c873-51ad-b55d-3f35c6f9ef55")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathExists } from "../../../core/fs/fs-utils.js";
@@ -14,25 +14,58 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
         entry: "./index.js",
         capabilities: ["commands"],
     }, null, 2)}\n`;
-    const entrypoint = [
-        "export function activate(api) {",
-        "  api.registerCommand({",
-        `    name: ${JSON.stringify(commandName)},`,
-        '    description: "Starter scaffold command. Replace with your own behavior.",',
-        "    run: async (context) => ({",
-        "      ok: true,",
-        `      source: ${JSON.stringify(extensionName)},`,
-        "      command: context.command,",
-        '      message: "Starter extension scaffold is active.",',
-        "    }),",
-        "  });",
-        "}",
-        "",
-        "export default {",
-        "  activate,",
-        "};",
-        "",
-    ].join("\n");
+    // pm-fl0c B-1 (2026-05-28): emit the documented `defineExtension({...})`
+    // shape so the generated module gets full TypeScript narrowing on the
+    // `activate(api)` signature (matches docs/EXTENSIONS.md, docs/SDK.md and
+    // docs/examples/starter-extension/index.js). Codex P2 follow-up
+    // (PR #78 review): a bare `import "@unbrained/pm-cli/sdk"` cannot resolve
+    // in extension-only mode — there is no package.json with a dep on
+    // @unbrained/pm-cli, so the loader's `import(<file-url>)` would raise
+    // ERR_MODULE_NOT_FOUND. We therefore emit the typed shape ONLY in package
+    // mode (peerDependencies make the import resolvable from the package's
+    // own node_modules) and keep the import-free shape in extension-only
+    // mode, decorated with a JSDoc @param hint so editors that follow JSDoc
+    // still narrow the `api` parameter.
+    const entrypoint = vocabulary === "package"
+        ? [
+            'import { defineExtension } from "@unbrained/pm-cli/sdk";',
+            "",
+            "export default defineExtension({",
+            "  activate(api) {",
+            "    api.registerCommand({",
+            `      name: ${JSON.stringify(commandName)},`,
+            '      description: "Starter scaffold command. Replace with your own behavior.",',
+            "      run: async (context) => ({",
+            "        ok: true,",
+            `        source: ${JSON.stringify(extensionName)},`,
+            "        command: context.command,",
+            '        message: "Starter extension scaffold is active.",',
+            "      }),",
+            "    });",
+            "  },",
+            "});",
+            "",
+        ].join("\n")
+        : [
+            '/** @param {import("@unbrained/pm-cli/sdk").ExtensionApi} api */',
+            "export function activate(api) {",
+            "  api.registerCommand({",
+            `    name: ${JSON.stringify(commandName)},`,
+            '    description: "Starter scaffold command. Replace with your own behavior.",',
+            "    run: async (context) => ({",
+            "      ok: true,",
+            `      source: ${JSON.stringify(extensionName)},`,
+            "      command: context.command,",
+            '      message: "Starter extension scaffold is active.",',
+            "    }),",
+            "  });",
+            "}",
+            "",
+            "export default {",
+            "  activate,",
+            "};",
+            "",
+        ].join("\n");
     if (vocabulary === "package") {
         const packageJson = `${JSON.stringify({
             name: packageName,
@@ -166,4 +199,4 @@ export async function scaffoldExtensionProject(target, vocabulary = "extension")
     };
 }
 //# sourceMappingURL=scaffold.js.map
-//# debugId=9c6ffbe2-7771-564a-8aac-0c77af41629b
+//# debugId=6ba6d57e-c873-51ad-b55d-3f35c6f9ef55

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

@@ -1 +1 @@
-{"version":3,"file":"scaffold.js","sources":["cli/commands/extension/scaffold.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { normalizeManagedDirectoryName } from \"./shared.js\";\n\ninterface ExtensionScaffoldFileResult {\n  path: string;\n  status: \"created\" | \"unchanged\";\n}\n\ninterface ExtensionScaffoldResult {\n  extension_name: string;\n  command_name: string;\n  target_path: string;\n  created_directory: boolean;\n  files: ExtensionScaffoldFileResult[];\n}\n\n\nexport function buildStarterExtensionScaffoldFiles(\n  extensionName: string,\n  commandName: string,\n  vocabulary: \"extension\" | \"package\",\n): Record<string, string> {\n  const packageName = `pm-${extensionName}`;\n  const manifest = `${JSON.stringify(\n    {\n      name: extensionName,\n      version: \"0.1.0\",\n      entry: \"./index.js\",\n      capabilities: [\"commands\"],\n    },\n    null,\n    2,\n  )}\\n`;\n  const entrypoint = [\n    \"export function activate(api) {\",\n    \"  api.registerCommand({\",\n    `    name: ${JSON.stringify(commandName)},`,\n    '    description: \"Starter scaffold command. Replace with your own behavior.\",',\n    \"    run: async (context) => ({\",\n    \"      ok: true,\",\n    `      source: ${JSON.stringify(extensionName)},`,\n    \"      command: context.command,\",\n    '      message: \"Starter extension scaffold is active.\",',\n    \"    }),\",\n    \"  });\",\n    \"}\",\n    \"\",\n    \"export default {\",\n    \"  activate,\",\n    \"};\",\n    \"\",\n  ].join(\"\\n\");\n  if (vocabulary === \"package\") {\n    const packageJson = `${JSON.stringify(\n      {\n        name: packageName,\n        version: \"0.1.0\",\n        private: true,\n        type: \"module\",\n        keywords: [\"pm-package\"],\n        peerDependencies: {\n          \"@unbrained/pm-cli\": \"*\",\n        },\n        pm: {\n          aliases: [extensionName],\n          extensions: [`extensions/${extensionName}`],\n          docs: [\"README.md\"],\n          examples: [\"README.md\"],\n          catalog: {\n            display_name: extensionName,\n            category: \"workflow\",\n            summary: \"Starter pm package scaffold.\",\n            tags: [\"starter\"],\n          },\n        },\n      },\n      null,\n      2,\n    )}\\n`;\n    const packageReadme = [\n      `# ${packageName}`,\n      \"\",\n      \"Generated by `pm package init`.\",\n      \"\",\n      \"## Included Files\",\n      \"- `package.json`: package metadata and `pm` resource manifest.\",\n      `- \\`extensions/${extensionName}/manifest.json\\`: extension metadata and capabilities.`,\n      `- \\`extensions/${extensionName}/index.js\\`: starter command registration using the \\`commands\\` capability.`,\n      \"\",\n      \"## Quick Start\",\n      \"```bash\",\n      \"pm install --project <package-path>\",\n      `pm ${commandName}`,\n      \"pm package doctor --project --detail summary\",\n      \"```\",\n      \"\",\n      \"## Notes\",\n      \"- Keep package metadata in `package.json` and runtime behavior under `extensions/`.\",\n      \"- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.\",\n      \"- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.\",\n      \"\",\n    ].join(\"\\n\");\n    return {\n      \"package.json\": packageJson,\n      [`extensions/${extensionName}/manifest.json`]: manifest,\n      [`extensions/${extensionName}/index.js`]: entrypoint,\n      \"README.md\": packageReadme,\n    };\n  }\n  const readme = [\n    `# ${extensionName}`,\n    \"\",\n    \"Generated by `pm extension init`.\",\n    \"\",\n    \"## Included Files\",\n    \"- `manifest.json`: extension metadata and capabilities.\",\n    \"- `index.js`: starter command registration using the `commands` capability.\",\n    \"\",\n    \"## Quick Start\",\n    \"```bash\",\n    \"pm extension --install --project <scaffold-path>\",\n    `pm ${commandName}`,\n    \"pm extension --doctor --project --detail summary\",\n    \"```\",\n    \"\",\n    \"## Notes\",\n    \"- This scaffold uses ESM exports so it works in package scopes with `type: module`.\",\n    \"- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.\",\n    \"\",\n  ].join(\"\\n\");\n  return {\n    \"manifest.json\": manifest,\n    \"index.js\": entrypoint,\n    \"README.md\": readme,\n  };\n}\n\nexport async function scaffoldExtensionProject(\n  target: string,\n  vocabulary: \"extension\" | \"package\" = \"extension\",\n): Promise<ExtensionScaffoldResult> {\n  const normalizedTarget = target.trim();\n  const targetPath = path.resolve(process.cwd(), normalizedTarget);\n  const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));\n  const commandName = `${extensionName} ping`;\n  const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary);\n\n  let createdDirectory = false;\n  if (await pathExists(targetPath)) {\n    const existingTargetStats = await fs.stat(targetPath);\n    if (!existingTargetStats.isDirectory()) {\n      throw new PmCliError(\n        `Scaffold target \"${targetPath}\" exists and is not a directory.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  } else {\n    await fs.mkdir(targetPath, { recursive: true });\n    createdDirectory = true;\n  }\n\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (!(await pathExists(absolutePath))) {\n      continue;\n    }\n    const existingContent = await fs.readFile(absolutePath, \"utf8\");\n    if (existingContent !== content) {\n      throw new PmCliError(\n        `Scaffold file \"${relativePath}\" already exists with different content in \"${targetPath}\". Choose a new target path or remove conflicting files.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  }\n\n  const files: ExtensionScaffoldFileResult[] = [];\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (await pathExists(absolutePath)) {\n      files.push({\n        path: relativePath,\n        status: \"unchanged\",\n      });\n      continue;\n    }\n    await fs.mkdir(path.dirname(absolutePath), { recursive: true });\n    await fs.writeFile(absolutePath, content, \"utf8\");\n    files.push({\n      path: relativePath,\n      status: \"created\",\n    });\n  }\n\n  return {\n    extension_name: extensionName,\n    command_name: commandName,\n    target_path: targetPath,\n    created_directory: createdDirectory,\n    files,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"9c6ffbe2-7771-564a-8aac-0c77af41629b"}
+{"version":3,"file":"scaffold.js","sources":["cli/commands/extension/scaffold.ts"],"sourceRoot":"/","sourcesContent":["import fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { pathExists } from \"../../../core/fs/fs-utils.js\";\nimport { EXIT_CODE } from \"../../../core/shared/constants.js\";\nimport { PmCliError } from \"../../../core/shared/errors.js\";\nimport { normalizeManagedDirectoryName } from \"./shared.js\";\n\ninterface ExtensionScaffoldFileResult {\n  path: string;\n  status: \"created\" | \"unchanged\";\n}\n\ninterface ExtensionScaffoldResult {\n  extension_name: string;\n  command_name: string;\n  target_path: string;\n  created_directory: boolean;\n  files: ExtensionScaffoldFileResult[];\n}\n\n\nexport function buildStarterExtensionScaffoldFiles(\n  extensionName: string,\n  commandName: string,\n  vocabulary: \"extension\" | \"package\",\n): Record<string, string> {\n  const packageName = `pm-${extensionName}`;\n  const manifest = `${JSON.stringify(\n    {\n      name: extensionName,\n      version: \"0.1.0\",\n      entry: \"./index.js\",\n      capabilities: [\"commands\"],\n    },\n    null,\n    2,\n  )}\\n`;\n  // pm-fl0c B-1 (2026-05-28): emit the documented `defineExtension({...})`\n  // shape so the generated module gets full TypeScript narrowing on the\n  // `activate(api)` signature (matches docs/EXTENSIONS.md, docs/SDK.md and\n  // docs/examples/starter-extension/index.js). Codex P2 follow-up\n  // (PR #78 review): a bare `import \"@unbrained/pm-cli/sdk\"` cannot resolve\n  // in extension-only mode — there is no package.json with a dep on\n  // @unbrained/pm-cli, so the loader's `import(<file-url>)` would raise\n  // ERR_MODULE_NOT_FOUND. We therefore emit the typed shape ONLY in package\n  // mode (peerDependencies make the import resolvable from the package's\n  // own node_modules) and keep the import-free shape in extension-only\n  // mode, decorated with a JSDoc @param hint so editors that follow JSDoc\n  // still narrow the `api` parameter.\n  const entrypoint =\n    vocabulary === \"package\"\n      ? [\n          'import { defineExtension } from \"@unbrained/pm-cli/sdk\";',\n          \"\",\n          \"export default defineExtension({\",\n          \"  activate(api) {\",\n          \"    api.registerCommand({\",\n          `      name: ${JSON.stringify(commandName)},`,\n          '      description: \"Starter scaffold command. Replace with your own behavior.\",',\n          \"      run: async (context) => ({\",\n          \"        ok: true,\",\n          `        source: ${JSON.stringify(extensionName)},`,\n          \"        command: context.command,\",\n          '        message: \"Starter extension scaffold is active.\",',\n          \"      }),\",\n          \"    });\",\n          \"  },\",\n          \"});\",\n          \"\",\n        ].join(\"\\n\")\n      : [\n          '/** @param {import(\"@unbrained/pm-cli/sdk\").ExtensionApi} api */',\n          \"export function activate(api) {\",\n          \"  api.registerCommand({\",\n          `    name: ${JSON.stringify(commandName)},`,\n          '    description: \"Starter scaffold command. Replace with your own behavior.\",',\n          \"    run: async (context) => ({\",\n          \"      ok: true,\",\n          `      source: ${JSON.stringify(extensionName)},`,\n          \"      command: context.command,\",\n          '      message: \"Starter extension scaffold is active.\",',\n          \"    }),\",\n          \"  });\",\n          \"}\",\n          \"\",\n          \"export default {\",\n          \"  activate,\",\n          \"};\",\n          \"\",\n        ].join(\"\\n\");\n  if (vocabulary === \"package\") {\n    const packageJson = `${JSON.stringify(\n      {\n        name: packageName,\n        version: \"0.1.0\",\n        private: true,\n        type: \"module\",\n        keywords: [\"pm-package\"],\n        peerDependencies: {\n          \"@unbrained/pm-cli\": \"*\",\n        },\n        pm: {\n          aliases: [extensionName],\n          extensions: [`extensions/${extensionName}`],\n          docs: [\"README.md\"],\n          examples: [\"README.md\"],\n          catalog: {\n            display_name: extensionName,\n            category: \"workflow\",\n            summary: \"Starter pm package scaffold.\",\n            tags: [\"starter\"],\n          },\n        },\n      },\n      null,\n      2,\n    )}\\n`;\n    const packageReadme = [\n      `# ${packageName}`,\n      \"\",\n      \"Generated by `pm package init`.\",\n      \"\",\n      \"## Included Files\",\n      \"- `package.json`: package metadata and `pm` resource manifest.\",\n      `- \\`extensions/${extensionName}/manifest.json\\`: extension metadata and capabilities.`,\n      `- \\`extensions/${extensionName}/index.js\\`: starter command registration using the \\`commands\\` capability.`,\n      \"\",\n      \"## Quick Start\",\n      \"```bash\",\n      \"pm install --project <package-path>\",\n      `pm ${commandName}`,\n      \"pm package doctor --project --detail summary\",\n      \"```\",\n      \"\",\n      \"## Notes\",\n      \"- Keep package metadata in `package.json` and runtime behavior under `extensions/`.\",\n      \"- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.\",\n      \"- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.\",\n      \"\",\n    ].join(\"\\n\");\n    return {\n      \"package.json\": packageJson,\n      [`extensions/${extensionName}/manifest.json`]: manifest,\n      [`extensions/${extensionName}/index.js`]: entrypoint,\n      \"README.md\": packageReadme,\n    };\n  }\n  const readme = [\n    `# ${extensionName}`,\n    \"\",\n    \"Generated by `pm extension init`.\",\n    \"\",\n    \"## Included Files\",\n    \"- `manifest.json`: extension metadata and capabilities.\",\n    \"- `index.js`: starter command registration using the `commands` capability.\",\n    \"\",\n    \"## Quick Start\",\n    \"```bash\",\n    \"pm extension --install --project <scaffold-path>\",\n    `pm ${commandName}`,\n    \"pm extension --doctor --project --detail summary\",\n    \"```\",\n    \"\",\n    \"## Notes\",\n    \"- This scaffold uses ESM exports so it works in package scopes with `type: module`.\",\n    \"- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.\",\n    \"\",\n  ].join(\"\\n\");\n  return {\n    \"manifest.json\": manifest,\n    \"index.js\": entrypoint,\n    \"README.md\": readme,\n  };\n}\n\nexport async function scaffoldExtensionProject(\n  target: string,\n  vocabulary: \"extension\" | \"package\" = \"extension\",\n): Promise<ExtensionScaffoldResult> {\n  const normalizedTarget = target.trim();\n  const targetPath = path.resolve(process.cwd(), normalizedTarget);\n  const extensionName = normalizeManagedDirectoryName(path.basename(targetPath));\n  const commandName = `${extensionName} ping`;\n  const scaffoldFiles = buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary);\n\n  let createdDirectory = false;\n  if (await pathExists(targetPath)) {\n    const existingTargetStats = await fs.stat(targetPath);\n    if (!existingTargetStats.isDirectory()) {\n      throw new PmCliError(\n        `Scaffold target \"${targetPath}\" exists and is not a directory.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  } else {\n    await fs.mkdir(targetPath, { recursive: true });\n    createdDirectory = true;\n  }\n\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (!(await pathExists(absolutePath))) {\n      continue;\n    }\n    const existingContent = await fs.readFile(absolutePath, \"utf8\");\n    if (existingContent !== content) {\n      throw new PmCliError(\n        `Scaffold file \"${relativePath}\" already exists with different content in \"${targetPath}\". Choose a new target path or remove conflicting files.`,\n        EXIT_CODE.CONFLICT,\n      );\n    }\n  }\n\n  const files: ExtensionScaffoldFileResult[] = [];\n  for (const [relativePath, content] of Object.entries(scaffoldFiles)) {\n    const absolutePath = path.join(targetPath, relativePath);\n    if (await pathExists(absolutePath)) {\n      files.push({\n        path: relativePath,\n        status: \"unchanged\",\n      });\n      continue;\n    }\n    await fs.mkdir(path.dirname(absolutePath), { recursive: true });\n    await fs.writeFile(absolutePath, content, \"utf8\");\n    files.push({\n      path: relativePath,\n      status: \"created\",\n    });\n  }\n\n  return {\n    extension_name: extensionName,\n    command_name: commandName,\n    target_path: targetPath,\n    created_directory: createdDirectory,\n    files,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"6ba6d57e-c873-51ad-b55d-3f35c6f9ef55"}

package/dist/cli/commands/health.js

@@ -1,5 +1,5 @@
 
-!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]="43221c16-6351-5238-a4d1-d94619239fb2")}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]="3ee1354d-7d6b-504d-9740-8f4c1b8451be")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
@@ -11,6 +11,7 @@ import { scanHistoryDrift } from "../../core/history/drift-scan.js";
 import { readVectorizationStatusLedger, refreshSemanticEmbeddingsForMutatedItems, } from "../../core/search/cache.js";
 import { resolveEmbeddingProviders } from "../../core/search/providers.js";
 import { resolveSettingsWithSemanticRuntimeDefaults } from "../../core/search/semantic-defaults.js";
+import { collectStaleVectorizationIds } from "../../core/search/staleness.js";
 import { resolveVectorStores } from "../../core/search/vector-stores.js";
 import { EXIT_CODE, PM_CORE_REQUIRED_SUBDIRS, PM_OPTIONAL_TYPE_SUBDIRS } from "../../core/shared/constants.js";
 import { findFirstMergeConflictMarker } from "../../core/shared/conflict-markers.js";
@@ -541,15 +542,6 @@ async function buildExtensionCheck(pmRoot, settings, noExtensionsFlag) {
         warnings: extensionWarnings,
     };
 }
-function collectStaleVectorizationIds(items, ledgerEntries) {
-    return items
-        .filter((item) => {
-        const trackedUpdatedAt = ledgerEntries[item.id];
-        return trackedUpdatedAt !== item.updated_at;
-    })
-        .map((item) => item.id)
-        .sort((left, right) => left.localeCompare(right));
-}
 function summarizeList(values, limit) {
     if (values.length <= limit) {
         return { values, truncated: false };
@@ -1256,4 +1248,4 @@ export async function runHealth(global, options = {}) {
     return options.brief === true ? applyBriefHealthProjection(result) : result;
 }
 //# sourceMappingURL=health.js.map
-//# debugId=43221c16-6351-5238-a4d1-d94619239fb2
+//# debugId=3ee1354d-7d6b-504d-9740-8f4c1b8451be