@unbrained/pm-cli 2026.9.7 → 2026.9.8

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

@@ -1,700 +1,2 @@
-/**
- * @module core/extensions/extension-hook-runtime
- *
- * Implements extension runtime contracts and governance for Extension Hook Runtime.
- */
-
-!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]="d1dd5d4f-5f08-5e52-b109-d066f92ae3b3")}catch(e){}}();
-import { cloneCommandOptionsSnapshot, cloneContextSnapshot, cloneGlobalOptionsSnapshot, normalizeCommandName, } from "./extension-runtime-helpers.js";
-import { stableValueEquals } from "../shared/serialization.js";
-import { EXIT_CODE } from "../shared/constants.js";
-import { PmCliError } from "../shared/errors.js";
-const DEFAULT_MUTATION_GUARD_TIMEOUT_MS = 5_000;
-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;
-}
-/** Implements run before command hooks for the public runtime surface of this module. */
-export async function runBeforeCommandHooks(hooks, context) {
-    return executeRegisteredHooks(hooks.beforeCommand, "beforeCommand", context);
-}
-/** Reject malformed or denied mutation-guard decisions with stable extension diagnostics. */
-function enforceMutationGuardDecision(decision, entry, operation) {
-    if (decision === undefined)
-        return;
-    if (typeof decision !== "object" ||
-        decision === null ||
-        !("allow" in decision) ||
-        decision.allow !== true &&
-            decision.allow !== false) {
-        throw new PmCliError(`Extension mutation guard ${entry.name} returned an invalid decision.`, EXIT_CODE.CONFLICT, {
-            code: "extension_mutation_guard_invalid_decision",
-            reason: `${entry.layer}:${entry.name}`,
-            nextSteps: ["Return { allow: true } or a structured denial from the guard."],
-        });
-    }
-    if (decision.allow)
-        return;
-    const denial = decision;
-    const code = typeof denial.code === "string" ? denial.code.trim() : "";
-    const remediation = typeof denial.remediation === "string" ? denial.remediation.trim() : "";
-    if (code.length === 0 || remediation.length === 0) {
-        throw new PmCliError(`Extension mutation guard ${entry.name} returned an invalid denial.`, EXIT_CODE.CONFLICT, {
-            code: "extension_mutation_guard_invalid_denial",
-            reason: `${entry.layer}:${entry.name}`,
-            nextSteps: ["Return non-empty code and remediation fields from the guard."],
-        });
-    }
-    const message = typeof denial.message === "string" ? denial.message.trim() : "";
-    throw new PmCliError(message || `Extension mutation guard ${entry.name} denied ${operation}.`, EXIT_CODE.CONFLICT, {
-        code,
-        reason: `${entry.layer}:${entry.name}`,
-        nextSteps: [remediation],
-    });
-}
-/** Run every transactional mutation guard in registration order and fail closed on denial or failure. */
-export async function runBeforeMutationHooks(hooks, context) {
-    for (const entry of hooks.beforeMutation ?? []) {
-        let decision;
-        let timeoutHandle;
-        try {
-            const guardPromise = Promise.resolve().then(() => entry.run({
-                pm_root: context.pm_root,
-                operation: context.operation,
-                before: context.before === null
-                    ? null
-                    : cloneContextSnapshot(context.before),
-                after: context.after === null
-                    ? null
-                    : cloneContextSnapshot(context.after),
-                changed_fields: [...context.changed_fields],
-                sdk: context.sdk,
-            }));
-            guardPromise.catch(() => { });
-            decision = await Promise.race([
-                guardPromise,
-                new Promise((_, reject) => {
-                    timeoutHandle = setTimeout(() => {
-                        reject(new PmCliError(`Extension mutation guard ${entry.name} timed out before ${context.operation}.`, EXIT_CODE.CONFLICT, {
-                            code: "extension_mutation_guard_timed_out",
-                            reason: `${entry.layer}:${entry.name}`,
-                            nextSteps: [
-                                "Fix or disable the stalled extension guard, then retry the mutation.",
-                            ],
-                        }));
-                    }, DEFAULT_MUTATION_GUARD_TIMEOUT_MS);
-                    timeoutHandle.unref?.();
-                }),
-            ]);
-        }
-        catch (error) {
-            if (error instanceof PmCliError)
-                throw error;
-            throw new PmCliError(`Extension mutation guard ${entry.name} failed before ${context.operation}.`, EXIT_CODE.CONFLICT, {
-                code: "extension_mutation_guard_failed",
-                reason: `${entry.layer}:${entry.name}`,
-                nextSteps: ["Fix or disable the failing extension guard, then retry the mutation."],
-            });
-        }
-        finally {
-            clearTimeout(timeoutHandle);
-        }
-        enforceMutationGuardDecision(decision, entry, context.operation);
-    }
-}
-/** Implements run after command hooks for the public runtime surface of this module. */
-export async function runAfterCommandHooks(hooks, context) {
-    return executeRegisteredHooks(hooks.afterCommand, "afterCommand", context);
-}
-/** Implements run on write hooks for the public runtime surface of this module. */
-export async function runOnWriteHooks(hooks, context) {
-    return executeRegisteredHooks(hooks.onWrite, "onWrite", context);
-}
-/** Implements run on read hooks for the public runtime surface of this module. */
-export async function runOnReadHooks(hooks, context) {
-    return executeRegisteredHooks(hooks.onRead, "onRead", context);
-}
-/** Implements run on index hooks for the public runtime surface of this module. */
-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;
-}
-/** Read one bounded string field from an extension result or thrown value. */
-function readHandlerStringField(value, field) {
-    if (typeof value !== "object" ||
-        value === null ||
-        typeof value[field] !== "string") {
-        return undefined;
-    }
-    const normalized = String(value[field])
-        .replace(/\s+/gu, " ")
-        .trim();
-    return normalized.length > 0 ? normalized.slice(0, 300) : undefined;
-}
-/** Validate an optional structured extension result exit code. */
-function readHandlerResultExitCode(result) {
-    if (typeof result !== "object" ||
-        result === null ||
-        !Object.hasOwn(result, "exit_code")) {
-        return undefined;
-    }
-    const exitCode = result.exit_code;
-    if (typeof exitCode !== "number" ||
-        !Number.isInteger(exitCode) ||
-        exitCode < 1 ||
-        exitCode > 255) {
-        throw new TypeError("Extension command result exit_code must be an integer from 1 to 255.");
-    }
-    return exitCode;
-}
-/** Implements run command handler for the public runtime surface of this module. */
-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,
-            source_workspace_root: context.source_workspace_root,
-            repo_root: context.repo_root,
-            pm_root_rel: context.pm_root_rel,
-            ...(context.sdk === undefined ? {} : { sdk: context.sdk }),
-        });
-        return {
-            handled: true,
-            result,
-            warnings: [],
-            ...Object.fromEntries([
-                ["exitCode", readHandlerResultExitCode(result)],
-                ["errorCode", readHandlerStringField(result, "code")],
-                ["remediation", readHandlerStringField(result, "remediation")],
-            ].filter((entry) => entry[1] !== undefined)),
-        };
-    }
-    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),
-            ...Object.fromEntries([
-                ["errorCode", readHandlerStringField(error, "code")],
-                ["remediation", readHandlerStringField(error, "remediation")],
-            ].filter((entry) => entry[1] !== undefined)),
-        };
-    }
-}
-/** Implements run parser override for the public runtime surface of this module. */
-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,
-                source_workspace_root: context.source_workspace_root,
-                repo_root: context.repo_root,
-                pm_root_rel: context.pm_root_rel,
-            },
-            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,
-                source_workspace_root: context.source_workspace_root,
-                repo_root: context.repo_root,
-                pm_root_rel: context.pm_root_rel,
-            },
-            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,
-            source_workspace_root: context.source_workspace_root,
-            repo_root: context.repo_root,
-            pm_root_rel: context.pm_root_rel,
-        }))) ?? {};
-        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,
-                source_workspace_root: context.source_workspace_root,
-                repo_root: context.repo_root,
-                pm_root_rel: context.pm_root_rel,
-            },
-            warnings: [],
-        };
-    }
-    catch {
-        return {
-            overridden: false,
-            context: {
-                command,
-                args: cloneContextSnapshot(context.args),
-                options: cloneCommandOptionsSnapshot(context.options),
-                global: cloneGlobalOptionsSnapshot(context.global),
-                pm_root: context.pm_root,
-                source_workspace_root: context.source_workspace_root,
-                repo_root: context.repo_root,
-                pm_root_rel: context.pm_root_rel,
-            },
-            warnings: [
-                `extension_parser_override_failed:${matched.layer}:${matched.name}:${matched.command}`,
-            ],
-        };
-    }
-}
-/** Implements run preflight override for the public runtime surface of this module. */
-export async function runPreflightOverride(preflight, context) {
-    const baseContext = {
-        command: normalizeCommandName(context.command),
-        args: cloneContextSnapshot(context.args),
-        options: cloneCommandOptionsSnapshot(context.options),
-        global: cloneGlobalOptionsSnapshot(context.global),
-        pm_root: context.pm_root,
-        source_workspace_root: context.source_workspace_root,
-        repo_root: context.repo_root,
-        pm_root_rel: context.pm_root_rel,
-    };
-    const baseDecision = cloneContextSnapshot(context.decision);
-    const matched = [...preflight.overrides]
-        .reverse()
-        .find((entry) => !entry.commands?.length || entry.commands.includes(baseContext.command));
-    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,
-            source_workspace_root: baseContext.source_workspace_root,
-            repo_root: baseContext.repo_root,
-            pm_root_rel: baseContext.pm_root_rel,
-            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,
-            source_workspace_root: baseContext.source_workspace_root,
-            repo_root: baseContext.repo_root,
-            pm_root_rel: baseContext.pm_root_rel,
-        };
-        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: [],
-    };
-}
-function matchingServiceOverrides(services, service) {
-    return [...services.overrides]
-        .reverse()
-        .filter((entry) => entry.service === service);
-}
-function buildServiceOverrideContext(context) {
-    return {
-        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,
-        source_workspace_root: context.source_workspace_root,
-        repo_root: context.repo_root,
-        pm_root_rel: context.pm_root_rel,
-        payload: cloneContextSnapshot(context.payload),
-    };
-}
-function isServiceOverrideDecision(value) {
-    if (typeof value !== "object" ||
-        value === null ||
-        !Object.hasOwn(value, "handled")) {
-        return false;
-    }
-    const handled = value.handled;
-    return handled === true
-        ? Object.hasOwn(value, "result")
-        : handled === false && Reflect.ownKeys(value).length === 1;
-}
-function resolveServiceOverrideValue(result, context) {
-    if (isServiceOverrideDecision(result)) {
-        return result.handled
-            ? { handled: true, result: result.result }
-            : { handled: false, result: context.payload };
-    }
-    if (context.service === "output_format" &&
-        (result === null || result === undefined)) {
-        return { handled: false, result: context.payload };
-    }
-    return { handled: true, result };
-}
-function isLegacyOutputPayloadEcho(result, context, serviceContext) {
-    return (context.service === "output_format" &&
-        typeof result === "object" &&
-        result !== null &&
-        stableValueEquals(result, serviceContext.payload));
-}
-function resolveMatchedServiceDecision(matched, decision, warnings) {
-    if (!decision.handled) {
-        return undefined;
-    }
-    if (matched.passThrough === true) {
-        warnings.push(`extension_service_pass_through_contract_violated:${matched.layer}:${matched.name}:${matched.service}`);
-        return undefined;
-    }
-    return {
-        handled: true,
-        result: decision.result,
-        warnings,
-    };
-}
-/** Implements run service override sync for the public runtime surface of this module. */
-export function runServiceOverrideSync(services, context) {
-    const matches = matchingServiceOverrides(services, context.service);
-    if (matches.length === 0) {
-        return resolveDefaultServiceResult(context);
-    }
-    const warnings = [];
-    for (const matched of matches) {
-        try {
-            const serviceContext = buildServiceOverrideContext(context);
-            const result = matched.run(serviceContext);
-            if (result instanceof Promise) {
-                warnings.push(`extension_service_override_async_unsupported:${matched.layer}:${matched.name}:${matched.service}`);
-                continue;
-            }
-            if (isLegacyOutputPayloadEcho(result, context, serviceContext)) {
-                warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);
-                continue;
-            }
-            const resolved = resolveMatchedServiceDecision(matched, resolveServiceOverrideValue(result, context), warnings);
-            if (resolved)
-                return resolved;
-        }
-        catch {
-            warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
-        }
-    }
-    return {
-        handled: false,
-        result: context.payload,
-        warnings,
-    };
-}
-/** Implements run service override for the public runtime surface of this module. */
-export async function runServiceOverride(services, context) {
-    const matches = matchingServiceOverrides(services, context.service);
-    if (matches.length === 0) {
-        return resolveDefaultServiceResult(context);
-    }
-    const warnings = [];
-    for (const matched of matches) {
-        try {
-            const serviceContext = buildServiceOverrideContext(context);
-            const result = await Promise.resolve(matched.run(serviceContext));
-            if (isLegacyOutputPayloadEcho(result, context, serviceContext)) {
-                warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);
-                continue;
-            }
-            const resolved = resolveMatchedServiceDecision(matched, resolveServiceOverrideValue(result, context), warnings);
-            if (resolved)
-                return resolved;
-        }
-        catch {
-            warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`);
-        }
-    }
-    return {
-        handled: false,
-        result: context.payload,
-        warnings,
-    };
-}
-/** Implements run command override for the public runtime surface of this module. */
-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,
-            source_workspace_root: context.source_workspace_root,
-            repo_root: context.repo_root,
-            pm_root_rel: context.pm_root_rel,
-            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}`,
-            ],
-        };
-    }
-}
-function rendererOwnsContext(entry, command, result) {
-    if ((entry.commands?.length ?? 0) > 0 && !entry.commands?.includes(command)) {
-        return false;
-    }
-    if (entry.resultDiscriminator === undefined) {
-        return true;
-    }
-    try {
-        return entry.resultDiscriminator(cloneContextSnapshot(result));
-    }
-    catch {
-        return false;
-    }
-}
-/** Implements run renderer override for the public runtime surface of this module. */
-export function runRendererOverride(renderers, context) {
-    const rendererCommand = typeof context.command === "string"
-        ? normalizeCommandName(context.command)
-        : "";
-    const matched = [...renderers.overrides]
-        .reverse()
-        .find((entry) => entry.format === context.format &&
-        rendererOwnsContext(entry, rendererCommand, context.result));
-    if (!matched) {
-        return {
-            overridden: false,
-            rendered: null,
-            warnings: [],
-        };
-    }
-    try {
-        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,
-            source_workspace_root: context.source_workspace_root,
-            repo_root: context.repo_root,
-            pm_root_rel: context.pm_root_rel,
-            result: cloneContextSnapshot(context.result),
-        });
-        if (rendered === null || rendered === undefined) {
-            return {
-                overridden: false,
-                rendered: null,
-                warnings: [],
-            };
-        }
-        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}`,
-            ],
-        };
-    }
-}
+!(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]="736cf7fc-d4da-57ce-90d8-2432085dd2c8")}catch(e2){}})();import{cloneCommandOptionsSnapshot,cloneContextSnapshot,cloneGlobalOptionsSnapshot,normalizeCommandName}from"./extension-runtime-helpers.js";import{stableValueEquals}from"../shared/serialization.js";import{EXIT_CODE}from"../shared/constants.js";import{PmCliError}from"../shared/errors.js";const DEFAULT_MUTATION_GUARD_TIMEOUT_MS=5e3;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}async function runBeforeCommandHooks(hooks,context){return executeRegisteredHooks(hooks.beforeCommand,"beforeCommand",context)}function enforceMutationGuardDecision(decision,entry,operation){if(decision===void 0)return;if(typeof decision!=="object"||decision===null||!("allow"in decision)||decision.allow!==true&&decision.allow!==false){throw new PmCliError(`Extension mutation guard ${entry.name} returned an invalid decision.`,EXIT_CODE.CONFLICT,{code:"extension_mutation_guard_invalid_decision",reason:`${entry.layer}:${entry.name}`,nextSteps:["Return { allow: true } or a structured denial from the guard."]})}if(decision.allow)return;const denial=decision;const code=typeof denial.code==="string"?denial.code.trim():"";const remediation=typeof denial.remediation==="string"?denial.remediation.trim():"";if(code.length===0||remediation.length===0){throw new PmCliError(`Extension mutation guard ${entry.name} returned an invalid denial.`,EXIT_CODE.CONFLICT,{code:"extension_mutation_guard_invalid_denial",reason:`${entry.layer}:${entry.name}`,nextSteps:["Return non-empty code and remediation fields from the guard."]})}const message=typeof denial.message==="string"?denial.message.trim():"";throw new PmCliError(message||`Extension mutation guard ${entry.name} denied ${operation}.`,EXIT_CODE.CONFLICT,{code,reason:`${entry.layer}:${entry.name}`,nextSteps:[remediation]})}async function runBeforeMutationHooks(hooks,context){for(const entry of hooks.beforeMutation??[]){let decision;let timeoutHandle;try{const guardPromise=Promise.resolve().then(()=>entry.run({pm_root:context.pm_root,operation:context.operation,before:context.before===null?null:cloneContextSnapshot(context.before),after:context.after===null?null:cloneContextSnapshot(context.after),changed_fields:[...context.changed_fields],sdk:context.sdk}));guardPromise.catch(()=>{});decision=await Promise.race([guardPromise,new Promise((_,reject)=>{timeoutHandle=setTimeout(()=>{reject(new PmCliError(`Extension mutation guard ${entry.name} timed out before ${context.operation}.`,EXIT_CODE.CONFLICT,{code:"extension_mutation_guard_timed_out",reason:`${entry.layer}:${entry.name}`,nextSteps:["Fix or disable the stalled extension guard, then retry the mutation."]}))},DEFAULT_MUTATION_GUARD_TIMEOUT_MS);timeoutHandle.unref?.()})])}catch(error){if(error instanceof PmCliError)throw error;throw new PmCliError(`Extension mutation guard ${entry.name} failed before ${context.operation}.`,EXIT_CODE.CONFLICT,{code:"extension_mutation_guard_failed",reason:`${entry.layer}:${entry.name}`,nextSteps:["Fix or disable the failing extension guard, then retry the mutation."]})}finally{clearTimeout(timeoutHandle)}enforceMutationGuardDecision(decision,entry,context.operation)}}async function runAfterCommandHooks(hooks,context){return executeRegisteredHooks(hooks.afterCommand,"afterCommand",context)}async function runOnWriteHooks(hooks,context){return executeRegisteredHooks(hooks.onWrite,"onWrite",context)}async function runOnReadHooks(hooks,context){return executeRegisteredHooks(hooks.onRead,"onRead",context)}async function runOnIndexHooks(hooks,context){return executeRegisteredHooks(hooks.onIndex,"onIndex",context)}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"){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)}\u2026`:normalized}function readHandlerStringField(value,field){if(typeof value!=="object"||value===null||typeof value[field]!=="string"){return void 0}const normalized=String(value[field]).replace(/\s+/gu," ").trim();return normalized.length>0?normalized.slice(0,300):void 0}function readHandlerResultExitCode(result){if(typeof result!=="object"||result===null||!Object.hasOwn(result,"exit_code")){return void 0}const exitCode=result.exit_code;if(typeof exitCode!=="number"||!Number.isInteger(exitCode)||exitCode<1||exitCode>255){throw new TypeError("Extension command result exit_code must be an integer from 1 to 255.")}return exitCode}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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,...context.sdk===void 0?{}:{sdk:context.sdk}});return{handled:true,result,warnings:[],...Object.fromEntries([["exitCode",readHandlerResultExitCode(result)],["errorCode",readHandlerStringField(result,"code")],["remediation",readHandlerStringField(result,"remediation")]].filter(entry=>entry[1]!==void 0))}}catch(error){const exitCode=typeof error==="object"&&error!==null&&"exitCode"in error?error.exitCode:void 0;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),...Object.fromEntries([["errorCode",readHandlerStringField(error,"code")],["remediation",readHandlerStringField(error,"remediation")]].filter(entry=>entry[1]!==void 0))}}}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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel},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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel},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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel}))??{};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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel},warnings:[]}}catch{return{overridden:false,context:{command,args:cloneContextSnapshot(context.args),options:cloneCommandOptionsSnapshot(context.options),global:cloneGlobalOptionsSnapshot(context.global),pm_root:context.pm_root,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel},warnings:[`extension_parser_override_failed:${matched.layer}:${matched.name}:${matched.command}`]}}}async function runPreflightOverride(preflight,context){const baseContext={command:normalizeCommandName(context.command),args:cloneContextSnapshot(context.args),options:cloneCommandOptionsSnapshot(context.options),global:cloneGlobalOptionsSnapshot(context.global),pm_root:context.pm_root,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel};const baseDecision=cloneContextSnapshot(context.decision);const matched=[...preflight.overrides].reverse().find(entry=>!entry.commands?.length||entry.commands.includes(baseContext.command));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,source_workspace_root:baseContext.source_workspace_root,repo_root:baseContext.repo_root,pm_root_rel:baseContext.pm_root_rel,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,source_workspace_root:baseContext.source_workspace_root,repo_root:baseContext.repo_root,pm_root_rel:baseContext.pm_root_rel};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:[]}}function matchingServiceOverrides(services,service){return[...services.overrides].reverse().filter(entry=>entry.service===service)}function buildServiceOverrideContext(context){return{service:context.service,command:context.command?normalizeCommandName(context.command):void 0,args:context.args?cloneContextSnapshot(context.args):void 0,options:context.options?cloneCommandOptionsSnapshot(context.options):void 0,global:context.global?cloneGlobalOptionsSnapshot(context.global):void 0,pm_root:context.pm_root,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,payload:cloneContextSnapshot(context.payload)}}function isServiceOverrideDecision(value){if(typeof value!=="object"||value===null||!Object.hasOwn(value,"handled")){return false}const handled=value.handled;return handled===true?Object.hasOwn(value,"result"):handled===false&&Reflect.ownKeys(value).length===1}function resolveServiceOverrideValue(result,context){if(isServiceOverrideDecision(result)){return result.handled?{handled:true,result:result.result}:{handled:false,result:context.payload}}if(context.service==="output_format"&&(result===null||result===void 0)){return{handled:false,result:context.payload}}return{handled:true,result}}function isLegacyOutputPayloadEcho(result,context,serviceContext){return context.service==="output_format"&&typeof result==="object"&&result!==null&&stableValueEquals(result,serviceContext.payload)}function resolveMatchedServiceDecision(matched,decision,warnings){if(!decision.handled){return void 0}if(matched.passThrough===true){warnings.push(`extension_service_pass_through_contract_violated:${matched.layer}:${matched.name}:${matched.service}`);return void 0}return{handled:true,result:decision.result,warnings}}function runServiceOverrideSync(services,context){const matches=matchingServiceOverrides(services,context.service);if(matches.length===0){return resolveDefaultServiceResult(context)}const warnings=[];for(const matched of matches){try{const serviceContext=buildServiceOverrideContext(context);const result=matched.run(serviceContext);if(result instanceof Promise){warnings.push(`extension_service_override_async_unsupported:${matched.layer}:${matched.name}:${matched.service}`);continue}if(isLegacyOutputPayloadEcho(result,context,serviceContext)){warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);continue}const resolved=resolveMatchedServiceDecision(matched,resolveServiceOverrideValue(result,context),warnings);if(resolved)return resolved}catch{warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`)}}return{handled:false,result:context.payload,warnings}}async function runServiceOverride(services,context){const matches=matchingServiceOverrides(services,context.service);if(matches.length===0){return resolveDefaultServiceResult(context)}const warnings=[];for(const matched of matches){try{const serviceContext=buildServiceOverrideContext(context);const result=await Promise.resolve(matched.run(serviceContext));if(isLegacyOutputPayloadEcho(result,context,serviceContext)){warnings.push(`extension_output_format_payload_echo_deprecated:${matched.layer}:${matched.name}`);continue}const resolved=resolveMatchedServiceDecision(matched,resolveServiceOverrideValue(result,context),warnings);if(resolved)return resolved}catch{warnings.push(`extension_service_override_failed:${matched.layer}:${matched.name}:${matched.service}`)}}return{handled:false,result:context.payload,warnings}}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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,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}`]}}}function rendererOwnsContext(entry,command,result){if((entry.commands?.length??0)>0&&!entry.commands?.includes(command)){return false}if(entry.resultDiscriminator===void 0){return true}try{return entry.resultDiscriminator(cloneContextSnapshot(result))}catch{return false}}function runRendererOverride(renderers,context){const rendererCommand=typeof context.command==="string"?normalizeCommandName(context.command):"";const matched=[...renderers.overrides].reverse().find(entry=>entry.format===context.format&&rendererOwnsContext(entry,rendererCommand,context.result));if(!matched){return{overridden:false,rendered:null,warnings:[]}}try{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,source_workspace_root:context.source_workspace_root,repo_root:context.repo_root,pm_root_rel:context.pm_root_rel,result:cloneContextSnapshot(context.result)});if(rendered===null||rendered===void 0){return{overridden:false,rendered:null,warnings:[]}}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}`]}}}export{runAfterCommandHooks,runBeforeCommandHooks,runBeforeMutationHooks,runCommandHandler,runCommandOverride,runOnIndexHooks,runOnReadHooks,runOnWriteHooks,runParserOverride,runPreflightOverride,runRendererOverride,runServiceOverride,runServiceOverrideSync};
 //# sourceMappingURL=extension-hook-runtime.js.map
-//# debugId=d1dd5d4f-5f08-5e52-b109-d066f92ae3b3