prismcast 1.9.0 → 1.10.0

package/dist/upgrade/commands.d.ts

@@ -1,6 +1,33 @@
+import type { InstallInfo } from "./detection.ts";
 /**
- * Main handler for the `upgrade` subcommand. Parses arguments and executes the appropriate upgrade logic.
+ * Result of running an upgrade command. The success flag distinguishes ran-without-error from threw-or-exited-non-zero; the runner does not surface the actual
+ * error because execSync's stderr is inherited to the user's terminal directly.
+ */
+export interface UpgradeResult {
+    readonly success: boolean;
+}
+/**
+ * The runtime context handleUpgradeCommand consumes. Each field models one capability the command needs - detection, version lookup, subprocess execution,
+ * stdout/stderr output, process termination, and a service-mode probe. Decision logic is a pure function of this shape; production wires it through
+ * createDefaultUpgradeContext (in commands.context.ts), tests pass a context literal.
+ */
+export interface UpgradeContext {
+    readonly detect: () => InstallInfo;
+    readonly exit: (code: number) => never;
+    readonly fetchLatestVersion: () => Promise<string | null>;
+    readonly isService: boolean;
+    readonly runUpgradeCommand: (cmd: string, options: {
+        cwd?: string;
+    }) => UpgradeResult;
+    readonly stderr: (line: string) => void;
+    readonly stdout: (line: string) => void;
+}
+/**
+ * Main handler for the `upgrade` subcommand. Parses arguments and orchestrates the appropriate upgrade flow through the UpgradeContext. Pure function of
+ * UpgradeContext modulo the help/usage paths that just write to stdout - no detection, registry, subprocess, or process state is touched outside the context's
+ * methods.
  * @param args - Arguments after 'upgrade' (e.g., ['--check', '--force']).
+ * @param ctx - The upgrade context. Defaults to createDefaultUpgradeContext() which wires real runtime I/O.
  * @returns Exit code (0 for success, 1 for error).
  */
-export declare function handleUpgradeCommand(args: string[]): Promise<number>;
+export declare function handleUpgradeCommand(args: readonly string[], ctx?: UpgradeContext): Promise<number>;

package/dist/upgrade/commands.js

@@ -1,195 +1,148 @@
-/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
- *
- * commands.ts: Upgrade command handlers for PrismCast CLI.
+import { getPackageVersion, isVersionLessThan, normalizeVersion } from "../utils/version.js";
+import { createDefaultUpgradeContext } from "./commands.context.js";
+/* The upgrade subcommand handles `prismcast upgrade [--check] [--force] [-h|--help]`. Detection picks the install method, the registry lookup checks for a
+ * newer version, and the runner executes the per-method upgrade command (or prints manual instructions for non-upgradeable methods).
  */
-import { fetchLatestVersion, getPackageVersion, isVersionLessThan, normalizeVersion } from "../utils/version.js";
-import { print, printError } from "../utils/cliOutput.js";
-import { detectInstallMethod } from "./detection.js";
-import { execSync } from "node:child_process";
-import { isRunningAsService } from "../utils/platform.js";
-/* These handlers implement the `prismcast upgrade` subcommand for detecting the installation method, checking for updates, and executing the appropriate upgrade
- * command. The pattern mirrors the service subcommand handlers in service/commands.ts.
- */
-/**
- * Formats the display name for an installation method.
- * @param info - The installation info to format.
- * @returns A human-readable name for the install method.
- */
-function formatMethodName(info) {
-    switch (info.method) {
-        case "docker": {
-            return "Docker";
-        }
-        case "homebrew": {
-            return "Homebrew";
-        }
-        case "npm-global": {
-            return "npm (global)";
-        }
-        case "npm-local": {
-            return "npm (local)";
-        }
-        default: {
-            return "Unknown";
-        }
-    }
-}
 /**
  * Prints usage information for the upgrade subcommand.
+ * @param ctx - The upgrade context (used for stdout output).
  */
-function printUpgradeUsage() {
-    print("Usage: prismcast upgrade [options]");
-    print("");
-    print("Upgrade PrismCast to the latest version.");
-    print("");
-    print("Options:");
-    print("  --check             Show upgrade information without upgrading");
-    print("  --force             Upgrade even if already up to date");
-    print("  -h, --help          Show this help message");
+function printUpgradeUsage(ctx) {
+    ctx.stdout("Usage: prismcast upgrade [options]");
+    ctx.stdout("");
+    ctx.stdout("Upgrade PrismCast to the latest version.");
+    ctx.stdout("");
+    ctx.stdout("Options:");
+    ctx.stdout("  --check             Show upgrade information without upgrading");
+    ctx.stdout("  --force             Upgrade even if already up to date");
+    ctx.stdout("  -h, --help          Show this help message");
 }
 /**
- * Prints the upgrade check summary (shared between --check mode and the pre-upgrade display).
+ * Prints the upgrade summary table (shared between --check mode and the pre-upgrade display).
+ * @param ctx - The upgrade context (used for stdout output).
  * @param info - The detected installation info.
  * @param currentVersion - The currently running version.
  * @param latestVersion - The latest available version, or null if unknown.
  */
-function printUpgradeInfo(info, currentVersion, latestVersion) {
-    print("PrismCast Upgrade Check");
-    print("\u2500".repeat(40));
-    print("Current version: v" + currentVersion);
+function printUpgradeInfo(ctx, info, currentVersion, latestVersion) {
+    ctx.stdout("PrismCast Upgrade Check");
+    ctx.stdout("─".repeat(40));
+    ctx.stdout("Current version: v" + currentVersion);
     if (latestVersion) {
-        print("Latest version:  v" + latestVersion);
+        ctx.stdout("Latest version:  v" + latestVersion);
     }
     else {
-        print("Latest version:  (unable to check)");
+        ctx.stdout("Latest version:  (unable to check)");
     }
-    print("Install method:  " + formatMethodName(info));
+    ctx.stdout("Install method:  " + info.displayName);
     if (info.upgradeable) {
-        print("Upgrade command: " + info.upgradeCommand);
+        ctx.stdout("Upgrade command: " + info.upgradeCommand);
     }
 }
 /**
- * Handles the --check flag: prints upgrade information and exits.
+ * Prints the full report for a non-upgradeable install method - the summary table, a blank line, the strategy's manual upgrade message, and the indented
+ * command. Single source of truth for "this is what the user sees when we cannot upgrade in-place," shared between the --check flow and the main upgrade flow.
+ * The parameter type is the narrow NonUpgradeableInstallInfo variant; callers narrow via the discriminated union before invoking, so manualUpgradeMessage is
+ * always in scope.
+ * @param ctx - The upgrade context (used for stdout output).
+ * @param info - The detected non-upgradeable installation info.
+ * @param currentVersion - The currently running version.
+ * @param latestVersion - The latest available version, or null if unknown.
+ */
+function printNonUpgradeableSummary(ctx, info, currentVersion, latestVersion) {
+    printUpgradeInfo(ctx, info, currentVersion, latestVersion);
+    ctx.stdout("");
+    for (const line of info.manualUpgradeMessage) {
+        ctx.stdout(line);
+    }
+    ctx.stdout("  " + info.upgradeCommand);
+}
+/**
+ * Handles the --check flag: prints upgrade information and exits with 0.
+ * @param ctx - The upgrade context.
  * @param info - The detected installation info.
  * @param currentVersion - The currently running version.
  * @param latestVersion - The latest available version, or null if unknown.
- * @returns Exit code (0 for success).
+ * @returns Exit code (0).
  */
-function handleCheck(info, currentVersion, latestVersion) {
-    printUpgradeInfo(info, currentVersion, latestVersion);
-    print("");
+function handleCheck(ctx, info, currentVersion, latestVersion) {
     if (!info.upgradeable) {
-        // Docker or unknown: show manual instructions using the command from detection.
-        if (info.method === "docker") {
-            print("To upgrade, pull the latest image and recreate the container:");
-            print("  " + info.upgradeCommand);
-        }
-        else {
-            print("Unable to detect installation method. Please upgrade manually:");
-            print("  " + info.upgradeCommand);
-        }
+        printNonUpgradeableSummary(ctx, info, currentVersion, latestVersion);
         return 0;
     }
+    printUpgradeInfo(ctx, info, currentVersion, latestVersion);
+    ctx.stdout("");
     if (!latestVersion) {
-        print("Run 'prismcast upgrade --force' to upgrade without a version check.");
+        ctx.stdout("Run 'prismcast upgrade --force' to upgrade without a version check.");
     }
     else if (!isVersionLessThan(currentVersion, latestVersion)) {
-        print("PrismCast v" + currentVersion + " is already the latest version.");
+        ctx.stdout("PrismCast v" + currentVersion + " is already the latest version.");
     }
     else {
-        print("Run 'prismcast upgrade' to upgrade.");
+        ctx.stdout("Run 'prismcast upgrade' to upgrade.");
     }
     return 0;
 }
 /**
- * Executes the upgrade command for the detected installation method.
- * @param info - The detected installation info.
- * @returns True if the upgrade command succeeded, false otherwise.
- */
-function executeUpgrade(info) {
-    try {
-        // For npm-local, run the install from the project directory that contains the dependency.
-        const options = { encoding: "utf-8", stdio: "inherit" };
-        if ((info.method === "npm-local") && info.packageDir) {
-            options.cwd = info.packageDir;
-        }
-        execSync(info.upgradeCommand, options);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Main handler for the `upgrade` subcommand. Parses arguments and executes the appropriate upgrade logic.
+ * Main handler for the `upgrade` subcommand. Parses arguments and orchestrates the appropriate upgrade flow through the UpgradeContext. Pure function of
+ * UpgradeContext modulo the help/usage paths that just write to stdout - no detection, registry, subprocess, or process state is touched outside the context's
+ * methods.
  * @param args - Arguments after 'upgrade' (e.g., ['--check', '--force']).
+ * @param ctx - The upgrade context. Defaults to createDefaultUpgradeContext() which wires real runtime I/O.
  * @returns Exit code (0 for success, 1 for error).
  */
-export async function handleUpgradeCommand(args) {
-    // Parse flags.
+export async function handleUpgradeCommand(args, ctx = createDefaultUpgradeContext()) {
     const showHelp = args.includes("--help") || args.includes("-h") || args.includes("help");
     const checkOnly = args.includes("--check");
     const force = args.includes("--force");
     if (showHelp) {
-        printUpgradeUsage();
+        printUpgradeUsage(ctx);
         return 0;
     }
-    // Detect installation method.
-    const info = detectInstallMethod();
+    const info = ctx.detect();
     const currentVersion = normalizeVersion(getPackageVersion());
-    // Fetch the latest version from npm.
-    const latestVersion = await fetchLatestVersion();
-    // Handle --check mode.
+    const latestVersion = await ctx.fetchLatestVersion();
     if (checkOnly) {
-        return handleCheck(info, currentVersion, latestVersion);
+        return handleCheck(ctx, info, currentVersion, latestVersion);
     }
-    // If the installation is not upgradeable (Docker or unknown), print instructions and exit.
+    // Non-upgradeable methods (docker, unknown): delegate to the shared summary helper, which is the SSOT for the version-table-plus-manual-instructions report.
+    // The InstallInfo union narrows on `!info.upgradeable` to expose manualUpgradeMessage; the consumer never switches on info.method.
     if (!info.upgradeable) {
-        printUpgradeInfo(info, currentVersion, latestVersion);
-        print("");
-        if (info.method === "docker") {
-            print("Docker containers cannot be upgraded in-place.");
-            print("To upgrade, pull the latest image and recreate the container:");
-            print("  " + info.upgradeCommand);
-        }
-        else {
-            print("Unable to detect installation method. Please upgrade manually:");
-            print("  " + info.upgradeCommand);
-        }
+        printNonUpgradeableSummary(ctx, info, currentVersion, latestVersion);
         return 0;
     }
-    // Check if already up to date (skip with --force or if version check failed).
+    // Already-current short-circuit: skip when --force is set or when we could not check the registry. Without --force, an indeterminate version check is fatal
+    // because we should not blindly run npm install when we can not see whether it would do anything.
     if (!force && latestVersion && !isVersionLessThan(currentVersion, latestVersion)) {
-        print("PrismCast v" + currentVersion + " is already the latest version.");
-        print("Use --force to upgrade anyway.");
+        ctx.stdout("PrismCast v" + currentVersion + " is already the latest version.");
+        ctx.stdout("Use --force to upgrade anyway.");
         return 0;
     }
-    // If we couldn't check the latest version and --force wasn't specified, warn the user.
     if (!force && !latestVersion) {
-        printError("Unable to check for updates. Run with --force to upgrade anyway.");
+        ctx.stderr("Unable to check for updates. Run with --force to upgrade anyway.");
         return 1;
     }
-    // Show what we're about to do.
-    print("Upgrading PrismCast...");
-    print("Install method: " + formatMethodName(info));
-    print("Running: " + info.upgradeCommand);
-    print("");
-    // Execute the upgrade.
-    if (!executeUpgrade(info)) {
-        printError("");
-        printError("Upgrade failed. Check the output above for details.");
+    // Pre-upgrade announcement so the user knows what is about to run.
+    ctx.stdout("Upgrading PrismCast...");
+    ctx.stdout("Install method: " + info.displayName);
+    ctx.stdout("Running: " + info.upgradeCommand);
+    ctx.stdout("");
+    // Execute the upgrade. packageDir is set only by the npm-local strategy (it is the lone field in ResolvableFields and only npm-local declares a resolver),
+    // so reading it directly is sufficient - the runner uses it as cwd when present and falls back to process.cwd() when absent.
+    const result = ctx.runUpgradeCommand(info.upgradeCommand, { cwd: info.packageDir });
+    if (!result.success) {
+        ctx.stderr("");
+        ctx.stderr("Upgrade failed. Check the output above for details.");
         return 1;
     }
-    print("");
-    print("Upgrade complete.");
-    // Handle restart: if running as a service, the service manager will restart PrismCast when we exit.
-    if (isRunningAsService()) {
-        print("Restarting PrismCast via service manager...");
-        process.exit(0);
-    }
-    else {
-        print("Please restart PrismCast manually to use the new version.");
+    ctx.stdout("");
+    ctx.stdout("Upgrade complete.");
+    // Service-managed processes restart automatically when we exit; manual installs need a user-driven restart.
+    if (ctx.isService) {
+        ctx.stdout("Restarting PrismCast via service manager...");
+        ctx.exit(0);
     }
+    ctx.stdout("Please restart PrismCast manually to use the new version.");
     return 0;
 }
 //# sourceMappingURL=commands.js.map

package/dist/upgrade/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/upgrade/commands.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/upgrade/commands.ts"],"names":[],"mappings":"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"}

package/dist/upgrade/detection.context.d.ts

@@ -0,0 +1,6 @@
+import type { DetectionContext } from "./detection.ts";
+/**
+ * Builds the default DetectionContext from real runtime I/O.
+ * @returns A DetectionContext populated from the live process.
+ */
+export declare function createDefaultDetectionContext(): DetectionContext;

package/dist/upgrade/detection.context.js

@@ -0,0 +1,24 @@
+import { execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { isRunningInContainer } from "../utils/platform.js";
+import url from "node:url";
+/**
+ * Builds the default DetectionContext from real runtime I/O.
+ * @returns A DetectionContext populated from the live process.
+ */
+export function createDefaultDetectionContext() {
+    return {
+        currentFile: url.fileURLToPath(import.meta.url),
+        fileExists: existsSync,
+        isContainer: isRunningInContainer(),
+        runCommand: (cmd) => {
+            try {
+                return execSync(cmd, { encoding: "utf-8", timeout: 5000 }).trim();
+            }
+            catch {
+                return null;
+            }
+        }
+    };
+}
+//# sourceMappingURL=detection.context.js.map

package/dist/upgrade/detection.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.context.js","sourceRoot":"","sources":["../../src/upgrade/detection.context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,GAAG,MAAM,UAAU,CAAC;AAE3B;;;GAGG;AACH,MAAM,UAAU,6BAA6B;IAE3C,OAAO;QAEL,WAAW,EAAE,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;QAC/C,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,oBAAoB,EAAE;QACnC,UAAU,EAAE,CAAC,GAAW,EAAiB,EAAE;YAEzC,IAAI,CAAC;gBAEH,OAAO,QAAQ,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACpE,CAAC;YAAC,MAAM,CAAC;gBAEP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/upgrade/detection.d.ts

@@ -1,15 +1,145 @@
-export type InstallMethod = "docker" | "homebrew" | "npm-global" | "npm-local" | "unknown";
 /**
- * Information about the detected installation method and how to upgrade.
+ * The runtime context detection consumes. Each field is one narrow capability the decision logic depends on - the path of the running module, whether we are
+ * inside a Docker container, the ability to run a shell command and read its trimmed stdout, the ability to check that a path exists. Decision logic is a pure
+ * function of this shape; the default adapter wires it from real I/O, tests pass a context literal.
  */
-export interface InstallInfo {
-    method: InstallMethod;
-    packageDir?: string;
-    upgradeCommand: string;
-    upgradeable: boolean;
+export interface DetectionContext {
+    readonly currentFile: string;
+    readonly fileExists: (path: string) => boolean;
+    readonly isContainer: boolean;
+    readonly runCommand: (cmd: string) => string | null;
 }
 /**
- * Detects how PrismCast was installed by examining the path of the running code. Detection order: Docker container, Homebrew, npm global, npm local, unknown.
- * @returns Installation information including method, whether it is upgradeable, and the appropriate upgrade command.
+ * The narrow set of InstallInfo fields a strategy's resolver may compute from the runtime context. Today there's only one - npm-local's packageDir, derived
+ * from the consumer's project root - but the dedicated type guarantees the resolver cannot accidentally override the strategy's constant fields. Adding a new
+ * resolvable field is an additive edit here; strategies opt in by declaring the field on their resolve return.
  */
-export declare function detectInstallMethod(): InstallInfo;
+export interface ResolvableFields {
+    readonly packageDir?: string;
+}
+/**
+ * Common fields shared by every install strategy. Generic in the literal id type so each strategy declaration carries its own narrow id (e.g.,
+ * InstallStrategyBase<"docker">), which the registry then harvests into the RegisteredMethod literal union.
+ *
+ * Strategies own no state and perform no I/O outside what the context exposes.
+ */
+interface InstallStrategyBase<M extends string = string> {
+    readonly displayName: string;
+    readonly id: M;
+    readonly matches: (ctx: DetectionContext) => boolean;
+    readonly resolve?: (ctx: DetectionContext) => ResolvableFields;
+    readonly upgradeCommand: string;
+}
+/**
+ * Strategy variant for install methods the tool can upgrade in place. The runner invokes upgradeCommand directly; no manual-instruction strings are needed.
+ */
+export interface UpgradeableInstallStrategy<M extends string = string> extends InstallStrategyBase<M> {
+    readonly upgradeable: true;
+}
+/**
+ * Strategy variant for install methods the tool cannot upgrade in place. Carries manualUpgradeMessage - the user-facing prose lines that explain why the
+ * automated path is unavailable and what the user should do instead. The dispatcher copies this onto the resulting InstallInfo so the consumer (commands.ts)
+ * never has to switch on the install method to choose its messaging.
+ */
+export interface NonUpgradeableInstallStrategy<M extends string = string> extends InstallStrategyBase<M> {
+    readonly manualUpgradeMessage: readonly string[];
+    readonly upgradeable: false;
+}
+/**
+ * Discriminated union of install-method strategies. Discriminator is `upgradeable`. Consumers narrow on it to access manualUpgradeMessage with type safety;
+ * structurally impossible to declare an upgradeable strategy that carries manual instructions or a non-upgradeable strategy that omits them.
+ */
+export type InstallStrategy<M extends string = string> = UpgradeableInstallStrategy<M> | NonUpgradeableInstallStrategy<M>;
+declare const STRATEGY_TUPLE: readonly [{
+    readonly displayName: "Docker";
+    readonly id: "docker";
+    readonly manualUpgradeMessage: readonly ["Docker containers cannot be upgraded in-place.", "To upgrade, pull the latest image and recreate the container:"];
+    readonly matches: (ctx: DetectionContext) => boolean;
+    readonly upgradeCommand: "docker pull ghcr.io/hjdhjd/prismcast:latest && docker compose up -d";
+    readonly upgradeable: false;
+}, {
+    readonly displayName: "Homebrew";
+    readonly id: "homebrew";
+    readonly matches: (ctx: DetectionContext) => boolean;
+    readonly upgradeCommand: "brew update && brew upgrade prismcast";
+    readonly upgradeable: true;
+}, {
+    readonly displayName: "npm (global)";
+    readonly id: "npm-global";
+    readonly matches: (ctx: DetectionContext) => boolean;
+    readonly upgradeCommand: "npm install -g prismcast@latest";
+    readonly upgradeable: true;
+}, {
+    readonly displayName: "npm (local)";
+    readonly id: "npm-local";
+    readonly matches: (ctx: DetectionContext) => boolean;
+    readonly resolve: (ctx: DetectionContext) => ResolvableFields;
+    readonly upgradeCommand: "npm install prismcast@latest";
+    readonly upgradeable: true;
+}];
+/**
+ * The literal-union type of install method ids that strategies actually register for. Derived from the strategy tuple rather than declared in parallel - adding
+ * a strategy automatically widens this type, removing one is impossible without removing the strategy. There is no way for the type and the registry to drift.
+ */
+export type RegisteredMethod = typeof STRATEGY_TUPLE[number]["id"];
+/**
+ * The install-method strategy registry. Same runtime data as STRATEGY_TUPLE; the public name carries the wide InstallStrategy<RegisteredMethod> type so the
+ * dispatcher (and any future consumer that iterates) sees the union uniformly. Order is priority order: docker first (container probe is unambiguous), homebrew
+ * (path marker is unambiguous), npm-global (requires successful npm prefix lookup), npm-local (broader path marker). Adding a new install method is appending an
+ * entry to STRATEGY_TUPLE.
+ */
+export declare const INSTALL_STRATEGIES: readonly InstallStrategy<RegisteredMethod>[];
+/**
+ * The full install-method discriminator. Adds the unknown sentinel that the dispatcher returns when no strategy in the registry matches; everything else is
+ * registered. Consumers (e.g., commands.ts's switch on info.method) that need exhaustive coverage get it via this type.
+ */
+export type InstallMethod = RegisteredMethod | "unknown";
+/**
+ * Common fields shared by every InstallInfo variant. Mirrors InstallStrategyBase but with `method: InstallMethod` instead of `id: M`, and extends ResolvableFields
+ * so packageDir is optionally present on either variant.
+ */
+interface InstallInfoBase extends ResolvableFields {
+    readonly displayName: string;
+    readonly method: InstallMethod;
+    readonly upgradeCommand: string;
+}
+/**
+ * InstallInfo variant for upgradeable install methods. The upgrade runner can invoke upgradeCommand directly.
+ */
+export interface UpgradeableInstallInfo extends InstallInfoBase {
+    readonly upgradeable: true;
+}
+/**
+ * InstallInfo variant for non-upgradeable install methods. Carries manualUpgradeMessage - the prose lines printed before the indented upgradeCommand. The
+ * structural guarantee that manualUpgradeMessage exists exactly when upgradeable is false means consumers (commands.ts) can narrow on `!info.upgradeable` and
+ * read the message with type safety, rather than switching on info.method to pick the right messaging.
+ */
+export interface NonUpgradeableInstallInfo extends InstallInfoBase {
+    readonly manualUpgradeMessage: readonly string[];
+    readonly upgradeable: false;
+}
+/**
+ * Information about the detected installation method and how to upgrade. Discriminated union over `upgradeable`; consumers narrow on it to choose between
+ * "run the command" and "print manual instructions" without ever switching on info.method.
+ */
+export type InstallInfo = UpgradeableInstallInfo | NonUpgradeableInstallInfo;
+/**
+ * The fallback InstallInfo returned when no strategy in the registry matches. Development builds, npx invocations, and unrecognized layouts land here. The
+ * upgrade command points at the canonical npm-global install path because that is the most likely successful manual upgrade, but upgradeable is false so the
+ * tool prints instructions rather than running the command.
+ */
+export declare const UNKNOWN_INSTALL: NonUpgradeableInstallInfo;
+/**
+ * Detects the installation method. Walks INSTALL_STRATEGIES in priority order; on the first match, builds an InstallInfo by composing the strategy's optional
+ * resolver output with the strategy's constant fields. The resolver's return type is restricted to ResolvableFields, so it cannot override id, displayName,
+ * upgradeCommand, or upgradeable; the spread order also places constants after the resolved fields as belt-and-suspenders. The strategy's `upgradeable`
+ * discriminator selects which InstallInfo variant the dispatcher emits, carrying manualUpgradeMessage through for the non-upgradeable case.
+ *
+ * Pure function of DetectionContext - all I/O happens inside the context's runCommand and fileExists callbacks, which the default adapter wires to real system
+ * calls and tests stub inline. Falls back to UNKNOWN_INSTALL when no strategy matches.
+ *
+ * @param ctx - The runtime context. Defaults to createDefaultDetectionContext() which builds one from real I/O.
+ * @returns Installation information.
+ */
+export declare function detectInstallMethod(ctx?: DetectionContext): InstallInfo;
+export {};