@unbrained/pm-cli 2026.5.24 → 2026.5.28

package/dist/core/extensions/extension-capability-aliases.js

@@ -0,0 +1,159 @@
+
+!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]="05fd9473-dd6f-5618-89e3-8746ce68e4e0")}catch(e){}}();
+import { KNOWN_EXTENSION_CAPABILITIES, EXTENSION_CAPABILITY_CONTRACT_VERSION, EXTENSION_CAPABILITY_LEGACY_ALIASES, } from "./extension-types.js";
+export function normalizeNames(values) {
+    return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((a, b) => a.localeCompare(b));
+}
+export function isKnownExtensionCapability(value) {
+    return KNOWN_EXTENSION_CAPABILITIES.includes(value);
+}
+export function collectUnknownExtensionCapabilities(capabilities) {
+    return capabilities.filter((capability) => !isKnownExtensionCapability(capability));
+}
+export function resolveLegacyExtensionCapabilityAlias(capability) {
+    const normalized = capability.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return null;
+    }
+    return EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized] ?? null;
+}
+export function normalizeManifestCapabilities(rawCapabilities) {
+    const normalizedCapabilities = normalizeNames([...rawCapabilities].map((value) => value.toLowerCase()));
+    const remappedCapabilities = [];
+    const legacyAliases = [];
+    for (const capability of normalizedCapabilities) {
+        const legacyAliasTarget = resolveLegacyExtensionCapabilityAlias(capability);
+        if (legacyAliasTarget) {
+            remappedCapabilities.push(legacyAliasTarget);
+            legacyAliases.push({
+                alias: capability,
+                target: legacyAliasTarget,
+            });
+            continue;
+        }
+        remappedCapabilities.push(capability);
+    }
+    const dedupedLegacyAliases = [...new Map(legacyAliases.map((entry) => [`${entry.alias}>${entry.target}`, entry])).values()].sort((left, right) => left.alias.localeCompare(right.alias));
+    return {
+        capabilities: normalizeNames(remappedCapabilities),
+        legacy_aliases: dedupedLegacyAliases,
+    };
+}
+function levenshteinDistance(left, right) {
+    if (left === right) {
+        return 0;
+    }
+    if (left.length === 0) {
+        return right.length;
+    }
+    if (right.length === 0) {
+        return left.length;
+    }
+    const previous = new Array(right.length + 1);
+    const current = new Array(right.length + 1);
+    for (let j = 0; j <= right.length; j += 1) {
+        previous[j] = j;
+    }
+    for (let i = 1; i <= left.length; i += 1) {
+        current[0] = i;
+        for (let j = 1; j <= right.length; j += 1) {
+            const substitutionCost = left[i - 1] === right[j - 1] ? 0 : 1;
+            current[j] = Math.min(previous[j] + 1, current[j - 1] + 1, previous[j - 1] + substitutionCost);
+        }
+        for (let j = 0; j <= right.length; j += 1) {
+            previous[j] = current[j];
+        }
+    }
+    return previous[right.length] ?? left.length;
+}
+export function suggestKnownExtensionCapability(capability) {
+    const normalized = capability.trim().toLowerCase();
+    if (normalized.length === 0) {
+        return null;
+    }
+    const legacyAlias = resolveLegacyExtensionCapabilityAlias(normalized);
+    if (legacyAlias) {
+        return legacyAlias;
+    }
+    let bestMatch = null;
+    let bestDistance = Number.POSITIVE_INFINITY;
+    for (const candidate of KNOWN_EXTENSION_CAPABILITIES) {
+        const distance = levenshteinDistance(normalized, candidate);
+        if (distance < bestDistance) {
+            bestDistance = distance;
+            bestMatch = candidate;
+        }
+    }
+    const maxDistance = Math.max(1, Math.floor(normalized.length * 0.34));
+    return bestMatch !== null && bestDistance <= maxDistance ? bestMatch : null;
+}
+export function formatUnknownExtensionCapabilityWarning(layer, name, capability) {
+    const allowed = KNOWN_EXTENSION_CAPABILITIES.join(",");
+    const suggested = suggestKnownExtensionCapability(capability) ?? "none";
+    return `extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`;
+}
+export function formatLegacyExtensionCapabilityAliasWarning(layer, name, aliases) {
+    const aliasesToken = aliases.map((entry) => `${entry.alias}>${entry.target}`).join(",");
+    return `extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`;
+}
+export function parseUnknownExtensionCapabilityWarning(warning) {
+    const match = /^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(warning.trim());
+    if (!match) {
+        return null;
+    }
+    const [, layerRaw, name, capability, allowedRaw, suggestedRaw] = match;
+    const layer = layerRaw;
+    const allowed_capabilities = allowedRaw
+        .split(",")
+        .map((value) => value.trim())
+        .filter((value) => value.length > 0);
+    const legacyAlias = resolveLegacyExtensionCapabilityAlias(capability);
+    const suggestedFromWarning = suggestedRaw === "none" ? undefined : suggestedRaw;
+    const suggested_capability = suggestedFromWarning ?? legacyAlias ?? undefined;
+    const suggestion_source = suggested_capability
+        ? legacyAlias === suggested_capability
+            ? "legacy_alias"
+            : "nearest_match"
+        : undefined;
+    return {
+        layer,
+        name,
+        capability,
+        allowed_capabilities,
+        capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
+        suggested_capability,
+        suggestion_source,
+        legacy_alias_target: legacyAlias ?? undefined,
+    };
+}
+export function parseLegacyExtensionCapabilityAliasWarning(warning) {
+    const match = /^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());
+    if (!match) {
+        return [];
+    }
+    const [, layerRaw, name, aliasesRaw] = match;
+    const layer = layerRaw;
+    const allowedCapabilities = [...KNOWN_EXTENSION_CAPABILITIES];
+    const parsed = [];
+    for (const token of aliasesRaw.split(",")) {
+        const [rawAlias, rawTarget] = token.split(">");
+        const alias = rawAlias?.trim();
+        const target = rawTarget?.trim().toLowerCase();
+        if (!alias || !target || !isKnownExtensionCapability(target)) {
+            continue;
+        }
+        parsed.push({
+            layer,
+            name,
+            capability: alias,
+            allowed_capabilities: allowedCapabilities,
+            capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,
+            suggested_capability: target,
+            suggestion_source: "legacy_alias",
+            legacy_alias_target: target,
+        });
+    }
+    return parsed;
+}
+//# sourceMappingURL=extension-capability-aliases.js.map
+//# debugId=05fd9473-dd6f-5618-89e3-8746ce68e4e0

package/dist/core/extensions/extension-capability-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-capability-aliases.js","sources":["core/extensions/extension-capability-aliases.ts"],"sourceRoot":"/","sourcesContent":["import {\n  KNOWN_EXTENSION_CAPABILITIES,\n  EXTENSION_CAPABILITY_CONTRACT_VERSION,\n  EXTENSION_CAPABILITY_LEGACY_ALIASES,\n  type ExtensionCapability,\n  type ExtensionLayer,\n  type LegacyExtensionCapabilityAliasMapping,\n  type UnknownExtensionCapabilityWarningDetails,\n} from \"./extension-types.js\";\n\nexport function normalizeNames(values: string[]): string[] {\n  return [...new Set(values.map((value) => value.trim()).filter((value) => value.length > 0))].sort((a, b) =>\n    a.localeCompare(b),\n  );\n}\n\nexport function isKnownExtensionCapability(value: string): value is ExtensionCapability {\n  return (KNOWN_EXTENSION_CAPABILITIES as readonly string[]).includes(value);\n}\n\nexport function collectUnknownExtensionCapabilities(capabilities: readonly string[]): string[] {\n  return capabilities.filter((capability) => !isKnownExtensionCapability(capability));\n}\n\nexport function resolveLegacyExtensionCapabilityAlias(capability: string): ExtensionCapability | null {\n  const normalized = capability.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return null;\n  }\n  return EXTENSION_CAPABILITY_LEGACY_ALIASES[normalized] ?? null;\n}\n\nexport function normalizeManifestCapabilities(rawCapabilities: readonly string[]): {\n  capabilities: string[];\n  legacy_aliases: LegacyExtensionCapabilityAliasMapping[];\n} {\n  const normalizedCapabilities = normalizeNames([...rawCapabilities].map((value) => value.toLowerCase()));\n  const remappedCapabilities: string[] = [];\n  const legacyAliases: LegacyExtensionCapabilityAliasMapping[] = [];\n  for (const capability of normalizedCapabilities) {\n    const legacyAliasTarget = resolveLegacyExtensionCapabilityAlias(capability);\n    if (legacyAliasTarget) {\n      remappedCapabilities.push(legacyAliasTarget);\n      legacyAliases.push({\n        alias: capability,\n        target: legacyAliasTarget,\n      });\n      continue;\n    }\n    remappedCapabilities.push(capability);\n  }\n  const dedupedLegacyAliases = [...new Map(legacyAliases.map((entry) => [`${entry.alias}>${entry.target}`, entry])).values()].sort(\n    (left, right) => left.alias.localeCompare(right.alias),\n  );\n  return {\n    capabilities: normalizeNames(remappedCapabilities),\n    legacy_aliases: dedupedLegacyAliases,\n  };\n}\n\nfunction levenshteinDistance(left: string, right: string): number {\n  if (left === right) {\n    return 0;\n  }\n  if (left.length === 0) {\n    return right.length;\n  }\n  if (right.length === 0) {\n    return left.length;\n  }\n  const previous = new Array<number>(right.length + 1);\n  const current = new Array<number>(right.length + 1);\n  for (let j = 0; j <= right.length; j += 1) {\n    previous[j] = j;\n  }\n  for (let i = 1; i <= left.length; i += 1) {\n    current[0] = i;\n    for (let j = 1; j <= right.length; j += 1) {\n      const substitutionCost = left[i - 1] === right[j - 1] ? 0 : 1;\n      current[j] = Math.min(\n        previous[j] + 1,\n        current[j - 1] + 1,\n        previous[j - 1] + substitutionCost,\n      );\n    }\n    for (let j = 0; j <= right.length; j += 1) {\n      previous[j] = current[j];\n    }\n  }\n  return previous[right.length] ?? left.length;\n}\n\nexport function suggestKnownExtensionCapability(capability: string): string | null {\n  const normalized = capability.trim().toLowerCase();\n  if (normalized.length === 0) {\n    return null;\n  }\n  const legacyAlias = resolveLegacyExtensionCapabilityAlias(normalized);\n  if (legacyAlias) {\n    return legacyAlias;\n  }\n  let bestMatch: string | null = null;\n  let bestDistance = Number.POSITIVE_INFINITY;\n  for (const candidate of KNOWN_EXTENSION_CAPABILITIES) {\n    const distance = levenshteinDistance(normalized, candidate);\n    if (distance < bestDistance) {\n      bestDistance = distance;\n      bestMatch = candidate;\n    }\n  }\n  const maxDistance = Math.max(1, Math.floor(normalized.length * 0.34));\n  return bestMatch !== null && bestDistance <= maxDistance ? bestMatch : null;\n}\n\nexport function formatUnknownExtensionCapabilityWarning(layer: ExtensionLayer, name: string, capability: string): string {\n  const allowed = KNOWN_EXTENSION_CAPABILITIES.join(\",\");\n  const suggested = suggestKnownExtensionCapability(capability) ?? \"none\";\n  return `extension_capability_unknown:${layer}:${name}:${capability}:allowed=${allowed}:suggested=${suggested}`;\n}\n\nexport function formatLegacyExtensionCapabilityAliasWarning(\n  layer: ExtensionLayer,\n  name: string,\n  aliases: readonly LegacyExtensionCapabilityAliasMapping[],\n): string {\n  const aliasesToken = aliases.map((entry) => `${entry.alias}>${entry.target}`).join(\",\");\n  return `extension_capability_legacy_alias:${layer}:${name}:aliases=${aliasesToken}`;\n}\n\n\nexport function parseUnknownExtensionCapabilityWarning(\n  warning: string,\n): UnknownExtensionCapabilityWarningDetails | null {\n  const match = /^extension_capability_unknown:(global|project):([^:]+):([^:]+):allowed=([^:]+):suggested=([^:]+)$/.exec(\n    warning.trim(),\n  );\n  if (!match) {\n    return null;\n  }\n  const [, layerRaw, name, capability, allowedRaw, suggestedRaw] = match;\n  const layer = layerRaw as ExtensionLayer;\n  const allowed_capabilities = allowedRaw\n    .split(\",\")\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n  const legacyAlias = resolveLegacyExtensionCapabilityAlias(capability);\n  const suggestedFromWarning = suggestedRaw === \"none\" ? undefined : suggestedRaw;\n  const suggested_capability = suggestedFromWarning ?? legacyAlias ?? undefined;\n  const suggestion_source = suggested_capability\n    ? legacyAlias === suggested_capability\n      ? \"legacy_alias\"\n      : \"nearest_match\"\n    : undefined;\n  return {\n    layer,\n    name,\n    capability,\n    allowed_capabilities,\n    capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,\n    suggested_capability,\n    suggestion_source,\n    legacy_alias_target: legacyAlias ?? undefined,\n  };\n}\n\nexport function parseLegacyExtensionCapabilityAliasWarning(warning: string): UnknownExtensionCapabilityWarningDetails[] {\n  const match = /^extension_capability_legacy_alias:(global|project):([^:]+):aliases=(.+)$/.exec(warning.trim());\n  if (!match) {\n    return [];\n  }\n  const [, layerRaw, name, aliasesRaw] = match;\n  const layer = layerRaw as ExtensionLayer;\n  const allowedCapabilities = [...KNOWN_EXTENSION_CAPABILITIES];\n  const parsed: UnknownExtensionCapabilityWarningDetails[] = [];\n  for (const token of aliasesRaw.split(\",\")) {\n    const [rawAlias, rawTarget] = token.split(\">\");\n    const alias = rawAlias?.trim();\n    const target = rawTarget?.trim().toLowerCase();\n    if (!alias || !target || !isKnownExtensionCapability(target)) {\n      continue;\n    }\n    parsed.push({\n      layer,\n      name,\n      capability: alias,\n      allowed_capabilities: allowedCapabilities,\n      capability_contract_version: EXTENSION_CAPABILITY_CONTRACT_VERSION,\n      suggested_capability: target,\n      suggestion_source: \"legacy_alias\",\n      legacy_alias_target: target,\n    });\n  }\n  return parsed;\n}\n"],"names":[],"mappings":"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","debugId":"05fd9473-dd6f-5618-89e3-8746ce68e4e0"}

package/dist/core/extensions/extension-hook-runtime.d.ts

@@ -0,0 +1,13 @@
+import type { ExtensionHookRegistry, BeforeCommandHookContext, AfterCommandHookContext, OnWriteHookContext, OnReadHookContext, OnIndexHookContext, ExtensionCommandRegistry, CommandHandlerContext, CommandHandlerResult, ExtensionParserRegistry, ParserOverrideContext, ParserOverrideResult, ExtensionPreflightRegistry, PreflightOverrideContext, PreflightOverrideResult, ExtensionServiceRegistry, ServiceOverrideContext, ServiceOverrideResult, CommandOverrideContext, CommandOverrideResult, ExtensionRendererRegistry, RendererOverrideContext, RendererOverrideResult } from "./extension-types.js";
+export declare function runBeforeCommandHooks(hooks: ExtensionHookRegistry, context: BeforeCommandHookContext): Promise<string[]>;
+export declare function runAfterCommandHooks(hooks: ExtensionHookRegistry, context: AfterCommandHookContext): Promise<string[]>;
+export declare function runOnWriteHooks(hooks: ExtensionHookRegistry, context: OnWriteHookContext): Promise<string[]>;
+export declare function runOnReadHooks(hooks: ExtensionHookRegistry, context: OnReadHookContext): Promise<string[]>;
+export declare function runOnIndexHooks(hooks: ExtensionHookRegistry, context: OnIndexHookContext): Promise<string[]>;
+export declare function runCommandHandler(commands: ExtensionCommandRegistry, context: CommandHandlerContext): Promise<CommandHandlerResult>;
+export declare function runParserOverride(parsers: ExtensionParserRegistry, context: ParserOverrideContext): Promise<ParserOverrideResult>;
+export declare function runPreflightOverride(preflight: ExtensionPreflightRegistry, context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
+export declare function runServiceOverrideSync(services: ExtensionServiceRegistry, context: ServiceOverrideContext): ServiceOverrideResult;
+export declare function runServiceOverride(services: ExtensionServiceRegistry, context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
+export declare function runCommandOverride(commands: ExtensionCommandRegistry, context: CommandOverrideContext): CommandOverrideResult;
+export declare function runRendererOverride(renderers: ExtensionRendererRegistry, context: RendererOverrideContext): RendererOverrideResult;

package/dist/core/extensions/extension-hook-runtime.js

@@ -0,0 +1,414 @@
+
+!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]="015da859-473a-5b98-b534-a4edbfae0dd7")}catch(e){}}();
+import { cloneCommandOptionsSnapshot, cloneContextSnapshot, cloneGlobalOptionsSnapshot, normalizeCommandName, } from "./extension-runtime-helpers.js";
+async function executeRegisteredHooks(entries, hookName, context) {
+    const warnings = [];
+    for (const entry of entries) {
+        try {
+            await entry.run(cloneContextSnapshot(context));
+        }
+        catch {
+            warnings.push(`extension_hook_failed:${entry.layer}:${entry.name}:${hookName}`);
+        }
+    }
+    return warnings;
+}
+export async function runBeforeCommandHooks(hooks, context) {
+    return executeRegisteredHooks(hooks.beforeCommand, "beforeCommand", context);
+}
+export async function runAfterCommandHooks(hooks, context) {
+    return executeRegisteredHooks(hooks.afterCommand, "afterCommand", context);
+}
+export async function runOnWriteHooks(hooks, context) {
+    return executeRegisteredHooks(hooks.onWrite, "onWrite", context);
+}
+export async function runOnReadHooks(hooks, context) {
+    return executeRegisteredHooks(hooks.onRead, "onRead", context);
+}
+export async function runOnIndexHooks(hooks, context) {
+    return executeRegisteredHooks(hooks.onIndex, "onIndex", context);
+}
+/**
+ * Normalize an extension handler failure into a single-line, length-bounded
+ * message so the real cause can be surfaced to the user/CI without leaking
+ * multi-line stack noise or unbounded payloads.
+ */
+function describeHandlerError(error) {
+    let raw = "";
+    if (error instanceof Error && typeof error.message === "string") {
+        raw = error.message;
+    }
+    else if (typeof error === "string") {
+        raw = error;
+    }
+    else if (typeof error === "object" &&
+        error !== null &&
+        typeof error.message === "string") {
+        // Extensions may throw plain/serialized objects that carry a message but do
+        // not inherit from the base Error class.
+        raw = error.message;
+    }
+    const normalized = raw.replace(/\s+/gu, " ").trim();
+    if (normalized.length === 0) {
+        return "";
+    }
+    const maxLength = 300;
+    return normalized.length > maxLength ? `${normalized.slice(0, maxLength - 1)}…` : normalized;
+}
+export async function runCommandHandler(commands, context) {
+    const command = normalizeCommandName(context.command);
+    if (command.length === 0) {
+        return {
+            handled: false,
+            result: null,
+            warnings: [],
+        };
+    }
+    const matched = [...commands.handlers].reverse().find((entry) => entry.command === command);
+    if (!matched) {
+        return {
+            handled: false,
+            result: null,
+            warnings: [],
+        };
+    }
+    try {
+        const result = await matched.run({
+            command,
+            args: cloneContextSnapshot(context.args),
+            options: cloneContextSnapshot(context.options),
+            global: cloneContextSnapshot(context.global),
+            pm_root: context.pm_root,
+        });
+        return {
+            handled: true,
+            result,
+            warnings: [],
+        };
+    }
+    catch (error) {
+        const exitCode = typeof error === "object" && error !== null && "exitCode" in error
+            ? error.exitCode
+            : undefined;
+        if (typeof exitCode === "number" && Number.isFinite(exitCode)) {
+            throw error;
+        }
+        return {
+            handled: false,
+            result: null,
+            warnings: [`extension_command_handler_failed:${matched.layer}:${matched.name}:${matched.command}`],
+            errorMessage: describeHandlerError(error),
+        };
+    }
+}
+export async function runParserOverride(parsers, context) {
+    const command = normalizeCommandName(context.command);
+    if (command.length === 0) {
+        return {
+            overridden: false,
+            context: {
+                command,
+                args: cloneContextSnapshot(context.args),
+                options: cloneCommandOptionsSnapshot(context.options),
+                global: cloneGlobalOptionsSnapshot(context.global),
+                pm_root: context.pm_root,
+            },
+            warnings: [],
+        };
+    }
+    const matched = [...parsers.overrides].reverse().find((entry) => entry.command === command);
+    if (!matched) {
+        return {
+            overridden: false,
+            context: {
+                command,
+                args: cloneContextSnapshot(context.args),
+                options: cloneCommandOptionsSnapshot(context.options),
+                global: cloneGlobalOptionsSnapshot(context.global),
+                pm_root: context.pm_root,
+            },
+            warnings: [],
+        };
+    }
+    try {
+        const delta = (await Promise.resolve(matched.run({
+            command,
+            args: cloneContextSnapshot(context.args),
+            options: cloneCommandOptionsSnapshot(context.options),
+            global: cloneGlobalOptionsSnapshot(context.global),
+            pm_root: context.pm_root,
+        }))) ?? {};
+        const nextArgs = Array.isArray(delta.args) ? cloneContextSnapshot(delta.args) : cloneContextSnapshot(context.args);
+        const nextOptions = delta.options ? cloneCommandOptionsSnapshot(delta.options) : cloneCommandOptionsSnapshot(context.options);
+        const nextGlobal = delta.global ? cloneGlobalOptionsSnapshot(delta.global) : cloneGlobalOptionsSnapshot(context.global);
+        return {
+            overridden: true,
+            context: {
+                command,
+                args: nextArgs,
+                options: nextOptions,
+                global: nextGlobal,
+                pm_root: context.pm_root,
+            },
+            warnings: [],
+        };
+    }
+    catch {
+        return {
+            overridden: false,
+            context: {
+                command,
+                args: cloneContextSnapshot(context.args),
+                options: cloneCommandOptionsSnapshot(context.options),
+                global: cloneGlobalOptionsSnapshot(context.global),
+                pm_root: context.pm_root,
+            },
+            warnings: [`extension_parser_override_failed:${matched.layer}:${matched.name}:${matched.command}`],
+        };
+    }
+}
+export async function runPreflightOverride(preflight, context) {
+    const matched = [...preflight.overrides].reverse()[0];
+    const baseContext = {
+        command: normalizeCommandName(context.command),
+        args: cloneContextSnapshot(context.args),
+        options: cloneCommandOptionsSnapshot(context.options),
+        global: cloneGlobalOptionsSnapshot(context.global),
+        pm_root: context.pm_root,
+    };
+    const baseDecision = cloneContextSnapshot(context.decision);
+    if (!matched) {
+        return {
+            overridden: false,
+            context: baseContext,
+            decision: baseDecision,
+            warnings: [],
+        };
+    }
+    try {
+        const delta = (await Promise.resolve(matched.run({
+            command: baseContext.command,
+            args: cloneContextSnapshot(baseContext.args),
+            options: cloneCommandOptionsSnapshot(baseContext.options),
+            global: cloneGlobalOptionsSnapshot(baseContext.global),
+            pm_root: baseContext.pm_root,
+            decision: cloneContextSnapshot(baseDecision),
+        }))) ?? {};
+        const nextContext = {
+            command: baseContext.command,
+            args: Array.isArray(delta.args) ? cloneContextSnapshot(delta.args) : baseContext.args,
+            options: delta.options ? cloneCommandOptionsSnapshot(delta.options) : baseContext.options,
+            global: delta.global ? cloneGlobalOptionsSnapshot(delta.global) : baseContext.global,
+            pm_root: baseContext.pm_root,
+        };
+        const nextDecision = {
+            enforce_item_format_gate: typeof delta.enforce_item_format_gate === "boolean"
+                ? delta.enforce_item_format_gate
+                : baseDecision.enforce_item_format_gate,
+            run_preflight_item_format_sync: typeof delta.run_preflight_item_format_sync === "boolean"
+                ? delta.run_preflight_item_format_sync
+                : baseDecision.run_preflight_item_format_sync,
+            run_extension_migrations: typeof delta.run_extension_migrations === "boolean"
+                ? delta.run_extension_migrations
+                : baseDecision.run_extension_migrations,
+            enforce_mandatory_migration_gate: typeof delta.enforce_mandatory_migration_gate === "boolean"
+                ? delta.enforce_mandatory_migration_gate
+                : baseDecision.enforce_mandatory_migration_gate,
+        };
+        return {
+            overridden: true,
+            context: nextContext,
+            decision: nextDecision,
+            warnings: [],
+        };
+    }
+    catch {
+        return {
+            overridden: false,
+            context: baseContext,
+            decision: baseDecision,
+            warnings: [`extension_preflight_override_failed:${matched.layer}:${matched.name}`],
+        };
+    }
+}
+function resolveDefaultServiceResult(context) {
+    return {
+        handled: false,
+        result: context.payload,
+        warnings: [],
+    };
+}
+export function runServiceOverrideSync(services, context) {
+    const matches = [...services.overrides].reverse().filter((entry) => entry.service === context.service);
+    if (matches.length === 0) {
+        return resolveDefaultServiceResult(context);
+    }
+    const warnings = [];
+    for (const matched of matches) {
+        try {
+            const serviceContext = {
+                service: context.service,
+                command: context.command ? normalizeCommandName(context.command) : undefined,
+                args: context.args ? cloneContextSnapshot(context.args) : undefined,
+                options: context.options ? cloneCommandOptionsSnapshot(context.options) : undefined,
+                global: context.global ? cloneGlobalOptionsSnapshot(context.global) : undefined,
+                pm_root: context.pm_root,
+                payload: cloneContextSnapshot(context.payload),
+            };
+            const result = matched.run(serviceContext);
+            if (result instanceof Promise) {
+                warnings.push(`extension_service_override_async_unsupported:${matched.layer}:${matched.name}:${matched.service}`);
+                continue;
+            }
+            if (context.service === "output_format" && (result === null || result === undefined || result === serviceContext.payload)) {
+                continue;
+            }
+            return {
+                handled: true,
+                result,
+                warnings,
+            };
+        }
+        catch {
+            warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
+        }
+    }
+    return {
+        handled: false,
+        result: context.payload,
+        warnings,
+    };
+}
+export async function runServiceOverride(services, context) {
+    const matches = [...services.overrides].reverse().filter((entry) => entry.service === context.service);
+    if (matches.length === 0) {
+        return resolveDefaultServiceResult(context);
+    }
+    const warnings = [];
+    for (const matched of matches) {
+        try {
+            const serviceContext = {
+                service: context.service,
+                command: context.command ? normalizeCommandName(context.command) : undefined,
+                args: context.args ? cloneContextSnapshot(context.args) : undefined,
+                options: context.options ? cloneCommandOptionsSnapshot(context.options) : undefined,
+                global: context.global ? cloneGlobalOptionsSnapshot(context.global) : undefined,
+                pm_root: context.pm_root,
+                payload: cloneContextSnapshot(context.payload),
+            };
+            const result = await Promise.resolve(matched.run(serviceContext));
+            if (context.service === "output_format" && (result === null || result === undefined || result === serviceContext.payload)) {
+                continue;
+            }
+            return {
+                handled: true,
+                result,
+                warnings,
+            };
+        }
+        catch {
+            warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
+        }
+    }
+    return {
+        handled: false,
+        result: context.payload,
+        warnings,
+    };
+}
+export function runCommandOverride(commands, context) {
+    const command = normalizeCommandName(context.command);
+    if (command.length === 0) {
+        return {
+            overridden: false,
+            result: context.result,
+            warnings: [],
+        };
+    }
+    const matched = [...commands.overrides].reverse().find((entry) => entry.command === command);
+    if (!matched) {
+        return {
+            overridden: false,
+            result: context.result,
+            warnings: [],
+        };
+    }
+    try {
+        const overrideOptions = cloneCommandOptionsSnapshot(context.options);
+        const overrideGlobal = cloneGlobalOptionsSnapshot(context.global);
+        const overrideResult = matched.run({
+            command,
+            args: cloneContextSnapshot(context.args),
+            options: overrideOptions,
+            global: overrideGlobal,
+            pm_root: context.pm_root,
+            result: cloneContextSnapshot(context.result),
+        });
+        if (overrideResult instanceof Promise) {
+            return {
+                overridden: false,
+                result: context.result,
+                warnings: [`extension_command_override_async_unsupported:${matched.layer}:${matched.name}:${matched.command}`],
+            };
+        }
+        return {
+            overridden: true,
+            result: overrideResult,
+            warnings: [],
+        };
+    }
+    catch {
+        return {
+            overridden: false,
+            result: context.result,
+            warnings: [`extension_command_override_failed:${matched.layer}:${matched.name}:${matched.command}`],
+        };
+    }
+}
+export function runRendererOverride(renderers, context) {
+    const matched = [...renderers.overrides].reverse().find((entry) => entry.format === context.format);
+    if (!matched) {
+        return {
+            overridden: false,
+            rendered: null,
+            warnings: [],
+        };
+    }
+    try {
+        const rendererCommand = typeof context.command === "string" ? normalizeCommandName(context.command) : "";
+        const rendererArgs = Array.isArray(context.args) ? cloneContextSnapshot(context.args) : [];
+        const rendererOptions = cloneCommandOptionsSnapshot(context.options);
+        const rendererGlobal = cloneGlobalOptionsSnapshot(context.global);
+        const rendererPmRoot = typeof context.pm_root === "string" ? context.pm_root : "";
+        const rendered = matched.run({
+            format: context.format,
+            command: rendererCommand,
+            args: rendererArgs,
+            options: rendererOptions,
+            global: rendererGlobal,
+            pm_root: rendererPmRoot,
+            result: cloneContextSnapshot(context.result),
+        });
+        if (typeof rendered !== "string") {
+            return {
+                overridden: false,
+                rendered: null,
+                warnings: [`extension_renderer_invalid_result:${matched.layer}:${matched.name}:${matched.format}`],
+            };
+        }
+        return {
+            overridden: true,
+            rendered,
+            warnings: [],
+        };
+    }
+    catch {
+        return {
+            overridden: false,
+            rendered: null,
+            warnings: [`extension_renderer_failed:${matched.layer}:${matched.name}:${matched.format}`],
+        };
+    }
+}
+//# sourceMappingURL=extension-hook-runtime.js.map
+//# debugId=015da859-473a-5b98-b534-a4edbfae0dd7