@unbrained/pm-cli 2026.6.23 → 2026.6.30

package/dist/core/config/positional-value.d.ts

@@ -39,6 +39,8 @@ export interface ConfigPositionalNotRoutable {
  * Restricts config positional result values accepted by command, SDK, and storage contracts.
  */
 export type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;
+/** Canonical snake-case config keys accepted by the config command and positional router. */
+export type ConfigKey = "definition_of_done" | "item_format" | "history_missing_stream_policy" | "sprint_release_format_policy" | "parent_reference_policy" | "metadata_validation_profile" | "metadata_required_fields" | "lifecycle_stale_blocker_reason_patterns" | "lifecycle_closure_like_blocked_reason_patterns" | "lifecycle_closure_like_resolution_patterns" | "lifecycle_closure_like_actual_result_patterns" | "governance_preset" | "governance_ownership_enforcement" | "governance_create_mode_default" | "governance_close_validation_default" | "governance_require_close_reason" | "governance_create_default_type" | "governance_workflow_enforcement" | "governance_parent_reference_policy" | "governance_metadata_validation_profile" | "governance_force_required_for_stale_lock" | "test_result_tracking" | "telemetry_tracking" | "context";
 /**
  * Resolve which typed flag a positional `pm config set <key> <value>` value should
  * populate, plus the normalized value.

package/dist/core/config/positional-value.js

@@ -10,7 +10,7 @@
  * good error messages.
  */
 
-!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]="6cd7dcb8-a001-52ee-bcd6-e6c9f3d33f02")}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]="c7e38647-27e9-5ea0-8c7f-7decefb9a882")}catch(e){}}();
 const FORMAT_KEYS = new Set(["item_format"]);
 const CRITERIA_KEYS = new Set([
     "definition_of_done",
@@ -110,4 +110,4 @@ export function resolveConfigPositionalValue(canonicalKeyOrAlias, value) {
     return { routable: true, flag: "policy", value: policyValue };
 }
 //# sourceMappingURL=positional-value.js.map
-//# debugId=6cd7dcb8-a001-52ee-bcd6-e6c9f3d33f02
+//# debugId=c7e38647-27e9-5ea0-8c7f-7decefb9a882

package/dist/core/config/positional-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"positional-value.js","sources":["core/config/positional-value.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Pure routing helper for the optional positional `value` argument of `pm config set`.\n *\n * `pm config set <key> <value>` is the intuitive form agents reach for, but config\n * VALUES are actually carried by typed flags (`--format`, `--policy`, `--criterion`).\n * This module maps a config key (kebab or snake form, canonical or alias) plus a raw\n * positional value onto the typed flag it should populate, applying enabled/disabled\n * synonyms (off/on/true/false) for boolean-style policy keys. The existing per-key\n * validators in config.ts still run on the routed value, so bad values keep their\n * good error messages.\n */\n\n/** The typed flag a positional value routes to. */\nexport type ConfigPositionalFlag = \"format\" | \"policy\" | \"criterion\";\n\n/** Successful routing of a positional value to a single-value typed flag. */\nexport interface ConfigPositionalScalarRouted {\n  routable: true;\n  flag: \"format\" | \"policy\";\n  /** Normalized scalar value for single-value flags. */\n  value: string;\n}\n\n/** Successful routing of a positional value to the criteria-list flag. */\nexport interface ConfigPositionalListRouted {\n  routable: true;\n  flag: \"criterion\";\n  /** Criteria-list flag (`--criterion`) value, supplied as a values array. */\n  values: string[];\n}\n\n/**\n * Restricts config positional routed values accepted by command, SDK, and storage contracts.\n */\nexport type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;\n\n/** A key whose value cannot be carried by a single positional (e.g. `context`). */\nexport interface ConfigPositionalNotRoutable {\n  routable: false;\n  /** Human/agent-facing reason + the flags to use instead. */\n  reason: string;\n}\n\n/**\n * Restricts config positional result values accepted by command, SDK, and storage contracts.\n */\nexport type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;\n\n/** Canonical snake-case config keys this helper understands. */\ntype CanonicalConfigKey =\n  | \"definition_of_done\"\n  | \"item_format\"\n  | \"history_missing_stream_policy\"\n  | \"sprint_release_format_policy\"\n  | \"parent_reference_policy\"\n  | \"metadata_validation_profile\"\n  | \"metadata_required_fields\"\n  | \"lifecycle_stale_blocker_reason_patterns\"\n  | \"lifecycle_closure_like_blocked_reason_patterns\"\n  | \"lifecycle_closure_like_resolution_patterns\"\n  | \"lifecycle_closure_like_actual_result_patterns\"\n  | \"governance_preset\"\n  | \"governance_ownership_enforcement\"\n  | \"governance_create_mode_default\"\n  | \"governance_close_validation_default\"\n  | \"governance_require_close_reason\"\n  | \"governance_create_default_type\"\n  | \"governance_workflow_enforcement\"\n  | \"governance_parent_reference_policy\"\n  | \"governance_metadata_validation_profile\"\n  | \"governance_force_required_for_stale_lock\"\n  | \"test_result_tracking\"\n  | \"telemetry_tracking\"\n  | \"context\";\n\nconst FORMAT_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\"item_format\"]);\n\nconst CRITERIA_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"definition_of_done\",\n  \"metadata_required_fields\",\n  \"lifecycle_stale_blocker_reason_patterns\",\n  \"lifecycle_closure_like_blocked_reason_patterns\",\n  \"lifecycle_closure_like_resolution_patterns\",\n  \"lifecycle_closure_like_actual_result_patterns\",\n]);\n\nconst POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"history_missing_stream_policy\",\n  \"sprint_release_format_policy\",\n  \"parent_reference_policy\",\n  \"metadata_validation_profile\",\n  \"governance_preset\",\n  \"governance_ownership_enforcement\",\n  \"governance_create_mode_default\",\n  \"governance_close_validation_default\",\n  \"governance_require_close_reason\",\n  \"governance_create_default_type\",\n  \"governance_workflow_enforcement\",\n  \"governance_parent_reference_policy\",\n  \"governance_metadata_validation_profile\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\n/**\n * Policy keys whose only valid values are enabled/disabled. For these we accept the\n * intuitive synonyms off/on/true/false. Other policy keys pass through unchanged so\n * their own validators report the precise allowed set.\n */\nconst ENABLED_DISABLED_POLICY_KEYS: ReadonlySet<CanonicalConfigKey> = new Set<CanonicalConfigKey>([\n  \"governance_require_close_reason\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\nconst ENABLED_DISABLED_SYNONYMS: Record<string, string> = {\n  off: \"disabled\",\n  on: \"enabled\",\n  true: \"enabled\",\n  false: \"disabled\",\n  enabled: \"enabled\",\n  disabled: \"disabled\",\n};\n\n/** Normalize any kebab/snake key form to the canonical snake key (or undefined). */\nfunction toCanonicalKey(keyOrAlias: string): CanonicalConfigKey | undefined {\n  const normalized = keyOrAlias.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (\n    FORMAT_KEYS.has(normalized as CanonicalConfigKey) ||\n    CRITERIA_KEYS.has(normalized as CanonicalConfigKey) ||\n    POLICY_KEYS.has(normalized as CanonicalConfigKey) ||\n    normalized === \"context\"\n  ) {\n    return normalized as CanonicalConfigKey;\n  }\n  return undefined;\n}\n\n/**\n * Map an enabled/disabled-style value through its synonyms (case-insensitive). Values\n * that are not synonyms pass through unchanged so the downstream validator can reject\n * them with its own message.\n */\nfunction normalizeEnabledDisabled(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  return ENABLED_DISABLED_SYNONYMS[normalized] ?? value;\n}\n\n/**\n * Resolve which typed flag a positional `pm config set <key> <value>` value should\n * populate, plus the normalized value.\n *\n * Returns `{ routable: false, reason }` for keys that require multiple/structured\n * flags (e.g. `context`). Unknown keys also return `routable: false` so the caller\n * can fall back to the existing invalid-key path.\n */\nexport function resolveConfigPositionalValue(\n  canonicalKeyOrAlias: string,\n  value: string,\n): ConfigPositionalResult {\n  const key = toCanonicalKey(canonicalKeyOrAlias);\n  if (key === undefined) {\n    return {\n      routable: false,\n      reason: `Unknown config key \"${canonicalKeyOrAlias}\" cannot route a positional value.`,\n    };\n  }\n\n  if (key === \"context\") {\n    return {\n      routable: false,\n      reason:\n        'Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags.',\n    };\n  }\n\n  if (FORMAT_KEYS.has(key)) {\n    return { routable: true, flag: \"format\", value };\n  }\n\n  if (CRITERIA_KEYS.has(key)) {\n    return { routable: true, flag: \"criterion\", values: [value] };\n  }\n\n  // policy key\n  const policyValue = ENABLED_DISABLED_POLICY_KEYS.has(key) ? normalizeEnabledDisabled(value) : value;\n  return { routable: true, flag: \"policy\", value: policyValue };\n}\n"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;;;AAiEH,MAAM,WAAW,GAAoC,IAAI,GAAG,CAAqB,CAAC,aAAa,CAAC,CAAC,CAAC;AAElG,MAAM,aAAa,GAAoC,IAAI,GAAG,CAAqB;IACjF,oBAAoB;IACpB,0BAA0B;IAC1B,yCAAyC;IACzC,gDAAgD;IAChD,4CAA4C;IAC5C,+CAA+C;CAChD,CAAC,CAAC;AAEH,MAAM,WAAW,GAAoC,IAAI,GAAG,CAAqB;IAC/E,+BAA+B;IAC/B,8BAA8B;IAC9B,yBAAyB;IACzB,6BAA6B;IAC7B,mBAAmB;IACnB,kCAAkC;IAClC,gCAAgC;IAChC,qCAAqC;IACrC,iCAAiC;IACjC,gCAAgC;IAChC,iCAAiC;IACjC,oCAAoC;IACpC,wCAAwC;IACxC,0CAA0C;IAC1C,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,4BAA4B,GAAoC,IAAI,GAAG,CAAqB;IAChG,iCAAiC;IACjC,0CAA0C;IAC1C,sBAAsB;IACtB,oBAAoB;CACrB,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAA2B;IACxD,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,SAAS;IACb,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,UAAU;IACjB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,oFAAoF;AACpF,SAAS,cAAc,CAAC,UAAkB;IACxC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACxE,IACE,WAAW,CAAC,GAAG,CAAC,UAAgC,CAAC;QACjD,aAAa,CAAC,GAAG,CAAC,UAAgC,CAAC;QACnD,WAAW,CAAC,GAAG,CAAC,UAAgC,CAAC;QACjD,UAAU,KAAK,SAAS,EACxB,CAAC;QACD,OAAO,UAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,wBAAwB,CAAC,KAAa;IAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,yBAAyB,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;AACxD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,4BAA4B,CAC1C,mBAA2B,EAC3B,KAAa;IAEb,MAAM,GAAG,GAAG,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,uBAAuB,mBAAmB,oCAAoC;SACvF,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO;YACL,QAAQ,EAAE,KAAK;YACf,MAAM,EACJ,kJAAkJ;SACrJ,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IAED,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;IAChE,CAAC;IAED,aAAa;IACb,MAAM,WAAW,GAAG,4BAA4B,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACpG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChE,CAAC","debugId":"6cd7dcb8-a001-52ee-bcd6-e6c9f3d33f02"}
+{"version":3,"file":"positional-value.js","sources":["core/config/positional-value.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Pure routing helper for the optional positional `value` argument of `pm config set`.\n *\n * `pm config set <key> <value>` is the intuitive form agents reach for, but config\n * VALUES are actually carried by typed flags (`--format`, `--policy`, `--criterion`).\n * This module maps a config key (kebab or snake form, canonical or alias) plus a raw\n * positional value onto the typed flag it should populate, applying enabled/disabled\n * synonyms (off/on/true/false) for boolean-style policy keys. The existing per-key\n * validators in config.ts still run on the routed value, so bad values keep their\n * good error messages.\n */\n\n/** The typed flag a positional value routes to. */\nexport type ConfigPositionalFlag = \"format\" | \"policy\" | \"criterion\";\n\n/** Successful routing of a positional value to a single-value typed flag. */\nexport interface ConfigPositionalScalarRouted {\n  routable: true;\n  flag: \"format\" | \"policy\";\n  /** Normalized scalar value for single-value flags. */\n  value: string;\n}\n\n/** Successful routing of a positional value to the criteria-list flag. */\nexport interface ConfigPositionalListRouted {\n  routable: true;\n  flag: \"criterion\";\n  /** Criteria-list flag (`--criterion`) value, supplied as a values array. */\n  values: string[];\n}\n\n/**\n * Restricts config positional routed values accepted by command, SDK, and storage contracts.\n */\nexport type ConfigPositionalRouted = ConfigPositionalScalarRouted | ConfigPositionalListRouted;\n\n/** A key whose value cannot be carried by a single positional (e.g. `context`). */\nexport interface ConfigPositionalNotRoutable {\n  routable: false;\n  /** Human/agent-facing reason + the flags to use instead. */\n  reason: string;\n}\n\n/**\n * Restricts config positional result values accepted by command, SDK, and storage contracts.\n */\nexport type ConfigPositionalResult = ConfigPositionalRouted | ConfigPositionalNotRoutable;\n\n/** Canonical snake-case config keys accepted by the config command and positional router. */\nexport type ConfigKey =\n  | \"definition_of_done\"\n  | \"item_format\"\n  | \"history_missing_stream_policy\"\n  | \"sprint_release_format_policy\"\n  | \"parent_reference_policy\"\n  | \"metadata_validation_profile\"\n  | \"metadata_required_fields\"\n  | \"lifecycle_stale_blocker_reason_patterns\"\n  | \"lifecycle_closure_like_blocked_reason_patterns\"\n  | \"lifecycle_closure_like_resolution_patterns\"\n  | \"lifecycle_closure_like_actual_result_patterns\"\n  | \"governance_preset\"\n  | \"governance_ownership_enforcement\"\n  | \"governance_create_mode_default\"\n  | \"governance_close_validation_default\"\n  | \"governance_require_close_reason\"\n  | \"governance_create_default_type\"\n  | \"governance_workflow_enforcement\"\n  | \"governance_parent_reference_policy\"\n  | \"governance_metadata_validation_profile\"\n  | \"governance_force_required_for_stale_lock\"\n  | \"test_result_tracking\"\n  | \"telemetry_tracking\"\n  | \"context\";\n\nconst FORMAT_KEYS: ReadonlySet<ConfigKey> = new Set<ConfigKey>([\"item_format\"]);\n\nconst CRITERIA_KEYS: ReadonlySet<ConfigKey> = new Set<ConfigKey>([\n  \"definition_of_done\",\n  \"metadata_required_fields\",\n  \"lifecycle_stale_blocker_reason_patterns\",\n  \"lifecycle_closure_like_blocked_reason_patterns\",\n  \"lifecycle_closure_like_resolution_patterns\",\n  \"lifecycle_closure_like_actual_result_patterns\",\n]);\n\nconst POLICY_KEYS: ReadonlySet<ConfigKey> = new Set<ConfigKey>([\n  \"history_missing_stream_policy\",\n  \"sprint_release_format_policy\",\n  \"parent_reference_policy\",\n  \"metadata_validation_profile\",\n  \"governance_preset\",\n  \"governance_ownership_enforcement\",\n  \"governance_create_mode_default\",\n  \"governance_close_validation_default\",\n  \"governance_require_close_reason\",\n  \"governance_create_default_type\",\n  \"governance_workflow_enforcement\",\n  \"governance_parent_reference_policy\",\n  \"governance_metadata_validation_profile\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\n/**\n * Policy keys whose only valid values are enabled/disabled. For these we accept the\n * intuitive synonyms off/on/true/false. Other policy keys pass through unchanged so\n * their own validators report the precise allowed set.\n */\nconst ENABLED_DISABLED_POLICY_KEYS: ReadonlySet<ConfigKey> = new Set<ConfigKey>([\n  \"governance_require_close_reason\",\n  \"governance_force_required_for_stale_lock\",\n  \"test_result_tracking\",\n  \"telemetry_tracking\",\n]);\n\nconst ENABLED_DISABLED_SYNONYMS: Record<string, string> = {\n  off: \"disabled\",\n  on: \"enabled\",\n  true: \"enabled\",\n  false: \"disabled\",\n  enabled: \"enabled\",\n  disabled: \"disabled\",\n};\n\n/** Normalize any kebab/snake key form to the canonical snake key (or undefined). */\nfunction toCanonicalKey(keyOrAlias: string): ConfigKey | undefined {\n  const normalized = keyOrAlias.trim().toLowerCase().replaceAll(\"-\", \"_\");\n  if (\n    FORMAT_KEYS.has(normalized as ConfigKey) ||\n    CRITERIA_KEYS.has(normalized as ConfigKey) ||\n    POLICY_KEYS.has(normalized as ConfigKey) ||\n    normalized === \"context\"\n  ) {\n    return normalized as ConfigKey;\n  }\n  return undefined;\n}\n\n/**\n * Map an enabled/disabled-style value through its synonyms (case-insensitive). Values\n * that are not synonyms pass through unchanged so the downstream validator can reject\n * them with its own message.\n */\nfunction normalizeEnabledDisabled(value: string): string {\n  const normalized = value.trim().toLowerCase();\n  return ENABLED_DISABLED_SYNONYMS[normalized] ?? value;\n}\n\n/**\n * Resolve which typed flag a positional `pm config set <key> <value>` value should\n * populate, plus the normalized value.\n *\n * Returns `{ routable: false, reason }` for keys that require multiple/structured\n * flags (e.g. `context`). Unknown keys also return `routable: false` so the caller\n * can fall back to the existing invalid-key path.\n */\nexport function resolveConfigPositionalValue(\n  canonicalKeyOrAlias: string,\n  value: string,\n): ConfigPositionalResult {\n  const key = toCanonicalKey(canonicalKeyOrAlias);\n  if (key === undefined) {\n    return {\n      routable: false,\n      reason: `Unknown config key \"${canonicalKeyOrAlias}\" cannot route a positional value.`,\n    };\n  }\n\n  if (key === \"context\") {\n    return {\n      routable: false,\n      reason:\n        'Config set context does not accept a positional value. Use --default-depth, --activity-limit, --stale-threshold-days, or --section-<name> flags.',\n    };\n  }\n\n  if (FORMAT_KEYS.has(key)) {\n    return { routable: true, flag: \"format\", value };\n  }\n\n  if (CRITERIA_KEYS.has(key)) {\n    return { routable: true, flag: \"criterion\", values: [value] };\n  }\n\n  // policy key\n  const policyValue = ENABLED_DISABLED_POLICY_KEYS.has(key) ? normalizeEnabledDisabled(value) : value;\n  return { routable: true, flag: \"policy\", value: policyValue };\n}\n"],"names":[],"mappings":"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","debugId":"c7e38647-27e9-5ea0-8c7f-7decefb9a882"}

package/dist/core/extensions/activation-summary-markdown.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @module core/extensions/activation-summary-markdown
+ *
+ * Renders an {@link ExtensionActivationSummary} to a deterministic Markdown
+ * reference document — the *render* leg that completes the `describe`
+ * (enumerate-all) verb.
+ *
+ * {@link ./activation-summary.js#describeExtensionActivation | `describeExtensionActivation`}
+ * (and its author-time twin
+ * {@link ../../sdk/compose.js#describeExtensionBlueprint | `describeExtensionBlueprint`})
+ * already answer "what does this package register?" as a structured summary, and
+ * the `assert*`/`run*` testing helpers verify and invoke each surface. What was
+ * missing is a way to turn that summary into human-readable docs: package
+ * authors hand-wrote the README "commands & capabilities" reference, which
+ * silently drifted from the surface the loader actually registers.
+ *
+ * {@link renderExtensionSurfaceMarkdown} closes that gap. It is a pure,
+ * dependency-free projection of the summary, so an author can pipe
+ * `describeExtensionBlueprint(blueprint)` straight into it during their build or
+ * test step and embed the result in their README — a reference that can never
+ * drift from the registered surface ("project management = context management").
+ * The CLI's `pm extension|package describe --markdown` composes the same
+ * primitive across every loaded extension.
+ */
+import type { ExtensionActivationSummary } from "./activation-summary.js";
+/**
+ * Options for {@link renderExtensionSurfaceMarkdown}.
+ */
+export interface ExtensionSurfaceMarkdownOptions {
+    /**
+     * Heading text for the document title. Defaults to `"Extension surfaces"`.
+     * The title always renders as an ATX heading at
+     * {@link ExtensionSurfaceMarkdownOptions.headingLevel}; per-surface sections
+     * render one level deeper.
+     */
+    title?: string;
+    /**
+     * ATX heading level for the title, an integer in `[1, 6]` (default `2`, i.e.
+     * `##`, so the document embeds cleanly under a `# Package` README heading).
+     * Section headings render at `headingLevel + 1`, clamped to `6`. Values
+     * outside `[1, 6]` throw a {@link RangeError}.
+     */
+    headingLevel?: number;
+    /**
+     * When `true`, render every surface section even when it has no entries
+     * (emitting `_None._` under the heading) and always emit the capabilities
+     * line. Defaults to `false`, which omits empty sections so the reference lists
+     * only what the package actually contributes.
+     */
+    includeEmpty?: boolean;
+}
+/**
+ * Render an {@link ExtensionActivationSummary} as a deterministic Markdown
+ * reference document.
+ *
+ * The output is a title heading, a one-line capabilities summary, and a section
+ * per registered surface (commands, overrides, flags, item types/fields,
+ * migrations, importers/exporters, search providers, vector adapters, lifecycle
+ * hooks, and the parser/service/renderer override surfaces), followed by a
+ * preflight-override count line when any are registered. Section order and
+ * within-section identifier order both come straight from the summary, so the
+ * same summary always renders byte-for-byte the same document.
+ *
+ * By default empty sections are omitted so the reference lists only what the
+ * package contributes; set {@link ExtensionSurfaceMarkdownOptions.includeEmpty}
+ * to render every section. A summary with no surfaces at all renders the title,
+ * the capabilities line, and a `_This extension registers no surfaces._` note.
+ *
+ * @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.
+ */
+export declare function renderExtensionSurfaceMarkdown(summary: ExtensionActivationSummary, options?: ExtensionSurfaceMarkdownOptions): string;

package/dist/core/extensions/activation-summary-markdown.js

@@ -0,0 +1,140 @@
+/**
+ * The lowest and highest ATX heading levels Markdown supports, used to validate
+ * {@link ExtensionSurfaceMarkdownOptions.headingLevel} and to clamp nested
+ * section headings so a deep title never emits an invalid `#######` run.
+ */
+
+!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]="916c708e-0da8-5408-8d50-ce702f482e94")}catch(e){}}();
+const MIN_HEADING_LEVEL = 1;
+const MAX_HEADING_LEVEL = 6;
+/**
+ * A surface section paired with the {@link ExtensionActivationSummary} field
+ * whose identifiers populate it. Ordered for an author-facing reference:
+ * commands first, then schema, then importers/exporters, retrieval, lifecycle
+ * hooks, and finally the override surfaces. {@link ExtensionActivationSummary.command_handlers}
+ * is intentionally omitted — it is a documented superset of `commands` plus the
+ * synthesized `<name> import`/`<name> export` paths already covered by the
+ * Importers and Exporters sections, so rendering it would duplicate information.
+ */
+const 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"],
+];
+/**
+ * Repeat `#` `level` times to form an ATX heading prefix.
+ */
+function headingPrefix(level) {
+    return "#".repeat(level);
+}
+/**
+ * Render `value` as an inline Markdown code span. Backslash escapes do not work
+ * inside CommonMark code spans, so when `value` contains backticks the span is
+ * delimited by a run of backticks one longer than the longest internal run, and
+ * padded with a space when the value borders a backtick — the CommonMark rule
+ * for embedding literal backticks in a code span.
+ */
+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}`;
+}
+/**
+ * Render the comma-separated capabilities summary line (or `_none registered_`
+ * when the activation exercised no known capability).
+ */
+function renderCapabilitiesLine(capabilities) {
+    if (capabilities.length === 0) {
+        return "Capabilities: _none registered_";
+    }
+    return `Capabilities: ${capabilities.map(code).join(", ")}`;
+}
+/**
+ * Render one surface section as `heading` + a bullet per identifier, or, when
+ * `entries` is empty, `heading` + `_None._`. Callers decide whether an empty
+ * section is rendered at all via {@link ExtensionSurfaceMarkdownOptions.includeEmpty}.
+ */
+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;
+}
+/**
+ * Render an {@link ExtensionActivationSummary} as a deterministic Markdown
+ * reference document.
+ *
+ * The output is a title heading, a one-line capabilities summary, and a section
+ * per registered surface (commands, overrides, flags, item types/fields,
+ * migrations, importers/exporters, search providers, vector adapters, lifecycle
+ * hooks, and the parser/service/renderer override surfaces), followed by a
+ * preflight-override count line when any are registered. Section order and
+ * within-section identifier order both come straight from the summary, so the
+ * same summary always renders byte-for-byte the same document.
+ *
+ * By default empty sections are omitted so the reference lists only what the
+ * package contributes; set {@link ExtensionSurfaceMarkdownOptions.includeEmpty}
+ * to render every section. A summary with no surfaces at all renders the title,
+ * the capabilities line, and a `_This extension registers no surfaces._` note.
+ *
+ * @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.
+ */
+export 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), "");
+    }
+    let renderedSurface = false;
+    for (const [field, heading] of SURFACE_SECTIONS) {
+        const entries = summary[field];
+        if (entries.length === 0 && !includeEmpty) {
+            continue;
+        }
+        renderedSurface = renderedSurface || entries.length > 0;
+        lines.push(...renderSection(heading, sectionLevel, entries));
+    }
+    if (summary.preflight_overrides > 0 || includeEmpty) {
+        renderedSurface = renderedSurface || summary.preflight_overrides > 0;
+        lines.push(`${headingPrefix(sectionLevel)} Preflight overrides`, "");
+        lines.push(summary.preflight_overrides > 0
+            ? `- ${summary.preflight_overrides} registered (this surface carries no per-entry identifier)`
+            : "_None._", "");
+    }
+    if (!renderedSurface && !includeEmpty) {
+        lines.push("_This extension registers no surfaces._", "");
+    }
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+//# sourceMappingURL=activation-summary-markdown.js.map
+//# debugId=916c708e-0da8-5408-8d50-ce702f482e94

package/dist/core/extensions/activation-summary-markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-summary-markdown.js","sources":["core/extensions/activation-summary-markdown.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/activation-summary-markdown\n *\n * Renders an {@link ExtensionActivationSummary} to a deterministic Markdown\n * reference document — the *render* leg that completes the `describe`\n * (enumerate-all) verb.\n *\n * {@link ./activation-summary.js#describeExtensionActivation | `describeExtensionActivation`}\n * (and its author-time twin\n * {@link ../../sdk/compose.js#describeExtensionBlueprint | `describeExtensionBlueprint`})\n * already answer \"what does this package register?\" as a structured summary, and\n * the `assert*`/`run*` testing helpers verify and invoke each surface. What was\n * missing is a way to turn that summary into human-readable docs: package\n * authors hand-wrote the README \"commands & capabilities\" reference, which\n * silently drifted from the surface the loader actually registers.\n *\n * {@link renderExtensionSurfaceMarkdown} closes that gap. It is a pure,\n * dependency-free projection of the summary, so an author can pipe\n * `describeExtensionBlueprint(blueprint)` straight into it during their build or\n * test step and embed the result in their README — a reference that can never\n * drift from the registered surface (\"project management = context management\").\n * The CLI's `pm extension|package describe --markdown` composes the same\n * primitive across every loaded extension.\n */\nimport type { ExtensionActivationSummary } from \"./activation-summary.js\";\n\n/**\n * The lowest and highest ATX heading levels Markdown supports, used to validate\n * {@link ExtensionSurfaceMarkdownOptions.headingLevel} and to clamp nested\n * section headings so a deep title never emits an invalid `#######` run.\n */\nconst MIN_HEADING_LEVEL = 1;\nconst MAX_HEADING_LEVEL = 6;\n\n/**\n * Options for {@link renderExtensionSurfaceMarkdown}.\n */\nexport interface ExtensionSurfaceMarkdownOptions {\n  /**\n   * Heading text for the document title. Defaults to `\"Extension surfaces\"`.\n   * The title always renders as an ATX heading at\n   * {@link ExtensionSurfaceMarkdownOptions.headingLevel}; per-surface sections\n   * render one level deeper.\n   */\n  title?: string;\n  /**\n   * ATX heading level for the title, an integer in `[1, 6]` (default `2`, i.e.\n   * `##`, so the document embeds cleanly under a `# Package` README heading).\n   * Section headings render at `headingLevel + 1`, clamped to `6`. Values\n   * outside `[1, 6]` throw a {@link RangeError}.\n   */\n  headingLevel?: number;\n  /**\n   * When `true`, render every surface section even when it has no entries\n   * (emitting `_None._` under the heading) and always emit the capabilities\n   * line. Defaults to `false`, which omits empty sections so the reference lists\n   * only what the package actually contributes.\n   */\n  includeEmpty?: boolean;\n}\n\n/**\n * A surface section paired with the {@link ExtensionActivationSummary} field\n * whose identifiers populate it. Ordered for an author-facing reference:\n * commands first, then schema, then importers/exporters, retrieval, lifecycle\n * hooks, and finally the override surfaces. {@link ExtensionActivationSummary.command_handlers}\n * is intentionally omitted — it is a documented superset of `commands` plus the\n * synthesized `<name> import`/`<name> export` paths already covered by the\n * Importers and Exporters sections, so rendering it would duplicate information.\n */\nconst SURFACE_SECTIONS = [\n  [\"commands\", \"Commands\"],\n  [\"command_overrides\", \"Command overrides\"],\n  [\"flag_commands\", \"Flag commands\"],\n  [\"item_types\", \"Item types\"],\n  [\"item_fields\", \"Item fields\"],\n  [\"migrations\", \"Migrations\"],\n  [\"profiles\", \"Profiles\"],\n  [\"importers\", \"Importers\"],\n  [\"exporters\", \"Exporters\"],\n  [\"search_providers\", \"Search providers\"],\n  [\"vector_store_adapters\", \"Vector store adapters\"],\n  [\"hooks\", \"Lifecycle hooks\"],\n  [\"parser_overrides\", \"Parser overrides\"],\n  [\"service_overrides\", \"Service overrides\"],\n  [\"renderer_overrides\", \"Renderer overrides\"],\n] as const satisfies ReadonlyArray<\n  readonly [\n    {\n      [K in keyof ExtensionActivationSummary]: ExtensionActivationSummary[K] extends readonly string[] ? K : never;\n    }[keyof ExtensionActivationSummary],\n    string,\n  ]\n>;\n\n/**\n * Repeat `#` `level` times to form an ATX heading prefix.\n */\nfunction headingPrefix(level: number): string {\n  return \"#\".repeat(level);\n}\n\n/**\n * Render `value` as an inline Markdown code span. Backslash escapes do not work\n * inside CommonMark code spans, so when `value` contains backticks the span is\n * delimited by a run of backticks one longer than the longest internal run, and\n * padded with a space when the value borders a backtick — the CommonMark rule\n * for embedding literal backticks in a code span.\n */\nfunction code(value: string): string {\n  if (!value.includes(\"`\")) {\n    return `\\`${value}\\``;\n  }\n  let longestRun = 0;\n  let currentRun = 0;\n  for (const char of value) {\n    currentRun = char === \"`\" ? currentRun + 1 : 0;\n    longestRun = Math.max(longestRun, currentRun);\n  }\n  const fence = \"`\".repeat(longestRun + 1);\n  const pad = value.startsWith(\"`\") || value.endsWith(\"`\") ? \" \" : \"\";\n  return `${fence}${pad}${value}${pad}${fence}`;\n}\n\n/**\n * Render the comma-separated capabilities summary line (or `_none registered_`\n * when the activation exercised no known capability).\n */\nfunction renderCapabilitiesLine(capabilities: readonly string[]): string {\n  if (capabilities.length === 0) {\n    return \"Capabilities: _none registered_\";\n  }\n  return `Capabilities: ${capabilities.map(code).join(\", \")}`;\n}\n\n/**\n * Render one surface section as `heading` + a bullet per identifier, or, when\n * `entries` is empty, `heading` + `_None._`. Callers decide whether an empty\n * section is rendered at all via {@link ExtensionSurfaceMarkdownOptions.includeEmpty}.\n */\nfunction renderSection(heading: string, level: number, entries: readonly string[]): string[] {\n  const lines = [`${headingPrefix(level)} ${heading}`, \"\"];\n  if (entries.length === 0) {\n    lines.push(\"_None._\", \"\");\n    return lines;\n  }\n  lines.push(...entries.map((entry) => `- ${code(entry)}`), \"\");\n  return lines;\n}\n\n/**\n * Render an {@link ExtensionActivationSummary} as a deterministic Markdown\n * reference document.\n *\n * The output is a title heading, a one-line capabilities summary, and a section\n * per registered surface (commands, overrides, flags, item types/fields,\n * migrations, importers/exporters, search providers, vector adapters, lifecycle\n * hooks, and the parser/service/renderer override surfaces), followed by a\n * preflight-override count line when any are registered. Section order and\n * within-section identifier order both come straight from the summary, so the\n * same summary always renders byte-for-byte the same document.\n *\n * By default empty sections are omitted so the reference lists only what the\n * package contributes; set {@link ExtensionSurfaceMarkdownOptions.includeEmpty}\n * to render every section. A summary with no surfaces at all renders the title,\n * the capabilities line, and a `_This extension registers no surfaces._` note.\n *\n * @throws {RangeError} when `options.headingLevel` is not an integer in `[1, 6]`.\n */\nexport function renderExtensionSurfaceMarkdown(\n  summary: ExtensionActivationSummary,\n  options: ExtensionSurfaceMarkdownOptions = {},\n): string {\n  const titleLevel = options.headingLevel ?? 2;\n  if (!Number.isInteger(titleLevel) || titleLevel < MIN_HEADING_LEVEL || titleLevel > MAX_HEADING_LEVEL) {\n    throw new RangeError(\n      `headingLevel must be an integer in [${MIN_HEADING_LEVEL}, ${MAX_HEADING_LEVEL}], received ${String(options.headingLevel)}`,\n    );\n  }\n  const sectionLevel = Math.min(titleLevel + 1, MAX_HEADING_LEVEL);\n  const includeEmpty = options.includeEmpty === true;\n  const title = options.title ?? \"Extension surfaces\";\n\n  const lines = [`${headingPrefix(titleLevel)} ${title}`, \"\"];\n  if (includeEmpty || summary.capabilities.length > 0) {\n    lines.push(renderCapabilitiesLine(summary.capabilities), \"\");\n  }\n\n  let renderedSurface = false;\n  for (const [field, heading] of SURFACE_SECTIONS) {\n    const entries = summary[field];\n    if (entries.length === 0 && !includeEmpty) {\n      continue;\n    }\n    renderedSurface = renderedSurface || entries.length > 0;\n    lines.push(...renderSection(heading, sectionLevel, entries));\n  }\n\n  if (summary.preflight_overrides > 0 || includeEmpty) {\n    renderedSurface = renderedSurface || summary.preflight_overrides > 0;\n    lines.push(`${headingPrefix(sectionLevel)} Preflight overrides`, \"\");\n    lines.push(\n      summary.preflight_overrides > 0\n        ? `- ${summary.preflight_overrides} registered (this surface carries no per-entry identifier)`\n        : \"_None._\",\n      \"\",\n    );\n  }\n\n  if (!renderedSurface && !includeEmpty) {\n    lines.push(\"_This extension registers no surfaces._\", \"\");\n  }\n\n  return `${lines.join(\"\\n\").trimEnd()}\\n`;\n}\n"],"names":[],"mappings":"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","debugId":"916c708e-0da8-5408-8d50-ce702f482e94"}

package/dist/core/extensions/activation-summary.d.ts

@@ -62,6 +62,8 @@ export interface ExtensionActivationSummary {
     item_fields: string[];
     /** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */
     migrations: string[];
+    /** Project profile names registered via `registerProfile`. */
+    profiles: string[];
     /** Importer names registered via `registerImporter`. */
     importers: string[];
     /** Exporter names registered via `registerExporter`. */

package/dist/core/extensions/activation-summary.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]="13c88992-4da1-549d-8644-3ac448f6960e")}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]="39933cf1-dcc8-57c9-ab92-77dcadb707d8")}catch(e){}}();
 import { collectUsedExtensionCapabilities, normalizeExtensionName } from "./capability-usage.js";
 /**
  * Canonical lifecycle hook kinds paired with their {@link ExtensionHookRegistry}
@@ -43,6 +43,7 @@ export function describeExtensionActivation(activation, options = {}) {
         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),
@@ -57,4 +58,4 @@ function sortUnique(values) {
     return [...new Set(values)].sort((left, right) => left.localeCompare(right));
 }
 //# sourceMappingURL=activation-summary.js.map
-//# debugId=13c88992-4da1-549d-8644-3ac448f6960e
+//# debugId=39933cf1-dcc8-57c9-ab92-77dcadb707d8

package/dist/core/extensions/activation-summary.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation-summary.js","sources":["core/extensions/activation-summary.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/activation-summary\n *\n * Enumerates *what* an extension activation registered, by name, in one pass.\n *\n * {@link ./extension-types.js#ExtensionActivationResult | `ExtensionActivationResult`}\n * already carries per-surface *counts* (`hook_counts`, `registration_counts`,\n * the various `*_count` fields), but answering \"what does this extension\n * register?\" otherwise means walking fifteen-plus sub-registries by hand\n * (`registrations.commands`/`flags`/`item_types`/`item_fields`/`migrations`/\n * `importers`/`exporters`/`search_providers`/`vector_store_adapters`,\n * `commands.overrides`/`handlers`, the `parsers`/`preflight`/`services`/\n * `renderers` override registries, and the five `hooks.*` arrays).\n *\n * {@link describeExtensionActivation} flattens all of them into one sorted,\n * deterministic {@link ExtensionActivationSummary} of identifiers — the\n * `describe` (enumerate-all) verb that complements the SDK's `assert*`\n * (verify-one) and `run*` (invoke-one) testing helpers. It serves two callers:\n *\n * - **Agents** get a single token-efficient view of an activation instead of\n *   traversing every registry (\"project management = context management\").\n * - **Package authors** can assert their *entire* registration surface in one\n *   `deepEqual` — a least-privilege \"I register exactly these surfaces and\n *   nothing more\" check, the positive counterpart to\n *   {@link ./capability-usage.js#reconcileExtensionCapabilityUsage}.\n */\nimport type {\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionHookRegistry,\n  ExtensionServiceName,\n  OutputRendererFormat,\n} from \"./extension-types.js\";\nimport { collectUsedExtensionCapabilities, normalizeExtensionName } from \"./capability-usage.js\";\n\n/**\n * Canonical lifecycle hook kinds paired with their {@link ExtensionHookRegistry}\n * field, ordered to match `ExtensionActivationResult.hook_counts` so a summary's\n * `hooks` list reads in the same stable order the runtime reports counts in.\n */\nconst HOOK_REGISTRY_FIELD_TO_KIND = [\n  [\"beforeCommand\", \"before_command\"],\n  [\"afterCommand\", \"after_command\"],\n  [\"onWrite\", \"on_write\"],\n  [\"onRead\", \"on_read\"],\n  [\"onIndex\", \"on_index\"],\n] as const satisfies ReadonlyArray<readonly [keyof ExtensionHookRegistry, string]>;\n\n/**\n * Flat, name-level enumeration of every surface an activation registered.\n *\n * Arrays are de-duplicated for deterministic equality. Most are locale-sorted;\n * {@link ExtensionActivationSummary.hooks} is the exception — it is emitted in\n * canonical lifecycle order to mirror `ExtensionActivationResult.hook_counts`,\n * not alphabetically. The three command fields capture distinct dimensions and\n * can overlap: a command\n * registered via `api.registerCommand(definition)` appears in both\n * {@link ExtensionActivationSummary.commands} (its declared definition) and\n * {@link ExtensionActivationSummary.command_handlers} (its executable handler),\n * whereas a built-in command replaced via `api.registerCommand(name, override)`\n * appears only in {@link ExtensionActivationSummary.command_overrides}.\n */\nexport interface ExtensionActivationSummary {\n  /** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */\n  capabilities: ExtensionCapability[];\n  /** Full command paths declared via `registerCommand`'s definition form. */\n  commands: string[];\n  /** Built-in command paths replaced by an `registerCommand(name, override)` handler. */\n  command_overrides: string[];\n  /**\n   * Full command paths backed by an extension-provided handler. A superset of\n   * {@link ExtensionActivationSummary.commands} that also includes the\n   * `<name> import`/`<name> export` paths synthesized for importers/exporters.\n   */\n  command_handlers: string[];\n  /** Lifecycle hook kinds with at least one registered hook (canonical order). */\n  hooks: string[];\n  /** Command paths that received extension-registered flags. */\n  flag_commands: string[];\n  /** Custom item-type names registered via `registerItemTypes`. */\n  item_types: string[];\n  /** Custom front-matter field names registered via `registerItemFields`. */\n  item_fields: string[];\n  /** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */\n  migrations: string[];\n  /** Importer names registered via `registerImporter`. */\n  importers: string[];\n  /** Exporter names registered via `registerExporter`. */\n  exporters: string[];\n  /** Search-provider names registered via `registerSearchProvider`. */\n  search_providers: string[];\n  /** Vector-store adapter names registered via `registerVectorStoreAdapter`. */\n  vector_store_adapters: string[];\n  /** Command paths with a parser override registered via `registerParser`. */\n  parser_overrides: string[];\n  /** Built-in service names overridden via `registerService`. */\n  service_overrides: ExtensionServiceName[];\n  /** Output formats with a renderer override registered via `registerRenderer`. */\n  renderer_overrides: OutputRendererFormat[];\n  /**\n   * Count of registered preflight overrides. The surface carries no per-entry\n   * identifier, so this is a `number` rather than `string[]` — the only numeric\n   * field in the summary.\n   */\n  preflight_overrides: number;\n}\n\n/**\n * Options for {@link describeExtensionActivation}.\n */\nexport interface DescribeExtensionActivationOptions {\n  /**\n   * Restrict the summary to a single extension by name. Names are matched\n   * case-insensitively after trimming, mirroring\n   * {@link ./capability-usage.js#collectUsedExtensionCapabilities}. Omit to\n   * union across every extension in the activation result.\n   */\n  extensionName?: string;\n}\n\n/**\n * Summarize, by name, every registration surface an activation exercised.\n *\n * Walks the same sub-registries the loader populates and the capability\n * reconciler attributes, returning a flat {@link ExtensionActivationSummary}\n * whose arrays are sorted and de-duplicated. With\n * {@link DescribeExtensionActivationOptions.extensionName} only the matching\n * extension's registrations contribute (across both layers); without it the\n * summary unions every extension in the activation. Failed activations register\n * nothing, so they contribute only an empty summary.\n */\nexport function describeExtensionActivation(\n  activation: ExtensionActivationResult,\n  options: DescribeExtensionActivationOptions = {},\n): ExtensionActivationSummary {\n  // Match both sides with the same normalizer collectUsedExtensionCapabilities\n  // uses for the `capabilities` field below, so a filtered summary's named\n  // surfaces and capabilities never disagree for a stored name with whitespace.\n  const filter = options.extensionName !== undefined ? normalizeExtensionName(options.extensionName) : null;\n  const matches = (name: string): boolean => filter === null || normalizeExtensionName(name) === filter;\n  const collect = <TEntry extends { name: string }, TValue extends string>(\n    entries: readonly TEntry[],\n    identify: (entry: TEntry) => TValue,\n  ): TValue[] => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));\n  const collectFlat = <TEntry extends { name: string }>(\n    entries: readonly TEntry[],\n    expand: (entry: TEntry) => readonly string[],\n  ): string[] => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));\n  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;\n  return {\n    capabilities: collectUsedExtensionCapabilities(activation, options),\n    commands: collect(registrations.commands, (entry) => entry.command),\n    command_overrides: collect(commands.overrides, (entry) => entry.command),\n    command_handlers: collect(commands.handlers, (entry) => entry.command),\n    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(\n      ([, kind]) => kind,\n    ),\n    flag_commands: collect(registrations.flags, (entry) => entry.target_command),\n    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),\n    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),\n    migrations: collectFlat(registrations.migrations, (entry) =>\n      typeof entry.definition.id === \"string\" ? [entry.definition.id] : [],\n    ),\n    importers: collect(registrations.importers, (entry) => entry.importer),\n    exporters: collect(registrations.exporters, (entry) => entry.exporter),\n    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),\n    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),\n    parser_overrides: collect(parsers.overrides, (entry) => entry.command),\n    service_overrides: collect(services.overrides, (entry) => entry.service),\n    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),\n    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length,\n  };\n}\n\nfunction sortUnique<TValue extends string>(values: readonly TValue[]): TValue[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n"],"names":[],"mappings":"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","debugId":"13c88992-4da1-549d-8644-3ac448f6960e"}
+{"version":3,"file":"activation-summary.js","sources":["core/extensions/activation-summary.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/activation-summary\n *\n * Enumerates *what* an extension activation registered, by name, in one pass.\n *\n * {@link ./extension-types.js#ExtensionActivationResult | `ExtensionActivationResult`}\n * already carries per-surface *counts* (`hook_counts`, `registration_counts`,\n * the various `*_count` fields), but answering \"what does this extension\n * register?\" otherwise means walking fifteen-plus sub-registries by hand\n * (`registrations.commands`/`flags`/`item_types`/`item_fields`/`migrations`/\n * `importers`/`exporters`/`search_providers`/`vector_store_adapters`,\n * `commands.overrides`/`handlers`, the `parsers`/`preflight`/`services`/\n * `renderers` override registries, and the five `hooks.*` arrays).\n *\n * {@link describeExtensionActivation} flattens all of them into one sorted,\n * deterministic {@link ExtensionActivationSummary} of identifiers — the\n * `describe` (enumerate-all) verb that complements the SDK's `assert*`\n * (verify-one) and `run*` (invoke-one) testing helpers. It serves two callers:\n *\n * - **Agents** get a single token-efficient view of an activation instead of\n *   traversing every registry (\"project management = context management\").\n * - **Package authors** can assert their *entire* registration surface in one\n *   `deepEqual` — a least-privilege \"I register exactly these surfaces and\n *   nothing more\" check, the positive counterpart to\n *   {@link ./capability-usage.js#reconcileExtensionCapabilityUsage}.\n */\nimport type {\n  ExtensionActivationResult,\n  ExtensionCapability,\n  ExtensionHookRegistry,\n  ExtensionServiceName,\n  OutputRendererFormat,\n} from \"./extension-types.js\";\nimport { collectUsedExtensionCapabilities, normalizeExtensionName } from \"./capability-usage.js\";\n\n/**\n * Canonical lifecycle hook kinds paired with their {@link ExtensionHookRegistry}\n * field, ordered to match `ExtensionActivationResult.hook_counts` so a summary's\n * `hooks` list reads in the same stable order the runtime reports counts in.\n */\nconst HOOK_REGISTRY_FIELD_TO_KIND = [\n  [\"beforeCommand\", \"before_command\"],\n  [\"afterCommand\", \"after_command\"],\n  [\"onWrite\", \"on_write\"],\n  [\"onRead\", \"on_read\"],\n  [\"onIndex\", \"on_index\"],\n] as const satisfies ReadonlyArray<readonly [keyof ExtensionHookRegistry, string]>;\n\n/**\n * Flat, name-level enumeration of every surface an activation registered.\n *\n * Arrays are de-duplicated for deterministic equality. Most are locale-sorted;\n * {@link ExtensionActivationSummary.hooks} is the exception — it is emitted in\n * canonical lifecycle order to mirror `ExtensionActivationResult.hook_counts`,\n * not alphabetically. The three command fields capture distinct dimensions and\n * can overlap: a command\n * registered via `api.registerCommand(definition)` appears in both\n * {@link ExtensionActivationSummary.commands} (its declared definition) and\n * {@link ExtensionActivationSummary.command_handlers} (its executable handler),\n * whereas a built-in command replaced via `api.registerCommand(name, override)`\n * appears only in {@link ExtensionActivationSummary.command_overrides}.\n */\nexport interface ExtensionActivationSummary {\n  /** Known capabilities the registered surfaces exercise (sorted, de-duplicated). */\n  capabilities: ExtensionCapability[];\n  /** Full command paths declared via `registerCommand`'s definition form. */\n  commands: string[];\n  /** Built-in command paths replaced by an `registerCommand(name, override)` handler. */\n  command_overrides: string[];\n  /**\n   * Full command paths backed by an extension-provided handler. A superset of\n   * {@link ExtensionActivationSummary.commands} that also includes the\n   * `<name> import`/`<name> export` paths synthesized for importers/exporters.\n   */\n  command_handlers: string[];\n  /** Lifecycle hook kinds with at least one registered hook (canonical order). */\n  hooks: string[];\n  /** Command paths that received extension-registered flags. */\n  flag_commands: string[];\n  /** Custom item-type names registered via `registerItemTypes`. */\n  item_types: string[];\n  /** Custom front-matter field names registered via `registerItemFields`. */\n  item_fields: string[];\n  /** Schema migration ids registered via `registerMigration` (id-less migrations are omitted — they carry no identifier). */\n  migrations: string[];\n  /** Project profile names registered via `registerProfile`. */\n  profiles: string[];\n  /** Importer names registered via `registerImporter`. */\n  importers: string[];\n  /** Exporter names registered via `registerExporter`. */\n  exporters: string[];\n  /** Search-provider names registered via `registerSearchProvider`. */\n  search_providers: string[];\n  /** Vector-store adapter names registered via `registerVectorStoreAdapter`. */\n  vector_store_adapters: string[];\n  /** Command paths with a parser override registered via `registerParser`. */\n  parser_overrides: string[];\n  /** Built-in service names overridden via `registerService`. */\n  service_overrides: ExtensionServiceName[];\n  /** Output formats with a renderer override registered via `registerRenderer`. */\n  renderer_overrides: OutputRendererFormat[];\n  /**\n   * Count of registered preflight overrides. The surface carries no per-entry\n   * identifier, so this is a `number` rather than `string[]` — the only numeric\n   * field in the summary.\n   */\n  preflight_overrides: number;\n}\n\n/**\n * Options for {@link describeExtensionActivation}.\n */\nexport interface DescribeExtensionActivationOptions {\n  /**\n   * Restrict the summary to a single extension by name. Names are matched\n   * case-insensitively after trimming, mirroring\n   * {@link ./capability-usage.js#collectUsedExtensionCapabilities}. Omit to\n   * union across every extension in the activation result.\n   */\n  extensionName?: string;\n}\n\n/**\n * Summarize, by name, every registration surface an activation exercised.\n *\n * Walks the same sub-registries the loader populates and the capability\n * reconciler attributes, returning a flat {@link ExtensionActivationSummary}\n * whose arrays are sorted and de-duplicated. With\n * {@link DescribeExtensionActivationOptions.extensionName} only the matching\n * extension's registrations contribute (across both layers); without it the\n * summary unions every extension in the activation. Failed activations register\n * nothing, so they contribute only an empty summary.\n */\nexport function describeExtensionActivation(\n  activation: ExtensionActivationResult,\n  options: DescribeExtensionActivationOptions = {},\n): ExtensionActivationSummary {\n  // Match both sides with the same normalizer collectUsedExtensionCapabilities\n  // uses for the `capabilities` field below, so a filtered summary's named\n  // surfaces and capabilities never disagree for a stored name with whitespace.\n  const filter = options.extensionName !== undefined ? normalizeExtensionName(options.extensionName) : null;\n  const matches = (name: string): boolean => filter === null || normalizeExtensionName(name) === filter;\n  const collect = <TEntry extends { name: string }, TValue extends string>(\n    entries: readonly TEntry[],\n    identify: (entry: TEntry) => TValue,\n  ): TValue[] => sortUnique(entries.filter((entry) => matches(entry.name)).map(identify));\n  const collectFlat = <TEntry extends { name: string }>(\n    entries: readonly TEntry[],\n    expand: (entry: TEntry) => readonly string[],\n  ): string[] => sortUnique(entries.filter((entry) => matches(entry.name)).flatMap(expand));\n  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;\n  return {\n    capabilities: collectUsedExtensionCapabilities(activation, options),\n    commands: collect(registrations.commands, (entry) => entry.command),\n    command_overrides: collect(commands.overrides, (entry) => entry.command),\n    command_handlers: collect(commands.handlers, (entry) => entry.command),\n    hooks: HOOK_REGISTRY_FIELD_TO_KIND.filter(([field]) => hooks[field].some((entry) => matches(entry.name))).map(\n      ([, kind]) => kind,\n    ),\n    flag_commands: collect(registrations.flags, (entry) => entry.target_command),\n    item_types: collectFlat(registrations.item_types, (entry) => entry.types.map((type) => type.name)),\n    item_fields: collectFlat(registrations.item_fields, (entry) => entry.fields.map((field) => field.name)),\n    migrations: collectFlat(registrations.migrations, (entry) =>\n      typeof entry.definition.id === \"string\" ? [entry.definition.id] : [],\n    ),\n    profiles: collect(registrations.profiles, (entry) => entry.profile.name),\n    importers: collect(registrations.importers, (entry) => entry.importer),\n    exporters: collect(registrations.exporters, (entry) => entry.exporter),\n    search_providers: collect(registrations.search_providers, (entry) => entry.definition.name),\n    vector_store_adapters: collect(registrations.vector_store_adapters, (entry) => entry.definition.name),\n    parser_overrides: collect(parsers.overrides, (entry) => entry.command),\n    service_overrides: collect(services.overrides, (entry) => entry.service),\n    renderer_overrides: collect(renderers.overrides, (entry) => entry.format),\n    preflight_overrides: preflight.overrides.filter((entry) => matches(entry.name)).length,\n  };\n}\n\nfunction sortUnique<TValue extends string>(values: readonly TValue[]): TValue[] {\n  return [...new Set(values)].sort((left, right) => left.localeCompare(right));\n}\n"],"names":[],"mappings":"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","debugId":"39933cf1-dcc8-57c9-ab92-77dcadb707d8"}

package/dist/core/extensions/capability-usage.d.ts

@@ -26,7 +26,7 @@ export declare const EXTENSION_CAPABILITY_REGISTRATION_SURFACES: {
     readonly commands: readonly ["registerCommand", "command override", "command handler"];
     readonly renderers: readonly ["registerRenderer"];
     readonly hooks: readonly ["hooks.beforeCommand", "hooks.afterCommand", "hooks.onWrite", "hooks.onRead", "hooks.onIndex"];
-    readonly schema: readonly ["registerFlags", "registerItemFields", "registerItemTypes", "registerMigration"];
+    readonly schema: readonly ["registerFlags", "registerItemFields", "registerItemTypes", "registerMigration", "registerProfile"];
     readonly importers: readonly ["registerImporter", "registerExporter"];
     readonly search: readonly ["registerSearchProvider", "registerVectorStoreAdapter"];
     readonly parser: readonly ["registerParser"];

package/dist/core/extensions/capability-usage.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]="f6134b79-a7d0-57d9-b25a-8e3e7b4af416")}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]="7cc05bac-f673-59a1-9d51-64361cf5a939")}catch(e){}}();
 import { normalizeKnownExtensionCapability } from "./extension-capability-aliases.js";
 /**
  * Canonical map from each known extension capability to the human-readable
@@ -14,7 +14,7 @@ export const EXTENSION_CAPABILITY_REGISTRATION_SURFACES = {
     commands: ["registerCommand", "command override", "command handler"],
     renderers: ["registerRenderer"],
     hooks: ["hooks.beforeCommand", "hooks.afterCommand", "hooks.onWrite", "hooks.onRead", "hooks.onIndex"],
-    schema: ["registerFlags", "registerItemFields", "registerItemTypes", "registerMigration"],
+    schema: ["registerFlags", "registerItemFields", "registerItemTypes", "registerMigration", "registerProfile"],
     importers: ["registerImporter", "registerExporter"],
     search: ["registerSearchProvider", "registerVectorStoreAdapter"],
     parser: ["registerParser"],
@@ -79,6 +79,7 @@ function attributeCapabilityUsage(activation) {
     record(registrations.item_fields, "schema");
     record(registrations.item_types, "schema");
     record(registrations.migrations, "schema");
+    record(registrations.profiles, "schema");
     record(registrations.importers, "importers");
     record(registrations.exporters, "importers");
     record(registrations.search_providers, "search");
@@ -139,4 +140,4 @@ export function reconcileExtensionCapabilityUsage(loaded, activation) {
     return reconciliations;
 }
 //# sourceMappingURL=capability-usage.js.map
-//# debugId=f6134b79-a7d0-57d9-b25a-8e3e7b4af416
+//# debugId=7cc05bac-f673-59a1-9d51-64361cf5a939

package/dist/core/extensions/capability-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability-usage.js","sources":["core/extensions/capability-usage.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/capability-usage\n *\n * Reconciles the capabilities an extension manifest *declares* against the\n * capabilities it actually *exercises* during activation.\n *\n * The loader already enforces the opposite direction — registering a surface\n * whose capability is absent from `manifest.capabilities` throws an\n * `extension_capability_missing` activation failure. This module closes the\n * least-privilege loop by detecting capabilities a manifest declares but never\n * registers against, so package authors can trim manifests to the minimum\n * grant. Every declared-but-unused capability is an over-broad permission a\n * reviewer would otherwise have to catch by hand.\n */\nimport type { ExtensionActivationResult, ExtensionCapability, ExtensionLayer } from \"./extension-types.js\";\nimport { normalizeKnownExtensionCapability } from \"./extension-capability-aliases.js\";\n\n/**\n * Canonical map from each known extension capability to the human-readable\n * registration surfaces that exercise it.\n *\n * The `satisfies Record<ExtensionCapability, ...>` guard makes this exhaustive\n * at compile time: adding a capability to `KNOWN_EXTENSION_CAPABILITIES`\n * without giving it a registration surface here fails the build, which prevents\n * a capability that has *no* surface from being perpetually flagged as unused.\n */\nexport const EXTENSION_CAPABILITY_REGISTRATION_SURFACES = {\n  commands: [\"registerCommand\", \"command override\", \"command handler\"],\n  renderers: [\"registerRenderer\"],\n  hooks: [\"hooks.beforeCommand\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"],\n  schema: [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerMigration\"],\n  importers: [\"registerImporter\", \"registerExporter\"],\n  search: [\"registerSearchProvider\", \"registerVectorStoreAdapter\"],\n  parser: [\"registerParser\"],\n  preflight: [\"registerPreflight\"],\n  services: [\"registerService\"],\n} as const satisfies Record<ExtensionCapability, readonly string[]>;\n\n/**\n * Per-extension reconciliation of declared versus exercised capabilities.\n */\nexport interface ExtensionCapabilityUsageReconciliation {\n  /** Layer the extension was loaded from (`global` or `project`). */\n  layer: ExtensionLayer;\n  /** Extension name as it appears in the manifest. */\n  name: string;\n  /** Known capabilities declared in the manifest, sorted and de-duplicated. */\n  declared: ExtensionCapability[];\n  /** Known capabilities the extension actually registered against, sorted. */\n  used: ExtensionCapability[];\n  /** Declared capabilities with no matching registration (least-privilege gap). */\n  unused: ExtensionCapability[];\n}\n\n/**\n * Options for {@link collectUsedExtensionCapabilities}.\n */\nexport interface CollectUsedExtensionCapabilitiesOptions {\n  /**\n   * Restrict the result to a single extension by name. Names are matched\n   * case-insensitively after trimming. Omit to union across every extension in\n   * the activation result.\n   */\n  extensionName?: string;\n}\n\n// `layer` is a closed enum (`\"global\" | \"project\"`) that never contains a\n// colon, so the first colon always separates the layer from the (possibly\n// colon-bearing) name — making the key collision-proof without serialization.\nconst USAGE_KEY_SEPARATOR = \":\";\n\nfunction usageKey(layer: ExtensionLayer, name: string): string {\n  return `${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`;\n}\n\nfunction usageKeyName(key: string): string {\n  return key.slice(key.indexOf(USAGE_KEY_SEPARATOR) + 1);\n}\n\n/**\n * Canonical extension-name normalization (trim + lowercase) used to match an\n * `extensionName` filter against a registration's stored `name`.\n *\n * Activation stores `extension.name` verbatim — the synthetic test-activation\n * path (`activateExtensionForTest`) never trims it — so any helper that filters\n * by extension name must normalize both sides with this function to stay\n * consistent, including {@link ../extensions/activation-summary.js#describeExtensionActivation}.\n */\nexport function normalizeExtensionName(name: string): string {\n  return name.trim().toLowerCase();\n}\n\nfunction normalizeDeclaredCapabilities(capabilities: readonly string[] | undefined): ExtensionCapability[] {\n  if (!Array.isArray(capabilities)) {\n    return [];\n  }\n  const known = new Set<ExtensionCapability>();\n  for (const capability of capabilities) {\n    // Unknown capabilities are reported by the separate unknown-capability\n    // diagnostic; reconciling them here would double-report a typo as \"unused\".\n    const normalized = normalizeKnownExtensionCapability(capability);\n    if (normalized !== null) {\n      known.add(normalized);\n    }\n  }\n  return [...known].sort((left, right) => left.localeCompare(right));\n}\n\nfunction attributeCapabilityUsage(activation: ExtensionActivationResult): Map<string, Set<ExtensionCapability>> {\n  const usage = new Map<string, Set<ExtensionCapability>>();\n  const record = (\n    entries: ReadonlyArray<{ layer: ExtensionLayer; name: string }>,\n    capability: ExtensionCapability,\n  ): void => {\n    for (const entry of entries) {\n      const key = usageKey(entry.layer, entry.name);\n      let exercised = usage.get(key);\n      if (exercised === undefined) {\n        exercised = new Set<ExtensionCapability>();\n        usage.set(key, exercised);\n      }\n      exercised.add(capability);\n    }\n  };\n  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;\n  record(registrations.commands, \"commands\");\n  record(commands.overrides, \"commands\");\n  record(commands.handlers, \"commands\");\n  record(registrations.flags, \"schema\");\n  record(registrations.item_fields, \"schema\");\n  record(registrations.item_types, \"schema\");\n  record(registrations.migrations, \"schema\");\n  record(registrations.importers, \"importers\");\n  record(registrations.exporters, \"importers\");\n  record(registrations.search_providers, \"search\");\n  record(registrations.vector_store_adapters, \"search\");\n  record(parsers.overrides, \"parser\");\n  record(preflight.overrides, \"preflight\");\n  record(services.overrides, \"services\");\n  record(renderers.overrides, \"renderers\");\n  record(hooks.beforeCommand, \"hooks\");\n  record(hooks.afterCommand, \"hooks\");\n  record(hooks.onWrite, \"hooks\");\n  record(hooks.onRead, \"hooks\");\n  record(hooks.onIndex, \"hooks\");\n  return usage;\n}\n\n/**\n * Collect the known capabilities exercised across an activation result.\n *\n * Without {@link CollectUsedExtensionCapabilitiesOptions.extensionName} the\n * result unions every extension in the activation; with it, only the matching\n * extension's registrations contribute (across both layers).\n */\nexport function collectUsedExtensionCapabilities(\n  activation: ExtensionActivationResult,\n  options: CollectUsedExtensionCapabilitiesOptions = {},\n): ExtensionCapability[] {\n  const usage = attributeCapabilityUsage(activation);\n  const filter = options.extensionName !== undefined ? normalizeExtensionName(options.extensionName) : null;\n  const used = new Set<ExtensionCapability>();\n  for (const [key, capabilities] of usage) {\n    if (filter !== null && usageKeyName(key) !== filter) {\n      continue;\n    }\n    for (const capability of capabilities) {\n      used.add(capability);\n    }\n  }\n  return [...used].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Reconcile each loaded extension's declared capabilities against what it\n * exercised during activation.\n *\n * Extensions with no known declared capabilities are skipped — there is nothing\n * to reconcile. The returned entries preserve every reconcilable extension even\n * when `unused` is empty so callers can report fully-minimal manifests too.\n */\nexport function reconcileExtensionCapabilityUsage(\n  loaded: ReadonlyArray<{ layer: ExtensionLayer; name: string; capabilities?: readonly string[] }>,\n  activation: ExtensionActivationResult,\n): ExtensionCapabilityUsageReconciliation[] {\n  const usage = attributeCapabilityUsage(activation);\n  const reconciliations: ExtensionCapabilityUsageReconciliation[] = [];\n  for (const extension of loaded) {\n    const declared = normalizeDeclaredCapabilities(extension.capabilities);\n    if (declared.length === 0) {\n      continue;\n    }\n    const exercised = usage.get(usageKey(extension.layer, extension.name)) ?? new Set<ExtensionCapability>();\n    const used = [...exercised].sort((left, right) => left.localeCompare(right));\n    const unused = declared.filter((capability) => !exercised.has(capability));\n    reconciliations.push({ layer: extension.layer, name: extension.name, declared, used, unused });\n  }\n  return reconciliations;\n}\n"],"names":[],"mappings":"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","debugId":"f6134b79-a7d0-57d9-b25a-8e3e7b4af416"}
+{"version":3,"file":"capability-usage.js","sources":["core/extensions/capability-usage.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/capability-usage\n *\n * Reconciles the capabilities an extension manifest *declares* against the\n * capabilities it actually *exercises* during activation.\n *\n * The loader already enforces the opposite direction — registering a surface\n * whose capability is absent from `manifest.capabilities` throws an\n * `extension_capability_missing` activation failure. This module closes the\n * least-privilege loop by detecting capabilities a manifest declares but never\n * registers against, so package authors can trim manifests to the minimum\n * grant. Every declared-but-unused capability is an over-broad permission a\n * reviewer would otherwise have to catch by hand.\n */\nimport type { ExtensionActivationResult, ExtensionCapability, ExtensionLayer } from \"./extension-types.js\";\nimport { normalizeKnownExtensionCapability } from \"./extension-capability-aliases.js\";\n\n/**\n * Canonical map from each known extension capability to the human-readable\n * registration surfaces that exercise it.\n *\n * The `satisfies Record<ExtensionCapability, ...>` guard makes this exhaustive\n * at compile time: adding a capability to `KNOWN_EXTENSION_CAPABILITIES`\n * without giving it a registration surface here fails the build, which prevents\n * a capability that has *no* surface from being perpetually flagged as unused.\n */\nexport const EXTENSION_CAPABILITY_REGISTRATION_SURFACES = {\n  commands: [\"registerCommand\", \"command override\", \"command handler\"],\n  renderers: [\"registerRenderer\"],\n  hooks: [\"hooks.beforeCommand\", \"hooks.afterCommand\", \"hooks.onWrite\", \"hooks.onRead\", \"hooks.onIndex\"],\n  schema: [\"registerFlags\", \"registerItemFields\", \"registerItemTypes\", \"registerMigration\", \"registerProfile\"],\n  importers: [\"registerImporter\", \"registerExporter\"],\n  search: [\"registerSearchProvider\", \"registerVectorStoreAdapter\"],\n  parser: [\"registerParser\"],\n  preflight: [\"registerPreflight\"],\n  services: [\"registerService\"],\n} as const satisfies Record<ExtensionCapability, readonly string[]>;\n\n/**\n * Per-extension reconciliation of declared versus exercised capabilities.\n */\nexport interface ExtensionCapabilityUsageReconciliation {\n  /** Layer the extension was loaded from (`global` or `project`). */\n  layer: ExtensionLayer;\n  /** Extension name as it appears in the manifest. */\n  name: string;\n  /** Known capabilities declared in the manifest, sorted and de-duplicated. */\n  declared: ExtensionCapability[];\n  /** Known capabilities the extension actually registered against, sorted. */\n  used: ExtensionCapability[];\n  /** Declared capabilities with no matching registration (least-privilege gap). */\n  unused: ExtensionCapability[];\n}\n\n/**\n * Options for {@link collectUsedExtensionCapabilities}.\n */\nexport interface CollectUsedExtensionCapabilitiesOptions {\n  /**\n   * Restrict the result to a single extension by name. Names are matched\n   * case-insensitively after trimming. Omit to union across every extension in\n   * the activation result.\n   */\n  extensionName?: string;\n}\n\n// `layer` is a closed enum (`\"global\" | \"project\"`) that never contains a\n// colon, so the first colon always separates the layer from the (possibly\n// colon-bearing) name — making the key collision-proof without serialization.\nconst USAGE_KEY_SEPARATOR = \":\";\n\nfunction usageKey(layer: ExtensionLayer, name: string): string {\n  return `${layer}${USAGE_KEY_SEPARATOR}${normalizeExtensionName(name)}`;\n}\n\nfunction usageKeyName(key: string): string {\n  return key.slice(key.indexOf(USAGE_KEY_SEPARATOR) + 1);\n}\n\n/**\n * Canonical extension-name normalization (trim + lowercase) used to match an\n * `extensionName` filter against a registration's stored `name`.\n *\n * Activation stores `extension.name` verbatim — the synthetic test-activation\n * path (`activateExtensionForTest`) never trims it — so any helper that filters\n * by extension name must normalize both sides with this function to stay\n * consistent, including {@link ../extensions/activation-summary.js#describeExtensionActivation}.\n */\nexport function normalizeExtensionName(name: string): string {\n  return name.trim().toLowerCase();\n}\n\nfunction normalizeDeclaredCapabilities(capabilities: readonly string[] | undefined): ExtensionCapability[] {\n  if (!Array.isArray(capabilities)) {\n    return [];\n  }\n  const known = new Set<ExtensionCapability>();\n  for (const capability of capabilities) {\n    // Unknown capabilities are reported by the separate unknown-capability\n    // diagnostic; reconciling them here would double-report a typo as \"unused\".\n    const normalized = normalizeKnownExtensionCapability(capability);\n    if (normalized !== null) {\n      known.add(normalized);\n    }\n  }\n  return [...known].sort((left, right) => left.localeCompare(right));\n}\n\nfunction attributeCapabilityUsage(activation: ExtensionActivationResult): Map<string, Set<ExtensionCapability>> {\n  const usage = new Map<string, Set<ExtensionCapability>>();\n  const record = (\n    entries: ReadonlyArray<{ layer: ExtensionLayer; name: string }>,\n    capability: ExtensionCapability,\n  ): void => {\n    for (const entry of entries) {\n      const key = usageKey(entry.layer, entry.name);\n      let exercised = usage.get(key);\n      if (exercised === undefined) {\n        exercised = new Set<ExtensionCapability>();\n        usage.set(key, exercised);\n      }\n      exercised.add(capability);\n    }\n  };\n  const { registrations, commands, parsers, preflight, services, renderers, hooks } = activation;\n  record(registrations.commands, \"commands\");\n  record(commands.overrides, \"commands\");\n  record(commands.handlers, \"commands\");\n  record(registrations.flags, \"schema\");\n  record(registrations.item_fields, \"schema\");\n  record(registrations.item_types, \"schema\");\n  record(registrations.migrations, \"schema\");\n  record(registrations.profiles, \"schema\");\n  record(registrations.importers, \"importers\");\n  record(registrations.exporters, \"importers\");\n  record(registrations.search_providers, \"search\");\n  record(registrations.vector_store_adapters, \"search\");\n  record(parsers.overrides, \"parser\");\n  record(preflight.overrides, \"preflight\");\n  record(services.overrides, \"services\");\n  record(renderers.overrides, \"renderers\");\n  record(hooks.beforeCommand, \"hooks\");\n  record(hooks.afterCommand, \"hooks\");\n  record(hooks.onWrite, \"hooks\");\n  record(hooks.onRead, \"hooks\");\n  record(hooks.onIndex, \"hooks\");\n  return usage;\n}\n\n/**\n * Collect the known capabilities exercised across an activation result.\n *\n * Without {@link CollectUsedExtensionCapabilitiesOptions.extensionName} the\n * result unions every extension in the activation; with it, only the matching\n * extension's registrations contribute (across both layers).\n */\nexport function collectUsedExtensionCapabilities(\n  activation: ExtensionActivationResult,\n  options: CollectUsedExtensionCapabilitiesOptions = {},\n): ExtensionCapability[] {\n  const usage = attributeCapabilityUsage(activation);\n  const filter = options.extensionName !== undefined ? normalizeExtensionName(options.extensionName) : null;\n  const used = new Set<ExtensionCapability>();\n  for (const [key, capabilities] of usage) {\n    if (filter !== null && usageKeyName(key) !== filter) {\n      continue;\n    }\n    for (const capability of capabilities) {\n      used.add(capability);\n    }\n  }\n  return [...used].sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Reconcile each loaded extension's declared capabilities against what it\n * exercised during activation.\n *\n * Extensions with no known declared capabilities are skipped — there is nothing\n * to reconcile. The returned entries preserve every reconcilable extension even\n * when `unused` is empty so callers can report fully-minimal manifests too.\n */\nexport function reconcileExtensionCapabilityUsage(\n  loaded: ReadonlyArray<{ layer: ExtensionLayer; name: string; capabilities?: readonly string[] }>,\n  activation: ExtensionActivationResult,\n): ExtensionCapabilityUsageReconciliation[] {\n  const usage = attributeCapabilityUsage(activation);\n  const reconciliations: ExtensionCapabilityUsageReconciliation[] = [];\n  for (const extension of loaded) {\n    const declared = normalizeDeclaredCapabilities(extension.capabilities);\n    if (declared.length === 0) {\n      continue;\n    }\n    const exercised = usage.get(usageKey(extension.layer, extension.name)) ?? new Set<ExtensionCapability>();\n    const used = [...exercised].sort((left, right) => left.localeCompare(right));\n    const unused = declared.filter((capability) => !exercised.has(capability));\n    reconciliations.push({ layer: extension.layer, name: extension.name, declared, used, unused });\n  }\n  return reconciliations;\n}\n"],"names":[],"mappings":"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","debugId":"7cc05bac-f673-59a1-9d51-64361cf5a939"}

package/dist/core/extensions/extension-registries.js

@@ -2,7 +2,7 @@
  * Implements create empty extension hook registry for the public runtime surface of this module.
  */
 
-!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]="2520e0b0-3e9e-5f16-93a0-c0e45fc8bb8f")}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]="dcfdfd88-3d2a-57c9-9873-d8d7d9cf339d")}catch(e){}}();
 export function createEmptyExtensionHookRegistry() {
     return {
         beforeCommand: [],
@@ -63,6 +63,7 @@ export function createEmptyExtensionRegistrationRegistry() {
         item_fields: [],
         item_types: [],
         migrations: [],
+        profiles: [],
         importers: [],
         exporters: [],
         search_providers: [],
@@ -70,4 +71,4 @@ export function createEmptyExtensionRegistrationRegistry() {
     };
 }
 //# sourceMappingURL=extension-registries.js.map
-//# debugId=2520e0b0-3e9e-5f16-93a0-c0e45fc8bb8f
+//# debugId=dcfdfd88-3d2a-57c9-9873-d8d7d9cf339d

package/dist/core/extensions/extension-registries.js.map

@@ -1 +1 @@
-{"version":3,"file":"extension-registries.js","sources":["core/extensions/extension-registries.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/extension-registries\n *\n * Implements extension runtime contracts and governance for Extension Registries.\n */\nimport type {\n  ExtensionHookRegistry,\n  ExtensionCommandRegistry,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionServiceRegistry,\n  ExtensionRendererRegistry,\n  ExtensionRegistrationRegistry,\n} from \"./extension-types.js\";\n\n/**\n * Implements create empty extension hook registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionHookRegistry(): ExtensionHookRegistry {\n  return {\n    beforeCommand: [],\n    afterCommand: [],\n    onWrite: [],\n    onRead: [],\n    onIndex: [],\n  };\n}\n\n/**\n * Implements create empty extension command registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionCommandRegistry(): ExtensionCommandRegistry {\n  return {\n    overrides: [],\n    handlers: [],\n  };\n}\n\n/**\n * Implements create empty extension parser registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionParserRegistry(): ExtensionParserRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension preflight registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionPreflightRegistry(): ExtensionPreflightRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension service registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionServiceRegistry(): ExtensionServiceRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension renderer registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionRendererRegistry(): ExtensionRendererRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension registration registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionRegistrationRegistry(): ExtensionRegistrationRegistry {\n  return {\n    commands: [],\n    flags: [],\n    item_fields: [],\n    item_types: [],\n    migrations: [],\n    importers: [],\n    exporters: [],\n    search_providers: [],\n    vector_store_adapters: [],\n  };\n}\n"],"names":[],"mappings":"AAeA;;GAEG;;;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC;IACnD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC;IAClD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wCAAwC;IACtD,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,EAAE;QACpB,qBAAqB,EAAE,EAAE;KAC1B,CAAC;AACJ,CAAC","debugId":"2520e0b0-3e9e-5f16-93a0-c0e45fc8bb8f"}
+{"version":3,"file":"extension-registries.js","sources":["core/extensions/extension-registries.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module core/extensions/extension-registries\n *\n * Implements extension runtime contracts and governance for Extension Registries.\n */\nimport type {\n  ExtensionHookRegistry,\n  ExtensionCommandRegistry,\n  ExtensionParserRegistry,\n  ExtensionPreflightRegistry,\n  ExtensionServiceRegistry,\n  ExtensionRendererRegistry,\n  ExtensionRegistrationRegistry,\n} from \"./extension-types.js\";\n\n/**\n * Implements create empty extension hook registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionHookRegistry(): ExtensionHookRegistry {\n  return {\n    beforeCommand: [],\n    afterCommand: [],\n    onWrite: [],\n    onRead: [],\n    onIndex: [],\n  };\n}\n\n/**\n * Implements create empty extension command registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionCommandRegistry(): ExtensionCommandRegistry {\n  return {\n    overrides: [],\n    handlers: [],\n  };\n}\n\n/**\n * Implements create empty extension parser registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionParserRegistry(): ExtensionParserRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension preflight registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionPreflightRegistry(): ExtensionPreflightRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension service registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionServiceRegistry(): ExtensionServiceRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension renderer registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionRendererRegistry(): ExtensionRendererRegistry {\n  return {\n    overrides: [],\n  };\n}\n\n/**\n * Implements create empty extension registration registry for the public runtime surface of this module.\n */\nexport function createEmptyExtensionRegistrationRegistry(): ExtensionRegistrationRegistry {\n  return {\n    commands: [],\n    flags: [],\n    item_fields: [],\n    item_types: [],\n    migrations: [],\n    profiles: [],\n    importers: [],\n    exporters: [],\n    search_providers: [],\n    vector_store_adapters: [],\n  };\n}\n"],"names":[],"mappings":"AAeA;;GAEG;;;AACH,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,aAAa,EAAE,EAAE;QACjB,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,MAAM,EAAE,EAAE;QACV,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kCAAkC;IAChD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qCAAqC;IACnD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oCAAoC;IAClD,OAAO;QACL,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wCAAwC;IACtD,OAAO;QACL,QAAQ,EAAE,EAAE;QACZ,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,EAAE;QACf,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;QACZ,SAAS,EAAE,EAAE;QACb,SAAS,EAAE,EAAE;QACb,gBAAgB,EAAE,EAAE;QACpB,qBAAqB,EAAE,EAAE;KAC1B,CAAC;AACJ,CAAC","debugId":"dcfdfd88-3d2a-57c9-9873-d8d7d9cf339d"}