@unbrained/pm-cli 2026.5.30 → 2026.6.5

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

@@ -1,11 +1,17 @@
 
-!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){}}();
+!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]="a36c8ce6-d9bd-5c8b-bb3c-5615aa081b71")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathExists } from "../../../core/fs/fs-utils.js";
 import { EXIT_CODE } from "../../../core/shared/constants.js";
 import { PmCliError } from "../../../core/shared/errors.js";
 import { normalizeManagedDirectoryName } from "./shared.js";
+// Safe compatibility floor emitted into scaffolded manifests. Mirrors the
+// first-party package manifests (pm-nf2q): every current 2026.5.x CLI
+// satisfies it, and it models the field for external authors. manifest_version
+// tracks the manifest schema generation (currently 1).
+const SCAFFOLD_MANIFEST_VERSION = 1;
+const SCAFFOLD_PM_MIN_VERSION = "2026.5.0";
 export function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabulary) {
     const packageName = `pm-${extensionName}`;
     const manifest = `${JSON.stringify({
@@ -13,6 +19,8 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
         version: "0.1.0",
         entry: "./index.js",
         capabilities: ["commands"],
+        manifest_version: SCAFFOLD_MANIFEST_VERSION,
+        pm_min_version: SCAFFOLD_PM_MIN_VERSION,
     }, null, 2)}\n`;
     // pm-fl0c B-1 (2026-05-28): emit the documented `defineExtension({...})`
     // shape so the generated module gets full TypeScript narrowing on the
@@ -26,46 +34,26 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
     // 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");
+    const entrypoint = [
+        '/** @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,
@@ -78,7 +66,7 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
             },
             pm: {
                 aliases: [extensionName],
-                extensions: [`extensions/${extensionName}`],
+                extensions: ["."],
                 docs: ["README.md"],
                 examples: ["README.md"],
                 catalog: {
@@ -96,8 +84,8 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
             "",
             "## Included Files",
             "- `package.json`: package metadata and `pm` resource manifest.",
-            `- \`extensions/${extensionName}/manifest.json\`: extension metadata and capabilities.`,
-            `- \`extensions/${extensionName}/index.js\`: starter command registration using the \`commands\` capability.`,
+            "- `manifest.json`: extension metadata and capabilities.",
+            "- `index.js`: starter command registration using the `commands` capability.",
             "",
             "## Quick Start",
             "```bash",
@@ -106,16 +94,23 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
             "pm package doctor --project --detail summary",
             "```",
             "",
+            "## Compatibility Bounds",
+            "`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",
+            `- \`manifest_version\` (integer): manifest schema generation. Leave at \`${SCAFFOLD_MANIFEST_VERSION}\` unless you adopt a newer manifest schema.`,
+            `- \`pm_min_version\` (string): lowest pm CLI version that may load this package. Scaffolded as \`${SCAFFOLD_PM_MIN_VERSION}\`. The loader blocks the package on older CLIs.`,
+            "- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.",
+            "",
             "## Notes",
-            "- Keep package metadata in `package.json` and runtime behavior under `extensions/`.",
+            "- Keep simple starter runtime behavior at the package root so local installs work without dependency bootstrapping.",
+            "- Move larger runtimes into subdirectories only after adding package dependencies and validating `pm package doctor`.",
             "- Add capabilities to the extension manifest only when the entrypoint uses the matching SDK API.",
             "- Use `@unbrained/pm-cli/sdk` as the public SDK import for richer package runtimes.",
             "",
         ].join("\n");
         return {
             "package.json": packageJson,
-            [`extensions/${extensionName}/manifest.json`]: manifest,
-            [`extensions/${extensionName}/index.js`]: entrypoint,
+            "manifest.json": manifest,
+            "index.js": entrypoint,
             "README.md": packageReadme,
         };
     }
@@ -135,6 +130,12 @@ export function buildStarterExtensionScaffoldFiles(extensionName, commandName, v
         "pm extension --doctor --project --detail summary",
         "```",
         "",
+        "## Compatibility Bounds",
+        "`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:",
+        `- \`manifest_version\` (integer): manifest schema generation. Leave at \`${SCAFFOLD_MANIFEST_VERSION}\` unless you adopt a newer manifest schema.`,
+        `- \`pm_min_version\` (string): lowest pm CLI version that may load this extension. Scaffolded as \`${SCAFFOLD_PM_MIN_VERSION}\`. The loader blocks the extension on older CLIs.`,
+        "- `pm_max_version` (string, optional): highest pm CLI version that may load this extension. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the extension when the CLI exceeds this bound.",
+        "",
         "## Notes",
         "- This scaffold uses ESM exports so it works in package scopes with `type: module`.",
         "- Update `manifest.json` capabilities and `index.js` command behavior as your extension evolves.",
@@ -199,4 +200,4 @@ export async function scaffoldExtensionProject(target, vocabulary = "extension")
     };
 }
 //# sourceMappingURL=scaffold.js.map
-//# debugId=6ba6d57e-c873-51ad-b55d-3f35c6f9ef55
+//# debugId=a36c8ce6-d9bd-5c8b-bb3c-5615aa081b71

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  // 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"}
+{"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\n// Safe compatibility floor emitted into scaffolded manifests. Mirrors the\n// first-party package manifests (pm-nf2q): every current 2026.5.x CLI\n// satisfies it, and it models the field for external authors. manifest_version\n// tracks the manifest schema generation (currently 1).\nconst SCAFFOLD_MANIFEST_VERSION = 1;\nconst SCAFFOLD_PM_MIN_VERSION = \"2026.5.0\";\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      manifest_version: SCAFFOLD_MANIFEST_VERSION,\n      pm_min_version: SCAFFOLD_PM_MIN_VERSION,\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    '/** @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: [\".\"],\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      \"- `manifest.json`: extension metadata and capabilities.\",\n      \"- `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      \"## Compatibility Bounds\",\n      \"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:\",\n      `- \\`manifest_version\\` (integer): manifest schema generation. Leave at \\`${SCAFFOLD_MANIFEST_VERSION}\\` unless you adopt a newer manifest schema.`,\n      `- \\`pm_min_version\\` (string): lowest pm CLI version that may load this package. Scaffolded as \\`${SCAFFOLD_PM_MIN_VERSION}\\`. The loader blocks the package on older CLIs.`,\n      \"- `pm_max_version` (string, optional): highest pm CLI version that may load this package. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the package when the CLI exceeds this bound.\",\n      \"\",\n      \"## Notes\",\n      \"- Keep simple starter runtime behavior at the package root so local installs work without dependency bootstrapping.\",\n      \"- Move larger runtimes into subdirectories only after adding package dependencies and validating `pm package doctor`.\",\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      \"manifest.json\": manifest,\n      \"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    \"## Compatibility Bounds\",\n    \"`manifest.json` cannot hold comments, so the version-compatibility fields are documented here:\",\n    `- \\`manifest_version\\` (integer): manifest schema generation. Leave at \\`${SCAFFOLD_MANIFEST_VERSION}\\` unless you adopt a newer manifest schema.`,\n    `- \\`pm_min_version\\` (string): lowest pm CLI version that may load this extension. Scaffolded as \\`${SCAFFOLD_PM_MIN_VERSION}\\`. The loader blocks the extension on older CLIs.`,\n    \"- `pm_max_version` (string, optional): highest pm CLI version that may load this extension. Add it to block CLIs that are newer than the version you have validated against. The loader blocks the extension when the CLI exceeds this bound.\",\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":"a36c8ce6-d9bd-5c8b-bb3c-5615aa081b71"}

package/dist/cli/commands/extension.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]="dc0411c0-3d3c-5495-9be5-d221c8a9498d")}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]="120f378d-34a8-5b2f-ab24-f056fb646d43")}catch(e){}}();
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";
@@ -24,7 +24,7 @@ import { sortManagedEntries, managedExtensionSourcesEquivalent, readManagedExten
 import { parseExtensionInstallSource, resolveInstallSource, areDirectoriesEquivalent, runGitCommand, } from "./extension/install-sources.js";
 import { resolveBundledExtensionAliasSource, isBundledPackageInstallAllTarget, listBundledPackageAliases, resolveBundledAliasManifestName, buildBundledPackageCatalog, } from "./extension/bundled-catalog.js";
 import { scaffoldExtensionProject } from "./extension/scaffold.js";
-import { applyDoctorRuntimeActivationState, classifyDoctorLoadFailureWarnings, buildExtensionTriageSummary, parseDoctorDetailMode, collectUnknownCapabilityGuidance, buildCapabilityContractMetadata, buildDoctorConsistencySummary, } from "./extension/doctor.js";
+import { applyDoctorRuntimeActivationState, classifyDoctorLoadFailureWarnings, classifyDoctorActivationFailureWarnings, buildExtensionTriageSummary, parseDoctorDetailMode, collectUnknownCapabilityGuidance, buildCapabilityContractMetadata, buildDoctorConsistencySummary, } from "./extension/doctor.js";
 // Re-export the public surface that lives in sibling modules but was previously
 // exported from this file (used by sdk barrels, upgrade.ts, and tests).
 export { parseExtensionManifest, validateExtensionDirectory, readManagedExtensionState, writeManagedExtensionState, resolveManagedExtensionStatePath, parseExtensionInstallSource, };
@@ -33,6 +33,7 @@ const EXTENSION_INSTALL_COPY_ATTEMPTS = 3;
 const EXTENSION_INSTALL_LOCK_ATTEMPTS = 120;
 const EXTENSION_INSTALL_LOCK_DELAY_MS = 250;
 const EXTENSION_INSTALL_LOCK_STALE_MS = 120_000;
+const NATIVE_OUTPUT_MARKER = "__pm_native_output";
 function buildExtensionPolicyDetails(policy) {
     const overrides = (policy.extension_overrides ?? [])
         .map((override) => ({
@@ -576,6 +577,19 @@ function requireTarget(target, action) {
     }
     return normalized;
 }
+function collectGlobalOutputOverrideDoctorWarnings(activationResult) {
+    const warnings = [];
+    for (const entry of activationResult.services.overrides) {
+        if (entry.service !== "output_format") {
+            continue;
+        }
+        warnings.push(`extension_output_service_override_global:${entry.service}:${entry.layer}:${entry.name}`);
+    }
+    for (const entry of activationResult.renderers.overrides) {
+        warnings.push(`extension_output_renderer_override_global:${entry.format}:${entry.layer}:${entry.name}`);
+    }
+    return [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
+}
 export async function runExtension(target, options, global) {
     const action = resolveAction(target, options);
     if ((options.strictExit === true || options.failOnWarn === true) && action !== "doctor") {
@@ -616,26 +630,36 @@ export async function runExtension(target, options, global) {
     const scope = resolveScope(options);
     const resolvedRoots = resolveExtensionRootsForScope(scope, global);
     const warnings = [];
-    const withResult = (details) => ({
-        ok: true,
-        action,
-        scope,
-        roots: action === "catalog" && typeof options.fields === "string" && options.fields.trim().length > 0
-            ? {
-                project: "project",
-                global: "global",
-                selected: scope,
-                settings_root: "project",
-            }
-            : {
-                project: resolvedRoots.roots.project,
-                global: resolvedRoots.roots.global,
-                selected: resolvedRoots.selected_root,
-                settings_root: resolvedRoots.settings_root,
-            },
-        warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
-        details,
-    });
+    const withResult = (details) => {
+        const result = {
+            ok: true,
+            action,
+            scope,
+            roots: action === "catalog" && typeof options.fields === "string" && options.fields.trim().length > 0
+                ? {
+                    project: "project",
+                    global: "global",
+                    selected: scope,
+                    settings_root: "project",
+                }
+                : {
+                    project: resolvedRoots.roots.project,
+                    global: resolvedRoots.roots.global,
+                    selected: resolvedRoots.selected_root,
+                    settings_root: resolvedRoots.settings_root,
+                },
+            warnings: [...new Set(warnings)].sort((left, right) => left.localeCompare(right)),
+            details,
+        };
+        if (action === "doctor") {
+            Object.defineProperty(result, NATIVE_OUTPUT_MARKER, {
+                value: true,
+                enumerable: false,
+                configurable: false,
+            });
+        }
+        return result;
+    };
     if (action === "init") {
         const githubOption = resolveGithubOption(options);
         if (githubOption !== undefined || (typeof options.ref === "string" && options.ref.trim().length > 0)) {
@@ -1061,6 +1085,8 @@ export async function runExtension(target, options, global) {
         warnings.push(...loadResult.warnings);
         warnings.push(...classifyDoctorLoadFailureWarnings(loadResult.failed));
         warnings.push(...activationResult.warnings);
+        warnings.push(...classifyDoctorActivationFailureWarnings(activationResult.failed));
+        warnings.push(...collectGlobalOutputOverrideDoctorWarnings(activationResult));
         const runtimeInstalledExtensions = applyDoctorRuntimeActivationState(refreshedInstalled.extensions, loadResult, activationResult);
         const doctorConsistency = buildDoctorConsistencySummary(scope, runtimeInstalledExtensions, loadResult.loaded.map((entry) => ({ layer: entry.layer, name: entry.name })), loadResult.failed.map((entry) => ({ name: entry.name })), loadResult.disabled_by_flag);
         warnings.push(...doctorConsistency.warnings);
@@ -1231,6 +1257,8 @@ export async function runExtension(target, options, global) {
                         error: entry.error,
                         method: entry.trace?.method,
                         command: entry.trace?.command,
+                        capability: entry.trace?.capability,
+                        missing_capability: entry.trace?.missing_capability,
                         registration_index: entry.trace?.registration_index,
                         expected_schema: entry.trace?.expected_schema,
                         hint: entry.trace?.hint,
@@ -1354,4 +1382,4 @@ export async function runExtension(target, options, global) {
     throw new PmCliError(`Unsupported extension action "${action}".`, EXIT_CODE.USAGE);
 }
 //# sourceMappingURL=extension.js.map
-//# debugId=dc0411c0-3d3c-5495-9be5-d221c8a9498d
+//# debugId=120f378d-34a8-5b2f-ab24-f056fb646d43