@unbrained/pm-cli 2026.10.12 → 2026.10.13

package/dist/sdk/extension.d.ts

@@ -24,315 +24,315 @@ export type ExtensionScope = "project" | "global";
 export type ExtensionActivationStatus = "ok" | "failed" | "not_loaded" | "unknown";
 /** Documents the extension command options payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandOptions {
-    /** Value that configures or reports install for this contract. */
-    install?: boolean;
-    /** Value that configures or reports uninstall for this contract. */
-    uninstall?: boolean;
-    /** Value that configures or reports explore for this contract. */
-    explore?: boolean;
-    /** Value that configures or reports manage for this contract. */
-    manage?: boolean;
-    /** Value that configures or reports describe for this contract. */
-    describe?: boolean;
-    /** Value that configures or reports markdown for this contract. */
-    markdown?: boolean;
-    /** Value that configures or reports output for this contract. */
-    output?: string;
-    /** Value that configures or reports reload for this contract. */
-    reload?: boolean;
-    /** Value that configures or reports doctor for this contract. */
-    doctor?: boolean;
-    /** Value that configures or reports catalog for this contract. */
-    catalog?: boolean;
-    /** Value that configures or reports init for this contract. */
-    init?: boolean;
-    /** Value that configures or reports scaffold for this contract. */
-    scaffold?: boolean;
-    /** Value that configures or reports strict exit for this contract. */
-    strictExit?: boolean;
-    /** Value that configures or reports fail on warn for this contract. */
-    failOnWarn?: boolean;
-    /** Value that configures or reports adopt for this contract. */
-    adopt?: boolean;
-    /** Value that configures or reports adopt all for this contract. */
-    adoptAll?: boolean;
-    /** Registers this package's commands, actions, and runtime hooks with the host. */
-    activate?: boolean;
-    /** Value that configures or reports deactivate for this contract. */
-    deactivate?: boolean;
-    /** Plan or apply active extension migrations. */
-    migrate?: boolean;
-    /** Value that configures or reports project for this contract. */
-    project?: boolean;
-    /** Value that configures or reports local for this contract. */
-    local?: boolean;
-    /** Value that configures or reports global for this contract. */
-    global?: boolean;
-    /** Value that configures or reports gh for this contract. */
-    gh?: string;
-    /** Value that configures or reports github for this contract. */
-    github?: string;
-    /** Value that configures or reports ref for this contract. */
-    ref?: string;
-    /** Value that configures or reports detail for this contract. */
-    detail?: string;
-    /** Value that configures or reports trace for this contract. */
-    trace?: boolean;
-    /** Value that configures or reports watch for this contract. */
-    watch?: boolean;
-    /** Value that configures or reports runtime probe for this contract. */
-    runtimeProbe?: boolean;
-    /** Skip remote freshness checks during manage and report unknown availability. */
-    offline?: boolean;
-    /** Value that configures or reports fix managed state for this contract. */
-    fixManagedState?: boolean;
-    /** Value that configures or reports isolated for this contract. */
-    isolated?: boolean;
-    /** Value that configures or reports ignore global for this contract. */
-    ignoreGlobal?: boolean;
-    /** Value that configures or reports fields for this contract. */
-    fields?: string;
-    /** Value that configures or reports capability for this contract. */
-    capability?: string;
-    /** Value that configures or reports declarative for this contract. */
-    declarative?: boolean;
-    /** Value that configures or reports vocabulary for this contract. */
-    vocabulary?: "extension" | "package";
-    /** Plan migrations or resolve install sources and estimate copying without destination writes or activation. */
-    dryRun?: boolean;
-    /** SDK limits and cancellation for install copy-cost enumeration. */
-    copyPlan?: ExtensionCopyPlanOptions;
+/** Value that configures or reports install for this contract. */
+install?: boolean;
+/** Value that configures or reports uninstall for this contract. */
+uninstall?: boolean;
+/** Value that configures or reports explore for this contract. */
+explore?: boolean;
+/** Value that configures or reports manage for this contract. */
+manage?: boolean;
+/** Value that configures or reports describe for this contract. */
+describe?: boolean;
+/** Value that configures or reports markdown for this contract. */
+markdown?: boolean;
+/** Value that configures or reports output for this contract. */
+output?: string;
+/** Value that configures or reports reload for this contract. */
+reload?: boolean;
+/** Value that configures or reports doctor for this contract. */
+doctor?: boolean;
+/** Value that configures or reports catalog for this contract. */
+catalog?: boolean;
+/** Value that configures or reports init for this contract. */
+init?: boolean;
+/** Value that configures or reports scaffold for this contract. */
+scaffold?: boolean;
+/** Value that configures or reports strict exit for this contract. */
+strictExit?: boolean;
+/** Value that configures or reports fail on warn for this contract. */
+failOnWarn?: boolean;
+/** Value that configures or reports adopt for this contract. */
+adopt?: boolean;
+/** Value that configures or reports adopt all for this contract. */
+adoptAll?: boolean;
+/** Registers this package's commands, actions, and runtime hooks with the host. */
+activate?: boolean;
+/** Value that configures or reports deactivate for this contract. */
+deactivate?: boolean;
+/** Plan or apply active extension migrations. */
+migrate?: boolean;
+/** Value that configures or reports project for this contract. */
+project?: boolean;
+/** Value that configures or reports local for this contract. */
+local?: boolean;
+/** Value that configures or reports global for this contract. */
+global?: boolean;
+/** Value that configures or reports gh for this contract. */
+gh?: string;
+/** Value that configures or reports github for this contract. */
+github?: string;
+/** Value that configures or reports ref for this contract. */
+ref?: string;
+/** Value that configures or reports detail for this contract. */
+detail?: string;
+/** Value that configures or reports trace for this contract. */
+trace?: boolean;
+/** Value that configures or reports watch for this contract. */
+watch?: boolean;
+/** Value that configures or reports runtime probe for this contract. */
+runtimeProbe?: boolean;
+/** Skip remote freshness checks during manage and report unknown availability. */
+offline?: boolean;
+/** Value that configures or reports fix managed state for this contract. */
+fixManagedState?: boolean;
+/** Value that configures or reports isolated for this contract. */
+isolated?: boolean;
+/** Value that configures or reports ignore global for this contract. */
+ignoreGlobal?: boolean;
+/** Value that configures or reports fields for this contract. */
+fields?: string;
+/** Value that configures or reports capability for this contract. */
+capability?: string;
+/** Value that configures or reports declarative for this contract. */
+declarative?: boolean;
+/** Value that configures or reports vocabulary for this contract. */
+vocabulary?: "extension" | "package";
+/** Plan migrations or resolve install sources and estimate copying without destination writes or activation. */
+dryRun?: boolean;
+/** SDK limits and cancellation for install copy-cost enumeration. */
+copyPlan?: ExtensionCopyPlanOptions;
 }
 /** Documents the managed extension summary payload exchanged by command, SDK, and package integrations. */
 export interface ManagedExtensionSummary {
-    /** Value that configures or reports name for this contract. */
-    name: string;
-    /** Value that configures or reports directory for this contract. */
-    directory: string;
-    /** Value that configures or reports version for this contract. */
-    version: string;
-    /** Value that configures or reports entry for this contract. */
-    entry: string;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports active for this contract. */
-    active: boolean;
-    /** Whether enabled applies to this operation. */
-    enabled: boolean;
-    /** Value that configures or reports runtime active for this contract. */
-    runtime_active: boolean | null;
-    /** Activation outcome reported for this extension. */
-    activation_status: ExtensionActivationStatus;
-    /** Value that configures or reports command paths for this contract. */
-    command_paths?: string[];
-    /** Value that configures or reports action paths for this contract. */
-    action_paths?: string[];
-    /** Static install-time contribution inventory. */
-    contributions?: ManagedExtensionRecord["contributions"];
-    /** Value that configures or reports managed for this contract. */
-    managed: boolean;
-    /** Value that configures or reports source for this contract. */
-    source?: ManagedExtensionSource;
-    /** Value that configures or reports update available for this contract. */
-    update_available?: boolean | null;
-    /** ISO 8601 timestamp recording when last update check occurred. */
-    last_update_check_at?: string;
-    /** Value that configures or reports last update remote commit for this contract. */
-    last_update_remote_commit?: string;
-    /** Latest npm registry version observed by this invocation. */
-    last_update_remote_version?: string;
-    /** Value that configures or reports update error for this contract. */
-    update_error?: string;
-    /** Outcome of the registry update check for this extension. */
-    update_check_status: ExtensionUpdateCheckStatus;
-    /** Value that configures or reports update check reason for this contract. */
-    update_check_reason: string;
+/** Value that configures or reports name for this contract. */
+name: string;
+/** Value that configures or reports directory for this contract. */
+directory: string;
+/** Value that configures or reports version for this contract. */
+version: string;
+/** Value that configures or reports entry for this contract. */
+entry: string;
+/** Value that configures or reports scope for this contract. */
+scope: ExtensionScope;
+/** Value that configures or reports active for this contract. */
+active: boolean;
+/** Whether enabled applies to this operation. */
+enabled: boolean;
+/** Value that configures or reports runtime active for this contract. */
+runtime_active: boolean | null;
+/** Activation outcome reported for this extension. */
+activation_status: ExtensionActivationStatus;
+/** Value that configures or reports command paths for this contract. */
+command_paths?: string[];
+/** Value that configures or reports action paths for this contract. */
+action_paths?: string[];
+/** Static install-time contribution inventory. */
+contributions?: ManagedExtensionRecord["contributions"];
+/** Value that configures or reports managed for this contract. */
+managed: boolean;
+/** Value that configures or reports source for this contract. */
+source?: ManagedExtensionSource;
+/** Value that configures or reports update available for this contract. */
+update_available?: boolean | null;
+/** ISO 8601 timestamp recording when last update check occurred. */
+last_update_check_at?: string;
+/** Value that configures or reports last update remote commit for this contract. */
+last_update_remote_commit?: string;
+/** Latest npm registry version observed by this invocation. */
+last_update_remote_version?: string;
+/** Value that configures or reports update error for this contract. */
+update_error?: string;
+/** Outcome of the registry update check for this extension. */
+update_check_status: ExtensionUpdateCheckStatus;
+/** Value that configures or reports update check reason for this contract. */
+update_check_reason: string;
 }
 /** Documents the extension command result payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCommandResult {
-    /** Whether the operation completed without a blocking failure. */
-    ok: boolean;
-    /** Value that configures or reports action for this contract. */
-    action: ExtensionCommandAction;
-    /** Value that configures or reports scope for this contract. */
-    scope: ExtensionScope;
-    /** Value that configures or reports roots for this contract. */
-    roots: {
-        project: string;
-        global: string;
-        selected: string;
-        settings_root: string;
-    };
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Value that configures or reports details for this contract. */
-    details: Record<string, unknown> & {
-        install_plan?: ExtensionInstallPlan;
-    };
+/** Whether the operation completed without a blocking failure. */
+ok: boolean;
+/** Value that configures or reports action for this contract. */
+action: ExtensionCommandAction;
+/** Value that configures or reports scope for this contract. */
+scope: ExtensionScope;
+/** Value that configures or reports roots for this contract. */
+roots: {
+project: string;
+global: string;
+selected: string;
+settings_root: string;
+};
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Value that configures or reports details for this contract. */
+details: Record<string, unknown> & {
+install_plan?: ExtensionInstallPlan;
+};
 }
 /** Documents the extension triage summary payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionTriageSummary {
-    /** Lifecycle state reported for status. */
-    status: "ok" | "warn";
-    /** Number of warning entries represented by this result. */
-    warning_count: number;
-    /** Value that configures or reports warning codes for this contract. */
-    warning_codes: string[];
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** Number of policy warning entries represented by this result. */
-    policy_warning_count: number;
-    /** Number of policy violation entries represented by this result. */
-    policy_violation_count: number;
-    /** Number of policy blocked entries represented by this result. */
-    policy_blocked_count: number;
-    /** Value that configures or reports total extensions for this contract. */
-    total_extensions: number;
-    /** Value that configures or reports managed total for this contract. */
-    managed_total: number;
-    /** Value that configures or reports enabled total for this contract. */
-    enabled_total: number;
-    /** Value that configures or reports active total for this contract. */
-    active_total: number;
-    /** Value that configures or reports update available total for this contract. */
-    update_available_total: number;
-    /** Value that configures or reports update health coverage for this contract. */
-    update_health_coverage: "full" | "partial";
-    /** Value that configures or reports update health partial for this contract. */
-    update_health_partial: boolean;
-    /** Number of unmanaged loaded extension entries represented by this result. */
-    unmanaged_loaded_extension_count: number;
-    /** Value that configures or reports unmanaged loaded extensions for this contract. */
-    unmanaged_loaded_extensions: string[];
-    /** Number of unmanaged expected extension entries represented by this result. */
-    unmanaged_expected_extension_count: number;
-    /** Value that configures or reports unmanaged expected extensions for this contract. */
-    unmanaged_expected_extensions: string[];
-    /** Number of unmanaged action required extension entries represented by this result. */
-    unmanaged_action_required_extension_count: number;
-    /** Value that configures or reports unmanaged action required extensions for this contract. */
-    unmanaged_action_required_extensions: string[];
-    /** Value that configures or reports update check status totals for this contract. */
-    update_check_status_totals: Record<ExtensionUpdateCheckStatus, number>;
-    /** Value that configures or reports update check failed total for this contract. */
-    update_check_failed_total: number;
-    /** Value that configures or reports top warnings for this contract. */
-    top_warnings: string[];
-    /** Value that configures or reports remediation for this contract. */
-    remediation: string[];
-    /** Value that configures or reports collision plan for this contract. */
-    collision_plan?: ExtensionCollisionPlan;
+/** Lifecycle state reported for status. */
+status: "ok" | "warn";
+/** Number of warning entries represented by this result. */
+warning_count: number;
+/** Value that configures or reports warning codes for this contract. */
+warning_codes: string[];
+/** Value that configures or reports warnings for this contract. */
+warnings: string[];
+/** Number of policy warning entries represented by this result. */
+policy_warning_count: number;
+/** Number of policy violation entries represented by this result. */
+policy_violation_count: number;
+/** Number of policy blocked entries represented by this result. */
+policy_blocked_count: number;
+/** Value that configures or reports total extensions for this contract. */
+total_extensions: number;
+/** Value that configures or reports managed total for this contract. */
+managed_total: number;
+/** Value that configures or reports enabled total for this contract. */
+enabled_total: number;
+/** Value that configures or reports active total for this contract. */
+active_total: number;
+/** Value that configures or reports update available total for this contract. */
+update_available_total: number;
+/** Value that configures or reports update health coverage for this contract. */
+update_health_coverage: "full" | "partial";
+/** Value that configures or reports update health partial for this contract. */
+update_health_partial: boolean;
+/** Number of unmanaged loaded extension entries represented by this result. */
+unmanaged_loaded_extension_count: number;
+/** Value that configures or reports unmanaged loaded extensions for this contract. */
+unmanaged_loaded_extensions: string[];
+/** Number of unmanaged expected extension entries represented by this result. */
+unmanaged_expected_extension_count: number;
+/** Value that configures or reports unmanaged expected extensions for this contract. */
+unmanaged_expected_extensions: string[];
+/** Number of unmanaged action required extension entries represented by this result. */
+unmanaged_action_required_extension_count: number;
+/** Value that configures or reports unmanaged action required extensions for this contract. */
+unmanaged_action_required_extensions: string[];
+/** Value that configures or reports update check status totals for this contract. */
+update_check_status_totals: Record<ExtensionUpdateCheckStatus, number>;
+/** Value that configures or reports update check failed total for this contract. */
+update_check_failed_total: number;
+/** Value that configures or reports top warnings for this contract. */
+top_warnings: string[];
+/** Value that configures or reports remediation for this contract. */
+remediation: string[];
+/** Value that configures or reports collision plan for this contract. */
+collision_plan?: ExtensionCollisionPlan;
 }
 /** Documents the extension collision plan payload exchanged by command, SDK, and package integrations. */
 export interface ExtensionCollisionPlan {
-    /** Lifecycle state reported for status. */
-    status: "ok" | "conflicts_detected";
-    /** Number of collision entries represented by this result. */
-    collision_count: number;
-    /** Number of extension entries represented by this result. */
-    extension_count: number;
-    /** Value that configures or reports next best command for this contract. */
-    next_best_command: string;
-    /** Value that configures or reports collisions for this contract. */
-    collisions: Array<{
-        code: string;
-        surface: string;
-        winner: {
-            layer: ExtensionScope;
-            name: string;
-        };
-        displaced: {
-            layer: ExtensionScope;
-            name: string;
-        };
-    }>;
-    /** Value that configures or reports remediation candidates for this contract. */
-    remediation_candidates: Array<{
-        action: "deactivate";
-        extension: string;
-        command: string;
-        affected_collisions: number;
-        feature_loss: {
-            command_paths: string[];
-            action_paths: string[];
-        };
-    }>;
+/** Lifecycle state reported for status. */
+status: "ok" | "conflicts_detected";
+/** Number of collision entries represented by this result. */
+collision_count: number;
+/** Number of extension entries represented by this result. */
+extension_count: number;
+/** Value that configures or reports next best command for this contract. */
+next_best_command: string;
+/** Value that configures or reports collisions for this contract. */
+collisions: Array<{
+code: string;
+surface: string;
+winner: {
+layer: ExtensionScope;
+name: string;
+};
+displaced: {
+layer: ExtensionScope;
+name: string;
+};
+}>;
+/** Value that configures or reports remediation candidates for this contract. */
+remediation_candidates: Array<{
+action: "deactivate";
+extension: string;
+command: string;
+affected_collisions: number;
+feature_loss: {
+command_paths: string[];
+action_paths: string[];
+};
+}>;
 }
 /** Restricts extension update check status values accepted by command, SDK, and storage contracts. */
 export type ExtensionUpdateCheckStatus = "checked" | "skipped_unmanaged" | "skipped_non_github" | "failed" | "not_checked";
 interface ExtensionUpdateCheckResolution {
-    status: ExtensionUpdateCheckStatus;
-    reason: string;
+status: ExtensionUpdateCheckStatus;
+reason: string;
 }
 /** Restricts extension doctor detail mode values accepted by command, SDK, and storage contracts. */
 export type ExtensionDoctorDetailMode = "summary" | "deep";
 interface ExtensionPolicyOverrideDetails {
-    name: string;
-    disabled?: boolean;
-    require_trusted?: boolean;
-    require_provenance?: boolean;
-    sandbox_profile?: "none" | "restricted" | "strict";
-    allowed_capabilities?: string[];
-    blocked_capabilities?: string[];
-    allowed_surfaces?: string[];
-    blocked_surfaces?: string[];
-    allowed_commands?: string[];
-    blocked_commands?: string[];
-    allowed_actions?: string[];
-    blocked_actions?: string[];
-    allowed_services?: string[];
-    blocked_services?: string[];
+name: string;
+disabled?: boolean;
+require_trusted?: boolean;
+require_provenance?: boolean;
+sandbox_profile?: "none" | "restricted" | "strict";
+allowed_capabilities?: string[];
+blocked_capabilities?: string[];
+allowed_surfaces?: string[];
+blocked_surfaces?: string[];
+allowed_commands?: string[];
+blocked_commands?: string[];
+allowed_actions?: string[];
+blocked_actions?: string[];
+allowed_services?: string[];
+blocked_services?: string[];
 }
 interface ExtensionPolicyDetails {
-    mode: "off" | "warn" | "enforce";
-    trust_mode: "off" | "warn" | "enforce";
-    require_provenance: boolean;
-    trusted_extensions: string[];
-    default_sandbox_profile: "none" | "restricted" | "strict";
-    allowed_extensions: string[];
-    blocked_extensions: string[];
-    allowed_capabilities: string[];
-    blocked_capabilities: string[];
-    allowed_surfaces: string[];
-    blocked_surfaces: string[];
-    allowed_commands: string[];
-    blocked_commands: string[];
-    allowed_actions: string[];
-    blocked_actions: string[];
-    allowed_services: string[];
-    blocked_services: string[];
-    extension_overrides: ExtensionPolicyOverrideDetails[];
+mode: "off" | "warn" | "enforce";
+trust_mode: "off" | "warn" | "enforce";
+require_provenance: boolean;
+trusted_extensions: string[];
+default_sandbox_profile: "none" | "restricted" | "strict";
+allowed_extensions: string[];
+blocked_extensions: string[];
+allowed_capabilities: string[];
+blocked_capabilities: string[];
+allowed_surfaces: string[];
+blocked_surfaces: string[];
+allowed_commands: string[];
+blocked_commands: string[];
+allowed_actions: string[];
+blocked_actions: string[];
+allowed_services: string[];
+blocked_services: string[];
+extension_overrides: ExtensionPolicyOverrideDetails[];
 }
 type ActivationFailureEntry = Awaited<ReturnType<typeof activateExtensions>>["failed"][number];
 interface ActivationFailureDiagnostic {
-    layer: string;
-    name: string;
-    entry_path: string;
-    error: string;
-    missing_capability?: string;
-    hint?: string;
-    trace?: {
-        method: string;
-        registration_index: number;
-        expected_schema: string;
-        command?: string;
-        capability?: string;
-        missing_capability?: string;
-        hint?: string;
-    };
+layer: string;
+name: string;
+entry_path: string;
+error: string;
+missing_capability?: string;
+hint?: string;
+trace?: {
+method: string;
+registration_index: number;
+expected_schema: string;
+command?: string;
+capability?: string;
+missing_capability?: string;
+hint?: string;
+};
 }
 interface AdoptedUnmanagedExtension {
-    name: string;
-    directory: string;
-    version: string;
-    entry: string;
-    source: ManagedExtensionSource;
+name: string;
+directory: string;
+version: string;
+entry: string;
+source: ManagedExtensionSource;
 }
 interface AdoptUnmanagedExtensionsResult {
-    state: ManagedExtensionState;
-    adopted_entries: AdoptedUnmanagedExtension[];
-    unmanaged_candidates: ManagedExtensionSummary[];
-    already_managed_count: number;
+state: ManagedExtensionState;
+adopted_entries: AdoptedUnmanagedExtension[];
+unmanaged_candidates: ManagedExtensionSummary[];
+already_managed_count: number;
 }
 /**
  * Entry point for the `pm extension` / `pm package` command surface. Resolves the
@@ -345,44 +345,44 @@ interface AdoptUnmanagedExtensionsResult {
 export declare const runExtension: (target: string | undefined, options: ExtensionCommandOptions, global: GlobalOptions) => Promise<ExtensionCommandResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
 export declare const _testOnly: {
-    adoptUnmanagedExtensions: (extensionsRoot: string, scope: ExtensionScope, installedExtensions: ManagedExtensionSummary[], state: ManagedExtensionState) => Promise<AdoptUnmanagedExtensionsResult>;
-    buildAdoptedExtensionSource: (githubOption: string | undefined, extensionTarget: string, extensionDirectory: string, ref: string | undefined) => ManagedExtensionSource;
-    buildExtensionPolicyDetails: (policy: PmSettings["extensions"]["policy"] | null | undefined) => ExtensionPolicyDetails;
-    buildInstallCommandDiscovery: (extensionName: string, source: ManagedExtensionSource, commandSummary: {
-        command_paths: string[];
-        action_paths: string[];
-    }, activationFailure?: ActivationFailureDiagnostic) => Record<string, unknown>;
-    checkGithubUpdate: (source: ManagedExtensionSource, gitCommandRunner?: typeof import("./extension/install-sources.js").runGitCommand) => Promise<import("./extension/update-check.js").GithubUpdateStatus>;
-    clearExtensionState: (settings: PmSettings, name: string) => boolean;
-    collectActivationFailureDiagnostics: (failures: ActivationFailureEntry[]) => ActivationFailureDiagnostic[];
-    findActivationFailureByName: (extensionName: string, failures: ActivationFailureDiagnostic[], layer?: ExtensionScope) => ActivationFailureDiagnostic | undefined;
-    resolveInstallRuntimeActivationStatus: (extensionName: string, scope: ExtensionScope, runtimeInstalled: ManagedExtensionSummary[], installActivationFailure: ActivationFailureDiagnostic | undefined) => ExtensionActivationStatus;
-    collectGlobalOutputOverrideDoctorWarnings: typeof collectGlobalOutputOverrideDoctorWarnings;
-    collectMcpCustomFieldCollisionDoctorWarnings: (activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
-    collectSchemaNarrowActivationDoctorWarnings: (loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
-    copyExtensionDirectoryWithoutSelfNesting: (sourceDirectory: string, destinationDirectory: string, copyDirectory: typeof fs.cp, temporaryDirectory?: string) => Promise<void>;
-    isErrnoCode: (error: unknown, code: string) => boolean;
-    isRetriableExtensionInstallCopyError: (error: unknown) => boolean;
-    listInstalledExtensions: (extensionsRoot: string, scope: ExtensionScope, settings: PmSettings, state: ManagedExtensionState) => Promise<{
-        extensions: ManagedExtensionSummary[];
-        warnings: string[];
-    }>;
-    mapWithFixedConcurrency: <Input, Output>(inputs: Input[], concurrency: number, mapper: (input: Input) => Promise<Output>) => Promise<Output[]>;
-    projectExtensionUpdateCheck: (entry: ManagedExtensionSummary | undefined) => {
-        update_check_status: string | null;
-        update_check_reason: string | null;
-    };
-    readOptionalMetadataFile: (filePath: string) => Promise<Buffer | null>;
-    requireTarget: (target: string | undefined, action: ExtensionCommandAction, options?: ExtensionCommandOptions) => string;
-    resolveAction: (target: string | undefined, options: ExtensionCommandOptions) => ExtensionCommandAction;
-    resolveCommandDiscoveryPackageName: (extensionName: string, source: ManagedExtensionSource) => string;
-    resolveGithubOption: (options: ExtensionCommandOptions) => string | undefined;
-    resolveInstalledExtensionCandidate: (installed: ManagedExtensionSummary[], extensionTarget: string) => Promise<ManagedExtensionSummary | undefined>;
-    resolveManagedInstallTimestamps: (existing: ManagedExtensionRecord | undefined, manifestVersion: string, source: ManagedExtensionSource, now: string) => {
-        installed_at: string;
-        updated_at: string;
-    };
-    resolveScope: (options: ExtensionCommandOptions) => ExtensionScope;
-    resolveUpdateCheckResolution: (managedEntry: ManagedExtensionRecord | undefined) => ExtensionUpdateCheckResolution;
-    withExtensionInstallLock: <T>(settingsRoot: string, destinationDirectoryName: string, run: () => Promise<T>, options?: import("./extension/install-runtime.js").ExtensionInstallLockOptions) => Promise<T>;
+adoptUnmanagedExtensions: (extensionsRoot: string, scope: ExtensionScope, installedExtensions: ManagedExtensionSummary[], state: ManagedExtensionState) => Promise<AdoptUnmanagedExtensionsResult>;
+buildAdoptedExtensionSource: (githubOption: string | undefined, extensionTarget: string, extensionDirectory: string, ref: string | undefined) => ManagedExtensionSource;
+buildExtensionPolicyDetails: (policy: PmSettings["extensions"]["policy"] | null | undefined) => ExtensionPolicyDetails;
+buildInstallCommandDiscovery: (extensionName: string, source: ManagedExtensionSource, commandSummary: {
+command_paths: string[];
+action_paths: string[];
+}, activationFailure?: ActivationFailureDiagnostic) => Record<string, unknown>;
+checkGithubUpdate: (source: ManagedExtensionSource, gitCommandRunner?: typeof import("./extension/install-sources.js").runGitCommand) => Promise<import("./extension/update-check.js").GithubUpdateStatus>;
+clearExtensionState: (settings: PmSettings, name: string) => boolean;
+collectActivationFailureDiagnostics: (failures: ActivationFailureEntry[]) => ActivationFailureDiagnostic[];
+findActivationFailureByName: (extensionName: string, failures: ActivationFailureDiagnostic[], layer?: ExtensionScope) => ActivationFailureDiagnostic | undefined;
+resolveInstallRuntimeActivationStatus: (extensionName: string, scope: ExtensionScope, runtimeInstalled: ManagedExtensionSummary[], installActivationFailure: ActivationFailureDiagnostic | undefined) => ExtensionActivationStatus;
+collectGlobalOutputOverrideDoctorWarnings: typeof collectGlobalOutputOverrideDoctorWarnings;
+collectMcpCustomFieldCollisionDoctorWarnings: (activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
+collectSchemaNarrowActivationDoctorWarnings: (loadResult: Awaited<ReturnType<typeof loadExtensions>>, activationResult: Awaited<ReturnType<typeof activateExtensions>>) => string[];
+copyExtensionDirectoryWithoutSelfNesting: (sourceDirectory: string, destinationDirectory: string, copyDirectory: typeof fs.cp, temporaryDirectory?: string) => Promise<void>;
+isErrnoCode: (error: unknown, code: string) => boolean;
+isRetriableExtensionInstallCopyError: (error: unknown) => boolean;
+listInstalledExtensions: (extensionsRoot: string, scope: ExtensionScope, settings: PmSettings, state: ManagedExtensionState) => Promise<{
+extensions: ManagedExtensionSummary[];
+warnings: string[];
+}>;
+mapWithFixedConcurrency: <Input, Output>(inputs: Input[], concurrency: number, mapper: (input: Input) => Promise<Output>) => Promise<Output[]>;
+projectExtensionUpdateCheck: (entry: ManagedExtensionSummary | undefined) => {
+update_check_status: string | null;
+update_check_reason: string | null;
+};
+readOptionalMetadataFile: (filePath: string) => Promise<Buffer | null>;
+requireTarget: (target: string | undefined, action: ExtensionCommandAction, options?: ExtensionCommandOptions) => string;
+resolveAction: (target: string | undefined, options: ExtensionCommandOptions) => ExtensionCommandAction;
+resolveCommandDiscoveryPackageName: (extensionName: string, source: ManagedExtensionSource) => string;
+resolveGithubOption: (options: ExtensionCommandOptions) => string | undefined;
+resolveInstalledExtensionCandidate: (installed: ManagedExtensionSummary[], extensionTarget: string) => Promise<ManagedExtensionSummary | undefined>;
+resolveManagedInstallTimestamps: (existing: ManagedExtensionRecord | undefined, manifestVersion: string, source: ManagedExtensionSource, now: string) => {
+installed_at: string;
+updated_at: string;
+};
+resolveScope: (options: ExtensionCommandOptions) => ExtensionScope;
+resolveUpdateCheckResolution: (managedEntry: ManagedExtensionRecord | undefined) => ExtensionUpdateCheckResolution;
+withExtensionInstallLock: <T>(settingsRoot: string, destinationDirectoryName: string, run: () => Promise<T>, options?: import("./extension/install-runtime.js").ExtensionInstallLockOptions) => Promise<T>;
 };