@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/extension/doctor.js

@@ -1,607 +1,2 @@
-/**
- * @module sdk/extension/doctor
- *
- * Implements extension package-management support for Doctor.
- */
-
-!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]="54ce5bae-db04-5c19-81df-093802bf41c7")}catch(e){}}();
-import { reconcileExtensionCapabilityUsage, } from "../../core/extensions/index.js";
-import { EXTENSION_CAPABILITY_CONTRACT, KNOWN_EXTENSION_CAPABILITIES, parseLegacyExtensionCapabilityAliasWarning, parseUnknownExtensionCapabilityWarning, } from "../../core/extensions/loader.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { normalizeExtensionNameForMatch } from "./shared.js";
-/** Project loader and activation failures into bounded doctor output. */
-export function summarizeExtensionFailures(failures) {
-    return failures.map(({ layer, name, error }) => ({ layer, name, error }));
-}
-function addRuntimePath(pathsByExtension, extensionName, pathValue) {
-    const normalizedName = normalizeExtensionNameForMatch(extensionName);
-    const normalizedPath = pathValue.trim();
-    if (normalizedName.length === 0 || normalizedPath.length === 0) {
-        return;
-    }
-    const existing = pathsByExtension.get(normalizedName) ?? new Set();
-    existing.add(normalizedPath);
-    pathsByExtension.set(normalizedName, existing);
-}
-function collectRuntimeActivationPaths(activationResult) {
-    const commandPathsByExtension = new Map();
-    const actionPathsByExtension = new Map();
-    for (const registration of activationResult.registrations.commands) {
-        addRuntimePath(commandPathsByExtension, registration.name, registration.command);
-        addRuntimePath(actionPathsByExtension, registration.name, registration.action);
-    }
-    for (const handler of activationResult.commands.handlers) {
-        addRuntimePath(commandPathsByExtension, handler.name, handler.command);
-    }
-    for (const override of activationResult.commands.overrides) {
-        addRuntimePath(commandPathsByExtension, override.name, override.command);
-    }
-    return { commandPathsByExtension, actionPathsByExtension };
-}
-function sortedRuntimePaths(values) {
-    if (!values || values.size === 0) {
-        return undefined;
-    }
-    return [...values].sort((left, right) => left.localeCompare(right));
-}
-function resolveDoctorActivationStatus(params) {
-    const { enabled, normalizedName, loadedNames, loadFailedNames, activationFailedNames, } = params;
-    if (!enabled) {
-        return { runtime_active: false, activation_status: "not_loaded" };
-    }
-    if (loadFailedNames.has(normalizedName) ||
-        activationFailedNames.has(normalizedName)) {
-        return { runtime_active: false, activation_status: "failed" };
-    }
-    if (loadedNames.has(normalizedName)) {
-        return { runtime_active: true, activation_status: "ok" };
-    }
-    return { runtime_active: false, activation_status: "not_loaded" };
-}
-/** Implements apply doctor runtime activation state for the public runtime surface of this module. */
-export function applyDoctorRuntimeActivationState(extensions, loadResult, activationResult) {
-    const loadedNames = new Set(loadResult.loaded.map((entry) => normalizeExtensionNameForMatch(entry.name)));
-    const loadFailedNames = new Set(loadResult.failed.map((entry) => normalizeExtensionNameForMatch(entry.name)));
-    const activationFailedNames = new Set(activationResult.failed.map((entry) => normalizeExtensionNameForMatch(entry.name)));
-    const { commandPathsByExtension, actionPathsByExtension } = collectRuntimeActivationPaths(activationResult);
-    return extensions.map((entry) => {
-        const normalizedName = normalizeExtensionNameForMatch(entry.name);
-        const commandPaths = sortedRuntimePaths(commandPathsByExtension.get(normalizedName));
-        const actionPaths = sortedRuntimePaths(actionPathsByExtension.get(normalizedName));
-        const runtimeMetadata = {
-            ...(commandPaths ? { command_paths: commandPaths } : {}),
-            ...(actionPaths ? { action_paths: actionPaths } : {}),
-        };
-        const activationStatus = resolveDoctorActivationStatus({
-            enabled: entry.enabled,
-            normalizedName,
-            loadedNames,
-            loadFailedNames,
-            activationFailedNames,
-        });
-        return {
-            ...entry,
-            ...activationStatus,
-            ...runtimeMetadata,
-        };
-    });
-}
-function summarizePolicyWarnings(warnings) {
-    let warningCount = 0;
-    let violationCount = 0;
-    let blockedCount = 0;
-    for (const warning of warnings) {
-        if (!warning.startsWith("extension_policy_")) {
-            continue;
-        }
-        warningCount += 1;
-        if (warning.startsWith("extension_policy_violation_")) {
-            violationCount += 1;
-            continue;
-        }
-        if (warning.startsWith("extension_policy_blocked_")) {
-            blockedCount += 1;
-        }
-    }
-    return {
-        warning_count: warningCount,
-        violation_count: violationCount,
-        blocked_count: blockedCount,
-    };
-}
-function lifecycleFlagCommand(options, action) {
-    return options.vocabulary === "package"
-        ? `pm package --${action}`
-        : `pm extension --${action}`;
-}
-const REGISTRATION_COLLISION_WARNING_CODES = new Set([
-    "extension_command_handler_collision",
-    "extension_command_override_collision",
-    "extension_command_override_handler_overlap",
-    "extension_parser_override_collision",
-    "extension_preflight_override_collision",
-    "extension_renderer_collision",
-    "extension_service_override_collision",
-]);
-/** Implements check whether registration collision warning for the public runtime surface of this module. */
-function isRegistrationCollisionWarning(warning) {
-    return REGISTRATION_COLLISION_WARNING_CODES.has(warningCode(warning));
-}
-function isExtensionLayer(value) {
-    return value === "project" || value === "global";
-}
-function parseRegistrationCollisionWarning(warning) {
-    const parts = warning.split(":");
-    const code = parts[0];
-    if (!code || !REGISTRATION_COLLISION_WARNING_CODES.has(code)) {
-        return null;
-    }
-    // Collision warnings end with winnerLayer:winnerName:displacedLayer:displacedName.
-    // Surface identifiers before that suffix may contain colons, so parse from the right.
-    const winnerLayer = parts.at(-4);
-    const winnerName = parts.at(-3)?.trim();
-    const displacedLayer = parts.at(-2);
-    const displacedName = parts.at(-1)?.trim();
-    if (!isExtensionLayer(winnerLayer) ||
-        !isExtensionLayer(displacedLayer) ||
-        !winnerName ||
-        !displacedName) {
-        return null;
-    }
-    return {
-        code,
-        surface: parts.slice(1, -4).join(":") || "global",
-        winner: { layer: winnerLayer, name: winnerName },
-        displaced: { layer: displacedLayer, name: displacedName },
-    };
-}
-function collectRegistrationCollisionExtensionNames(warnings) {
-    const names = new Set();
-    for (const warning of warnings) {
-        const parsed = parseRegistrationCollisionWarning(warning);
-        if (!parsed) {
-            continue;
-        }
-        names.add(parsed.winner.name);
-        names.add(parsed.displaced.name);
-    }
-    return [...names].sort((left, right) => left.localeCompare(right));
-}
-/** Implements build registration collision remediation for the public runtime surface of this module. */
-export function buildRegistrationCollisionRemediation(warnings, commands) {
-    const registrationCollisionWarnings = warnings.filter(isRegistrationCollisionWarning);
-    if (registrationCollisionWarnings.length === 0) {
-        return null;
-    }
-    const collisionNames = collectRegistrationCollisionExtensionNames(registrationCollisionWarnings);
-    const collisionNameText = collisionNames.length > 0
-        ? ` Conflicting extensions: ${collisionNames.join(", ")}.`
-        : "";
-    return (`Extension registration collisions or handler/override overlaps detected.${collisionNameText} Single-winner surfaces can hide earlier package behavior. ` +
-        `Deactivate one conflicting package with ${commands.deactivate}, ` +
-        `or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${commands.doctor}.`);
-}
-function buildRegistrationCollisionPlan(scope, warnings, extensions, options) {
-    const collisions = warnings
-        .map((warning) => parseRegistrationCollisionWarning(warning))
-        .filter((entry) => entry !== null)
-        .sort((left, right) => `${left.code}:${left.surface}:${left.winner.name}:${left.displaced.name}`.localeCompare(`${right.code}:${right.surface}:${right.winner.name}:${right.displaced.name}`));
-    if (collisions.length === 0) {
-        return undefined;
-    }
-    const scopeFlag = scope === "global" ? "--global" : "--project";
-    const deactivatePrefix = lifecycleFlagCommand(options, "deactivate");
-    const doctorCommand = `${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace`;
-    const extensionByName = new Map(extensions.map((entry) => [
-        normalizeExtensionNameForMatch(entry.name),
-        entry,
-    ]));
-    const affectedByName = new Map();
-    for (const collision of collisions) {
-        for (const name of [collision.winner.name, collision.displaced.name]) {
-            const normalizedName = normalizeExtensionNameForMatch(name);
-            affectedByName.set(normalizedName, (affectedByName.get(normalizedName) ?? 0) + 1);
-        }
-    }
-    const remediationCandidates = [...affectedByName.entries()]
-        .map(([normalizedName, affectedCollisions]) => {
-        const extension = extensionByName.get(normalizedName);
-        const extensionName = extension?.name ?? normalizedName;
-        const commandPaths = extension?.command_paths ?? [];
-        const actionPaths = extension?.action_paths ?? [];
-        return {
-            action: "deactivate",
-            extension: extensionName,
-            command: `${deactivatePrefix} ${extensionName} ${scopeFlag}`,
-            affected_collisions: affectedCollisions,
-            feature_loss: {
-                command_paths: [...commandPaths].sort((left, right) => left.localeCompare(right)),
-                action_paths: [...actionPaths].sort((left, right) => left.localeCompare(right)),
-            },
-        };
-    })
-        .sort((left, right) => {
-        const affectedDelta = right.affected_collisions - left.affected_collisions;
-        if (affectedDelta !== 0) {
-            return affectedDelta;
-        }
-        const leftSurfaceCount = left.feature_loss.command_paths.length +
-            left.feature_loss.action_paths.length;
-        const rightSurfaceCount = right.feature_loss.command_paths.length +
-            right.feature_loss.action_paths.length;
-        if (leftSurfaceCount !== rightSurfaceCount) {
-            return leftSurfaceCount - rightSurfaceCount;
-        }
-        return left.extension.localeCompare(right.extension);
-    });
-    return {
-        status: "conflicts_detected",
-        collision_count: collisions.length,
-        extension_count: affectedByName.size,
-        next_best_command: doctorCommand,
-        collisions,
-        remediation_candidates: remediationCandidates,
-    };
-}
-/** Implements classify doctor load failure warnings for the public runtime surface of this module. */
-export function classifyDoctorLoadFailureWarnings(loadFailures) {
-    const warnings = [];
-    for (const failure of loadFailures) {
-        const normalizedError = failure.error.toLowerCase();
-        if (normalizedError.includes("cannot find package '@unbrained/pm-cli'") ||
-            normalizedError.includes('cannot find module "@unbrained/pm-cli"') ||
-            normalizedError.includes("cannot find module '@unbrained/pm-cli'")) {
-            warnings.push(`extension_load_failed_sdk_dependency_missing:${failure.name}`);
-        }
-        if (normalizedError.includes("cannot use import statement outside a module") ||
-            normalizedError.includes("to load an es module") ||
-            normalizedError.includes("must use import to load es module")) {
-            warnings.push(`extension_load_failed_module_mode_mismatch:${failure.name}`);
-        }
-    }
-    return [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
-}
-/** Implements classify doctor activation failure warnings for the public runtime surface of this module. */
-export function classifyDoctorActivationFailureWarnings(activationFailures = []) {
-    const failures = Array.isArray(activationFailures) ? activationFailures : [];
-    const warnings = [];
-    for (const failure of failures) {
-        if (!failure || typeof failure.name !== "string") {
-            continue;
-        }
-        const missingCapability = failure.trace?.missing_capability ?? failure.trace?.capability;
-        if (typeof missingCapability === "string" &&
-            missingCapability.trim().length > 0) {
-            warnings.push(`extension_capability_missing:${failure.name}:${missingCapability.trim().toLowerCase()}`);
-        }
-    }
-    return [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
-}
-/**
- * Classify advisory least-privilege warnings for capabilities each loaded
- * extension declares in its manifest but never registers against.
- *
- * Emits one `extension_capability_unused:<layer>:<name>:<capability>` token per
- * over-broad grant. These are advisory hygiene hints — they never block — that
- * tell an author to trim the manifest (or add the missing registration). The
- * inverse failure (registering a surface whose capability is undeclared) is the
- * blocking `extension_capability_missing` warning emitted during activation.
- */
-export function classifyUnusedCapabilityWarnings(loadResult, activationResult) {
-    const warnings = [];
-    for (const entry of reconcileExtensionCapabilityUsage(loadResult.loaded, activationResult)) {
-        for (const capability of entry.unused) {
-            warnings.push(`extension_capability_unused:${entry.layer}:${entry.name}:${capability}`);
-        }
-    }
-    return [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
-}
-/** Ordered remediation rules evaluated while at least one warning is present. The order is load-bearing — it is the order remediation hints appear in doctor output — so new rules must be inserted at the intended position rather than appended. */
-const TRIAGE_REMEDIATION_RULES = [
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_manifest_")),
-        build: (ctx) => `Run ${lifecycleFlagCommand(ctx.options, "explore")} ${ctx.scopeFlag} to inspect discovered manifests and directories.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_unknown:")),
-        build: () => `Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. ` +
-            "Review extension_capability_unknown warning details for suggested replacements.",
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_legacy_alias:")),
-        build: () => "Legacy extension capability aliases were auto-remapped to canonical capabilities. " +
-            "Update manifests to canonical names (migration/validation -> schema).",
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_missing:")),
-        build: (ctx) => `Extension activation failed because code registered a surface missing from manifest capabilities. ` +
-            `Run ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_capability_unused:")),
-        build: (ctx) => "Extension manifests declare capabilities that are never registered against. " +
-            `Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag} --detail deep --trace for per-extension registration counts.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_command_definition_legacy_handler_alias:")),
-        build: () => "Extension command definitions using legacy handler were auto-remapped. " +
-            "Update command definitions to use run: (context) => ... for forward compatibility.",
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_output_service_override_global:") ||
-            warning.startsWith("extension_output_renderer_override_global:")),
-        build: () => "Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering.",
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_schema_narrow_activation:")),
-        build: () => "A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or — if the schema is intentionally command-scoped — knowingly ignore this advisory.",
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_load_failed_sdk_dependency_missing:")),
-        build: (ctx) => `Detected extension load failures caused by missing SDK dependency resolution. ` +
-            `Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_load_failed_module_mode_mismatch:")),
-        build: (ctx) => `Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" ` +
-            `or use an explicit .mjs entry and rerun ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_pm_min_version_") ||
-            warning.startsWith("extension_pm_max_version_")),
-        build: (ctx) => "Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version " +
-            `with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${lifecycleFlagCommand(ctx.options, "doctor")} ${ctx.scopeFlag}.`,
-    },
-    {
-        matches: (_warnings, ctx) => ctx.updateCheckFailedTotal > 0,
-        build: (ctx) => `Run ${lifecycleFlagCommand(ctx.options, "manage")} ${ctx.scopeFlag} after validating network and repository access.`,
-    },
-    {
-        matches: (warnings) => warnings.some((warning) => warning.startsWith("extension_manager_state_")),
-        build: (ctx) => `Review and repair ${ctx.scope} managed extension state file if schema/read warnings persist.`,
-    },
-    {
-        matches: (_warnings, ctx) => ctx.policyWarningCount > 0,
-        build: () => "Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces.",
-    },
-];
-/**
- * Build the ordered remediation hints for a triage summary. Warning-driven rules
- * (collision remediation first, then {@link TRIAGE_REMEDIATION_RULES}) only run
- * when at least one warning is present; the update-health coverage and
- * availability hints always run; and a "no immediate action" fallback is
- * appended when nothing else applied.
- */
-function buildExtensionTriageRemediation(params) {
-    const { normalizedWarnings, options, scope, scopeFlag, updateCheckFailedTotal, policyWarningCount, updateHealthPartial, skippedUnmanagedTotal, skippedNonGithubTotal, updateAvailableTotal, } = params;
-    const remediation = [];
-    const ctx = {
-        options,
-        scope,
-        scopeFlag,
-        updateCheckFailedTotal,
-        policyWarningCount,
-    };
-    if (normalizedWarnings.length > 0) {
-        const registrationCollisionRemediation = buildRegistrationCollisionRemediation(normalizedWarnings, {
-            deactivate: `${lifecycleFlagCommand(options, "deactivate")} <name> ${scopeFlag}`,
-            doctor: `${lifecycleFlagCommand(options, "doctor")} ${scopeFlag} --detail deep --trace`,
-        });
-        if (registrationCollisionRemediation) {
-            remediation.push(registrationCollisionRemediation);
-        }
-        for (const rule of TRIAGE_REMEDIATION_RULES) {
-            if (rule.matches(normalizedWarnings, ctx)) {
-                remediation.push(rule.build(ctx));
-            }
-        }
-    }
-    if (updateHealthPartial) {
-        remediation.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state (or ${lifecycleFlagCommand(options, "adopt-all")} ${scopeFlag}, ${lifecycleFlagCommand(options, "adopt")} <name> ${scopeFlag}, or reinstall via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>).`);
-    }
-    else if (skippedUnmanagedTotal > 0) {
-        remediation.push(`Loaded unmanaged extensions are currently treated as informational. Use ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} --fix-managed-state to adopt them for update checks.`);
-    }
-    if (skippedNonGithubTotal > 0) {
-        remediation.push(`Non-GitHub managed extensions are skipped by update checks. Use doctor output for non-update diagnostics.`);
-    }
-    if (updateAvailableTotal > 0) {
-        remediation.push(`Update available managed extensions via ${lifecycleFlagCommand(options, "install")} ${scopeFlag} <source>.`);
-    }
-    if (remediation.length === 0) {
-        remediation.push(`No immediate action required. Re-run ${lifecycleFlagCommand(options, "manage")} ${scopeFlag} after extension changes.`);
-    }
-    return remediation;
-}
-/** Implements build extension triage summary for the public runtime surface of this module. */
-export function buildExtensionTriageSummary(scope, warnings, extensions, options = {}) {
-    const normalizedWarnings = [...new Set(warnings)].sort((left, right) => left.localeCompare(right));
-    const managedTotal = extensions.filter((entry) => entry.managed).length;
-    const enabledTotal = extensions.filter((entry) => entry.enabled).length;
-    const activeTotal = extensions.filter((entry) => entry.active).length;
-    const updateAvailableTotal = extensions.filter((entry) => entry.update_available === true).length;
-    const unmanagedExtensions = extensions.filter((entry) => entry.managed === false);
-    const unmanagedExpectedExtensions = unmanagedExtensions
-        .filter((entry) => isExpectedUnmanagedExtension(entry))
-        .map((entry) => entry.name)
-        .sort((left, right) => left.localeCompare(right));
-    const unmanagedActionRequiredExtensions = unmanagedExtensions
-        .filter((entry) => !isExpectedUnmanagedExtension(entry))
-        .map((entry) => entry.name)
-        .sort((left, right) => left.localeCompare(right));
-    const updateCheckStatusTotals = {
-        checked: 0,
-        skipped_unmanaged: 0,
-        skipped_non_github: 0,
-        failed: 0,
-        not_checked: 0,
-    };
-    for (const entry of extensions) {
-        updateCheckStatusTotals[entry.update_check_status] += 1;
-    }
-    const updateCheckFailedTotal = updateCheckStatusTotals.failed;
-    const skippedUnmanagedTotal = updateCheckStatusTotals.skipped_unmanaged;
-    const skippedNonGithubTotal = updateCheckStatusTotals.skipped_non_github;
-    const updateHealthPartial = unmanagedActionRequiredExtensions.length > 0;
-    const updateHealthCoverage = updateHealthPartial ? "partial" : "full";
-    const partialCoverageWarnings = updateHealthPartial
-        ? [
-            `extension_update_health_partial_coverage:skipped_unmanaged:${unmanagedActionRequiredExtensions.length}`,
-        ]
-        : [];
-    const effectiveWarnings = [
-        ...new Set([...normalizedWarnings, ...partialCoverageWarnings]),
-    ].sort((left, right) => left.localeCompare(right));
-    const warningCodes = [
-        ...new Set(effectiveWarnings.map((value) => warningCode(value))),
-    ].sort((left, right) => left.localeCompare(right));
-    const policyWarnings = summarizePolicyWarnings(effectiveWarnings);
-    const scopeFlag = scope === "global" ? "--global" : "--project";
-    const collisionPlan = buildRegistrationCollisionPlan(scope, normalizedWarnings, extensions, options);
-    const remediation = buildExtensionTriageRemediation({
-        normalizedWarnings,
-        options,
-        scope,
-        scopeFlag,
-        updateCheckFailedTotal,
-        policyWarningCount: policyWarnings.warning_count,
-        updateHealthPartial,
-        skippedUnmanagedTotal,
-        skippedNonGithubTotal,
-        updateAvailableTotal,
-    });
-    return {
-        status: effectiveWarnings.length === 0 ? "ok" : "warn",
-        warning_count: effectiveWarnings.length,
-        warning_codes: warningCodes,
-        warnings: effectiveWarnings,
-        policy_warning_count: policyWarnings.warning_count,
-        policy_violation_count: policyWarnings.violation_count,
-        policy_blocked_count: policyWarnings.blocked_count,
-        total_extensions: extensions.length,
-        managed_total: managedTotal,
-        enabled_total: enabledTotal,
-        active_total: activeTotal,
-        update_available_total: updateAvailableTotal,
-        update_health_coverage: updateHealthCoverage,
-        update_health_partial: updateHealthPartial,
-        unmanaged_loaded_extension_count: unmanagedExtensions.length,
-        unmanaged_loaded_extensions: unmanagedExtensions
-            .map((entry) => entry.name)
-            .sort((left, right) => left.localeCompare(right)),
-        unmanaged_expected_extension_count: unmanagedExpectedExtensions.length,
-        unmanaged_expected_extensions: unmanagedExpectedExtensions,
-        unmanaged_action_required_extension_count: unmanagedActionRequiredExtensions.length,
-        unmanaged_action_required_extensions: unmanagedActionRequiredExtensions,
-        update_check_status_totals: updateCheckStatusTotals,
-        update_check_failed_total: updateCheckFailedTotal,
-        top_warnings: effectiveWarnings.slice(0, 8),
-        remediation,
-        ...(collisionPlan ? { collision_plan: collisionPlan } : {}),
-    };
-}
-/** Implements parse doctor detail mode for the public runtime surface of this module. */
-export function parseDoctorDetailMode(raw) {
-    if (!raw || raw.trim().length === 0) {
-        return "summary";
-    }
-    const normalized = raw.trim().toLowerCase();
-    if (normalized === "summary" || normalized === "deep") {
-        return normalized;
-    }
-    throw new PmCliError(`Invalid --detail value "${raw}". Expected summary or deep.`, EXIT_CODE.USAGE);
-}
-function warningCode(value) {
-    const normalized = value.trim();
-    const separator = normalized.indexOf(":");
-    if (separator === -1) {
-        return normalized;
-    }
-    return normalized.slice(0, separator);
-}
-/** Implements collect unknown capability guidance for the public runtime surface of this module. */
-export function collectUnknownCapabilityGuidance(warnings) {
-    const seen = new Set();
-    const guidance = [];
-    for (const warning of warnings) {
-        const parsedDetails = (() => {
-            const unknownWarning = parseUnknownExtensionCapabilityWarning(warning);
-            if (unknownWarning) {
-                return [unknownWarning];
-            }
-            return parseLegacyExtensionCapabilityAliasWarning(warning);
-        })();
-        for (const parsed of parsedDetails) {
-            const key = `${parsed.layer}:${parsed.name}:${parsed.capability}`;
-            if (seen.has(key)) {
-                continue;
-            }
-            seen.add(key);
-            guidance.push(parsed);
-        }
-    }
-    return guidance;
-}
-/** Implements build capability contract metadata for the public runtime surface of this module. */
-export function buildCapabilityContractMetadata() {
-    return {
-        version: EXTENSION_CAPABILITY_CONTRACT.version,
-        capabilities: [...EXTENSION_CAPABILITY_CONTRACT.capabilities],
-        legacy_aliases: { ...EXTENSION_CAPABILITY_CONTRACT.legacy_aliases },
-    };
-}
-function isExpectedUnmanagedExtension(entry) {
-    const normalizedName = normalizeExtensionNameForMatch(entry.name);
-    const normalizedDirectory = normalizeExtensionNameForMatch(entry.directory);
-    if (normalizedName.startsWith("builtin-")) {
-        return true;
-    }
-    return normalizedDirectory === "beads" || normalizedDirectory === "todos";
-}
-/** Implements build doctor consistency summary for the public runtime surface of this module. */
-export function buildDoctorConsistencySummary(scope, installedExtensions, loadedExtensions, failedLoads, disabledByFlag) {
-    if (scope !== "project" || disabledByFlag) {
-        return {
-            warnings: [],
-            summary: {
-                active_project_count: 0,
-                loaded_project_count: 0,
-                active_project_names: [],
-                loaded_project_names: [],
-                missing_active_project_names: [],
-            },
-        };
-    }
-    const activeProjectNames = [
-        ...new Set(installedExtensions
-            .filter((entry) => entry.active)
-            .map((entry) => normalizeExtensionNameForMatch(entry.name))),
-    ].sort((left, right) => left.localeCompare(right));
-    const loadedProjectNames = [
-        ...new Set(loadedExtensions
-            .filter((entry) => entry.layer === "project")
-            .map((entry) => normalizeExtensionNameForMatch(entry.name))),
-    ].sort((left, right) => left.localeCompare(right));
-    const failedLoadNames = new Set(failedLoads.map((entry) => normalizeExtensionNameForMatch(entry.name)));
-    const missingActiveProjectNames = activeProjectNames
-        .filter((name) => !loadedProjectNames.includes(name) && !failedLoadNames.has(name))
-        .sort((left, right) => left.localeCompare(right));
-    const warnings = missingActiveProjectNames.length > 0
-        ? [
-            `extension_doctor_consistency_active_not_loaded:${missingActiveProjectNames.join(",")}`,
-        ]
-        : [];
-    return {
-        warnings,
-        summary: {
-            active_project_count: activeProjectNames.length,
-            loaded_project_count: loadedProjectNames.length,
-            active_project_names: activeProjectNames,
-            loaded_project_names: loadedProjectNames,
-            missing_active_project_names: missingActiveProjectNames,
-        },
-    };
-}
+!(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]="df60255d-fdd6-594a-9e17-547d53f7b3bb")}catch(e2){}})();import{reconcileExtensionCapabilityUsage}from"../../core/extensions/index.js";import{EXTENSION_CAPABILITY_CONTRACT,KNOWN_EXTENSION_CAPABILITIES,parseLegacyExtensionCapabilityAliasWarning,parseUnknownExtensionCapabilityWarning}from"../../core/extensions/loader.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{normalizeExtensionNameForMatch}from"./shared.js";function summarizeExtensionFailures(failures){return failures.map(({layer,name,error})=>({layer,name,error}))}function addRuntimePath(pathsByExtension,extensionName,pathValue){const normalizedName=normalizeExtensionNameForMatch(extensionName);const normalizedPath=pathValue.trim();if(normalizedName.length===0||normalizedPath.length===0){return}const existing=pathsByExtension.get(normalizedName)??new Set;existing.add(normalizedPath);pathsByExtension.set(normalizedName,existing)}function collectRuntimeActivationPaths(activationResult){const commandPathsByExtension=new Map;const actionPathsByExtension=new Map;for(const registration of activationResult.registrations.commands){addRuntimePath(commandPathsByExtension,registration.name,registration.command);addRuntimePath(actionPathsByExtension,registration.name,registration.action)}for(const handler of activationResult.commands.handlers){addRuntimePath(commandPathsByExtension,handler.name,handler.command)}for(const override of activationResult.commands.overrides){addRuntimePath(commandPathsByExtension,override.name,override.command)}return{commandPathsByExtension,actionPathsByExtension}}function sortedRuntimePaths(values){if(!values||values.size===0){return void 0}return[...values].sort((left,right)=>left.localeCompare(right))}function resolveDoctorActivationStatus(params){const{enabled,normalizedName,loadedNames,loadFailedNames,activationFailedNames}=params;if(!enabled){return{runtime_active:false,activation_status:"not_loaded"}}if(loadFailedNames.has(normalizedName)||activationFailedNames.has(normalizedName)){return{runtime_active:false,activation_status:"failed"}}if(loadedNames.has(normalizedName)){return{runtime_active:true,activation_status:"ok"}}return{runtime_active:false,activation_status:"not_loaded"}}function applyDoctorRuntimeActivationState(extensions,loadResult,activationResult){const loadedNames=new Set(loadResult.loaded.map(entry=>normalizeExtensionNameForMatch(entry.name)));const loadFailedNames=new Set(loadResult.failed.map(entry=>normalizeExtensionNameForMatch(entry.name)));const activationFailedNames=new Set(activationResult.failed.map(entry=>normalizeExtensionNameForMatch(entry.name)));const{commandPathsByExtension,actionPathsByExtension}=collectRuntimeActivationPaths(activationResult);return extensions.map(entry=>{const normalizedName=normalizeExtensionNameForMatch(entry.name);const commandPaths=sortedRuntimePaths(commandPathsByExtension.get(normalizedName));const actionPaths=sortedRuntimePaths(actionPathsByExtension.get(normalizedName));const runtimeMetadata={...commandPaths?{command_paths:commandPaths}:{},...actionPaths?{action_paths:actionPaths}:{}};const activationStatus=resolveDoctorActivationStatus({enabled:entry.enabled,normalizedName,loadedNames,loadFailedNames,activationFailedNames});return{...entry,...activationStatus,...runtimeMetadata}})}function summarizePolicyWarnings(warnings){let warningCount=0;let violationCount=0;let blockedCount=0;for(const warning of warnings){if(!warning.startsWith("extension_policy_")){continue}warningCount+=1;if(warning.startsWith("extension_policy_violation_")){violationCount+=1;continue}if(warning.startsWith("extension_policy_blocked_")){blockedCount+=1}}return{warning_count:warningCount,violation_count:violationCount,blocked_count:blockedCount}}function lifecycleFlagCommand(options,action){return options.vocabulary==="package"?`pm package --${action}`:`pm extension --${action}`}const REGISTRATION_COLLISION_WARNING_CODES=new Set(["extension_command_handler_collision","extension_command_override_collision","extension_command_override_handler_overlap","extension_parser_override_collision","extension_preflight_override_collision","extension_renderer_collision","extension_service_override_collision"]);function isRegistrationCollisionWarning(warning){return REGISTRATION_COLLISION_WARNING_CODES.has(warningCode(warning))}function isExtensionLayer(value){return value==="project"||value==="global"}function parseRegistrationCollisionWarning(warning){const parts=warning.split(":");const code=parts[0];if(!code||!REGISTRATION_COLLISION_WARNING_CODES.has(code)){return null}const winnerLayer=parts.at(-4);const winnerName=parts.at(-3)?.trim();const displacedLayer=parts.at(-2);const displacedName=parts.at(-1)?.trim();if(!isExtensionLayer(winnerLayer)||!isExtensionLayer(displacedLayer)||!winnerName||!displacedName){return null}return{code,surface:parts.slice(1,-4).join(":")||"global",winner:{layer:winnerLayer,name:winnerName},displaced:{layer:displacedLayer,name:displacedName}}}function collectRegistrationCollisionExtensionNames(warnings){const names=new Set;for(const warning of warnings){const parsed=parseRegistrationCollisionWarning(warning);if(!parsed){continue}names.add(parsed.winner.name);names.add(parsed.displaced.name)}return[...names].sort((left,right)=>left.localeCompare(right))}function buildRegistrationCollisionRemediation(warnings,commands){const registrationCollisionWarnings=warnings.filter(isRegistrationCollisionWarning);if(registrationCollisionWarnings.length===0){return null}const collisionNames=collectRegistrationCollisionExtensionNames(registrationCollisionWarnings);const collisionNameText=collisionNames.length>0?` Conflicting extensions: ${collisionNames.join(", ")}.`:"";return`Extension registration collisions or handler/override overlaps detected.${collisionNameText} Single-winner surfaces can hide earlier package behavior. Deactivate one conflicting package with ${commands.deactivate}, or scope registration surfaces in extensions.policy.extension_overrides, then rerun ${commands.doctor}.`}function buildRegistrationCollisionPlan(scope,warnings,extensions,options){const collisions=warnings.map(warning=>parseRegistrationCollisionWarning(warning)).filter(entry=>entry!==null).sort((left,right)=>`${left.code}:${left.surface}:${left.winner.name}:${left.displaced.name}`.localeCompare(`${right.code}:${right.surface}:${right.winner.name}:${right.displaced.name}`));if(collisions.length===0){return void 0}const scopeFlag=scope==="global"?"--global":"--project";const deactivatePrefix=lifecycleFlagCommand(options,"deactivate");const doctorCommand=`${lifecycleFlagCommand(options,"doctor")} ${scopeFlag} --detail deep --trace`;const extensionByName=new Map(extensions.map(entry=>[normalizeExtensionNameForMatch(entry.name),entry]));const affectedByName=new Map;for(const collision of collisions){for(const name of[collision.winner.name,collision.displaced.name]){const normalizedName=normalizeExtensionNameForMatch(name);affectedByName.set(normalizedName,(affectedByName.get(normalizedName)??0)+1)}}const remediationCandidates=[...affectedByName.entries()].map(([normalizedName,affectedCollisions])=>{const extension=extensionByName.get(normalizedName);const extensionName=extension?.name??normalizedName;const commandPaths=extension?.command_paths??[];const actionPaths=extension?.action_paths??[];return{action:"deactivate",extension:extensionName,command:`${deactivatePrefix} ${extensionName} ${scopeFlag}`,affected_collisions:affectedCollisions,feature_loss:{command_paths:[...commandPaths].sort((left,right)=>left.localeCompare(right)),action_paths:[...actionPaths].sort((left,right)=>left.localeCompare(right))}}}).sort((left,right)=>{const affectedDelta=right.affected_collisions-left.affected_collisions;if(affectedDelta!==0){return affectedDelta}const leftSurfaceCount=left.feature_loss.command_paths.length+left.feature_loss.action_paths.length;const rightSurfaceCount=right.feature_loss.command_paths.length+right.feature_loss.action_paths.length;if(leftSurfaceCount!==rightSurfaceCount){return leftSurfaceCount-rightSurfaceCount}return left.extension.localeCompare(right.extension)});return{status:"conflicts_detected",collision_count:collisions.length,extension_count:affectedByName.size,next_best_command:doctorCommand,collisions,remediation_candidates:remediationCandidates}}function classifyDoctorLoadFailureWarnings(loadFailures){const warnings=[];for(const failure of loadFailures){const normalizedError=failure.error.toLowerCase();if(normalizedError.includes("cannot find package '@unbrained/pm-cli'")||normalizedError.includes('cannot find module "@unbrained/pm-cli"')||normalizedError.includes("cannot find module '@unbrained/pm-cli'")){warnings.push(`extension_load_failed_sdk_dependency_missing:${failure.name}`)}if(normalizedError.includes("cannot use import statement outside a module")||normalizedError.includes("to load an es module")||normalizedError.includes("must use import to load es module")){warnings.push(`extension_load_failed_module_mode_mismatch:${failure.name}`)}}return[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))}function classifyDoctorActivationFailureWarnings(activationFailures=[]){const failures=Array.isArray(activationFailures)?activationFailures:[];const warnings=[];for(const failure of failures){if(!failure||typeof failure.name!=="string"){continue}const missingCapability=failure.trace?.missing_capability??failure.trace?.capability;if(typeof missingCapability==="string"&&missingCapability.trim().length>0){warnings.push(`extension_capability_missing:${failure.name}:${missingCapability.trim().toLowerCase()}`)}}return[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))}function classifyUnusedCapabilityWarnings(loadResult,activationResult){const warnings=[];for(const entry of reconcileExtensionCapabilityUsage(loadResult.loaded,activationResult)){for(const capability of entry.unused){warnings.push(`extension_capability_unused:${entry.layer}:${entry.name}:${capability}`)}}return[...new Set(warnings)].sort((left,right)=>left.localeCompare(right))}const TRIAGE_REMEDIATION_RULES=[{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_manifest_")),build:ctx=>`Run ${lifecycleFlagCommand(ctx.options,"explore")} ${ctx.scopeFlag} to inspect discovered manifests and directories.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_capability_unknown:")),build:()=>`Unknown extension capabilities detected. Allowed capabilities: ${KNOWN_EXTENSION_CAPABILITIES.join(", ")}. Review extension_capability_unknown warning details for suggested replacements.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_capability_legacy_alias:")),build:()=>"Legacy extension capability aliases were auto-remapped to canonical capabilities. Update manifests to canonical names (migration/validation -> schema)."},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_capability_missing:")),build:ctx=>`Extension activation failed because code registered a surface missing from manifest capabilities. Run ${lifecycleFlagCommand(ctx.options,"doctor")} ${ctx.scopeFlag} --detail deep --trace and add the reported missing_capability to manifest.json before publishing.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_capability_unused:")),build:ctx=>`Extension manifests declare capabilities that are never registered against. Remove each reported unused capability from manifest.json to keep least privilege, or add the matching registration. Run ${lifecycleFlagCommand(ctx.options,"doctor")} ${ctx.scopeFlag} --detail deep --trace for per-extension registration counts.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_command_definition_legacy_handler_alias:")),build:()=>"Extension command definitions using legacy handler were auto-remapped. Update command definitions to use run: (context) => ... for forward compatibility."},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_output_service_override_global:")||warning.startsWith("extension_output_renderer_override_global:")),build:()=>"Global output service/renderer overrides are active. For output_format, return context.payload/null/undefined unless the extension owns the command. For renderers, return null for unrelated payloads so pm falls back to native rendering."},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_schema_narrow_activation:")),build:()=>"A package registers custom item types/fields (a GLOBAL schema contribution) but also declares narrow activation.commands, so it never activates for built-in commands like pm create <type> and the custom type silently fails to register. Remove activation.commands from manifest.json so pm activates the package for every command, or \u2014 if the schema is intentionally command-scoped \u2014 knowingly ignore this advisory."},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_load_failed_sdk_dependency_missing:")),build:ctx=>`Detected extension load failures caused by missing SDK dependency resolution. Ensure extension package dependencies include "@unbrained/pm-cli" and reinstall dependencies before running ${lifecycleFlagCommand(ctx.options,"doctor")} ${ctx.scopeFlag}.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_load_failed_module_mode_mismatch:")),build:ctx=>`Detected extension module-mode mismatches. For ESM-based extension entries/imports, set package.json "type": "module" or use an explicit .mjs entry and rerun ${lifecycleFlagCommand(ctx.options,"doctor")} ${ctx.scopeFlag}.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_pm_min_version_")||warning.startsWith("extension_pm_max_version_")),build:ctx=>`Extension pm version-bound warnings detected. Align each package manifest's pm_min_version/pm_max_version with the installed pm CLI version (see the warning's required/allowed=...:current=... details), or upgrade/downgrade the pm CLI to satisfy the declared bounds, then rerun ${lifecycleFlagCommand(ctx.options,"doctor")} ${ctx.scopeFlag}.`},{matches:(_warnings,ctx)=>ctx.updateCheckFailedTotal>0,build:ctx=>`Run ${lifecycleFlagCommand(ctx.options,"manage")} ${ctx.scopeFlag} after validating network and repository access.`},{matches:warnings=>warnings.some(warning=>warning.startsWith("extension_manager_state_")),build:ctx=>`Review and repair ${ctx.scope} managed extension state file if schema/read warnings persist.`},{matches:(_warnings,ctx)=>ctx.policyWarningCount>0,build:()=>"Extension governance policy warnings detected. Review settings.extensions.policy mode and allow/block lists to confirm intended capabilities and registration surfaces."}];function buildExtensionTriageRemediation(params){const{normalizedWarnings,options,scope,scopeFlag,updateCheckFailedTotal,policyWarningCount,unmanagedActionRequiredTotal,notCheckedTotal,skippedNonGithubTotal,updateAvailableTotal}=params;const remediation=[];const ctx={options,scope,scopeFlag,updateCheckFailedTotal,policyWarningCount};if(normalizedWarnings.length>0){const registrationCollisionRemediation=buildRegistrationCollisionRemediation(normalizedWarnings,{deactivate:`${lifecycleFlagCommand(options,"deactivate")} <name> ${scopeFlag}`,doctor:`${lifecycleFlagCommand(options,"doctor")} ${scopeFlag} --detail deep --trace`});if(registrationCollisionRemediation){remediation.push(registrationCollisionRemediation)}for(const rule of TRIAGE_REMEDIATION_RULES){if(rule.matches(normalizedWarnings,ctx)){remediation.push(rule.build(ctx))}}}if(unmanagedActionRequiredTotal>0){remediation.push(`Update-check coverage is partial because unmanaged extensions need adoption. Adopt existing installs via ${lifecycleFlagCommand(options,"manage")} ${scopeFlag} --fix-managed-state (or ${lifecycleFlagCommand(options,"adopt-all")} ${scopeFlag}, ${lifecycleFlagCommand(options,"adopt")} <name> ${scopeFlag}, or reinstall via ${lifecycleFlagCommand(options,"install")} ${scopeFlag} <source>).`)}if(skippedNonGithubTotal>0){remediation.push("Update-check coverage is partial: non-GitHub managed sources were not checked. Inspect their registry or source directly; zero detected updates does not mean these packages are current. Runtime activation health is independent.")}if(notCheckedTotal>0){remediation.push(`Update-check coverage is partial: some sources have no completed check. Run ${lifecycleFlagCommand(options,"manage")} ${scopeFlag} to request update checks.`)}if(updateAvailableTotal>0){remediation.push(`Update available managed extensions via ${lifecycleFlagCommand(options,"install")} ${scopeFlag} <source>.`)}if(remediation.length===0){remediation.push(`No immediate action required. Re-run ${lifecycleFlagCommand(options,"manage")} ${scopeFlag} after extension changes.`)}return remediation}function buildExtensionTriageSummary(scope,warnings,extensions,options={}){const normalizedWarnings=[...new Set(warnings)].sort((left,right)=>left.localeCompare(right));const managedTotal=extensions.filter(entry=>entry.managed).length;const enabledTotal=extensions.filter(entry=>entry.enabled).length;const activeTotal=extensions.filter(entry=>entry.active).length;const updateAvailableTotal=extensions.filter(entry=>entry.update_check_status==="checked"&&entry.update_available===true).length;const unmanagedExtensions=extensions.filter(entry=>entry.managed===false);const unmanagedExpectedExtensions=unmanagedExtensions.filter(entry=>isExpectedUnmanagedExtension(entry)).map(entry=>entry.name).sort((left,right)=>left.localeCompare(right));const unmanagedActionRequiredExtensions=unmanagedExtensions.filter(entry=>!isExpectedUnmanagedExtension(entry)).map(entry=>entry.name).sort((left,right)=>left.localeCompare(right));const updateCheckStatusTotals={checked:0,skipped_unmanaged:0,skipped_non_github:0,failed:0,not_checked:0};for(const entry of extensions){updateCheckStatusTotals[entry.update_check_status]+=1}const updateCheckFailedTotal=updateCheckStatusTotals.failed;const skippedNonGithubTotal=extensions.filter(entry=>entry.update_check_status==="skipped_non_github"&&entry.source?.kind!=="builtin").length;const partialCoverageWarnings=Object.entries({skipped_unmanaged:unmanagedActionRequiredExtensions.length,skipped_non_github:skippedNonGithubTotal,failed:updateCheckFailedTotal,not_checked:updateCheckStatusTotals.not_checked}).filter(([,count])=>count>0).map(([status,count])=>`extension_update_health_partial_coverage:${status}:${count}`);const updateHealthPartial=partialCoverageWarnings.length>0;const updateHealthCoverage=updateHealthPartial?"partial":"full";const effectiveWarnings=[...new Set([...normalizedWarnings,...partialCoverageWarnings])].sort((left,right)=>left.localeCompare(right));const warningCodes=[...new Set(effectiveWarnings.map(value=>warningCode(value)))].sort((left,right)=>left.localeCompare(right));const policyWarnings=summarizePolicyWarnings(effectiveWarnings);const scopeFlag=scope==="global"?"--global":"--project";const collisionPlan=buildRegistrationCollisionPlan(scope,normalizedWarnings,extensions,options);const remediation=buildExtensionTriageRemediation({normalizedWarnings:effectiveWarnings,options,scope,scopeFlag,updateCheckFailedTotal,policyWarningCount:policyWarnings.warning_count,unmanagedActionRequiredTotal:unmanagedActionRequiredExtensions.length,notCheckedTotal:updateCheckStatusTotals.not_checked,skippedNonGithubTotal,updateAvailableTotal});return{status:effectiveWarnings.length===0?"ok":"warn",warning_count:effectiveWarnings.length,warning_codes:warningCodes,warnings:effectiveWarnings,policy_warning_count:policyWarnings.warning_count,policy_violation_count:policyWarnings.violation_count,policy_blocked_count:policyWarnings.blocked_count,total_extensions:extensions.length,managed_total:managedTotal,enabled_total:enabledTotal,active_total:activeTotal,update_available_total:updateAvailableTotal,update_health_coverage:updateHealthCoverage,update_health_partial:updateHealthPartial,unmanaged_loaded_extension_count:unmanagedExtensions.length,unmanaged_loaded_extensions:unmanagedExtensions.map(entry=>entry.name).sort((left,right)=>left.localeCompare(right)),unmanaged_expected_extension_count:unmanagedExpectedExtensions.length,unmanaged_expected_extensions:unmanagedExpectedExtensions,unmanaged_action_required_extension_count:unmanagedActionRequiredExtensions.length,unmanaged_action_required_extensions:unmanagedActionRequiredExtensions,update_check_status_totals:updateCheckStatusTotals,update_check_failed_total:updateCheckFailedTotal,top_warnings:effectiveWarnings.slice(0,8),remediation,...collisionPlan?{collision_plan:collisionPlan}:{}}}function parseDoctorDetailMode(raw){if(!raw||raw.trim().length===0){return"summary"}const normalized=raw.trim().toLowerCase();if(normalized==="summary"||normalized==="deep"){return normalized}throw new PmCliError(`Invalid --detail value "${raw}". Expected summary or deep.`,EXIT_CODE.USAGE)}function warningCode(value){const normalized=value.trim();const separator=normalized.indexOf(":");if(separator===-1){return normalized}return normalized.slice(0,separator)}function collectUnknownCapabilityGuidance(warnings){const seen=new Set;const guidance=[];for(const warning of warnings){const parsedDetails=(()=>{const unknownWarning=parseUnknownExtensionCapabilityWarning(warning);if(unknownWarning){return[unknownWarning]}return parseLegacyExtensionCapabilityAliasWarning(warning)})();for(const parsed of parsedDetails){const key=`${parsed.layer}:${parsed.name}:${parsed.capability}`;if(seen.has(key)){continue}seen.add(key);guidance.push(parsed)}}return guidance}function buildCapabilityContractMetadata(){return{version:EXTENSION_CAPABILITY_CONTRACT.version,capabilities:[...EXTENSION_CAPABILITY_CONTRACT.capabilities],legacy_aliases:{...EXTENSION_CAPABILITY_CONTRACT.legacy_aliases}}}function isExpectedUnmanagedExtension(entry){const normalizedName=normalizeExtensionNameForMatch(entry.name);const normalizedDirectory=normalizeExtensionNameForMatch(entry.directory);if(normalizedName.startsWith("builtin-")){return true}return normalizedDirectory==="beads"||normalizedDirectory==="todos"}function buildDoctorConsistencySummary(scope,installedExtensions,loadedExtensions,failedLoads,disabledByFlag){if(scope!=="project"||disabledByFlag){return{warnings:[],summary:{active_project_count:0,loaded_project_count:0,active_project_names:[],loaded_project_names:[],missing_active_project_names:[]}}}const activeProjectNames=[...new Set(installedExtensions.filter(entry=>entry.active).map(entry=>normalizeExtensionNameForMatch(entry.name)))].sort((left,right)=>left.localeCompare(right));const loadedProjectNames=[...new Set(loadedExtensions.filter(entry=>entry.layer==="project").map(entry=>normalizeExtensionNameForMatch(entry.name)))].sort((left,right)=>left.localeCompare(right));const failedLoadNames=new Set(failedLoads.map(entry=>normalizeExtensionNameForMatch(entry.name)));const missingActiveProjectNames=activeProjectNames.filter(name=>!loadedProjectNames.includes(name)&&!failedLoadNames.has(name)).sort((left,right)=>left.localeCompare(right));const warnings=missingActiveProjectNames.length>0?[`extension_doctor_consistency_active_not_loaded:${missingActiveProjectNames.join(",")}`]:[];return{warnings,summary:{active_project_count:activeProjectNames.length,loaded_project_count:loadedProjectNames.length,active_project_names:activeProjectNames,loaded_project_names:loadedProjectNames,missing_active_project_names:missingActiveProjectNames}}}export{applyDoctorRuntimeActivationState,buildCapabilityContractMetadata,buildDoctorConsistencySummary,buildExtensionTriageSummary,buildRegistrationCollisionRemediation,classifyDoctorActivationFailureWarnings,classifyDoctorLoadFailureWarnings,classifyUnusedCapabilityWarnings,collectUnknownCapabilityGuidance,parseDoctorDetailMode,summarizeExtensionFailures};
 //# sourceMappingURL=doctor.js.map
-//# debugId=54ce5bae-db04-5c19-81df-093802bf41c7