@unbrained/pm-cli 2026.7.14 → 2026.7.15

package/dist/sdk/extension/install-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-sources.js","sources":["sdk/extension/install-sources.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/extension/install-sources\n *\n * Implements extension package-management support for Install Sources.\n */\nimport { execFile } from \"node:child_process\";\nimport fs from \"node:fs/promises\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { promisify } from \"node:util\";\nimport { collectPackageExtensionDirectories } from \"../../core/packages/manifest.js\";\nimport { resolvePmPackageRootFromModule } from \"../../core/packages/root.js\";\nimport { pathExists } from \"../../core/fs/fs-utils.js\";\nimport { isPathWithinDirectory } from \"../../core/fs/path-utils.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport {\n  PmCliError,\n  type PmCliErrorContext,\n} from \"../../core/shared/errors.js\";\nimport { listBundledPackageAliases } from \"./bundled-catalog.js\";\n\nconst execFileAsync = promisify(execFile);\nconst PM_CLI_PACKAGE_NAME = \"@unbrained/pm-cli\";\nlet bundledPackageAliasesCache: { key: string; aliases: string[] } | undefined;\n\ninterface LocalInstallSource {\n  kind: \"local\";\n  input: string;\n  absolute_path: string;\n}\n\ninterface GithubInstallSource {\n  kind: \"github\";\n  input: string;\n  owner: string;\n  repo: string;\n  repository: string;\n  ref?: string;\n  subpath?: string;\n}\n\ninterface NpmInstallSource {\n  kind: \"npm\";\n  input: string;\n  spec: string;\n}\n\ntype InstallSource =\n  | LocalInstallSource\n  | GithubInstallSource\n  | NpmInstallSource;\n\ninterface ResolvedInstallSource {\n  source: InstallSource;\n  directory: string;\n  resolved_subpath?: string;\n  commit?: string;\n  npm_package?: string;\n  npm_version?: string;\n  cleanup?: () => Promise<void>;\n}\n\nfunction parseGithubPathSpec(\n  pathSpec: string,\n  input: string,\n  refOverride?: string,\n): GithubInstallSource | null {\n  const segments = pathSpec\n    .split(\"/\")\n    .map((segment) => segment.trim())\n    .filter((segment) => segment.length > 0);\n  if (segments.length < 2) {\n    return null;\n  }\n  const owner = segments[0];\n  const repo = segments[1].replace(/\\.git$/i, \"\");\n  if (owner.length === 0 || repo.length === 0) {\n    return null;\n  }\n  const tail = segments.slice(2);\n  let ref: string | undefined;\n  let subpath: string | undefined;\n  if (tail[0] === \"tree\" && tail.length >= 2) {\n    ref = tail[1];\n    subpath = tail.slice(2).join(\"/\");\n  } else if (tail.length > 0) {\n    subpath = tail.join(\"/\");\n  }\n  if (typeof refOverride === \"string\" && refOverride.trim().length > 0) {\n    ref = refOverride.trim();\n  }\n  return {\n    kind: \"github\",\n    input,\n    owner,\n    repo,\n    repository: `https://github.com/${owner}/${repo}.git`,\n    ref,\n    subpath: subpath && subpath.length > 0 ? subpath : undefined,\n  };\n}\n\nfunction parseNpmInstallSource(\n  normalizedInput: string,\n  forceGithub: boolean,\n  refOverride: string | undefined,\n): InstallSource {\n  const spec = normalizedInput.slice(\"npm:\".length).trim();\n  if (spec.length === 0) {\n    throw new PmCliError(\n      'npm package source must include a package spec after \"npm:\".',\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (forceGithub) {\n    throw new PmCliError(\n      'Options \"--gh/--github\" cannot be combined with npm: package sources.',\n      EXIT_CODE.USAGE,\n    );\n  }\n  if (refOverride) {\n    throw new PmCliError(\n      'Option \"--ref\" cannot be combined with npm: package sources.',\n      EXIT_CODE.USAGE,\n    );\n  }\n  return {\n    kind: \"npm\",\n    input: normalizedInput,\n    spec,\n  };\n}\n\n/** Implements parse extension install source for the public runtime surface of this module. */\nexport function parseExtensionInstallSource(\n  input: string,\n  options: { forceGithub?: boolean; ref?: string } = {},\n): InstallSource {\n  const normalizedInput = input.trim();\n  if (normalizedInput.length === 0) {\n    throw new PmCliError(\n      \"Extension source is required for --install.\",\n      EXIT_CODE.USAGE,\n    );\n  }\n  const refOverride =\n    typeof options.ref === \"string\" && options.ref.trim().length > 0\n      ? options.ref.trim()\n      : undefined;\n\n  if (normalizedInput.startsWith(\"npm:\")) {\n    return parseNpmInstallSource(\n      normalizedInput,\n      options.forceGithub === true,\n      refOverride,\n    );\n  }\n\n  const maybeGithubByUrl = (() => {\n    try {\n      const parsed = new URL(normalizedInput);\n      if (parsed.hostname !== \"github.com\") {\n        return null;\n      }\n      const pathSpec = parsed.pathname.replace(/^\\/+/, \"\");\n      return parseGithubPathSpec(pathSpec, normalizedInput, refOverride);\n    } catch {\n      return null;\n    }\n  })();\n  if (maybeGithubByUrl) {\n    return maybeGithubByUrl;\n  }\n\n  const strippedDomainInput = normalizedInput.startsWith(\"github.com/\")\n    ? normalizedInput.slice(\"github.com/\".length)\n    : null;\n  if (strippedDomainInput) {\n    const parsed = parseGithubPathSpec(\n      strippedDomainInput,\n      normalizedInput,\n      refOverride,\n    );\n    if (!parsed) {\n      throw new PmCliError(\n        `Invalid GitHub source \"${normalizedInput}\".`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return parsed;\n  }\n\n  if (options.forceGithub) {\n    const parsed = parseGithubPathSpec(\n      normalizedInput,\n      normalizedInput,\n      refOverride,\n    );\n    if (!parsed) {\n      throw new PmCliError(\n        `Invalid GitHub shorthand \"${normalizedInput}\".`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    return parsed;\n  }\n\n  if (/^https?:\\/\\//i.test(normalizedInput)) {\n    throw new PmCliError(\n      `Unsupported extension source URL \"${normalizedInput}\". Supported remote source host: github.com.`,\n      EXIT_CODE.USAGE,\n    );\n  }\n\n  return {\n    kind: \"local\",\n    input: normalizedInput,\n    absolute_path: path.resolve(process.cwd(), normalizedInput),\n  };\n}\n\n/** Implements run git command for the public runtime surface of this module. */\nexport async function runGitCommand(\n  args: string[],\n  execRunner: typeof execFileAsync = execFileAsync,\n  timeoutMs?: number,\n): Promise<string> {\n  try {\n    const result = await execRunner(\"git\", args, {\n      encoding: \"utf8\",\n      timeout: timeoutMs,\n    });\n    return (result.stdout ?? \"\").trim();\n  } catch (error: unknown) {\n    /* c8 ignore start -- stderr-vs-error-message precedence is validated in integration command-runner paths */\n    const stderr =\n      typeof error === \"object\" && error !== null && \"stderr\" in error\n        ? String((error as { stderr: unknown }).stderr)\n        : \"\";\n    const message =\n      stderr.trim().length > 0\n        ? stderr.trim()\n        : error instanceof Error\n          ? error.message\n          : String(error);\n    /* c8 ignore stop */\n    throw new PmCliError(\n      `Git command failed: git ${args.join(\" \")}\\n${message}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\n/** Implements resolve npm command name for the public runtime surface of this module. */\nexport function resolveNpmCommandName(\n  platform: NodeJS.Platform = process.platform,\n): \"npm\" | \"npm.cmd\" {\n  return platform === \"win32\" ? \"npm.cmd\" : \"npm\";\n}\n\n/** Implements should run npm command in shell for the public runtime surface of this module. */\nexport function shouldRunNpmCommandInShell(\n  platform: NodeJS.Platform = process.platform,\n): boolean {\n  return platform === \"win32\";\n}\n\nasync function runNpmCommand(\n  args: string[],\n  cwd?: string,\n  execRunner: typeof execFileAsync = execFileAsync,\n): Promise<string> {\n  const npmCommand = resolveNpmCommandName();\n  try {\n    const result = await execRunner(npmCommand, args, {\n      cwd,\n      encoding: \"utf8\",\n      shell: shouldRunNpmCommandInShell(),\n    });\n    return (result.stdout ?? \"\").trim();\n  } catch (error: unknown) {\n    const stderr =\n      typeof error === \"object\" && error !== null && \"stderr\" in error\n        ? String((error as { stderr: unknown }).stderr)\n        : \"\";\n    const message =\n      stderr.trim().length > 0\n        ? stderr.trim()\n        : error instanceof Error\n          ? error.message\n          : String(error);\n    throw new PmCliError(\n      `npm command failed: ${npmCommand} ${args.join(\" \")}\\n${message}`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\nfunction npmPackageNameFromSpec(spec: string): string {\n  const trimmed = spec.trim();\n  const withoutAlias = trimmed.includes(\"@file:\")\n    ? trimmed.slice(0, trimmed.lastIndexOf(\"@file:\"))\n    : trimmed;\n  if (withoutAlias.startsWith(\"@\")) {\n    const scoped = withoutAlias.match(/^(@[^/@\\s]+\\/[^/@\\s]+)/);\n    return scoped?.[1] ?? withoutAlias;\n  }\n  const unscoped = withoutAlias.match(/^([^/@\\s]+)/);\n  return unscoped?.[1] ?? withoutAlias;\n}\n\n/** Implements check whether npm not found error for the public runtime surface of this module. */\nexport function isNpmNotFoundError(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error);\n  const normalized = message.toLowerCase();\n  return (\n    normalized.includes(\"npm err! code e404\") ||\n    normalized.includes(\"404 not found\") ||\n    normalized.includes(\"is not in this registry\")\n  );\n}\n\n/** Implements check whether npm pack not found error for the public runtime surface of this module. */\nexport function isNpmPackNotFoundError(error: unknown): boolean {\n  const message = error instanceof Error ? error.message : String(error);\n  const normalized = message.toLowerCase();\n  return isNpmNotFoundError(error) || normalized.includes(\"not found\");\n}\n\nfunction isFirstPartyPmPackageName(packageName: string): boolean {\n  const normalized = packageName.trim().toLowerCase();\n  return (\n    normalized.startsWith(\"@unbrained/pm-\") || normalized.startsWith(\"pm-\")\n  );\n}\n\n/** Implements build npm not found recovery for the public runtime surface of this module. */\nexport function buildNpmNotFoundRecovery(spec: string): {\n  message: string;\n  context: PmCliErrorContext;\n} {\n  const packageName = npmPackageNameFromSpec(spec);\n  const isFirstPartyPackage = isFirstPartyPmPackageName(packageName);\n  const repoName = packageName.replace(/^.*\\//, \"\");\n  const githubSource = isFirstPartyPackage\n    ? `github.com/unbraind/${repoName}`\n    : undefined;\n  const nextBestCommand = githubSource\n    ? `pm install --project ${githubSource}`\n    : undefined;\n  return {\n    message: isFirstPartyPackage\n      ? `npm package \"${spec}\" was not found in the registry. If this is an unpublished first-party pm package, install its GitHub repository instead.`\n      : `npm package \"${spec}\" was not found in the registry.`,\n    context: {\n      code: \"npm_package_not_found\",\n      required:\n        \"Use an install source that exists, or publish the npm package before installing it with npm:<name>.\",\n      why: \"Classifying npm 404s avoids repeated registry retries and gives agents a deterministic fallback path.\",\n      examples: nextBestCommand\n        ? [nextBestCommand, `pm package catalog --project --json`]\n        : [`npm view ${packageName}`, `pm package catalog --project --json`],\n      nextSteps: nextBestCommand\n        ? [\n            `Try ${nextBestCommand} if the repository exists.`,\n            \"Use pm package catalog --project --json to inspect bundled package aliases before installing.\",\n          ]\n        : [\n            `Verify ${packageName} exists in the npm registry and that you have access to it.`,\n            \"Use pm package catalog --project --json to inspect bundled package aliases before installing.\",\n          ],\n      recovery: {\n        attempted_command: `pm install --project npm:${spec}`,\n        normalized_args: [\"install\", \"--project\", `npm:${spec}`],\n        ...(githubSource && nextBestCommand\n          ? {\n              fallback_candidates: [\n                {\n                  source: githubSource,\n                  command: nextBestCommand,\n                  reason:\n                    \"canonical first-party GitHub repository fallback for unpublished pm packages\",\n                },\n              ],\n              next_best_command: nextBestCommand,\n            }\n          : {}),\n      },\n    },\n  };\n}\n\n/** Implements wrap npm pack resolution error for the public runtime surface of this module. */\nexport function wrapNpmPackResolutionError(\n  spec: string,\n  error: unknown,\n): PmCliError | null {\n  if (!isNpmPackNotFoundError(error)) {\n    return null;\n  }\n  const recovery = buildNpmNotFoundRecovery(spec);\n  return new PmCliError(\n    recovery.message,\n    EXIT_CODE.NOT_FOUND,\n    recovery.context,\n  );\n}\n\nasync function resolveLocalNpmPackagePath(\n  spec: string,\n): Promise<string | null> {\n  if (path.isAbsolute(spec) || spec.startsWith(\".\") || spec.startsWith(\"..\")) {\n    const absolutePath = path.resolve(process.cwd(), spec);\n    return (await pathExists(absolutePath)) ? absolutePath : null;\n  }\n\n  try {\n    const parsed = new URL(spec);\n    if (parsed.protocol === \"file:\") {\n      const absolutePath = fileURLToPath(parsed);\n      return (await pathExists(absolutePath)) ? absolutePath : null;\n    }\n  } catch {\n    // Registry package specs are not URLs.\n  }\n\n  if (!/^[a-z][a-z0-9+.-]*:/i.test(spec)) {\n    const absolutePath = path.resolve(process.cwd(), spec);\n    if (await pathExists(absolutePath)) {\n      return absolutePath;\n    }\n  }\n\n  return null;\n}\n\nasync function resolveNpmPackSpec(spec: string): Promise<string> {\n  const localPath = await resolveLocalNpmPackagePath(spec);\n  if (localPath) {\n    // Hand npm pack a NATIVE filesystem path, never a percent-encoded file URL:\n    // npm opens the spec literally, so spaces (`%20`) or a Windows 8.3 `~` short\n    // name (`%7E`) escaped by pathToFileURL make pack fail ENOENT on every\n    // platform (GH-363). resolveLocalNpmPackagePath already decoded the path.\n    return localPath;\n  }\n\n  const localFileAlias = normalizeNpmLocalFileAliasSpec(spec);\n  if (localFileAlias !== spec) {\n    return localFileAlias;\n  }\n\n  if (/^[a-z][a-z0-9+.-]*:/i.test(spec)) {\n    return spec;\n  }\n\n  return spec;\n}\n\n/** Implements normalize npm local file alias spec for the public runtime surface of this module. */\nexport function normalizeNpmLocalFileAliasSpec(\n  spec: string,\n  cwd: string = process.cwd(),\n): string {\n  const marker = \"@file:\";\n  const markerIndex = spec.lastIndexOf(marker);\n  if (markerIndex <= 0) {\n    return spec;\n  }\n  const packageName = spec.slice(0, markerIndex);\n  const target = spec.slice(markerIndex + marker.length);\n  if (packageName.trim().length === 0 || target.trim().length === 0) {\n    return spec;\n  }\n  // `file://host/share` (exactly two leading slashes) is a UNC / network spec,\n  // not a local path — leave it for npm to resolve.\n  if (target.startsWith(\"//\") && !target.startsWith(\"///\")) {\n    return spec;\n  }\n  // A bare relative target resolves against cwd.\n  if (!target.startsWith(\"/\")) {\n    return `${packageName}@${path.resolve(cwd, target)}`;\n  }\n  // Resolve an absolute `file:` URL target to a NATIVE, percent-DECODED path\n  // (never an encoded file URL): npm opens the alias target literally, so an\n  // escaped path — spaces (`%20`) or a Windows 8.3 `~` short name escaped to\n  // `%7E` — fails ENOENT on every platform (GH-363). Decode via URL +\n  // decodeURIComponent rather than fileURLToPath, which throws\n  // ERR_INVALID_FILE_URL_PATH for a driveless absolute path supplied on Windows;\n  // strip the leading slash before a Windows drive letter (`/C:/x` -> `C:/x`).\n  let decodedPath: string;\n  try {\n    decodedPath = decodeURIComponent(new URL(`file:${target}`).pathname);\n  } catch {\n    // Malformed percent-encoding (e.g. `%ZZ`) makes decodeURIComponent throw a\n    // URIError; leave the spec untouched so npm surfaces a clear error instead\n    // of crashing the CLI on an uncaught exception.\n    return spec;\n  }\n  const nativePath = /^\\/[A-Za-z]:/.test(decodedPath)\n    ? decodedPath.slice(1)\n    : decodedPath;\n  return `${packageName}@${nativePath}`;\n}\n\nfunction parsePackedNpmPackage(\n  stdout: string,\n  packDirectory: string,\n): { tarball: string; package?: string; version?: string } {\n  try {\n    const parsed = JSON.parse(stdout) as Array<{\n      filename?: unknown;\n      name?: unknown;\n      version?: unknown;\n    }>;\n    const first = Array.isArray(parsed) ? parsed[0] : undefined;\n    if (\n      first &&\n      typeof first.filename === \"string\" &&\n      first.filename.trim().length > 0\n    ) {\n      return {\n        tarball: path.resolve(packDirectory, first.filename),\n        package: typeof first.name === \"string\" ? first.name : undefined,\n        version: typeof first.version === \"string\" ? first.version : undefined,\n      };\n    }\n  } catch {\n    // Fall back to the last stdout line for older npm output.\n  }\n  const lastLine = stdout\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0)\n    .at(-1);\n  if (!lastLine) {\n    throw new PmCliError(\n      \"npm pack did not report a tarball filename.\",\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n  return {\n    tarball: path.resolve(packDirectory, lastLine),\n  };\n}\n\nasync function resolveNpmSourceDirectory(source: NpmInstallSource): Promise<{\n  directory: string;\n  package?: string;\n  version?: string;\n  cleanup: () => Promise<void>;\n}> {\n  return resolveNpmSourceDirectoryWithRunner(source, runNpmCommand);\n}\n\nasync function resolveNpmSourceDirectoryWithRunner(\n  source: NpmInstallSource,\n  npmRunner: typeof runNpmCommand,\n): Promise<{\n  directory: string;\n  package?: string;\n  version?: string;\n  cleanup: () => Promise<void>;\n}> {\n  const localPackageRoot = await resolveLocalNpmPackagePath(source.spec);\n  if (localPackageRoot) {\n    const packageJsonPath = path.join(localPackageRoot, \"package.json\");\n    const packageJson = (await pathExists(packageJsonPath))\n      ? (JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as {\n          name?: unknown;\n          version?: unknown;\n        })\n      : {};\n    return {\n      directory: await resolvePackageExtensionDirectory(\n        localPackageRoot,\n        source.input,\n      ),\n      package:\n        typeof packageJson.name === \"string\" ? packageJson.name : undefined,\n      version:\n        typeof packageJson.version === \"string\"\n          ? packageJson.version\n          : undefined,\n      cleanup: async () => {},\n    };\n  }\n\n  const tempRoot = await fs.mkdtemp(\n    path.join(os.tmpdir(), \"pm-npm-package-source-\"),\n  );\n  const packDirectory = path.join(tempRoot, \"pack\");\n  const extractDirectory = path.join(tempRoot, \"extract\");\n  await fs.mkdir(packDirectory, { recursive: true });\n  await fs.mkdir(extractDirectory, { recursive: true });\n\n  try {\n    const packSpec = await resolveNpmPackSpec(source.spec);\n    const packStdout = await npmRunner([\n      \"pack\",\n      packSpec,\n      \"--json\",\n      \"--pack-destination\",\n      packDirectory,\n    ]);\n    const packed = parsePackedNpmPackage(packStdout, packDirectory);\n    await execFileAsync(\n      \"tar\",\n      [\"-xzf\", packed.tarball, \"-C\", extractDirectory],\n      { encoding: \"utf8\" },\n    );\n    const packageRoot = path.join(extractDirectory, \"package\");\n    await installNpmPackageRuntimeDependencies(packageRoot);\n    const directory = await resolvePackageExtensionDirectory(\n      packageRoot,\n      source.input,\n    );\n    return {\n      directory,\n      package: packed.package,\n      version: packed.version,\n      cleanup: async () => {\n        await fs.rm(tempRoot, { recursive: true, force: true });\n      },\n    };\n  } catch (error: unknown) {\n    await fs.rm(tempRoot, { recursive: true, force: true });\n    const wrappedError = wrapNpmPackResolutionError(source.spec, error);\n    if (wrappedError) {\n      throw wrappedError;\n    }\n    throw error;\n  }\n}\n\nasync function installNpmPackageRuntimeDependencies(\n  packageRoot: string,\n): Promise<void> {\n  const packageJsonPath = path.join(packageRoot, \"package.json\");\n  if (!(await pathExists(packageJsonPath))) {\n    return;\n  }\n\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(await fs.readFile(packageJsonPath, \"utf8\")) as unknown;\n  } catch {\n    return;\n  }\n  if (typeof parsed !== \"object\" || parsed === null) {\n    return;\n  }\n\n  const manifest = parsed as {\n    dependencies?: unknown;\n    optionalDependencies?: unknown;\n    peerDependencies?: unknown;\n  };\n  const dependencySpecs = runtimeDependencyInstallSpecs(manifest);\n  const shouldLinkHostedPmCli = hasHostedPmCliDependency(manifest);\n  if (dependencySpecs.length === 0 && !shouldLinkHostedPmCli) {\n    return;\n  }\n\n  const runtimeOnlyManifest = { ...(parsed as Record<string, unknown>) };\n  delete runtimeOnlyManifest.devDependencies;\n  const installManifest = { ...runtimeOnlyManifest };\n  removeHostedPmCliDependency(installManifest);\n  await fs.writeFile(\n    packageJsonPath,\n    `${JSON.stringify(installManifest, null, 2)}\\n`,\n    \"utf8\",\n  );\n  try {\n    await Promise.all([\n      fs.rm(path.join(packageRoot, \"package-lock.json\"), { force: true }),\n      fs.rm(path.join(packageRoot, \"npm-shrinkwrap.json\"), { force: true }),\n    ]);\n\n    if (dependencySpecs.length > 0) {\n      await runNpmCommand(\n        [\n          \"install\",\n          \"--ignore-scripts\",\n          \"--no-audit\",\n          \"--fund=false\",\n          \"--package-lock=false\",\n          \"--no-save\",\n          \"--omit=peer\",\n          ...dependencySpecs,\n        ],\n        packageRoot,\n      );\n    }\n\n    if (shouldLinkHostedPmCli) {\n      await linkHostedPmCliDependency(packageRoot);\n    }\n  } finally {\n    await fs.writeFile(\n      packageJsonPath,\n      `${JSON.stringify(runtimeOnlyManifest, null, 2)}\\n`,\n      \"utf8\",\n    );\n  }\n}\n\nfunction hasHostedPmCliDependency(manifest: {\n  dependencies?: unknown;\n  optionalDependencies?: unknown;\n  peerDependencies?: unknown;\n}): boolean {\n  for (const dependencyMap of [\n    manifest.dependencies,\n    manifest.optionalDependencies,\n    manifest.peerDependencies,\n  ]) {\n    if (\n      typeof dependencyMap === \"object\" &&\n      dependencyMap !== null &&\n      PM_CLI_PACKAGE_NAME in dependencyMap\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction removeHostedPmCliDependency(manifest: Record<string, unknown>): void {\n  for (const field of [\n    \"dependencies\",\n    \"optionalDependencies\",\n    \"peerDependencies\",\n  ] as const) {\n    const dependencyMap = manifest[field];\n    if (typeof dependencyMap !== \"object\" || dependencyMap === null) {\n      continue;\n    }\n    const nextMap = { ...(dependencyMap as Record<string, unknown>) };\n    delete nextMap[PM_CLI_PACKAGE_NAME];\n    if (Object.keys(nextMap).length === 0) {\n      delete manifest[field];\n    } else {\n      manifest[field] = nextMap;\n    }\n  }\n}\n\nasync function linkHostedPmCliDependency(packageRoot: string): Promise<void> {\n  const hostPackageRoot = resolvePmPackageRootFromModule(import.meta.url, [\n    \"../../..\",\n  ]);\n  const [scope, packageName] = PM_CLI_PACKAGE_NAME.split(\"/\");\n  const scopedDirectory = path.join(packageRoot, \"node_modules\", scope);\n  const linkPath = path.join(scopedDirectory, packageName);\n  await fs.mkdir(scopedDirectory, { recursive: true });\n  await fs.rm(linkPath, { recursive: true, force: true });\n  await fs.symlink(\n    hostPackageRoot,\n    linkPath,\n    resolveDirectorySymlinkType(process.platform),\n  );\n}\n\nfunction resolveDirectorySymlinkType(\n  platform: NodeJS.Platform,\n): \"dir\" | \"junction\" {\n  return platform === \"win32\" ? \"junction\" : \"dir\";\n}\n\nfunction runtimeDependencyInstallSpecs(manifest: {\n  dependencies?: unknown;\n  optionalDependencies?: unknown;\n  peerDependencies?: unknown;\n}): string[] {\n  const specs = new Map<string, string>();\n  for (const dependencyMap of [\n    manifest.dependencies,\n    manifest.optionalDependencies,\n    manifest.peerDependencies,\n  ]) {\n    if (typeof dependencyMap !== \"object\" || dependencyMap === null) {\n      continue;\n    }\n    for (const [name, version] of Object.entries(dependencyMap)) {\n      if (\n        name === PM_CLI_PACKAGE_NAME ||\n        typeof version !== \"string\" ||\n        version.trim().length === 0 ||\n        specs.has(name)\n      ) {\n        continue;\n      }\n      specs.set(name, `${name}@${version.trim()}`);\n    }\n  }\n  return [...specs.values()];\n}\n\nasync function resolvePackageExtensionDirectory(\n  packageRoot: string,\n  sourceLabel: string,\n): Promise<string> {\n  const discovered = await collectPackageExtensionDirectories(packageRoot);\n  if (discovered.length === 1) {\n    return discovered[0];\n  }\n  if (discovered.length > 1) {\n    const choices = discovered\n      .map((entry) =>\n        path.relative(packageRoot, entry).replaceAll(path.sep, \"/\"),\n      )\n      .sort((left, right) => left.localeCompare(right));\n    throw new PmCliError(\n      `Package source \"${sourceLabel}\" contains multiple extension manifests. Provide an explicit extension path. Candidates: ${choices.join(\", \")}`,\n      EXIT_CODE.USAGE,\n    );\n  }\n  throw new PmCliError(\n    `Unable to locate a pm extension manifest in package source \"${sourceLabel}\". Package installs currently activate only extension resources, so add package.json pm.extensions or an extensions/ directory. Metadata-only resources like pm.docs/pm.examples are catalog metadata and do not activate commands.`,\n    EXIT_CODE.USAGE,\n  );\n}\n\nasync function resolveGithubSourceDirectory(\n  cloneDirectory: string,\n  source: GithubInstallSource,\n): Promise<{ directory: string; resolved_subpath?: string }> {\n  const candidatePaths: string[] = [];\n  /* c8 ignore start -- subpath candidate expansion permutations are covered by source-resolution integration suites */\n  if (source.subpath) {\n    candidatePaths.push(source.subpath);\n    candidatePaths.push(\n      path.posix.join(\".agents/pm/extensions\", source.subpath),\n    );\n    candidatePaths.push(\n      path.posix.join(\".custom/pm-extensions\", source.subpath),\n    );\n    candidatePaths.push(\n      path.posix.join(\".custom/pm-extension\", source.subpath),\n    );\n  }\n  /* c8 ignore stop */\n\n  for (const candidate of candidatePaths) {\n    const absolute = path.resolve(cloneDirectory, candidate);\n    if (!isPathWithinDirectory(cloneDirectory, absolute)) {\n      // source.subpath is user-controlled; never resolve a manifest outside the\n      // cloned repository (path-traversal guard).\n      continue;\n    }\n    if (await pathExists(path.join(absolute, \"manifest.json\"))) {\n      return { directory: absolute, resolved_subpath: candidate };\n    }\n  }\n\n  if (await pathExists(path.join(cloneDirectory, \"manifest.json\"))) {\n    return { directory: cloneDirectory, resolved_subpath: \".\" };\n  }\n\n  const discoveredDirectory = await resolvePackageExtensionDirectory(\n    cloneDirectory,\n    source.input,\n  );\n  return {\n    directory: discoveredDirectory,\n    resolved_subpath: path\n      .relative(cloneDirectory, discoveredDirectory)\n      .replaceAll(path.sep, \"/\"),\n  };\n}\n\n/** Bare package-ish names (no path separators, or a single-scope npm name) that miss local resolution are almost always intended as npm or bundled installs, so the not-found error must route agents to those sources instead of dead-ending. */\nfunction looksLikeBarePackageName(input: string): boolean {\n  const trimmed = input.trim();\n  if (\n    trimmed.length === 0 ||\n    trimmed.startsWith(\".\") ||\n    trimmed.startsWith(\"~\")\n  ) {\n    return false;\n  }\n  if (trimmed.startsWith(\"@\")) {\n    return trimmed.split(\"/\").length === 2;\n  }\n  return !trimmed.includes(\"/\") && !trimmed.includes(\"\\\\\");\n}\n\nasync function buildLocalSourceNotFoundError(\n  source: LocalInstallSource,\n): Promise<PmCliError> {\n  const baseMessage = `Local extension source does not exist: \"${source.absolute_path}\".`;\n  const input = source.input.trim();\n  if (!looksLikeBarePackageName(input)) {\n    return new PmCliError(baseMessage, EXIT_CODE.NOT_FOUND);\n  }\n  let bundledAliases: string[] = [];\n  try {\n    const envPackageRoot = process.env.PM_CLI_PACKAGE_ROOT;\n    const cacheKey =\n      typeof envPackageRoot === \"string\" && envPackageRoot.trim().length > 0\n        ? path.resolve(envPackageRoot.trim())\n        : \"\";\n    if (bundledPackageAliasesCache?.key !== cacheKey) {\n      bundledPackageAliasesCache = {\n        key: cacheKey,\n        aliases: await listBundledPackageAliases(),\n      };\n    }\n    bundledAliases = bundledPackageAliasesCache.aliases;\n  } catch {\n    // Alias discovery is best-effort; the npm: hint alone still unblocks agents.\n  }\n  const nextSteps = [\n    `Retry with pm install npm:${input} if the package is published to npm.`,\n    `Or inspect bundled packages with pm package catalog --project --json before installing by alias. Known aliases (blank means none found): ${bundledAliases.join(\", \")}`,\n  ];\n  return new PmCliError(\n    `${baseMessage} \"${input}\" did not match a local directory, bundled package alias, or bundled package name; if you meant an npm package, install it as \"npm:${input}\".`,\n    EXIT_CODE.NOT_FOUND,\n    {\n      code: \"local_source_not_found_bare_name\",\n      required: `Use \"npm:${input}\" for npm registry packages, a bundled catalog alias, or an existing local directory path.`,\n      why: \"Bare names resolve as local paths only after bundled aliases, so unmatched names need an explicit npm: source.\",\n      examples: [\n        `pm install npm:${input}`,\n        \"pm package catalog --project --json\",\n      ],\n      nextSteps,\n      recovery: {\n        attempted_command: `pm install ${input}`,\n        normalized_args: [\"install\", input],\n        next_best_command: `pm install npm:${input}`,\n      },\n    },\n  );\n}\n\n/** Implements resolve install source for the public runtime surface of this module. */\nexport async function resolveInstallSource(\n  source: InstallSource,\n): Promise<ResolvedInstallSource> {\n  if (source.kind === \"local\") {\n    let localStats;\n    try {\n      localStats = await fs.stat(source.absolute_path);\n    } catch {\n      throw await buildLocalSourceNotFoundError(source);\n    }\n    if (!localStats.isDirectory()) {\n      throw new PmCliError(\n        `Local extension source must be a directory: \"${source.absolute_path}\".`,\n        EXIT_CODE.USAGE,\n      );\n    }\n    const directory = await resolvePackageExtensionDirectory(\n      source.absolute_path,\n      source.input,\n    );\n    return {\n      source,\n      directory,\n    };\n  }\n\n  if (source.kind === \"npm\") {\n    const resolved = await resolveNpmSourceDirectory(source);\n    return {\n      source,\n      directory: resolved.directory,\n      cleanup: resolved.cleanup,\n      resolved_subpath: path\n        .relative(path.dirname(resolved.directory), resolved.directory)\n        .replaceAll(path.sep, \"/\"),\n      npm_package: resolved.package,\n      npm_version: resolved.version,\n    };\n  }\n\n  const cloneDirectory = await fs.mkdtemp(\n    path.join(os.tmpdir(), \"pm-extension-source-\"),\n  );\n  const cloneArgs = [\"clone\", \"--depth\", \"1\"];\n  if (source.ref) {\n    cloneArgs.push(\"--branch\", source.ref);\n  }\n  cloneArgs.push(source.repository, cloneDirectory);\n\n  try {\n    await runGitCommand(cloneArgs);\n    const commit = await runGitCommand([\n      \"-C\",\n      cloneDirectory,\n      \"rev-parse\",\n      \"HEAD\",\n    ]);\n    const resolved = await resolveGithubSourceDirectory(cloneDirectory, source);\n    return {\n      source,\n      directory: resolved.directory,\n      resolved_subpath: resolved.resolved_subpath,\n      commit,\n      cleanup: async () => {\n        await fs.rm(cloneDirectory, { recursive: true, force: true });\n      },\n    };\n  } catch (error: unknown) {\n    await fs.rm(cloneDirectory, { recursive: true, force: true });\n    throw error;\n  }\n}\n\n/** Implements are directories equivalent for the public runtime surface of this module. */\nexport async function areDirectoriesEquivalent(\n  left: string,\n  right: string,\n): Promise<boolean> {\n  if (!(await pathExists(left)) || !(await pathExists(right))) {\n    return false;\n  }\n  const [leftRealPath, rightRealPath] = await Promise.all([\n    fs.realpath(left),\n    fs.realpath(right),\n  ]);\n  return leftRealPath === rightRealPath;\n}\n\n/** Public contract for test only install sources, shared by SDK and presentation-layer consumers. */\nexport const _testOnlyInstallSources = {\n  installNpmPackageRuntimeDependencies,\n  npmPackageNameFromSpec,\n  parsePackedNpmPackage,\n  resolveNpmSourceDirectoryWithRunner,\n  resolveNpmSourceDirectory,\n  resolveNpmPackSpec,\n  resolvePackageExtensionDirectory,\n  runtimeDependencyInstallSpecs,\n  hasHostedPmCliDependency,\n  removeHostedPmCliDependency,\n  linkHostedPmCliDependency,\n  resolveDirectorySymlinkType,\n  runNpmCommand,\n};\n"],"names":[],"mappings":"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","debugId":"38193531-eca3-557b-ab40-d4af159b9192"}

package/dist/{cli/commands → sdk}/extension/managed-state.js

@@ -1,15 +1,15 @@
 /**
- * @module cli/commands/extension/managed-state
+ * @module sdk/extension/managed-state
  *
  * Implements extension package-management support for Managed State.
  */
 
-!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]="a0286c96-941d-587e-b4a6-19f4248823ab")}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]="34e6fdd1-e124-5995-81aa-0de1092d36f8")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
-import { EXIT_CODE } from "../../../core/shared/constants.js";
-import { PmCliError } from "../../../core/shared/errors.js";
-import { nowIso } from "../../../core/shared/time.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
 import { normalizeExtensionNameForMatch, normalizeStringList, } from "./shared.js";
 const MANAGED_EXTENSION_STATE_FILENAME = ".managed-extensions.json";
 const MANAGED_EXTENSION_STATE_VERSION = 1;
@@ -233,4 +233,4 @@ export function upsertManagedEntry(state, entry) {
     };
 }
 //# sourceMappingURL=managed-state.js.map
-//# debugId=a0286c96-941d-587e-b4a6-19f4248823ab
+//# debugId=34e6fdd1-e124-5995-81aa-0de1092d36f8

package/dist/sdk/extension/managed-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-state.js","sources":["sdk/extension/managed-state.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module sdk/extension/managed-state\n *\n * Implements extension package-management support for Managed State.\n */\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { nowIso } from \"../../core/shared/time.js\";\nimport {\n  normalizeExtensionNameForMatch,\n  normalizeStringList,\n} from \"./shared.js\";\nimport type { ExtensionScope } from \"../extension.js\";\n\nconst MANAGED_EXTENSION_STATE_FILENAME = \".managed-extensions.json\";\nconst MANAGED_EXTENSION_STATE_VERSION = 1;\n\n/** Documents the managed extension source payload exchanged by command, SDK, and package integrations. */\nexport interface ManagedExtensionSource {\n  /** Value that configures or reports kind for this contract. */\n  kind: \"local\" | \"github\" | \"npm\" | \"builtin\";\n  /** Value that configures or reports input for this contract. */\n  input: string;\n  /** Value that configures or reports location for this contract. */\n  location: string;\n  /** Value that configures or reports name for this contract. */\n  name?: string;\n  /** Value that configures or reports package for this contract. */\n  package?: string;\n  /** Value that configures or reports version for this contract. */\n  version?: string;\n  /** Value that configures or reports repository for this contract. */\n  repository?: string;\n  /** Value that configures or reports owner for this contract. */\n  owner?: string;\n  /** Value that configures or reports repo for this contract. */\n  repo?: string;\n  /** Value that configures or reports ref for this contract. */\n  ref?: string;\n  /** Value that configures or reports subpath for this contract. */\n  subpath?: string;\n  /** Value that configures or reports commit for this contract. */\n  commit?: string;\n}\n\n/** Documents the managed extension record payload exchanged by command, SDK, and package integrations. */\nexport interface ManagedExtensionRecord {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports directory for this contract. */\n  directory: string;\n  /** Value that configures or reports scope for this contract. */\n  scope: ExtensionScope;\n  /** Value that configures or reports manifest version for this contract. */\n  manifest_version: string;\n  /** Value that configures or reports manifest entry for this contract. */\n  manifest_entry: string;\n  /** Value that configures or reports capabilities for this contract. */\n  capabilities: string[];\n  /** ISO 8601 timestamp recording when installed occurred. */\n  installed_at: string;\n  /** ISO 8601 timestamp recording when updated occurred. */\n  updated_at: string;\n  /** Value that configures or reports source for this contract. */\n  source: ManagedExtensionSource;\n  /** ISO 8601 timestamp recording when last update check occurred. */\n  last_update_check_at?: string;\n  /** Value that configures or reports last update remote commit for this contract. */\n  last_update_remote_commit?: string;\n  /** Value that configures or reports update available for this contract. */\n  update_available?: boolean | null;\n  /** Value that configures or reports update error for this contract. */\n  update_error?: string;\n}\n\n/** Documents the managed extension state payload exchanged by command, SDK, and package integrations. */\nexport interface ManagedExtensionState {\n  /** Value that configures or reports version for this contract. */\n  version: number;\n  /** ISO 8601 timestamp recording when updated occurred. */\n  updated_at: string;\n  /** Value that configures or reports entries for this contract. */\n  entries: ManagedExtensionRecord[];\n}\n\n/** Documents the managed extension state read result payload exchanged by command, SDK, and package integrations. */\nexport interface ManagedExtensionStateReadResult {\n  /** Filesystem path used for path resolution. */\n  path: string;\n  /** Value that configures or reports state for this contract. */\n  state: ManagedExtensionState;\n  /** Value that configures or reports warnings for this contract. */\n  warnings: string[];\n}\n\n/** Implements resolve managed extension state path for the public runtime surface of this module. */\nexport function resolveManagedExtensionStatePath(\n  extensionsRoot: string,\n): string {\n  return path.join(extensionsRoot, MANAGED_EXTENSION_STATE_FILENAME);\n}\n\n/** Implements create empty managed extension state for the public runtime surface of this module. */\nexport function createEmptyManagedExtensionState(): ManagedExtensionState {\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: [],\n  };\n}\n\n/** Implements sort managed entries for the public runtime surface of this module. */\nexport function sortManagedEntries(\n  entries: ManagedExtensionRecord[],\n): ManagedExtensionRecord[] {\n  return [...entries].sort((left, right) => {\n    const byScope = left.scope.localeCompare(right.scope);\n    if (byScope !== 0) {\n      return byScope;\n    }\n    const byName = left.name.localeCompare(right.name);\n    if (byName !== 0) {\n      return byName;\n    }\n    return left.directory.localeCompare(right.directory);\n  });\n}\n\n/** Implements managed extension sources equivalent for the public runtime surface of this module. */\nexport function managedExtensionSourcesEquivalent(\n  left: ManagedExtensionSource,\n  right: ManagedExtensionSource,\n): boolean {\n  if (\n    left.kind !== right.kind ||\n    left.input !== right.input ||\n    left.location !== right.location\n  ) {\n    return false;\n  }\n  if (left.kind === \"npm\" && right.kind === \"npm\") {\n    return left.package === right.package && left.version === right.version;\n  }\n  if (left.kind === \"github\" && right.kind === \"github\") {\n    return (\n      left.repository === right.repository &&\n      left.ref === right.ref &&\n      left.subpath === right.subpath &&\n      left.commit === right.commit\n    );\n  }\n  if (left.kind === \"builtin\" && right.kind === \"builtin\") {\n    return left.name === right.name;\n  }\n  return true;\n}\n\n/** Narrow `value` to a string, or `undefined` for any other type — the normalization applied to every optional managed-state string field so an absent or malformed value is dropped rather than carried through as `unknown`. */\nfunction optionalString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\n/**\n * Type guard asserting `entry` carries every always-present managed-record field\n * with the right primitive type: a non-empty `name`/`directory`, a known\n * {@link ExtensionScope}, string manifest metadata, a `string[]` capability\n * list, and string `installed_at`/`updated_at` timestamps. The optional columns\n * (`source` plus the update-check fields) are validated separately by the\n * caller, so this guard narrows only the required columns.\n */\nfunction hasRequiredManagedRecordFields(\n  entry: Record<string, unknown>,\n): entry is Record<string, unknown> &\n  Pick<\n    ManagedExtensionRecord,\n    | \"name\"\n    | \"directory\"\n    | \"scope\"\n    | \"manifest_version\"\n    | \"manifest_entry\"\n    | \"capabilities\"\n    | \"installed_at\"\n    | \"updated_at\"\n  > {\n  return (\n    typeof entry.name === \"string\" &&\n    entry.name.trim().length > 0 &&\n    typeof entry.directory === \"string\" &&\n    entry.directory.trim().length > 0 &&\n    (entry.scope === \"project\" || entry.scope === \"global\") &&\n    typeof entry.manifest_version === \"string\" &&\n    typeof entry.manifest_entry === \"string\" &&\n    Array.isArray(entry.capabilities) &&\n    entry.capabilities.every(\n      (value): value is string => typeof value === \"string\",\n    ) &&\n    typeof entry.installed_at === \"string\" &&\n    typeof entry.updated_at === \"string\"\n  );\n}\n\n/** Normalize one persisted managed-extension source object, returning `null` when the discriminant (`kind`) or the required `input`/`location` strings are missing or malformed so the caller can skip the owning record. */\nfunction normalizeManagedSource(raw: unknown): ManagedExtensionSource | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const source = raw as Record<string, unknown>;\n  if (\n    (source.kind !== \"local\" &&\n      source.kind !== \"github\" &&\n      source.kind !== \"npm\" &&\n      source.kind !== \"builtin\") ||\n    typeof source.input !== \"string\" ||\n    typeof source.location !== \"string\"\n  ) {\n    return null;\n  }\n  return {\n    kind: source.kind,\n    input: source.input,\n    location: source.location,\n    name: optionalString(source.name),\n    package: optionalString(source.package),\n    version: optionalString(source.version),\n    repository: optionalString(source.repository),\n    owner: optionalString(source.owner),\n    repo: optionalString(source.repo),\n    ref: optionalString(source.ref),\n    subpath: optionalString(source.subpath),\n    commit: optionalString(source.commit),\n  };\n}\n\n/**\n * Normalize one persisted managed-extension record, returning `null` when any\n * required field or its `source` is missing or malformed so {@link\n * normalizeManagedState} can drop the entry without discarding the rest of the\n * file.\n */\nfunction normalizeManagedRecord(raw: unknown): ManagedExtensionRecord | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const entry = raw as Record<string, unknown>;\n  if (!hasRequiredManagedRecordFields(entry)) {\n    return null;\n  }\n  const source = normalizeManagedSource(entry.source);\n  if (!source) {\n    return null;\n  }\n  return {\n    name: entry.name.trim(),\n    directory: entry.directory.trim(),\n    scope: entry.scope,\n    manifest_version: entry.manifest_version,\n    manifest_entry: entry.manifest_entry,\n    capabilities: normalizeStringList(entry.capabilities),\n    installed_at: entry.installed_at,\n    updated_at: entry.updated_at,\n    source,\n    last_update_check_at: optionalString(entry.last_update_check_at),\n    last_update_remote_commit: optionalString(entry.last_update_remote_commit),\n    update_available:\n      typeof entry.update_available === \"boolean\" ||\n      entry.update_available === null\n        ? entry.update_available\n        : undefined,\n    update_error: optionalString(entry.update_error),\n  };\n}\n\n/** Implements normalize managed state for the public runtime surface of this module. */\nexport function normalizeManagedState(\n  raw: unknown,\n): ManagedExtensionState | null {\n  if (typeof raw !== \"object\" || raw === null) {\n    return null;\n  }\n  const candidate = raw as Record<string, unknown>;\n  if (\n    candidate.version !== MANAGED_EXTENSION_STATE_VERSION ||\n    !Array.isArray(candidate.entries)\n  ) {\n    return null;\n  }\n\n  const entries: ManagedExtensionRecord[] = [];\n  for (const rawEntry of candidate.entries) {\n    const record = normalizeManagedRecord(rawEntry);\n    if (record) {\n      entries.push(record);\n    }\n  }\n  return {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: optionalString(candidate.updated_at) ?? nowIso(),\n    entries: sortManagedEntries(entries),\n  };\n}\n\n/** Implements read managed extension state for the public runtime surface of this module. */\nexport async function readManagedExtensionState(\n  extensionsRoot: string,\n): Promise<ManagedExtensionStateReadResult> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const fallback = createEmptyManagedExtensionState();\n  try {\n    const raw = await fs.readFile(statePath, \"utf8\");\n    const parsed = JSON.parse(raw) as unknown;\n    const normalized = normalizeManagedState(parsed);\n    if (!normalized) {\n      throw new PmCliError(\n        `Managed extension state file \"${statePath}\" has an invalid schema. Repair or remove it before mutating extension state.`,\n        EXIT_CODE.GENERIC_FAILURE,\n      );\n    }\n    return {\n      path: statePath,\n      state: normalized,\n      warnings: [],\n    };\n  } catch (error: unknown) {\n    if (error instanceof PmCliError) {\n      throw error;\n    }\n    if (\n      typeof error === \"object\" &&\n      error !== null &&\n      \"code\" in error &&\n      (error as { code?: string }).code === \"ENOENT\"\n    ) {\n      return {\n        path: statePath,\n        state: fallback,\n        warnings: [],\n      };\n    }\n    throw new PmCliError(\n      `Managed extension state file \"${statePath}\" could not be read. Repair or remove it before mutating extension state.`,\n      EXIT_CODE.GENERIC_FAILURE,\n    );\n  }\n}\n\n/** Implements write managed extension state for the public runtime surface of this module. */\nexport async function writeManagedExtensionState(\n  extensionsRoot: string,\n  state: ManagedExtensionState,\n): Promise<void> {\n  const statePath = resolveManagedExtensionStatePath(extensionsRoot);\n  const normalized: ManagedExtensionState = {\n    version: MANAGED_EXTENSION_STATE_VERSION,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(state.entries),\n  };\n  await fs.mkdir(extensionsRoot, { recursive: true });\n  await fs.writeFile(\n    statePath,\n    `${JSON.stringify(normalized, null, 2)}\\n`,\n    \"utf8\",\n  );\n}\n\n/** Implements upsert managed entry for the public runtime surface of this module. */\nexport function upsertManagedEntry(\n  state: ManagedExtensionState,\n  entry: ManagedExtensionRecord,\n): ManagedExtensionState {\n  const updatedEntries = state.entries.filter(\n    (candidate) =>\n      normalizeExtensionNameForMatch(candidate.name) !==\n        normalizeExtensionNameForMatch(entry.name) &&\n      normalizeExtensionNameForMatch(candidate.directory) !==\n        normalizeExtensionNameForMatch(entry.directory),\n  );\n  updatedEntries.push(entry);\n  return {\n    ...state,\n    updated_at: nowIso(),\n    entries: sortManagedEntries(updatedEntries),\n  };\n}\n"],"names":[],"mappings":"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","debugId":"34e6fdd1-e124-5995-81aa-0de1092d36f8"}

package/dist/sdk/extension/scaffold.d.ts

@@ -0,0 +1,36 @@
+/** Public contract for scaffold pm min version, shared by SDK and presentation-layer consumers. */
+export declare const SCAFFOLD_PM_MIN_VERSION = "2026.6.24";
+/** Capability shapes the package/extension scaffolder can target via the `--capability` selector — one per SDK extension capability, so every registration surface has a runnable starter. `commands` emits the default command-only starter; `hooks` additionally wires an `after_command` lifecycle reactor; `search` wires an in-memory provider/adapter pair; `importers` wires importer and exporter command primitives so authors can customize project context movement; `schema` registers a custom item type, item field, and migration so authors can model their own project domain; `profile` registers a complete project-profile archetype (item types, statuses, fields, a workflow, config, a template, and package recommendations) via `api.registerProfile` so `pm profile apply` can tailor a tracker in one shot; `renderers` overrides how a command's output is serialized for a format; `parser` rewrites a command's parsed options before its handler runs; `preflight` adjusts pm's pre-run migration/format gate decision; and `services` overrides a built-in pm service (e.g. output formatting) — without starting from a blank extension. */
+export declare const SCAFFOLD_CAPABILITIES: readonly ["commands", "hooks", "search", "importers", "schema", "profile", "renderers", "parser", "preflight", "services"];
+/**
+ * Restricts the `--capability` selector to a {@link SCAFFOLD_CAPABILITIES} value.
+ */
+export type ExtensionScaffoldCapability = (typeof SCAFFOLD_CAPABILITIES)[number];
+interface ExtensionScaffoldFileResult {
+    path: string;
+    status: "created" | "unchanged";
+}
+interface ExtensionScaffoldResult {
+    extension_name: string;
+    command_name: string;
+    capability: ExtensionScaffoldCapability;
+    /** Authoring style of the generated entrypoint: `"imperative"` (a hand-written `activate` body, the default) or `"declarative"` (a `composeExtension` blueprint). The declarative style is package-mode only (any capability). */
+    style: ExtensionScaffoldStyle;
+    target_path: string;
+    created_directory: boolean;
+    files: ExtensionScaffoldFileResult[];
+}
+/**
+ * Authoring style the scaffolder targets for the generated entrypoint. The
+ * default `"imperative"` emits a hand-written `activate` body; `"declarative"`
+ * emits the SDK's `composeExtension` blueprint loop (package-mode only, for any
+ * capability — see {@link buildDeclarativeEntrypoint}).
+ */
+export type ExtensionScaffoldStyle = "imperative" | "declarative";
+/** Builds the starter command path from the normalized package/extension name. Names that start with a built-in pm command or executable alias are prefixed with `starter` so the generated command dispatches to the package instead of being consumed by core command parsing. */
+export declare function buildScaffoldCommandName(extensionName: string): string;
+/** Implements build starter extension scaffold files for the public runtime surface of this module. */
+export declare function buildStarterExtensionScaffoldFiles(extensionName: string, commandName: string, vocabulary: "extension" | "package", capability?: ExtensionScaffoldCapability, declarative?: boolean): Record<string, string>;
+/** Implements scaffold extension project for the public runtime surface of this module. */
+export declare function scaffoldExtensionProject(target: string, vocabulary?: "extension" | "package", capability?: string, declarative?: boolean): Promise<ExtensionScaffoldResult>;
+export {};