@unbrained/pm-cli 2026.7.3 → 2026.7.5

package/dist/cli-bundle/chunks/{chunk-NZ7QIUP5.js → chunk-E2FUG6GD.js}

@@ -1,18 +1,17 @@
 import {
   EXECUTABLE_COMMAND_ALIASES,
-  normalizeExtensionNameForMatch,
   normalizeManagedDirectoryName
-} from "./chunk-T6AXEBOP.js";
+} from "./chunk-R3ZBLGTC.js";
 import {
   PM_CORE_COMMAND_NAMES
-} from "./chunk-RAHINBVP.js";
+} from "./chunk-UI5BJ6DO.js";
+import {
+  PmCliError
+} from "./chunk-P5YORJRH.js";
 import {
   EXIT_CODE,
-  PmCliError,
-  collectUsedExtensionCapabilities,
-  normalizeExtensionName,
   pathExists
-} from "./chunk-KHVGM5CS.js";
+} from "./chunk-5VVUKE3U.js";
 
 // dist/cli/commands/extension/scaffold.js
 import fs from "node:fs/promises";
@@ -20,7 +19,7 @@ import path from "node:path";
 !(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] = "9cc4cb5f-313d-5e8c-8c63-545a7a8d2a03");
+    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "41f2ec97-a92c-5a0d-a117-ffea360fad5c");
   } catch (e2) {
   }
 })();
@@ -63,6 +62,39 @@ var SAMPLE_HARNESS_FINALLY_LINES = [
   "    await deactivateIfNeeded(ext, deactivated);",
   "  }"
 ];
+function indentGeneratedLines(lines, prefix) {
+  return lines.map((line) => line === "" ? line : `${prefix}${line}`);
+}
+function buildSchemaCapabilityAssertionLines(options) {
+  const migrationHint = options.includeMigrationReplacementHint === true ? ["  // as your migration grows."] : [];
+  return [
+    "  // assertItemType/Field/Migration throw unless the registration is present, so",
+    "  // reaching each next line already proves the wiring; assert on the returned",
+    "  // definitions to demonstrate inspecting registered metadata.",
+    `  const itemType = ext.assertItemType({ itemType: ${JSON.stringify(options.itemTypeName)}, extensionName: ${JSON.stringify(options.extensionName)} });`,
+    `  assert.equal(itemType.itemType.folder, ${JSON.stringify(options.itemTypeFolder)});`,
+    `  const itemField = ext.assertItemField({ field: ${JSON.stringify(options.fieldName)}, extensionName: ${JSON.stringify(options.extensionName)} });`,
+    '  assert.equal(itemField.field.type, "string");',
+    `  ext.assertMigration({ migration: ${JSON.stringify(options.migrationId)}, extensionName: ${JSON.stringify(options.extensionName)}, mandatory: false });`,
+    "",
+    "  // runMigration invokes the migration through pm's real runner with a synthetic",
+    "  // context and returns its result.",
+    ...migrationHint,
+    `  const migrated = await ext.runMigration({ migration: ${JSON.stringify(options.migrationId)} });`,
+    `  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(options.migrationId)} });`
+  ];
+}
+function buildProfileCapabilityAssertionLines(extensionName) {
+  return [
+    "  // assertProfile throws unless the profile is registered, so reaching the next",
+    "  // line already proves the wiring; assert on the returned definition to inspect",
+    "  // the bundled archetype dimensions.",
+    `  const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
+    `  assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
+    "  assert.equal(profile.types.length, 1);",
+    "  assert.equal(profile.workflows.length, 1);"
+  ];
+}
 var SCAFFOLD_TSCONFIG = {
   compilerOptions: {
     target: "ES2022",
@@ -828,9 +860,6 @@ function buildSampleTestSource(extensionName, commandName, capability) {
   const preflightEnabled = capability === "preflight";
   const servicesEnabled = capability === "services";
   const capabilitiesLiteral = SAMPLE_TEST_CAPABILITIES_LITERAL[capability];
-  const searchProviderName = `${extensionName}-search`;
-  const vectorAdapterName = `${extensionName}-vector`;
-  const adapterName = `${extensionName.replace(/-/g, " ")} items`;
   const itemTypeName = extensionName;
   const itemTypeFolder = `${extensionName}s`;
   const fieldName = `${extensionName.replace(/-/g, "_")}_note`;
@@ -874,89 +903,8 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "});",
     ""
   ] : [];
-  const searchTestLines = searchEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes search primitives`)}, async () => {`,
-    "  const ext = await createExtensionTestHarness(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  let deactivated = false;",
-    "  try {",
-    `    ext.assertSearchProvider({ provider: ${JSON.stringify(searchProviderName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    ext.assertVectorStoreAdapter({ adapter: ${JSON.stringify(vectorAdapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    "",
-    "    // The starter provider reads only document title/id, so `settings` is a",
-    "    // minimal typed stub and `documents` carry just the fields it inspects.",
-    "    const query = await ext.runSearchProvider({",
-    `      provider: ${JSON.stringify(searchProviderName)},`,
-    '      operation: "query",',
-    "      context: {",
-    '        query: "sync",',
-    '        mode: "semantic",',
-    '        tokens: ["sync"],',
-    "        options: {},",
-    "        settings: {} as PmSettings,",
-    "        documents: [",
-    '          { metadata: { id: "pm-1", title: "Sync external context" }, body: "" },',
-    '          { metadata: { id: "pm-2", title: "Unrelated task" }, body: "" },',
-    "        ] as ItemDocument[],",
-    "      },",
-    "    });",
-    '    assert.deepEqual(query, { hits: [{ id: "pm-1", score: 1, matched_fields: ["title"] }] });',
-    "",
-    "    const embedding = await ext.runSearchProvider({",
-    `      provider: ${JSON.stringify(searchProviderName)},`,
-    '      operation: "embed",',
-    '      context: { input: "abc", settings: {} as PmSettings, model: "starter-model" },',
-    "    });",
-    "    assert.deepEqual(embedding, [3]);",
-    "",
-    "    const vectorHits = await ext.runVectorStoreAdapter({",
-    `      adapter: ${JSON.stringify(vectorAdapterName)},`,
-    '      operation: "query",',
-    "      context: { vector: [0.1, 0.2], limit: 2, settings: {} as PmSettings },",
-    "    });",
-    '    assert.deepEqual(vectorHits, [{ id: "starter-vector-hit", score: 2 }]);',
-    "    const teardown = await ext.deactivate();",
-    "    assertExtensionDeactivated(teardown);",
-    "    deactivated = true;",
-    ...SAMPLE_HARNESS_FINALLY_LINES,
-    "});",
-    ""
-  ] : [];
-  const importerTestLines = importersEnabled ? [
-    `test(${JSON.stringify(`${extensionName} registers and invokes import/export primitives`)}, async () => {`,
-    "  const ext = await createExtensionTestHarness(extension, {",
-    `    name: ${JSON.stringify(extensionName)},`,
-    `    capabilities: ${capabilitiesLiteral},`,
-    "  });",
-    "  let deactivated = false;",
-    "  try {",
-    `    ext.assertImporter({ importer: ${JSON.stringify(adapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    ext.assertExporter({ exporter: ${JSON.stringify(adapterName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    "",
-    "    const imported = await ext.runImporter({",
-    `      importer: ${JSON.stringify(adapterName)},`,
-    '      options: { source: "tickets" },',
-    '      args: ["batch-1"],',
-    "    });",
-    "    assert.equal(imported.handled, true);",
-    '    assert.deepEqual(imported.result, { imported: 1, source: "tickets", args: ["batch-1"] });',
-    "",
-    "    const exported = await ext.runExporter({",
-    `      exporter: ${JSON.stringify(adapterName)},`,
-    '      options: { destination: "archive" },',
-    '      args: ["done"],',
-    "    });",
-    "    assert.equal(exported.handled, true);",
-    '    assert.deepEqual(exported.result, { exported: true, destination: "archive", args: ["done"] });',
-    "    const teardown = await ext.deactivate();",
-    "    assertExtensionDeactivated(teardown);",
-    "    deactivated = true;",
-    ...SAMPLE_HARNESS_FINALLY_LINES,
-    "});",
-    ""
-  ] : [];
+  const searchTestLines = searchEnabled ? buildDeclarativeCapabilityTestBlock(extensionName, commandName, "search", capabilitiesLiteral) : [];
+  const importerTestLines = importersEnabled ? buildDeclarativeCapabilityTestBlock(extensionName, commandName, "importers", capabilitiesLiteral) : [];
   const schemaTestLines = schemaEnabled ? [
     `test(${JSON.stringify(`${extensionName} registers and runs its custom schema`)}, async () => {`,
     "  const ext = await createExtensionTestHarness(extension, {",
@@ -965,20 +913,14 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "  });",
     "  let deactivated = false;",
     "  try {",
-    "    // assertItemType/Field/Migration throw unless the registration is",
-    "    // present, so reaching each next line already proves the wiring; assert on",
-    "    // the returned definitions to demonstrate inspecting registered metadata.",
-    `    const itemType = ext.assertItemType({ itemType: ${JSON.stringify(itemTypeName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    assert.equal(itemType.itemType.folder, ${JSON.stringify(itemTypeFolder)});`,
-    `    const itemField = ext.assertItemField({ field: ${JSON.stringify(fieldName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    '    assert.equal(itemField.field.type, "string");',
-    `    ext.assertMigration({ migration: ${JSON.stringify(migrationId)}, extensionName: ${JSON.stringify(extensionName)}, mandatory: false });`,
-    "",
-    "    // runMigration invokes the migration through pm's real runner with a",
-    "    // synthetic context and returns its result. Replace the context/assertions",
-    "    // as your migration grows.",
-    `    const migrated = await ext.runMigration({ migration: ${JSON.stringify(migrationId)} });`,
-    `    assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(migrationId)} });`,
+    ...indentGeneratedLines(buildSchemaCapabilityAssertionLines({
+      extensionName,
+      itemTypeName,
+      itemTypeFolder,
+      fieldName,
+      migrationId,
+      includeMigrationReplacementHint: true
+    }), "  "),
     "    const teardown = await ext.deactivate();",
     "    assertExtensionDeactivated(teardown);",
     "    deactivated = true;",
@@ -994,13 +936,7 @@ function buildSampleTestSource(extensionName, commandName, capability) {
     "  });",
     "  let deactivated = false;",
     "  try {",
-    "    // assertProfile throws unless the profile is registered, so reaching the next",
-    "    // line already proves the wiring; assert on the returned definition to inspect",
-    "    // the bundled archetype dimensions.",
-    `    const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-    `    assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
-    "    assert.equal(profile.types.length, 1);",
-    "    assert.equal(profile.workflows.length, 1);",
+    ...indentGeneratedLines(buildProfileCapabilityAssertionLines(extensionName), "  "),
     "    const teardown = await ext.deactivate();",
     "    assertExtensionDeactivated(teardown);",
     "    deactivated = true;",
@@ -1532,36 +1468,20 @@ function buildDeclarativeCapabilityTestBlock(extensionName, commandName, capabil
     case "schema":
       return [
         `test(${JSON.stringify(`${extensionName} registers and runs its custom schema`)}, async () => {`,
-        ...withHarnessCleanup([
-          "  // assertItemType/Field/Migration throw unless the registration is present, so",
-          "  // reaching each next line already proves the wiring; assert on the returned",
-          "  // definitions to demonstrate inspecting registered metadata.",
-          `  const itemType = ext.assertItemType({ itemType: ${JSON.stringify(itemTypeName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          `  assert.equal(itemType.itemType.folder, ${JSON.stringify(itemTypeFolder)});`,
-          `  const itemField = ext.assertItemField({ field: ${JSON.stringify(fieldName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          '  assert.equal(itemField.field.type, "string");',
-          `  ext.assertMigration({ migration: ${JSON.stringify(migrationId)}, extensionName: ${JSON.stringify(extensionName)}, mandatory: false });`,
-          "",
-          "  // runMigration invokes the migration through pm's real runner with a synthetic",
-          "  // context and returns its result.",
-          `  const migrated = await ext.runMigration({ migration: ${JSON.stringify(migrationId)} });`,
-          `  assert.deepEqual(migrated, { migrated: true, id: ${JSON.stringify(migrationId)} });`
-        ]),
+        ...withHarnessCleanup(buildSchemaCapabilityAssertionLines({
+          extensionName,
+          itemTypeName,
+          itemTypeFolder,
+          fieldName,
+          migrationId
+        })),
         "});",
         ""
       ];
     case "profile":
       return [
         `test(${JSON.stringify(`${extensionName} registers its project profile`)}, async () => {`,
-        ...withHarnessCleanup([
-          "  // assertProfile throws unless the profile is registered, so reaching the next",
-          "  // line already proves the wiring; assert on the returned definition to inspect",
-          "  // the bundled archetype dimensions.",
-          `  const { profile } = ext.assertProfile({ profile: ${JSON.stringify(extensionName)}, extensionName: ${JSON.stringify(extensionName)} });`,
-          `  assert.equal(profile.title, ${JSON.stringify(`${extensionName} archetype`)});`,
-          "  assert.equal(profile.types.length, 1);",
-          "  assert.equal(profile.workflows.length, 1);"
-        ]),
+        ...withHarnessCleanup(buildProfileCapabilityAssertionLines(extensionName)),
         "});",
         ""
       ];
@@ -2150,6 +2070,7 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
     "## Included Files",
     manifestBullet,
     entrypointBullet,
+    '- `package.json`: `{ "type": "module" }` marker so the ESM entrypoint loads even when the host project is CommonJS.',
     TSCONFIG_BULLET,
     "",
     "## Quick Start",
@@ -2184,6 +2105,11 @@ function buildStarterExtensionScaffoldFiles(extensionName, commandName, vocabula
   return {
     "manifest.json": manifest,
     "index.ts": entrypoint,
+    // Module-type marker: pm loads index.ts as ESM, and without a nearby
+    // package.json Node inherits the host project's module type, breaking
+    // installs into "type": "commonjs" projects (pm-r0m4).
+    "package.json": `${JSON.stringify({ type: "module" }, null, 2)}
+`,
     "tsconfig.json": tsconfig,
     "README.md": readme
   };
@@ -2251,218 +2177,8 @@ async function scaffoldExtensionProject(target, vocabulary = "extension", capabi
   };
 }
 
-// dist/core/extensions/activation-summary.js
-!(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] = "39933cf1-dcc8-57c9-ab92-77dcadb707d8");
-  } catch (e2) {
-  }
-})();
-var HOOK_REGISTRY_FIELD_TO_KIND = [
-  ["beforeCommand", "before_command"],
-  ["afterCommand", "after_command"],
-  ["onWrite", "on_write"],
-  ["onRead", "on_read"],
-  ["onIndex", "on_index"]
-];
-function describeExtensionActivation(activation, options = {}) {
-  const filter = options.extensionName !== void 0 ? normalizeExtensionName(options.extensionName) : null;
-  const matches = (name) => filter === null || normalizeExtensionName(name) === filter;
-  const collect = (entries, identify) => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));
-  const collectFlat = (entries, expand) => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));
-  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;
-  return {
-    capabilities: collectUsedExtensionCapabilities(activation, options),
-    commands: collect(registrations.commands, (entry) => entry.command),
-    command_overrides: collect(commands.overrides, (entry) => entry.command),
-    command_handlers: collect(commands.handlers, (entry) => entry.command),
-    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(([, kind]) => kind),
-    flag_commands: collect(registrations.flags, (entry) => entry.target_command),
-    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),
-    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),
-    migrations: collectFlat(registrations.migrations, (entry) => typeof entry.definition.id === "string" ? [entry.definition.id] : []),
-    profiles: collect(registrations.profiles, (entry) => entry.profile.name),
-    importers: collect(registrations.importers, (entry) => entry.importer),
-    exporters: collect(registrations.exporters, (entry) => entry.exporter),
-    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),
-    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),
-    parser_overrides: collect(parsers.overrides, (entry) => entry.command),
-    service_overrides: collect(services.overrides, (entry) => entry.service),
-    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),
-    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length
-  };
-}
-function sortUnique(values) {
-  return [...new Set(values)].sort((left, right) => left.localeCompare(right));
-}
-
-// dist/core/extensions/activation-summary-markdown.js
-!(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] = "b179b4ec-bec8-5761-b7d2-db8f7c8ed54a");
-  } catch (e2) {
-  }
-})();
-var MIN_HEADING_LEVEL = 1;
-var MAX_HEADING_LEVEL = 6;
-var SURFACE_SECTIONS = [
-  ["commands", "Commands"],
-  ["command_overrides", "Command overrides"],
-  ["flag_commands", "Flag commands"],
-  ["item_types", "Item types"],
-  ["item_fields", "Item fields"],
-  ["migrations", "Migrations"],
-  ["profiles", "Profiles"],
-  ["importers", "Importers"],
-  ["exporters", "Exporters"],
-  ["search_providers", "Search providers"],
-  ["vector_store_adapters", "Vector store adapters"],
-  ["hooks", "Lifecycle hooks"],
-  ["parser_overrides", "Parser overrides"],
-  ["service_overrides", "Service overrides"],
-  ["renderer_overrides", "Renderer overrides"]
-];
-function headingPrefix(level) {
-  return "#".repeat(level);
-}
-function code(value) {
-  if (!value.includes("`")) {
-    return `\`${value}\``;
-  }
-  let longestRun = 0;
-  let currentRun = 0;
-  for (const char of value) {
-    currentRun = char === "`" ? currentRun + 1 : 0;
-    longestRun = Math.max(longestRun, currentRun);
-  }
-  const fence = "`".repeat(longestRun + 1);
-  const pad = value.startsWith("`") || value.endsWith("`") ? " " : "";
-  return `${fence}${pad}${value}${pad}${fence}`;
-}
-function renderCapabilitiesLine(capabilities) {
-  if (capabilities.length === 0) {
-    return "Capabilities: _none registered_";
-  }
-  return `Capabilities: ${capabilities.map(code).join(", ")}`;
-}
-function renderSection(heading, level, entries) {
-  const lines = [`${headingPrefix(level)} ${heading}`, ""];
-  if (entries.length === 0) {
-    lines.push("_None._", "");
-    return lines;
-  }
-  lines.push(...entries.map((entry) => `- ${code(entry)}`), "");
-  return lines;
-}
-function renderPreflightSection(count, level, includeEmpty) {
-  if (count === 0 && !includeEmpty) {
-    return [];
-  }
-  return [
-    `${headingPrefix(level)} Preflight overrides`,
-    "",
-    count > 0 ? `- ${count} registered (this surface carries no per-entry identifier)` : "_None._",
-    ""
-  ];
-}
-function renderExtensionSurfaceMarkdown(summary, options = {}) {
-  const titleLevel = options.headingLevel ?? 2;
-  if (!Number.isInteger(titleLevel) || titleLevel < MIN_HEADING_LEVEL || titleLevel > MAX_HEADING_LEVEL) {
-    throw new RangeError(`headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`);
-  }
-  const sectionLevel = Math.min(titleLevel + 1, MAX_HEADING_LEVEL);
-  const includeEmpty = options.includeEmpty === true;
-  const title = options.title ?? "Extension surfaces";
-  const lines = [`${headingPrefix(titleLevel)} ${title}`, ""];
-  if (includeEmpty || summary.capabilities.length > 0) {
-    lines.push(renderCapabilitiesLine(summary.capabilities), "");
-  }
-  for (const [field, heading] of SURFACE_SECTIONS) {
-    const entries = summary[field];
-    if (entries.length === 0 && !includeEmpty) {
-      continue;
-    }
-    lines.push(...renderSection(heading, sectionLevel, entries));
-  }
-  lines.push(...renderPreflightSection(summary.preflight_overrides, sectionLevel, includeEmpty));
-  const hasAnySurface = summary.preflight_overrides > 0 || SURFACE_SECTIONS.some(([field]) => summary[field].length > 0);
-  if (!hasAnySurface && !includeEmpty) {
-    lines.push("_This extension registers no surfaces._", "");
-  }
-  return `${lines.join("\n").trimEnd()}
-`;
-}
-
-// dist/cli/commands/extension/describe.js
-!(function() {
-  try {
-    var e = "undefined" != typeof window ? window : "undefined" != typeof global ? global : "undefined" != typeof globalThis ? globalThis : "undefined" != typeof self ? self : {}, n = new e.Error().stack;
-    n && (e._sentryDebugIds = e._sentryDebugIds || {}, e._sentryDebugIds[n] = "e32f1159-a3b3-5c1f-903f-c0ed2d4cf458");
-  } catch (e2) {
-  }
-})();
-function layerNameKey(layer, name) {
-  return `${layer}:${normalizeExtensionNameForMatch(name)}`;
-}
-function buildExtensionDescribeResult(target, loadResult, activationResult) {
-  const activationFailedKeys = new Set(activationResult.failed.map((entry) => layerNameKey(entry.layer, entry.name)));
-  const candidates = [
-    ...loadResult.loaded.map((entry) => ({
-      name: entry.name,
-      layer: entry.layer,
-      version: entry.version,
-      activation_status: activationFailedKeys.has(layerNameKey(entry.layer, entry.name)) ? "failed" : "ok",
-      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name })
-    })),
-    ...loadResult.failed.map((entry) => ({
-      name: entry.name,
-      layer: entry.layer,
-      version: "unknown",
-      activation_status: "not_loaded",
-      surfaces: describeExtensionActivation(activationResult, { extensionName: entry.name })
-    }))
-  ].sort((left, right) => left.name.localeCompare(right.name) || left.layer.localeCompare(right.layer));
-  const normalizedTarget = typeof target === "string" ? normalizeExtensionNameForMatch(target) : null;
-  const extensions = normalizedTarget === null ? candidates : candidates.filter((entry) => normalizeExtensionNameForMatch(entry.name) === normalizedTarget);
-  return {
-    target: typeof target === "string" ? target.trim() : null,
-    total: extensions.length,
-    extensions,
-    union: describeExtensionActivation(activationResult, normalizedTarget === null ? {} : { extensionName: target })
-  };
-}
-var ACTIVATION_STATUS_LABELS = {
-  ok: "loaded",
-  failed: "activation failed",
-  not_loaded: "not loaded"
-};
-function renderExtensionDescribeMarkdown(result, noun) {
-  const titleNoun = `${noun[0].toUpperCase()}${noun.slice(1)}`;
-  const lines = [`# ${titleNoun} surface reference`, ""];
-  lines.push(result.target === null ? `Scope: all loaded ${noun}s` : `Scope: \`${result.target}\``);
-  lines.push(`Described: ${result.total} ${noun}${result.total === 1 ? "" : "s"}`, "");
-  if (result.extensions.length === 0) {
-    lines.push(`_No ${noun}s are loaded._`, "");
-    return `${lines.join("\n").trimEnd()}
-`;
-  }
-  for (const entry of result.extensions) {
-    const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;
-    lines.push(renderExtensionSurfaceMarkdown(entry.surfaces, { title, headingLevel: 2 }));
-  }
-  if (result.extensions.length > 1) {
-    lines.push(renderExtensionSurfaceMarkdown(result.union, { title: `Union across all described ${noun}s`, headingLevel: 2 }));
-  }
-  return `${lines.join("\n").trimEnd()}
-`;
-}
-
 export {
   SCAFFOLD_CAPABILITIES,
-  scaffoldExtensionProject,
-  buildExtensionDescribeResult,
-  renderExtensionDescribeMarkdown
+  scaffoldExtensionProject
 };
-//# sourceMappingURL=chunk-NZ7QIUP5.js.map
+//# sourceMappingURL=chunk-E2FUG6GD.js.map