@unbrained/pm-cli 2026.7.14 → 2026.7.16

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

@@ -1,91 +1,2 @@
-/**
- * @module cli/commands/extension/describe
- *
- * Builds the `pm extension describe` / `pm package describe` payload: a flat,
- * by-name map of every surface each loaded extension registered.
- *
- * The SDK already ships {@link describeExtensionActivation} -- the `describe`
- * (enumerate-all) verb that complements the `assert*` (verify-one) and `run*`
- * (invoke-one) testing helpers -- but until now it was reachable only from a test
- * that hand-built an {@link ExtensionActivationResult}. This module is the thin
- * orchestration that lets an agent at the CLI (or over MCP) ask "what does this
- * installed extension add to my context?" in one call, instead of stitching
- * together `doctor` (errors), `manage` (update metadata), and a manifest read.
- *
- * It is intentionally pure: the caller performs the load+activate cycle (exactly
- * as `explore`/`doctor` already do) and hands the results here, so the same
- * builder is trivially unit-testable against synthetic activations.
- */
-import { type ExtensionActivationSummary } from "../../../core/extensions/activation-summary.js";
-import type { ExtensionActivationResult, ExtensionLayer, ExtensionLoadResult } from "../../../core/extensions/loader.js";
-/** Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). */
-export type ExtensionDescribeActivationStatus = "ok" | "failed" | "not_loaded";
-/**
- * One extension's contribution to the workspace: its identity plus the
- * {@link ExtensionActivationSummary} of every surface it registered.
- *
- * `surfaces` is matched by extension *name* (mirroring
- * {@link describeExtensionActivation}'s name filter), so when the same name is
- * loaded in both the project and global layers each entry reflects that name's
- * combined surfaces -- the `layer`/`version` fields still distinguish the
- * physical entries.
- */
-export interface ExtensionSurfaceDescription {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports layer for this contract. */
-    layer: ExtensionLayer;
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Lifecycle state reported for activationthe record. */
-    activation_status: ExtensionDescribeActivationStatus;
-    /** Value that configures or reports surfaces for this contract. */
-    surfaces: ExtensionActivationSummary;
-}
-/**
- * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps
- * plus a deduplicated `union` across the described set. `target` echoes the
- * requested name filter (or `null` for the whole workspace) and `total` counts
- * the described entries so callers need not re-measure `extensions`.
- */
-export interface ExtensionDescribeResult {
-    /** Value that configures or reports target for this contract. */
-    target: string | null;
-    /** Value that configures or reports total for this contract. */
-    total: number;
-    /** Value that configures or reports extensions for this contract. */
-    extensions: ExtensionSurfaceDescription[];
-    /** Value that configures or reports union for this contract. */
-    union: ExtensionActivationSummary;
-}
-/**
- * Summarize, by name, every registration surface the loaded extensions exercised.
- *
- * Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is
- * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts
- * the entries by name then layer for deterministic output, and attaches each
- * extension's {@link describeExtensionActivation} summary. When `target` is
- * provided only the case-insensitively matching extensions are described and the
- * `union` is scoped to that resolved name set; otherwise every loaded extension contributes.
- * A target may name either the extension itself or its source npm package
- * (`source_package`), so agents can reuse the `package_name` values surfaced by
- * `pm extension list` / install discovery without a second lookup. An unmatched
- * `target` yields an empty `extensions` array -- the caller decides whether that
- * is a not-found error.
- */
-export declare function buildExtensionDescribeResult(target: string | undefined, loadResult: ExtensionLoadResult, activationResult: ExtensionActivationResult): ExtensionDescribeResult;
-/**
- * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
- * top-level title and scope line, one section per described extension (titled
- * with its identity and activation status), and — only when more than one
- * extension was described — a final union section spanning them all. Each
- * extension and the union are rendered with the shared
- * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the
- * document nests cleanly under the level-1 title.
- *
- * `noun` is the lifecycle vocabulary (`"extension"` or `"package"`) so the prose
- * matches the command the agent invoked. When no extensions match (an unmatched
- * target is already a not-found error upstream, so this is the "nothing loaded"
- * case) the document is the title plus a single explanatory note.
- */
-export declare function renderExtensionDescribeMarkdown(result: ExtensionDescribeResult, noun: string): string;
+/** Compatibility exports for SDK-owned extension descriptions. */
+export * from "../../../sdk/extension/describe.js";

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

@@ -1,144 +1,6 @@
-/**
- * @module cli/commands/extension/describe
- *
- * Builds the `pm extension describe` / `pm package describe` payload: a flat,
- * by-name map of every surface each loaded extension registered.
- *
- * The SDK already ships {@link describeExtensionActivation} -- the `describe`
- * (enumerate-all) verb that complements the `assert*` (verify-one) and `run*`
- * (invoke-one) testing helpers -- but until now it was reachable only from a test
- * that hand-built an {@link ExtensionActivationResult}. This module is the thin
- * orchestration that lets an agent at the CLI (or over MCP) ask "what does this
- * installed extension add to my context?" in one call, instead of stitching
- * together `doctor` (errors), `manage` (update metadata), and a manifest read.
- *
- * It is intentionally pure: the caller performs the load+activate cycle (exactly
- * as `explore`/`doctor` already do) and hands the results here, so the same
- * builder is trivially unit-testable against synthetic activations.
- */
+/** Compatibility exports for SDK-owned extension descriptions. */
 
-!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]="2037cd4e-93aa-5e15-b38c-d3530f0b6f00")}catch(e){}}();
-import { describeExtensionActivation, } from "../../../core/extensions/activation-summary.js";
-import { renderExtensionSurfaceMarkdown } from "../../../core/extensions/activation-summary-markdown.js";
-import { normalizeExtensionNameForMatch } from "./shared.js";
-/** Compose a collision-free identity key for an extension from its layer and normalized name. The two parts are joined with a colon; the layer prefix is always a colon-free enum value, so distinct (layer, name) pairs never collide even when a name itself contains a colon. */
-function layerNameKey(layer, name) {
-    return `${layer}:${normalizeExtensionNameForMatch(name)}`;
-}
-/**
- * Summarize, by name, every registration surface the loaded extensions exercised.
- *
- * Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is
- * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts
- * the entries by name then layer for deterministic output, and attaches each
- * extension's {@link describeExtensionActivation} summary. When `target` is
- * provided only the case-insensitively matching extensions are described and the
- * `union` is scoped to that resolved name set; otherwise every loaded extension contributes.
- * A target may name either the extension itself or its source npm package
- * (`source_package`), so agents can reuse the `package_name` values surfaced by
- * `pm extension list` / install discovery without a second lookup. An unmatched
- * `target` yields an empty `extensions` array -- the caller decides whether that
- * is a not-found error.
- */
-export 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 matchedNames = normalizedTarget === null
-        ? null
-        : new Set(loadResult.loaded
-            .filter((entry) => normalizeExtensionNameForMatch(entry.name) ===
-            normalizedTarget ||
-            (typeof entry.source_package === "string" &&
-                normalizeExtensionNameForMatch(entry.source_package) ===
-                    normalizedTarget))
-            .map((entry) => normalizeExtensionNameForMatch(entry.name))
-            .concat(normalizedTarget));
-    const extensions = matchedNames === null
-        ? candidates
-        : candidates.filter((entry) => matchedNames.has(normalizeExtensionNameForMatch(entry.name)));
-    const unionOptions = matchedNames === null ? {} : { extensionNames: [...matchedNames] };
-    return {
-        target: typeof target === "string" ? target.trim() : null,
-        total: extensions.length,
-        extensions,
-        union: describeExtensionActivation(activationResult, unionOptions),
-    };
-}
-/**
- * Human-readable label for each {@link ExtensionDescribeActivationStatus}, used
- * in the Markdown per-extension heading so a reader sees *why* an entry has no
- * surfaces (activation failed / never loaded) rather than assuming it
- * contributes nothing.
- */
-const ACTIVATION_STATUS_LABELS = {
-    ok: "loaded",
-    failed: "activation failed",
-    not_loaded: "not loaded",
-};
-/**
- * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a
- * top-level title and scope line, one section per described extension (titled
- * with its identity and activation status), and — only when more than one
- * extension was described — a final union section spanning them all. Each
- * extension and the union are rendered with the shared
- * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the
- * document nests cleanly under the level-1 title.
- *
- * `noun` is the lifecycle vocabulary (`"extension"` or `"package"`) so the prose
- * matches the command the agent invoked. When no extensions match (an unmatched
- * target is already a not-found error upstream, so this is the "nothing loaded"
- * case) the document is the title plus a single explanatory note.
- */
-export function renderExtensionDescribeMarkdown(result, noun) {
-    const titleNoun = `${noun[0].toUpperCase()}${noun.slice(1)}`;
-    const lines = [`# ${titleNoun} surface reference`, ""];
-    lines.push(result.target === null
-        ? `Scope: all loaded ${noun}s`
-        : `Scope: \`${result.target}\``);
-    lines.push(`Described: ${result.total} ${noun}${result.total === 1 ? "" : "s"}`, "");
-    if (result.extensions.length === 0) {
-        lines.push(`_No ${noun}s are loaded._`, "");
-        return `${lines.join("\n").trimEnd()}\n`;
-    }
-    for (const entry of result.extensions) {
-        const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;
-        // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a
-        // single blank line between sections, so no extra "" separator is pushed.
-        lines.push(renderExtensionSurfaceMarkdown(entry.surfaces, {
-            title,
-            headingLevel: 2,
-        }));
-    }
-    if (result.extensions.length > 1) {
-        lines.push(renderExtensionSurfaceMarkdown(result.union, {
-            title: `Union across all described ${noun}s`,
-            headingLevel: 2,
-        }));
-    }
-    return `${lines.join("\n").trimEnd()}\n`;
-}
+!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]="07ad2bfe-8208-55f0-9ac1-b5bbf07179ff")}catch(e){}}();
+export * from "../../../sdk/extension/describe.js";
 //# sourceMappingURL=describe.js.map
-//# debugId=2037cd4e-93aa-5e15-b38c-d3530f0b6f00
+//# debugId=07ad2bfe-8208-55f0-9ac1-b5bbf07179ff

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

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sources":["cli/commands/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/extension/describe\n *\n * Builds the `pm extension describe` / `pm package describe` payload: a flat,\n * by-name map of every surface each loaded extension registered.\n *\n * The SDK already ships {@link describeExtensionActivation} -- the `describe`\n * (enumerate-all) verb that complements the `assert*` (verify-one) and `run*`\n * (invoke-one) testing helpers -- but until now it was reachable only from a test\n * that hand-built an {@link ExtensionActivationResult}. This module is the thin\n * orchestration that lets an agent at the CLI (or over MCP) ask \"what does this\n * installed extension add to my context?\" in one call, instead of stitching\n * together `doctor` (errors), `manage` (update metadata), and a manifest read.\n *\n * It is intentionally pure: the caller performs the load+activate cycle (exactly\n * as `explore`/`doctor` already do) and hands the results here, so the same\n * builder is trivially unit-testable against synthetic activations.\n */\nimport {\n  describeExtensionActivation,\n  type ExtensionActivationSummary,\n} from \"../../../core/extensions/activation-summary.js\";\nimport { renderExtensionSurfaceMarkdown } from \"../../../core/extensions/activation-summary-markdown.js\";\nimport type {\n  ExtensionActivationResult,\n  ExtensionLayer,\n  ExtensionLoadResult,\n} from \"../../../core/extensions/loader.js\";\nimport { normalizeExtensionNameForMatch } from \"./shared.js\";\n\n/** Runtime state of a described extension. `ok` loaded and activated cleanly, `failed` loaded but threw during `activate`, and `not_loaded` failed to import at all -- the latter two register nothing, so their `surfaces` are empty and the status explains why (rather than implying the extension contributes nothing). */\nexport type ExtensionDescribeActivationStatus = \"ok\" | \"failed\" | \"not_loaded\";\n\n/**\n * One extension's contribution to the workspace: its identity plus the\n * {@link ExtensionActivationSummary} of every surface it registered.\n *\n * `surfaces` is matched by extension *name* (mirroring\n * {@link describeExtensionActivation}'s name filter), so when the same name is\n * loaded in both the project and global layers each entry reflects that name's\n * combined surfaces -- the `layer`/`version` fields still distinguish the\n * physical entries.\n */\nexport interface ExtensionSurfaceDescription {\n  /** Value that configures or reports name for this contract. */\n  name: string;\n  /** Value that configures or reports layer for this contract. */\n  layer: ExtensionLayer;\n  /** Value that configures or reports version for this contract. */\n  version: string;\n  /** Lifecycle state reported for activationthe record. */\n  activation_status: ExtensionDescribeActivationStatus;\n  /** Value that configures or reports surfaces for this contract. */\n  surfaces: ExtensionActivationSummary;\n}\n\n/**\n * Result of {@link buildExtensionDescribeResult}: the per-extension surface maps\n * plus a deduplicated `union` across the described set. `target` echoes the\n * requested name filter (or `null` for the whole workspace) and `total` counts\n * the described entries so callers need not re-measure `extensions`.\n */\nexport interface ExtensionDescribeResult {\n  /** Value that configures or reports target for this contract. */\n  target: string | null;\n  /** Value that configures or reports total for this contract. */\n  total: number;\n  /** Value that configures or reports extensions for this contract. */\n  extensions: ExtensionSurfaceDescription[];\n  /** Value that configures or reports union for this contract. */\n  union: ExtensionActivationSummary;\n}\n\n/** Compose a collision-free identity key for an extension from its layer and normalized name. The two parts are joined with a colon; the layer prefix is always a colon-free enum value, so distinct (layer, name) pairs never collide even when a name itself contains a colon. */\nfunction layerNameKey(layer: ExtensionLayer, name: string): string {\n  return `${layer}:${normalizeExtensionNameForMatch(name)}`;\n}\n\n/**\n * Summarize, by name, every registration surface the loaded extensions exercised.\n *\n * Walks `loadResult.loaded` (annotating each with `failed` when its layer+name is\n * in `activationResult.failed`) and `loadResult.failed` (as `not_loaded`), sorts\n * the entries by name then layer for deterministic output, and attaches each\n * extension's {@link describeExtensionActivation} summary. When `target` is\n * provided only the case-insensitively matching extensions are described and the\n * `union` is scoped to that resolved name set; otherwise every loaded extension contributes.\n * A target may name either the extension itself or its source npm package\n * (`source_package`), so agents can reuse the `package_name` values surfaced by\n * `pm extension list` / install discovery without a second lookup. An unmatched\n * `target` yields an empty `extensions` array -- the caller decides whether that\n * is a not-found error.\n */\nexport function buildExtensionDescribeResult(\n  target: string | undefined,\n  loadResult: ExtensionLoadResult,\n  activationResult: ExtensionActivationResult,\n): ExtensionDescribeResult {\n  const activationFailedKeys = new Set(\n    activationResult.failed.map((entry) =>\n      layerNameKey(entry.layer, entry.name),\n    ),\n  );\n  const candidates: ExtensionSurfaceDescription[] = [\n    ...loadResult.loaded.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: entry.version,\n      activation_status: activationFailedKeys.has(\n        layerNameKey(entry.layer, entry.name),\n      )\n        ? (\"failed\" as const)\n        : (\"ok\" as const),\n      surfaces: describeExtensionActivation(activationResult, {\n        extensionName: entry.name,\n      }),\n    })),\n    ...loadResult.failed.map((entry) => ({\n      name: entry.name,\n      layer: entry.layer,\n      version: \"unknown\",\n      activation_status: \"not_loaded\" as const,\n      surfaces: describeExtensionActivation(activationResult, {\n        extensionName: entry.name,\n      }),\n    })),\n  ].sort(\n    (left, right) =>\n      left.name.localeCompare(right.name) ||\n      left.layer.localeCompare(right.layer),\n  );\n\n  const normalizedTarget =\n    typeof target === \"string\" ? normalizeExtensionNameForMatch(target) : null;\n  const matchedNames =\n    normalizedTarget === null\n      ? null\n      : new Set(\n          loadResult.loaded\n            .filter(\n              (entry) =>\n                normalizeExtensionNameForMatch(entry.name) ===\n                  normalizedTarget ||\n                (typeof entry.source_package === \"string\" &&\n                  normalizeExtensionNameForMatch(entry.source_package) ===\n                    normalizedTarget),\n            )\n            .map((entry) => normalizeExtensionNameForMatch(entry.name))\n            .concat(normalizedTarget),\n        );\n  const extensions =\n    matchedNames === null\n      ? candidates\n      : candidates.filter((entry) =>\n          matchedNames.has(normalizeExtensionNameForMatch(entry.name)),\n        );\n  const unionOptions =\n    matchedNames === null ? {} : { extensionNames: [...matchedNames] };\n\n  return {\n    target: typeof target === \"string\" ? target.trim() : null,\n    total: extensions.length,\n    extensions,\n    union: describeExtensionActivation(activationResult, unionOptions),\n  };\n}\n\n/**\n * Human-readable label for each {@link ExtensionDescribeActivationStatus}, used\n * in the Markdown per-extension heading so a reader sees *why* an entry has no\n * surfaces (activation failed / never loaded) rather than assuming it\n * contributes nothing.\n */\nconst ACTIVATION_STATUS_LABELS: Record<\n  ExtensionDescribeActivationStatus,\n  string\n> = {\n  ok: \"loaded\",\n  failed: \"activation failed\",\n  not_loaded: \"not loaded\",\n};\n\n/**\n * Render an {@link ExtensionDescribeResult} as a Markdown reference document: a\n * top-level title and scope line, one section per described extension (titled\n * with its identity and activation status), and — only when more than one\n * extension was described — a final union section spanning them all. Each\n * extension and the union are rendered with the shared\n * {@link renderExtensionSurfaceMarkdown} primitive at heading level 2, so the\n * document nests cleanly under the level-1 title.\n *\n * `noun` is the lifecycle vocabulary (`\"extension\"` or `\"package\"`) so the prose\n * matches the command the agent invoked. When no extensions match (an unmatched\n * target is already a not-found error upstream, so this is the \"nothing loaded\"\n * case) the document is the title plus a single explanatory note.\n */\nexport function renderExtensionDescribeMarkdown(\n  result: ExtensionDescribeResult,\n  noun: string,\n): string {\n  const titleNoun = `${noun[0]!.toUpperCase()}${noun.slice(1)}`;\n  const lines = [`# ${titleNoun} surface reference`, \"\"];\n  lines.push(\n    result.target === null\n      ? `Scope: all loaded ${noun}s`\n      : `Scope: \\`${result.target}\\``,\n  );\n  lines.push(\n    `Described: ${result.total} ${noun}${result.total === 1 ? \"\" : \"s\"}`,\n    \"\",\n  );\n\n  if (result.extensions.length === 0) {\n    lines.push(`_No ${noun}s are loaded._`, \"\");\n    return `${lines.join(\"\\n\").trimEnd()}\\n`;\n  }\n\n  for (const entry of result.extensions) {\n    const title = `${entry.name} (${entry.layer} v${entry.version}, ${ACTIVATION_STATUS_LABELS[entry.activation_status]})`;\n    // renderExtensionSurfaceMarkdown already ends with a newline; the join adds a\n    // single blank line between sections, so no extra \"\" separator is pushed.\n    lines.push(\n      renderExtensionSurfaceMarkdown(entry.surfaces, {\n        title,\n        headingLevel: 2,\n      }),\n    );\n  }\n\n  if (result.extensions.length > 1) {\n    lines.push(\n      renderExtensionSurfaceMarkdown(result.union, {\n        title: `Union across all described ${noun}s`,\n        headingLevel: 2,\n      }),\n    );\n  }\n\n  return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"2037cd4e-93aa-5e15-b38c-d3530f0b6f00"}
+{"version":3,"file":"describe.js","sources":["cli/commands/extension/describe.ts"],"sourceRoot":"/","sourcesContent":["/** Compatibility exports for SDK-owned extension descriptions. */\nexport * from \"../../../sdk/extension/describe.js\";\n"],"names":[],"mappings":"AAAA,kEAAkE;;;AAClE,cAAc,oCAAoC,CAAC","debugId":"07ad2bfe-8208-55f0-9ac1-b5bbf07179ff"}

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

@@ -1,36 +1,2 @@
-/** 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 {};
+/** Compatibility exports for SDK-owned extension scaffolding. */
+export * from "../../../sdk/extension/scaffold.js";