/**
 * The `upgrade` command adapter: read the running version, ask
 * CLI maintenance what the request selects, settle it as a preview or an
 * apply, and render the assessment as the machine document and the human
 * view.
 */
import * as Effect from "effect/Effect";
import * as Schema from "effect/Schema";
import { type AppError } from "../../app-error/index.js";
import { Verbosity } from "../../cli-flags/index.js";
import { ExecutionDirectory } from "../../execution-directory.js";
import { Screen } from "../../screen/index.js";
export declare const UpgradeDocumentSchema: Schema.Struct<{
    readonly result: Schema.Struct<{
        readonly contract: Schema.Literal<"axm.upgrade-assessment/v1">;
        readonly outcome: Schema.Literals<readonly ["previewed", "applied", "no-op", "failed", "indeterminate"]>;
        readonly disposition: Schema.Literals<readonly ["previewed", "upgraded", "reinstalled", "already-current", "local-newer", "downgrade-refused", "installer-lagging", "installer-leading", "installer-unavailable", "installer-indeterminate", "mutation-failed", "verification-failed", "rolled-back", "recovery-required"]>;
        readonly message: Schema.String;
        readonly intent: Schema.Struct<{
            readonly mode: Schema.Literals<readonly ["latest", "exact"]>;
            readonly requestedVersion: Schema.NullOr<Schema.String>;
            readonly reinstall: Schema.Boolean;
        }>;
        readonly platform: Schema.Struct<{
            readonly os: Schema.String;
            readonly arch: Schema.String;
            readonly target: Schema.String;
            readonly binaryName: Schema.String;
        }>;
        readonly local: Schema.Struct<{
            readonly version: Schema.NullOr<Schema.String>;
            readonly relation: Schema.Literals<readonly ["upgrade-available", "current", "local-newer", "unknown-local"]>;
        }>;
        readonly ownership: Schema.Struct<{
            readonly method: Schema.Literals<readonly ["script", "homebrew", "npm", "pnpm", "yarn", "unknown"]>;
            readonly source: Schema.String;
            readonly evidence: Schema.$Array<Schema.String>;
            readonly confidence: Schema.Literals<readonly ["high", "medium", "low"]>;
            readonly executablePath: Schema.NullOr<Schema.String>;
        }>;
        readonly canonical: Schema.Struct<{
            readonly source: Schema.Literals<readonly ["github-latest", "exact-version"]>;
            readonly version: Schema.String;
            readonly validatedAt: Schema.String;
        }>;
        readonly installerAvailability: Schema.Struct<{
            readonly state: Schema.Literals<readonly ["ready", "lagging", "leading", "unavailable", "indeterminate", "not-required"]>;
            readonly observedVersion: Schema.NullOr<Schema.String>;
        }>;
        readonly target: Schema.Struct<{
            readonly version: Schema.String;
            readonly releaseTag: Schema.String;
            readonly binaryAssetUrl: Schema.NullOr<Schema.String>;
            readonly checksumAssetUrl: Schema.NullOr<Schema.String>;
        }>;
        readonly mutation: Schema.Struct<{
            readonly state: Schema.Literals<readonly ["not-attempted", "unchanged", "updated", "rolled-back", "unknown"]>;
        }>;
        readonly verification: Schema.Struct<{
            readonly state: Schema.Literals<readonly ["verified", "unchanged", "mismatch", "unavailable", "not-attempted"]>;
            readonly reportedVersion: Schema.NullOr<Schema.String>;
            readonly executables: Schema.$Array<Schema.Struct<{
                readonly role: Schema.Literals<readonly ["invoked", "manager-owned", "path-resolved"]>;
                readonly path: Schema.String;
                readonly phase: Schema.optional<Schema.Literals<readonly ["pre-mutation", "post-primary", "post-fallback"]>>;
                readonly requestedExecutable: Schema.optional<Schema.String>;
                readonly resolvedExecutable: Schema.optional<Schema.NullOr<Schema.String>>;
                readonly queryOutcome: Schema.optional<Schema.Literals<readonly ["reported", "unavailable", "invalid", "not-attempted"]>>;
                readonly reportedVersion: Schema.NullOr<Schema.String>;
                readonly exitCode: Schema.NullOr<Schema.Number>;
            }>>;
        }>;
        readonly recovery: Schema.Struct<{
            readonly backupPath: Schema.NullOr<Schema.String>;
            readonly recommendedCommand: Schema.NullOr<Schema.Struct<{
                readonly display: Schema.String;
                readonly executable: Schema.String;
                readonly args: Schema.$Array<Schema.String>;
                readonly shellRequired: Schema.Boolean;
            }>>;
        }>;
        readonly commands: Schema.$Array<Schema.Struct<{
            readonly display: Schema.String;
            readonly purpose: Schema.Literals<readonly ["detection", "preparation", "delegation", "verification", "rollback"]>;
            readonly executable: Schema.String;
            readonly args: Schema.$Array<Schema.String>;
            readonly executionState: Schema.Literals<readonly ["not-started", "exited", "timed-out"]>;
            readonly exitCode: Schema.NullOr<Schema.Number>;
            readonly stdout: Schema.String;
            readonly stderr: Schema.String;
            readonly outputTruncated: Schema.Boolean;
        }>>;
        readonly details: Schema.Struct<{
            readonly messages: Schema.$Array<Schema.String>;
            readonly homebrewFailure: Schema.NullOr<Schema.Literals<readonly ["tap-query-failed", "tap-preparation-failed", "refresh-failed", "formula-query-failed", "target-formula-unavailable", "formula-ahead-of-target", "delegation-failed", "manager-version-unchanged", "manager-version-mismatch", "path-version-unavailable", "path-version-mismatch", "manager-path-disagreement"]>>;
            readonly observedFormulaVersion: Schema.NullOr<Schema.String>;
        }>;
        readonly steps: Schema.$Array<Schema.Struct<{
            readonly label: Schema.String;
            readonly status: Schema.Literals<readonly ["applied", "unchanged", "failed", "blocked"]>;
            readonly message: Schema.String;
            readonly details: Schema.$Array<Schema.String>;
            readonly artifact: Schema.optional<Schema.Struct<{
                readonly path: Schema.optional<Schema.String>;
                readonly scope: Schema.Literal<"user">;
                readonly version: Schema.optional<Schema.String>;
                readonly change: Schema.Literals<readonly ["updated", "unchanged", "unknown"]>;
                readonly previousVersion: Schema.optional<Schema.String>;
            }>>;
        }>>;
    }>;
}>;
export type UpgradeDocument = typeof UpgradeDocumentSchema.Type;
export interface UpgradeHandlerArgs {
    readonly reinstall: boolean;
    /** Optional exact stable version. Omit to use GitHub's latest release. */
    readonly requestedVersion?: string | undefined;
    /** Resolve and report the upgrade without performing it. */
    readonly preview?: boolean;
    /** Test/internal override for an observed local version. */
    readonly localVersion?: string | null;
}
export declare const handleUpgrade: (args: UpgradeHandlerArgs) => Effect.Effect<void, AppError, Verbosity | Screen | import("@agentxm/cli-maintenance/self-update/application").UpdateCheckCache | ExecutionDirectory | import("@agentxm/cli-maintenance/self-update/application").CliReleaseCatalog | import("@agentxm/cli-maintenance/self-update/application").InstallationInspection | import("@agentxm/cli-maintenance/self-update/application").InstallerInstructions | import("@agentxm/cli-maintenance/self-update/application").PackageInstaller | import("@agentxm/cli-maintenance/self-update/application").InstallationRecorder | import("@agentxm/cli-maintenance/self-update/application").ScriptReleaseAssets | import("@agentxm/cli-maintenance/self-update/application").ScriptExecutableInstaller>;
//# sourceMappingURL=handler.d.ts.map