@unbrained/pm-cli 2026.6.13 → 2026.6.16

package/dist/core/extensions/item-fields.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-fields.js","sources":["core/extensions/item-fields.ts"],"sourceRoot":"/","sourcesContent":["import type { ExtensionRegistrationRegistry } from \"./loader.js\";\nimport { normalizeItemFieldType, type KnownItemFieldType } from \"./item-field-types.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);\n\nfunction normalizeFieldName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeFieldType(value: unknown): KnownItemFieldType | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  return normalizeItemFieldType(value);\n}\n\nfunction cloneFieldValue<T>(value: T): T {\n  try {\n    return structuredClone(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction parseFieldAssignment(raw: string): { key: string; value: string } {\n  const trimmed = raw.trim();\n  const separatorIndex = trimmed.indexOf(\"=\");\n  if (separatorIndex <= 0) {\n    throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);\n  }\n  const key = trimmed.slice(0, separatorIndex).trim();\n  const value = trimmed.slice(separatorIndex + 1);\n  if (key.length === 0) {\n    throw new PmCliError(\"--field entries require a non-empty field name\", EXIT_CODE.USAGE);\n  }\n  return { key, value };\n}\n\nfunction parseJsonFieldValue(raw: string, fieldName: string, expectedType: \"array\" | \"object\"): unknown {\n  try {\n    const parsed = JSON.parse(raw);\n    if (expectedType === \"array\" && Array.isArray(parsed)) {\n      return parsed;\n    }\n    if (expectedType === \"object\" && typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Fall through to the typed usage error below.\n  }\n  throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);\n}\n\nfunction coerceRegisteredFieldValue(fieldName: string, fieldType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\", raw: string): unknown {\n  if (fieldType === \"string\") {\n    return raw;\n  }\n  if (fieldType === \"number\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    const parsed = Number(trimmed);\n    if (!Number.isFinite(parsed)) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n  if (fieldType === \"boolean\") {\n    const normalized = raw.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n      return false;\n    }\n    throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n  }\n  return parseJsonFieldValue(raw, fieldName, fieldType);\n}\n\nfunction collectRegisteredFieldDefinitions(\n  registrations: ExtensionRegistrationRegistry | null,\n): Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }> {\n  const definitions = new Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }>();\n  if (!registrations) {\n    return definitions;\n  }\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      const fieldType = normalizeFieldType(definition.type);\n      if (!fieldName || !fieldType) {\n        continue;\n      }\n      const existing = definitions.get(fieldName);\n      if (existing && existing.type !== fieldType) {\n        throw new PmCliError(\n          `Extension item field \"${fieldName}\" is declared with conflicting types: ${existing.type}, ${fieldType}`,\n          EXIT_CODE.USAGE,\n          {\n            code: \"extension_item_field_type_conflict\",\n            nextSteps: [\"Make every active extension declaration for this field use the same type.\"],\n          },\n        );\n      }\n      definitions.set(fieldName, { name: fieldName, type: fieldType });\n    }\n  }\n  return definitions;\n}\n\nfunction assertNotReservedItemFieldName(fieldName: string): void {\n  if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {\n    return;\n  }\n  throw new PmCliError(`Extension item field \"${fieldName}\" collides with reserved item metadata`, EXIT_CODE.USAGE, {\n    code: \"extension_item_field_reserved\",\n    nextSteps: [\"Rename the extension item field, preferably with an extension-specific prefix.\"],\n  });\n}\n\nexport function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[] {\n  return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));\n}\n\nexport function parseRegisteredItemFieldAssignments(\n  rawFields: string[] | undefined,\n  registrations: ExtensionRegistrationRegistry | null,\n): Record<string, unknown> {\n  if (!rawFields || rawFields.length === 0) {\n    return {};\n  }\n  const definitions = collectRegisteredFieldDefinitions(registrations);\n  const values: Record<string, unknown> = {};\n  for (const raw of rawFields) {\n    const { key, value } = parseFieldAssignment(raw);\n    const definition = definitions.get(key);\n    if (!definition) {\n      const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));\n      throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {\n        code: \"extension_item_field_unknown\",\n        recovery: { provided_fields: known },\n        nextSteps: known.length > 0\n          ? [`Use one of the declared fields: ${known.join(\", \")}`]\n          : [\"Activate an extension that calls registerItemFields before setting extension fields.\"],\n      });\n    }\n    assertNotReservedItemFieldName(definition.name);\n    values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);\n  }\n  return values;\n}\n\nfunction isValidFieldType(value: unknown, expectedType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\"): boolean {\n  if (expectedType === \"string\") {\n    return typeof value === \"string\";\n  }\n  if (expectedType === \"number\") {\n    return typeof value === \"number\" && Number.isFinite(value);\n  }\n  if (expectedType === \"boolean\") {\n    return typeof value === \"boolean\";\n  }\n  if (expectedType === \"array\") {\n    return Array.isArray(value);\n  }\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isAllowedFieldValue(value: unknown, allowed: unknown[] | undefined): boolean {\n  if (!allowed || allowed.length === 0) {\n    return true;\n  }\n  return allowed.some((candidate) => Object.is(candidate, value));\n}\n\nexport function applyRegisteredItemFieldDefaultsAndValidation(\n  frontMatter: Record<string, unknown>,\n  registrations: ExtensionRegistrationRegistry | null,\n  options: { skipDefaultFields?: ReadonlySet<string> } = {},\n): void {\n  if (!registrations) {\n    return;\n  }\n  collectRegisteredFieldDefinitions(registrations);\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      if (!fieldName) {\n        continue;\n      }\n      assertNotReservedItemFieldName(fieldName);\n      if (\n        !(fieldName in frontMatter) &&\n        !options.skipDefaultFields?.has(fieldName) &&\n        Object.prototype.hasOwnProperty.call(definition, \"default\")\n      ) {\n        frontMatter[fieldName] = cloneFieldValue(definition.default);\n      }\n\n      const currentValue = frontMatter[fieldName];\n      if (currentValue === undefined) {\n        continue;\n      }\n      const expectedType = normalizeFieldType(definition.type);\n      if (expectedType && !isValidFieldType(currentValue, expectedType)) {\n        throw new TypeError(`Item field \"${fieldName}\" must be of type ${expectedType}`);\n      }\n\n      const allowedValues = Array.isArray(definition.values) ? definition.values : undefined;\n      if (!isAllowedFieldValue(currentValue, allowedValues)) {\n        throw new TypeError(`Item field \"${fieldName}\" must match one of the configured allowed values`);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"1d92831e-54a7-5c1f-af04-7441908e8e5a"}
+{"version":3,"file":"item-fields.js","sources":["core/extensions/item-fields.ts"],"sourceRoot":"/","sourcesContent":["import type { ExtensionRegistrationRegistry } from \"./loader.js\";\nimport { normalizeItemFieldType, type KnownItemFieldType } from \"./item-field-types.js\";\nimport { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from \"../shared/constants.js\";\nimport { PmCliError } from \"../shared/errors.js\";\n\nconst RESERVED_ITEM_FIELD_NAMES = new Set(FRONT_MATTER_KEY_ORDER);\n\nfunction normalizeFieldName(value: unknown): string | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  const normalized = value.trim();\n  return normalized.length > 0 ? normalized : null;\n}\n\nfunction normalizeFieldType(value: unknown): KnownItemFieldType | null {\n  if (typeof value !== \"string\") {\n    return null;\n  }\n  return normalizeItemFieldType(value);\n}\n\nfunction cloneFieldValue<T>(value: T): T {\n  try {\n    return structuredClone(value);\n  } catch {\n    return value;\n  }\n}\n\nfunction parseFieldAssignment(raw: string): { key: string; value: string } {\n  const trimmed = raw.trim();\n  const separatorIndex = trimmed.indexOf(\"=\");\n  if (separatorIndex <= 0) {\n    throw new PmCliError(`--field entries must use name=value syntax, received: ${raw}`, EXIT_CODE.USAGE);\n  }\n  // `separatorIndex > 0` guarantees a non-`=` first character on the already\n  // trimmed string, so the trimmed key is always non-empty here.\n  const key = trimmed.slice(0, separatorIndex).trim();\n  const value = trimmed.slice(separatorIndex + 1);\n  return { key, value };\n}\n\nfunction parseJsonFieldValue(raw: string, fieldName: string, expectedType: \"array\" | \"object\"): unknown {\n  try {\n    const parsed = JSON.parse(raw);\n    if (expectedType === \"array\" && Array.isArray(parsed)) {\n      return parsed;\n    }\n    if (expectedType === \"object\" && typeof parsed === \"object\" && parsed !== null && !Array.isArray(parsed)) {\n      return parsed;\n    }\n  } catch {\n    // Fall through to the typed usage error below.\n  }\n  throw new PmCliError(`--field ${fieldName}=... must be valid JSON ${expectedType}`, EXIT_CODE.USAGE);\n}\n\nfunction coerceRegisteredFieldValue(fieldName: string, fieldType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\", raw: string): unknown {\n  if (fieldType === \"string\") {\n    return raw;\n  }\n  if (fieldType === \"number\") {\n    const trimmed = raw.trim();\n    if (trimmed.length === 0) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    const parsed = Number(trimmed);\n    if (!Number.isFinite(parsed)) {\n      throw new PmCliError(`--field ${fieldName}=... must be a number`, EXIT_CODE.USAGE);\n    }\n    return parsed;\n  }\n  if (fieldType === \"boolean\") {\n    const normalized = raw.trim().toLowerCase();\n    if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n      return true;\n    }\n    if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n      return false;\n    }\n    throw new PmCliError(`--field ${fieldName}=... must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n  }\n  return parseJsonFieldValue(raw, fieldName, fieldType);\n}\n\nfunction collectRegisteredFieldDefinitions(\n  registrations: ExtensionRegistrationRegistry | null,\n): Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }> {\n  const definitions = new Map<string, { name: string; type: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\" }>();\n  if (!registrations) {\n    return definitions;\n  }\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      const fieldType = normalizeFieldType(definition.type);\n      if (!fieldName || !fieldType) {\n        continue;\n      }\n      const existing = definitions.get(fieldName);\n      if (existing && existing.type !== fieldType) {\n        throw new PmCliError(\n          `Extension item field \"${fieldName}\" is declared with conflicting types: ${existing.type}, ${fieldType}`,\n          EXIT_CODE.USAGE,\n          {\n            code: \"extension_item_field_type_conflict\",\n            nextSteps: [\"Make every active extension declaration for this field use the same type.\"],\n          },\n        );\n      }\n      definitions.set(fieldName, { name: fieldName, type: fieldType });\n    }\n  }\n  return definitions;\n}\n\nfunction assertNotReservedItemFieldName(fieldName: string): void {\n  if (!RESERVED_ITEM_FIELD_NAMES.has(fieldName)) {\n    return;\n  }\n  throw new PmCliError(`Extension item field \"${fieldName}\" collides with reserved item metadata`, EXIT_CODE.USAGE, {\n    code: \"extension_item_field_reserved\",\n    nextSteps: [\"Rename the extension item field, preferably with an extension-specific prefix.\"],\n  });\n}\n\nexport function collectRegisteredItemFieldNames(registrations: ExtensionRegistrationRegistry | null): string[] {\n  return [...collectRegisteredFieldDefinitions(registrations).keys()].sort((left, right) => left.localeCompare(right));\n}\n\nexport function parseRegisteredItemFieldAssignments(\n  rawFields: string[] | undefined,\n  registrations: ExtensionRegistrationRegistry | null,\n): Record<string, unknown> {\n  if (!rawFields || rawFields.length === 0) {\n    return {};\n  }\n  const definitions = collectRegisteredFieldDefinitions(registrations);\n  const values: Record<string, unknown> = {};\n  for (const raw of rawFields) {\n    const { key, value } = parseFieldAssignment(raw);\n    const definition = definitions.get(key);\n    if (!definition) {\n      const known = [...definitions.keys()].sort((left, right) => left.localeCompare(right));\n      throw new PmCliError(`--field ${key} is not declared by an active extension item-field registration`, EXIT_CODE.USAGE, {\n        code: \"extension_item_field_unknown\",\n        recovery: { provided_fields: known },\n        nextSteps: known.length > 0\n          ? [`Use one of the declared fields: ${known.join(\", \")}`]\n          : [\"Activate an extension that calls registerItemFields before setting extension fields.\"],\n      });\n    }\n    assertNotReservedItemFieldName(definition.name);\n    values[definition.name] = coerceRegisteredFieldValue(definition.name, definition.type, value);\n  }\n  return values;\n}\n\nfunction isValidFieldType(value: unknown, expectedType: \"string\" | \"number\" | \"boolean\" | \"array\" | \"object\"): boolean {\n  if (expectedType === \"string\") {\n    return typeof value === \"string\";\n  }\n  if (expectedType === \"number\") {\n    return typeof value === \"number\" && Number.isFinite(value);\n  }\n  if (expectedType === \"boolean\") {\n    return typeof value === \"boolean\";\n  }\n  if (expectedType === \"array\") {\n    return Array.isArray(value);\n  }\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isAllowedFieldValue(value: unknown, allowed: unknown[] | undefined): boolean {\n  if (!allowed || allowed.length === 0) {\n    return true;\n  }\n  return allowed.some((candidate) => Object.is(candidate, value));\n}\n\nexport function applyRegisteredItemFieldDefaultsAndValidation(\n  frontMatter: Record<string, unknown>,\n  registrations: ExtensionRegistrationRegistry | null,\n  options: { skipDefaultFields?: ReadonlySet<string> } = {},\n): void {\n  if (!registrations) {\n    return;\n  }\n  collectRegisteredFieldDefinitions(registrations);\n  for (const registration of registrations.item_fields) {\n    for (const definition of registration.fields) {\n      const fieldName = normalizeFieldName(definition.name);\n      if (!fieldName) {\n        continue;\n      }\n      assertNotReservedItemFieldName(fieldName);\n      if (\n        !(fieldName in frontMatter) &&\n        !options.skipDefaultFields?.has(fieldName) &&\n        Object.prototype.hasOwnProperty.call(definition, \"default\")\n      ) {\n        frontMatter[fieldName] = cloneFieldValue(definition.default);\n      }\n\n      const currentValue = frontMatter[fieldName];\n      if (currentValue === undefined) {\n        continue;\n      }\n      const expectedType = normalizeFieldType(definition.type);\n      if (expectedType && !isValidFieldType(currentValue, expectedType)) {\n        throw new TypeError(`Item field \"${fieldName}\" must be of type ${expectedType}`);\n      }\n\n      const allowedValues = Array.isArray(definition.values) ? definition.values : undefined;\n      if (!isAllowedFieldValue(currentValue, allowedValues)) {\n        throw new TypeError(`Item field \"${fieldName}\" must match one of the configured allowed values`);\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"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","debugId":"a347b372-2690-5b65-a35c-7d2cfa3790d1"}

package/dist/core/extensions/loader.d.ts

@@ -1,14 +1,31 @@
+import { type NormalizedExtensionPolicy } from "./extension-policy.js";
 export { parseUnknownExtensionCapabilityWarning, parseLegacyExtensionCapabilityAliasWarning, } from "./extension-capability-aliases.js";
 export { createEmptyExtensionHookRegistry, createEmptyExtensionCommandRegistry, createEmptyExtensionParserRegistry, createEmptyExtensionPreflightRegistry, createEmptyExtensionServiceRegistry, createEmptyExtensionRendererRegistry, createEmptyExtensionRegistrationRegistry, } from "./extension-registries.js";
 export { runBeforeCommandHooks, runAfterCommandHooks, runOnWriteHooks, runOnReadHooks, runOnIndexHooks, runCommandHandler, runParserOverride, runPreflightOverride, runServiceOverrideSync, runServiceOverride, runCommandOverride, runRendererOverride, } from "./extension-hook-runtime.js";
-import { type ExtensionDeactivationOptions, type ExtensionDeactivationResult, type ExtensionDiscoveryResult, type ExtensionLoadResult, type ExtensionActivationResult, type DiscoverExtensionsOptions } from "./extension-types.js";
+import { type ExtensionDeactivationOptions, type ExtensionDeactivationResult, type PmMaxVersionExceededMode, type ExtensionLayer, type ExtensionManifest, type EffectiveExtension, type ExtensionDiscoveryResult, type LoadedExtension, type ExtensionLoadResult, type ExtensionHookRegistry, type ExtensionCommandArgumentDefinition, type ExtensionCommandRegistry, type ExtensionParserRegistry, type ExtensionPreflightRegistry, type ExtensionServiceRegistry, type ExtensionRendererRegistry, type ExtensionRegistrationRegistry, type ExtensionRegistrationCounts, type ExtensionApi, type ExtensionActivationFailureTrace, type ExtensionActivationResult, type DiscoverExtensionsOptions } from "./extension-types.js";
 export * from "./extension-types.js";
 export declare function nextExtensionReloadToken(seed?: number): string;
+declare function parseManifest(raw: unknown): ExtensionManifest | null;
 export declare function resolveExtensionRoots(pmRoot: string, cwd?: string): {
     global: string;
     project: string;
 };
+declare function readManagedExtensionSourcePackages(extensionsRoot: string): Promise<Map<string, string>>;
 export declare function discoverExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionDiscoveryResult>;
+declare function parseComparableVersion(value: string): number[] | null;
+declare function compareComparableVersions(currentVersion: string, minimumVersion: string): number | null;
+declare function readCurrentPmCliVersion(): Promise<string | null>;
+declare function resolveCurrentPmCliVersion(): Promise<string | null>;
+declare function evaluatePmMinVersionCompatibility(layer: ExtensionLayer, manifest: ExtensionManifest): Promise<{
+    allowed: boolean;
+    warning?: string;
+}>;
+declare function evaluatePmMaxVersionCompatibility(layer: ExtensionLayer, manifest: ExtensionManifest, exceededMode: PmMaxVersionExceededMode): Promise<{
+    allowed: boolean;
+    warning?: string;
+}>;
+declare function fingerprintPath(pathToInspect: string): Promise<string>;
+declare function resolveExtensionImportHref(extension: EffectiveExtension, options: DiscoverExtensionsOptions): Promise<string>;
 export declare function loadExtensions(options: DiscoverExtensionsOptions): Promise<ExtensionLoadResult>;
 /**
  * Run the optional `deactivate` teardown hook for every loaded extension that
@@ -25,4 +42,61 @@ export declare function loadExtensions(options: DiscoverExtensionsOptions): Prom
  * warnings/failures preserve loaded order.
  */
 export declare function deactivateExtensions(loadResult: ExtensionLoadResult, activationResult?: Pick<ExtensionActivationResult, "failed">, options?: ExtensionDeactivationOptions): Promise<ExtensionDeactivationResult>;
+declare function normalizeExtensionDeactivateTimeout(rawTimeout: unknown): number;
+declare function sanitizeRegistrationValue(value: unknown): unknown;
+declare function createRegistrationValidationError(message: string, trace: ExtensionActivationFailureTrace): TypeError;
+declare function extractRegistrationValidationTrace(error: unknown): ExtensionActivationFailureTrace | undefined;
+declare function normalizeRegistrationRecord(name: string, value: unknown): Record<string, unknown>;
+declare function normalizeRuntimeRegistrationRecord(name: string, value: unknown): Record<string, unknown>;
+declare function normalizeRegistrationRecordList(name: string, value: unknown): Array<Record<string, unknown>>;
+declare function assertOptionalStringField(name: string, value: unknown): void;
+declare function normalizeOptionalStringArrayField(name: string, value: unknown): string[];
+declare function resolveCommandDefinitionAction(commandPath: string, action: unknown): string;
+declare function normalizeCommandDefinitionArguments(value: unknown): ExtensionCommandArgumentDefinition[];
+/**
+ * Reject a declared `value_type`/`type` that is not a known flag value kind, and
+ * a `default` whose value(s) would not cleanly coerce under that kind — so the
+ * typed-flag contract is enforced at registration instead of silently leaving
+ * an untyped value to surface at use time.
+ */
+declare function assertFlagValueTypeAndDefault(label: string, record: Record<string, unknown>): void;
+declare function validateItemFieldDefinitions(fields: unknown): void;
+declare function createExtensionApi(extension: LoadedExtension, hooks: ExtensionHookRegistry, commands: ExtensionCommandRegistry, parsers: ExtensionParserRegistry, preflight: ExtensionPreflightRegistry, services: ExtensionServiceRegistry, renderers: ExtensionRendererRegistry, registrations: ExtensionRegistrationRegistry, activationWarnings: string[], policy: NormalizedExtensionPolicy): ExtensionApi;
+declare function getRegistrationCounts(registrations: ExtensionRegistrationRegistry): ExtensionRegistrationCounts;
+declare function collectCommandCollisionWarnings(commands: ExtensionCommandRegistry): string[];
+declare function collectRendererCollisionWarnings(renderers: ExtensionRendererRegistry): string[];
+declare function collectParserCollisionWarnings(parsers: ExtensionParserRegistry): string[];
+declare function collectServiceCollisionWarnings(services: ExtensionServiceRegistry): string[];
 export declare function activateExtensions(loadResult: ExtensionLoadResult): Promise<ExtensionActivationResult>;
+export declare const _testOnlyLoader: {
+    assertFlagValueTypeAndDefault: typeof assertFlagValueTypeAndDefault;
+    assertOptionalStringField: typeof assertOptionalStringField;
+    compareComparableVersions: typeof compareComparableVersions;
+    collectCommandCollisionWarnings: typeof collectCommandCollisionWarnings;
+    collectParserCollisionWarnings: typeof collectParserCollisionWarnings;
+    collectRendererCollisionWarnings: typeof collectRendererCollisionWarnings;
+    collectServiceCollisionWarnings: typeof collectServiceCollisionWarnings;
+    createExtensionApi: typeof createExtensionApi;
+    createRegistrationValidationError: typeof createRegistrationValidationError;
+    evaluatePmMaxVersionCompatibility: typeof evaluatePmMaxVersionCompatibility;
+    evaluatePmMinVersionCompatibility: typeof evaluatePmMinVersionCompatibility;
+    extractRegistrationValidationTrace: typeof extractRegistrationValidationTrace;
+    fingerprintPath: typeof fingerprintPath;
+    getRegistrationCounts: typeof getRegistrationCounts;
+    normalizeCommandDefinitionArguments: typeof normalizeCommandDefinitionArguments;
+    normalizeExtensionDeactivateTimeout: typeof normalizeExtensionDeactivateTimeout;
+    normalizeOptionalStringArrayField: typeof normalizeOptionalStringArrayField;
+    normalizeRegistrationRecord: typeof normalizeRegistrationRecord;
+    normalizeRegistrationRecordList: typeof normalizeRegistrationRecordList;
+    normalizeRuntimeRegistrationRecord: typeof normalizeRuntimeRegistrationRecord;
+    parseComparableVersion: typeof parseComparableVersion;
+    parseManifest: typeof parseManifest;
+    readCurrentPmCliVersion: typeof readCurrentPmCliVersion;
+    readManagedExtensionSourcePackages: typeof readManagedExtensionSourcePackages;
+    resolveExtensionImportHref: typeof resolveExtensionImportHref;
+    resolveCurrentPmCliVersion: typeof resolveCurrentPmCliVersion;
+    resolveCommandDefinitionAction: typeof resolveCommandDefinitionAction;
+    sanitizeRegistrationValue: typeof sanitizeRegistrationValue;
+    validateItemFieldDefinitions: typeof validateItemFieldDefinitions;
+    resetCurrentPmCliVersionCacheForTest: () => void;
+};

package/dist/core/extensions/loader.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]="19026387-34f8-5e8e-b936-4fc13489f244")}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]="5c5ced45-c38c-562e-a71b-e38fc696239f")}catch(e){}}();
 import fs from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
@@ -287,7 +287,7 @@ function summarizeCandidate(candidate) {
         capabilities: [...candidate.manifest.capabilities],
         activation: candidate.manifest.activation
             ? {
-                commands: [...(candidate.manifest.activation.commands ?? [])],
+                commands: [...candidate.manifest.activation.commands],
             }
             : undefined,
     };
@@ -551,7 +551,7 @@ function formatUnknownError(error) {
 }
 function parseComparableVersion(value) {
     const normalized = value.trim().replace(/^>=\s*/, "").replace(/^v/i, "");
-    const release = normalized.split(/[+-]/, 1)[0] ?? "";
+    const release = normalized.split(/[+-]/, 1)[0];
     if (!/^\d+(?:[.-]\d+)*$/.test(release)) {
         return null;
     }
@@ -853,9 +853,7 @@ async function runExtensionDeactivateWithTimeout(deactivate, timeoutMs) {
         ]);
     }
     finally {
-        if (timeoutHandle) {
-            clearTimeout(timeoutHandle);
-        }
+        clearTimeout(timeoutHandle);
     }
 }
 function isOutputRendererFormat(value) {
@@ -1084,25 +1082,18 @@ function normalizeCommandDefinitionArguments(value) {
             definition.variadic = true;
         }
         if (typeof record.description === "string") {
-            const trimmedDescription = record.description.trim();
-            if (trimmedDescription.length > 0) {
-                definition.description = trimmedDescription;
-            }
+            definition.description = record.description.trim();
         }
         normalized.push(definition);
     }
-    let variadicCount = 0;
-    for (const [index, argument] of normalized.entries()) {
-        if (!argument.variadic) {
-            continue;
-        }
-        variadicCount += 1;
-        if (variadicCount > 1) {
-            throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");
-        }
-        if (index !== normalized.length - 1) {
-            throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");
-        }
+    const variadicIndexes = normalized
+        .map((argument, index) => (argument.variadic ? index : -1))
+        .filter((index) => index >= 0);
+    if (variadicIndexes.length > 1) {
+        throw new TypeError("registerCommand definition.arguments supports at most one variadic argument");
+    }
+    if (variadicIndexes.length === 1 && variadicIndexes[0] !== normalized.length - 1) {
+        throw new TypeError("registerCommand definition.arguments variadic argument must be the final argument");
     }
     return normalized;
 }
@@ -1270,7 +1261,7 @@ function assertExtensionCapability(extension, capability, method) {
             capability,
             missing_capability: capability,
             expected_schema: `"capabilities": [..., "${capability}"]`,
-            received: extension.capabilities ?? [],
+            received: extension.capabilities,
             hint: `Add "${capability}" to ${extension.name} manifest capabilities, or remove the ${method} registration call.`,
         });
     }
@@ -1404,7 +1395,7 @@ function createExtensionApi(extension, hooks, commands, parsers, preflight, serv
             registrations.commands.push(registration);
         }
         catch (error) {
-            const reason = error instanceof Error ? error.message : "registerCommand definition validation failed";
+            const reason = formatUnknownError(error);
             const trace = registerCommandTrace("definition", normalizedCommand, "{ name: string; run: (context) => unknown; action?: string; arguments?: object[]; flags?: object[]; }", commandOrDefinition, "Use schema-style metadata (action/arguments/flags/examples/intent) with valid values.");
             throw createRegistrationValidationError(`registerCommand definition metadata invalid (command="${normalizedCommand}", registration_index=${trace.registration_index}): ${reason}`, trace);
         }
@@ -1785,7 +1776,7 @@ function collectCommandCollisionWarnings(commands) {
             grouped.set(entry.command, bucket);
         }
         for (const command of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-            const bucket = grouped.get(command) ?? [];
+            const bucket = grouped.get(command);
             if (bucket.length <= 1) {
                 continue;
             }
@@ -1798,9 +1789,8 @@ function collectCommandCollisionWarnings(commands) {
     collectByCommand(commands.handlers, "extension_command_handler_collision");
     collectByCommand(commands.overrides, "extension_command_override_collision");
     const handlerCommands = new Set(commands.handlers.map((entry) => entry.command));
-    const overlapCommands = [...new Set(commands.overrides.map((entry) => entry.command))]
-        .filter((command) => handlerCommands.has(command))
-        .sort((left, right) => left.localeCompare(right));
+    const overlapCommands = [...new Set(commands.overrides.map((entry) => entry.command))].filter((command) => handlerCommands.has(command));
+    overlapCommands.sort((left, right) => left.localeCompare(right));
     for (const command of overlapCommands) {
         const handlers = commands.handlers.filter((entry) => entry.command === command);
         const overrides = commands.overrides.filter((entry) => entry.command === command);
@@ -1821,7 +1811,7 @@ function collectRendererCollisionWarnings(renderers) {
     }
     const warnings = [];
     for (const format of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-        const bucket = grouped.get(format) ?? [];
+        const bucket = grouped.get(format);
         if (bucket.length <= 1) {
             continue;
         }
@@ -1841,7 +1831,7 @@ function collectParserCollisionWarnings(parsers) {
         grouped.set(entry.command, bucket);
     }
     for (const command of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-        const bucket = grouped.get(command) ?? [];
+        const bucket = grouped.get(command);
         if (bucket.length <= 1) {
             continue;
         }
@@ -1873,7 +1863,7 @@ function collectServiceCollisionWarnings(services) {
         grouped.set(entry.service, bucket);
     }
     for (const service of [...grouped.keys()].sort((left, right) => left.localeCompare(right))) {
-        const bucket = grouped.get(service) ?? [];
+        const bucket = grouped.get(service);
         if (bucket.length <= 1) {
             continue;
         }
@@ -1952,5 +1942,39 @@ export async function activateExtensions(loadResult) {
         registration_counts: getRegistrationCounts(registrations),
     };
 }
+export const _testOnlyLoader = {
+    assertFlagValueTypeAndDefault,
+    assertOptionalStringField,
+    compareComparableVersions,
+    collectCommandCollisionWarnings,
+    collectParserCollisionWarnings,
+    collectRendererCollisionWarnings,
+    collectServiceCollisionWarnings,
+    createExtensionApi,
+    createRegistrationValidationError,
+    evaluatePmMaxVersionCompatibility,
+    evaluatePmMinVersionCompatibility,
+    extractRegistrationValidationTrace,
+    fingerprintPath,
+    getRegistrationCounts,
+    normalizeCommandDefinitionArguments,
+    normalizeExtensionDeactivateTimeout,
+    normalizeOptionalStringArrayField,
+    normalizeRegistrationRecord,
+    normalizeRegistrationRecordList,
+    normalizeRuntimeRegistrationRecord,
+    parseComparableVersion,
+    parseManifest,
+    readCurrentPmCliVersion,
+    readManagedExtensionSourcePackages,
+    resolveExtensionImportHref,
+    resolveCurrentPmCliVersion,
+    resolveCommandDefinitionAction,
+    sanitizeRegistrationValue,
+    validateItemFieldDefinitions,
+    resetCurrentPmCliVersionCacheForTest: () => {
+        currentPmCliVersionPromise = null;
+    },
+};
 //# sourceMappingURL=loader.js.map
-//# debugId=19026387-34f8-5e8e-b936-4fc13489f244
+//# debugId=5c5ced45-c38c-562e-a71b-e38fc696239f