prismcast 1.10.2 → 1.11.0

package/dist/types/config.d.ts

@@ -1,7 +1,7 @@
 import type { ChannelSortField, Nullable, SortDirection } from "./shared.ts";
 /**
- * Browser-related configuration controlling Chrome launch behavior. Viewport dimensions are derived from the quality preset via getViewport() and are not stored in
- * this configuration object.
+ * Browser-related configuration controlling Chrome launch behavior. Viewport dimensions are derived from the quality preset via getPresetViewport() and are not
+ * stored in this configuration object.
  */
 export interface BrowserConfig {
     executablePath: Nullable<string>;
@@ -42,6 +42,9 @@ export interface RecoveryConfig {
     circuitBreakerThreshold: number;
     circuitBreakerWindow: number;
     maxBackoffDelay: number;
+    relaunchFailureThreshold: number;
+    relaunchFailureWindow: number;
+    relaunchHealthHold: number;
     stalePageCleanupInterval: number;
     stalePageGracePeriod: number;
 }
@@ -70,7 +73,7 @@ export interface ChannelsConfig {
  * and pretune scheduling.
  *
  * Host is auto-discovered at runtime from client request IPs by `showInfo.ts`. It is intentionally NOT in `CONFIG_METADATA` and is not exposed as a settings
- * UI field - users do not configure it directly. The host invariant: host-only, never `host:port`. Port lives at `channelsDvr.port` exclusively.
+ * UI field - users do not configure it directly. The host rule: host-only, never `host:port`. Port lives at `channelsDvr.port` exclusively.
  *
  * Port is user-configurable via `CONFIG_METADATA` because Channels DVR's port is user-configurable per their docs and a non-default port would otherwise be
  * unreachable from PrismCast.
@@ -84,11 +87,15 @@ export interface ChannelsDvrConfig {
     port: number;
 }
 /**
- * HDHomeRun emulation configuration. When enabled, PrismCast runs a separate HTTP server that emulates the HDHomeRun API, allowing Plex to discover and use
- * PrismCast as a virtual tuner for live TV and DVR recording. The emulated device appears in Plex's tuner setup and serves PrismCast's HLS streams directly.
+ * HDHomeRun emulation configuration. When enabled, PrismCast runs a separate HTTP server that emulates the HDHomeRun API and (when discoveryEnabled is also
+ * true) a UDP discovery responder on port 65001 that lets Plex find PrismCast on the LAN automatically. The emulated device appears in Plex's tuner setup and
+ * serves PrismCast's MPEG-TS streams directly. Channels DVR also auto-discovers but its discovery assumes the standard HDHomeRun port 80, which most
+ * installations cannot bind; Channels DVR users typically add PrismCast manually as a Custom Channels source. Other HDHR-aware clients work to the extent that
+ * they honor the BaseURL advertised in the protocol; their compatibility is incidental rather than supported.
  */
 export interface HdhrConfig {
     deviceId: string;
+    discoveryEnabled: boolean;
     enabled: boolean;
     friendlyName: string;
     port: number;
@@ -112,6 +119,9 @@ export interface ServerConfig {
  * Capture mode for media recording. Determines how video/audio is captured from the browser and processed for HLS output.
  * - "ffmpeg": Captures Matroska (H264+Opus) and uses FFmpeg to transcode audio to AAC. More stable for long recordings.
  * - "native": Captures fMP4 (H264+AAC) directly from Chrome. No dependencies but may be unstable with long recordings.
+ *
+ * Chrome's native fMP4 MediaRecorder produces corrupt output after 20-30 minutes of recording, so `config/index.ts` currently forces this value to "ffmpeg"
+ * at startup and rejects a live configuration save that requests "native" rather than silently coercing it.
  */
 export type CaptureMode = "ffmpeg" | "native";
 /**
@@ -145,3 +155,4 @@ export interface Config {
     server: ServerConfig;
     streaming: StreamingConfig;
 }
+//# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

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

package/dist/types/index.d.ts

@@ -2,8 +2,9 @@ export type { BrowserConfig, CaptureMode, ChannelsConfig, Config, HdhrConfig, HL
 export type { CanonicalChannel, Channel, ChannelDefinition, ChannelDelta, ChannelIdentity, ChannelListingEntry, ChannelMap, ChannelServiceBinding, CustomizableField, ResolvedChannel, ResolvedChannelMap, ServiceGroup, ServiceVariant, StoredChannel, StoredChannelMap, VariantChannel } from "./channels.ts";
 export { CHANNEL_BINDING_KEYS, CHANNEL_IDENTITY_KEYS, DELTA_ELIGIBLE_BINDING_KEYS, DELTA_ELIGIBLE_IDENTITY_KEYS } from "./channels.ts";
 export type { ChannelSelectionConfig, ChannelSelectionStrategy, DomainConfig, ProfileCategory, ProfileResolutionResult, ProfilesValidationResult, ResolvedSiteProfile, ServicePack, SiteProfile, UserProfilesFile, UserProfilesLoadResult } from "./profiles.ts";
-export type { CategoryResolution, CategoryResolutionConfig, CategoryResolutionFailure, CategoryResolutionSuccess, ChannelSelectionProfile, ChannelSelectorResult, ChannelStrategyEntry, ChannelStrategyHandler, ClickTarget, DiscoveredChannel, ProviderModule, TuneResult, UiSize } from "./selection.ts";
+export type { AuthWallIndicators, CategoryResolution, CategoryResolutionConfig, CategoryResolutionFailure, CategoryResolutionSuccess, ChannelSelectionProfile, ChannelSelectorResult, ChannelStrategyEntry, ChannelStrategyHandler, ClickTarget, DiscoveredChannel, ProviderModule, TuneResult, UiSize } from "./selection.ts";
 export type { ChannelSortField, Nullable, SortDirection } from "./shared.ts";
-export type { CaptureCodec, HealthStatus, StreamListItem, StreamListResponse, StreamingMode, UrlValidationResult, VideoSelectorType, VideoState } from "./streaming.ts";
+export type { CaptureCodec, HealthStatus, MediaContainer, StreamListItem, StreamListResponse, StreamingMode, UrlValidationResult, VideoSelectorType, VideoState } from "./streaming.ts";
 export { RECOGNIZED_CODECS } from "./streaming.ts";
 export { isChannelSelectionProfile } from "./selection.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,EACjJ,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,UAAU,EAAE,qBAAqB,EAC/I,iBAAiB,EAAE,eAAe,EAAE,kBAAkB,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/J,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AACvI,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,YAAY,EAAE,eAAe,EAAE,uBAAuB,EAAE,wBAAwB,EAC9I,mBAAmB,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACjH,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,uBAAuB,EAC3J,qBAAqB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,WAAW,EAAE,iBAAiB,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAClK,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EACjJ,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/profiles.d.ts

@@ -6,8 +6,8 @@ import type { Nullable } from "./shared.ts";
  * - "directvGrid": Tune via webpack injection - captures __webpack_require__, extracts the Redux store from the React fiber tree, matches by channel name, and
  *   dispatches playConsumable. Falls back to logo aria-label click when the interceptor fails. Used by DirecTV Stream.
  * - "foxGrid": Find channel by station code in a non-virtualized guide grid, click the channel logo button via DOM .click(). Used by Fox.com.
- * - "guideGrid": Find channel by exact-matching image alt text, click nearest clickable ancestor. Optionally clicks a tab to reveal the list first. Used by Hulu
- *   Live TV.
+ * - "guideGrid": Find channel by data-testid in a virtualized guide grid via binary search, click the on-now program cell, then click the play button tile.
+ *   Optionally clicks a tab to reveal the list first. Used by Hulu Live TV.
  * - "hboGrid": Discover the HBO tab page URL from the homepage menu bar, read the live channel tile rail for a matching channel name, and navigate to the watch
  *   URL. Caches the tab URL across tunes with stale-cache fallback. Used by HBO Max.
  * - "none": No channel selection needed (single-channel sites). This is the default.
@@ -100,12 +100,13 @@ export interface ResolvedSiteProfile {
  * profile came from a channel hint, domain-based autodetection, or the default fallback.
  */
 export interface ProfileResolutionResult {
+    readonly overriddenProfile?: string;
     profile: ResolvedSiteProfile;
     profileName: string;
 }
 /**
  * Domain-level configuration associating domain patterns with site profiles and service display names. Each entry can specify a site profile for behavior
- * configuration and/or a service display name for friendly UI labels. Used by both built-in domain mappings in sites.ts and user-defined mappings in profiles.json.
+ * configuration and/or a service display name for friendly UI labels. Used by both builtin domain mappings in sites.ts and user-defined mappings in profiles.json.
  */
 export interface DomainConfig {
     dismissSelector?: string;
@@ -118,7 +119,7 @@ export interface DomainConfig {
     videoTimeout?: number;
 }
 /**
- * Storage format for profiles.json. Contains user-defined site profiles and domain mappings that extend or override the built-in configurations.
+ * Storage format for profiles.json. Contains user-defined site profiles and domain mappings that extend or override the builtin configurations.
  */
 export interface UserProfilesFile {
     domains?: Record<string, DomainConfig>;
@@ -154,3 +155,4 @@ export interface ProfilesValidationResult {
     profiles: Record<string, SiteProfile>;
     valid: boolean;
 }
+//# sourceMappingURL=profiles.d.ts.map

package/dist/types/profiles.d.ts.map

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

package/dist/types/selection.d.ts

@@ -1,15 +1,25 @@
 import type { ChannelSelectionStrategy, ResolvedSiteProfile, SiteProfile } from "./profiles.ts";
 import type { Frame, Page } from "puppeteer-core";
 import type { Nullable } from "./shared.ts";
+import type { PersistedLineupChannel } from "../config/providerLineups.ts";
+/**
+ * Narrowed profile type for strategy functions. When selectChannel() validates that channelSelector is non-null, it narrows the profile to this type so
+ * strategy functions receive a guaranteed non-null channelSelector without needing non-null assertions.
+ */
 export interface ChannelSelectionProfile extends ResolvedSiteProfile {
     channelSelector: string;
 }
+/**
+ * Type guard that proves channelSelector is a non-empty string, rejecting both null and empty string. Used by the coordinator before dispatching to strategy
+ * functions.
+ */
 export declare function isChannelSelectionProfile(profile: ResolvedSiteProfile): profile is ChannelSelectionProfile;
 /**
  * Result of attempting to select a channel from a multi-channel player UI.
  */
 export interface ChannelSelectorResult {
     directTune?: boolean;
+    guideUnavailable?: boolean;
     reason?: string;
     success: boolean;
 }
@@ -54,17 +64,34 @@ export interface DiscoveredChannel {
     stationId?: string;
     tier?: string;
 }
+/**
+ * Provider-declared identifiers for the provider's authentication wall, consumed by the blocked-page classifier when a discovery walk returns zero channels.
+ * Host patterns match the landed URL's hostname (exact, or any subdomain of the pattern); selectors match against the page DOM. Either match classifies the page
+ * as an auth wall ahead of the generic sign-in shape probe. Declared per provider only when the generic probe cannot recognize that provider's wall.
+ */
+export interface AuthWallIndicators {
+    hosts?: string[];
+    selectors?: string[];
+}
 /**
  * Unified provider contract that bundles identity metadata, tuning strategy, and channel discovery into a single registry entry. Each provider tuning file
  * exports one ProviderModule. The coordinator builds its strategy dispatch lookup from provider modules at evaluation time. Generic strategies (thumbnailRow,
  * tileClick) remain bare ChannelStrategyEntry objects - they are not providers.
  */
 export interface ProviderModule {
+    authWallIndicators?: AuthWallIndicators;
     /**
      * Discovers all available channels from the provider's guide. The route handler navigates to guideUrl before calling this function unless handlesOwnNavigation
      * is set. Returns a standardized DiscoveredChannel array.
      */
     discoverChannels: (page: Page) => Promise<DiscoveredChannel[]>;
+    /**
+     * Returns the provider's own statement of which lineup facts outlive the browser session that discovered them, for the persisted lineup store. A provider whose
+     * direct-tune address is a stable per-channel URL (or a stable identifier the URL is built from) exports it here alongside the channel identity; a provider that
+     * tunes by interacting with its guide has no such address and omits the hook entirely, so the store never holds a watch URL that cannot be navigated to.
+     * Returns null when the provider's cache is cold and there is nothing to state.
+     */
+    exportDurableLineup?: () => Nullable<PersistedLineupChannel[]>;
     /**
      * Returns cached discovered channels if the provider has already fully enumerated its lineup from a previous tune or discovery call, or null if no enumeration
      * has occurred. When non-null, the route handler can skip browser page creation entirely and return the cached result immediately.
@@ -106,9 +133,9 @@ export interface CategoryResolutionFailure {
  * these two shapes - there is no null. This forces every resolver to articulate its outcome explicitly, which guarantees diagnostic detail on every failure and
  * removes ambiguity between "could not resolve" and "did not attempt to resolve."
  *
- * The union is structurally discriminated by the `callSign` and `reason` field names so consumers can use TypeScript's `"callSign" in result` narrowing without
- * needing a tagged enum. A future evolution that needs additional outcomes (e.g., resolution to a list of candidates for user disambiguation) can add a new
- * variant here as a new named interface without touching the existing two.
+ * Consumers tell the two variants apart by the `callSign` and `reason` field names, using TypeScript's `"callSign" in result` narrowing without needing a tagged
+ * enum. A future evolution that needs additional outcomes (e.g., resolution to a list of candidates for user disambiguation) can add a new variant here as a new
+ * named interface without touching the existing two.
  */
 export type CategoryResolution = CategoryResolutionSuccess | CategoryResolutionFailure;
 /**
@@ -148,3 +175,4 @@ export interface UiSize {
     height: number;
     width: number;
 }
+//# sourceMappingURL=selection.d.ts.map

package/dist/types/selection.d.ts.map

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

package/dist/types/selection.js

@@ -1,5 +1,7 @@
-// Type guard that proves channelSelector is a non-empty string. Matches the original !channelSelector truthiness check, which rejects both null and empty string.
-// Used by the coordinator before dispatching to strategy functions.
+/**
+ * Type guard that proves channelSelector is a non-empty string, rejecting both null and empty string. Used by the coordinator before dispatching to strategy
+ * functions.
+ */
 export function isChannelSelectionProfile(profile) {
     return (profile.channelSelector !== null) && (profile.channelSelector.length > 0);
 }

package/dist/types/selection.js.map

@@ -1 +1 @@
-{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/types/selection.ts"],"names":[],"mappings":"AAeA,kKAAkK;AAClK,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CAAC,OAA4B;IAEpE,OAAO,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpF,CAAC"}
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/types/selection.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAA4B;IAEpE,OAAO,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/types/shared.d.ts

@@ -5,3 +5,4 @@
 export type Nullable<T> = T | null;
 export type ChannelSortField = "channelNumber" | "channelSelector" | "hdhrEnabled" | "key" | "name" | "profile" | "service" | "stationId" | "tags";
 export type SortDirection = "asc" | "desc";
+//# sourceMappingURL=shared.d.ts.map

package/dist/types/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/types/shared.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAGnC,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,iBAAiB,GAAG,aAAa,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,CAAC;AAGnJ,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC"}

package/dist/types/streaming.d.ts

@@ -41,6 +41,13 @@ export interface UrlValidationResult {
  * directly in Node, bypassing screen capture entirely.
  */
 export type StreamingMode = "capture" | "native";
+/**
+ * Media container format of an upstream HLS source. "fmp4" sources (CMAF) carry their codec configuration in a separate initialization segment referenced by
+ * #EXT-X-MAP, so the relay must fetch, store, and re-reference that init for the fragments to be playable. "ts" sources are self-describing - every MPEG-TS
+ * segment carries its own PAT/PMT - so they need no init at all. Consumers select the fMP4 behavior on an exact "fmp4" match; every other value takes the
+ * self-describing path.
+ */
+export type MediaContainer = "fmp4" | "ts";
 /**
  * Health check response structure returned by the /health endpoint.
  */
@@ -93,3 +100,4 @@ export interface StreamListResponse {
     limit: number;
     streams: StreamListItem[];
 }
+//# sourceMappingURL=streaming.d.ts.map

package/dist/types/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/types/streaming.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,2BAA8B,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,UAAU;IAIzB,WAAW,EAAE,MAAM,CAAC;IAGpB,KAAK,EAAE,OAAO,CAAC;IAGf,KAAK,EAAE,OAAO,CAAC;IAGf,KAAK,EAAE,OAAO,CAAC;IAIf,YAAY,EAAE,MAAM,CAAC;IAGrB,MAAM,EAAE,OAAO,CAAC;IAIhB,UAAU,EAAE,MAAM,CAAC;IAGnB,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,MAAM,CAAC;IAGpB,UAAU,EAAE,MAAM,CAAC;IAGnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG,kBAAkB,CAAC;AAMxE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAGlC,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,YAAY;IAG3B,OAAO,EAAE;QAGP,SAAS,EAAE,OAAO,CAAC;QAGnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IAGF,WAAW,EAAE,MAAM,CAAC;IAGpB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAGzB,OAAO,EAAE;QAGP,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAG1C,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAGF,eAAe,EAAE,OAAO,CAAC;IAGzB,MAAM,EAAE;QAGN,SAAS,EAAE,MAAM,CAAC;QAGlB,QAAQ,EAAE,MAAM,CAAC;QAGjB,GAAG,EAAE,MAAM,CAAC;QAGZ,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAGF,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;IAG7C,OAAO,EAAE;QAGP,MAAM,EAAE,MAAM,CAAC;QAGf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IAGF,SAAS,EAAE,MAAM,CAAC;IAGlB,MAAM,EAAE,MAAM,CAAC;IAGf,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAG7B,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAG1B,QAAQ,EAAE,MAAM,CAAC;IAGjB,EAAE,EAAE,MAAM,CAAC;IAGX,SAAS,EAAE,MAAM,CAAC;IAGlB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAGjC,KAAK,EAAE,MAAM,CAAC;IAGd,KAAK,EAAE,MAAM,CAAC;IAGd,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B"}

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

@@ -4,3 +4,4 @@ import type { UpgradeContext } from "./commands.ts";
  * @returns An UpgradeContext populated from the live process.
  */
 export declare function createDefaultUpgradeContext(): UpgradeContext;
+//# sourceMappingURL=commands.context.d.ts.map

package/dist/upgrade/commands.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.context.d.ts","sourceRoot":"","sources":["../../src/upgrade/commands.context.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAQpD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAY5D"}

package/dist/upgrade/commands.context.js

@@ -1,8 +1,20 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * commands.context.ts: The default adapter that produces an UpgradeContext from real runtime I/O. The handler in commands.ts is a pure orchestrator over an
+ * UpgradeContext; this file is the only place in the upgrade-commands module that fetches the npm registry, invokes process.exit, or wires the platform-aware
+ * lifecycle through to performUpgrade. Tests bypass this file entirely by constructing UpgradeContext literals inline.
+ *
+ * The lifecycle context is built when performUpgrade is invoked, not at UpgradeContext construction time. Eager construction would call
+ * getDataDir() before the upgrade-execution branch is reached, which is wrong for the --help and --check paths (they never invoke performUpgrade) and brittle
+ * for tests that exercise those paths against the default context without initializing the data directory. Lazy construction keeps the cost paid exactly when
+ * the work happens.
+ */
 import { print, printError } from "../utils/cliOutput.js";
+import { createDefaultLifecycleContext } from "./lifecycle.context.js";
 import { detectInstallMethod } from "./detection.js";
-import { execSync } from "node:child_process";
 import { fetchLatestVersion } from "../utils/version.js";
 import { isRunningAsService } from "../utils/platform.js";
+import { performUpgrade } from "./lifecycle.js";
 /**
  * Builds the default UpgradeContext from real runtime I/O.
  * @returns An UpgradeContext populated from the live process.
@@ -13,15 +25,7 @@ export function createDefaultUpgradeContext() {
         exit: (code) => process.exit(code),
         fetchLatestVersion,
         isService: isRunningAsService(),
-        runUpgradeCommand: (cmd, options) => {
-            try {
-                execSync(cmd, { cwd: options.cwd, encoding: "utf-8", stdio: "inherit" });
-                return { success: true };
-            }
-            catch {
-                return { success: false };
-            }
-        },
+        performUpgrade: (info) => performUpgrade(createDefaultLifecycleContext(), info),
         stderr: printError,
         stdout: print
     };

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

@@ -1 +1 @@
-{"version":3,"file":"commands.context.js","sourceRoot":"","sources":["../../src/upgrade/commands.context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IAEzC,OAAO;QAEL,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,kBAAkB;QAClB,SAAS,EAAE,kBAAkB,EAAE;QAC/B,iBAAiB,EAAE,CAAC,GAAW,EAAE,OAAyB,EAAiB,EAAE;YAE3E,IAAI,CAAC;gBAEH,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAEzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBAEP,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}
+{"version":3,"file":"commands.context.js","sourceRoot":"","sources":["../../src/upgrade/commands.context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAI1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,2BAA2B;IAEzC,OAAO;QAEL,MAAM,EAAE,mBAAmB;QAC3B,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;QAClC,kBAAkB;QAClB,SAAS,EAAE,kBAAkB,EAAE;QAC/B,cAAc,EAAE,CAAC,IAAiB,EAAe,EAAE,CAAC,cAAc,CAAC,6BAA6B,EAAE,EAAE,IAAI,CAAC;QACzG,MAAM,EAAE,UAAU;QAClB,MAAM,EAAE,KAAK;KACd,CAAC;AACJ,CAAC"}

package/dist/upgrade/commands.d.ts

@@ -1,14 +1,8 @@
 import type { InstallInfo } from "./detection.ts";
+import type { UpgradeStep } from "./lifecycle.ts";
 /**
- * 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
+ * The runtime context handleUpgradeCommand consumes. Each field models one capability the command needs - detection, version lookup, platform-aware upgrade
+ * 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 {
@@ -16,18 +10,17 @@ export interface UpgradeContext {
     readonly exit: (code: number) => never;
     readonly fetchLatestVersion: () => Promise<string | null>;
     readonly isService: boolean;
-    readonly runUpgradeCommand: (cmd: string, options: {
-        cwd?: string;
-    }) => UpgradeResult;
+    readonly performUpgrade: (info: InstallInfo) => UpgradeStep;
     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.
+ * Main handler for the `upgrade` subcommand. Parses arguments and orchestrates the appropriate upgrade flow through the UpgradeContext. Pure orchestrator over
+ * UpgradeContext - decision logic depends only on context methods plus the synchronous getPackageVersion() lookup, never on direct subprocess, registry, or
+ * process-state I/O.
  * @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: readonly string[], ctx?: UpgradeContext): Promise<number>;
+//# sourceMappingURL=commands.d.ts.map

package/dist/upgrade/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/upgrade/commands.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAC;AAG7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAG7B,QAAQ,CAAC,MAAM,EAAE,MAAM,WAAW,CAAC;IAGnC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IAGvC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAK1D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAK5B,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,WAAW,CAAC;IAI5D,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAIxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AA0FD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,GAAE,cAA8C,GAAG,OAAO,CAAC,MAAM,CAAC,CAoGxI"}

package/dist/upgrade/commands.js

@@ -3,10 +3,6 @@ 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).
  */
-/**
- * Prints usage information for the upgrade subcommand.
- * @param ctx - The upgrade context (used for stdout output).
- */
 function printUpgradeUsage(ctx) {
     ctx.stdout("Usage: prismcast upgrade [options]");
     ctx.stdout("");
@@ -17,13 +13,7 @@ function printUpgradeUsage(ctx) {
     ctx.stdout("  --force             Upgrade even if already up to date");
     ctx.stdout("  -h, --help          Show this help message");
 }
-/**
- * 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.
- */
+// Shared between --check mode and the non-upgradeable summary so both surfaces print identical version/install-method/upgrade-command rows.
 function printUpgradeInfo(ctx, info, currentVersion, latestVersion) {
     ctx.stdout("PrismCast Upgrade Check");
     ctx.stdout("─".repeat(40));
@@ -57,14 +47,6 @@ function printNonUpgradeableSummary(ctx, info, currentVersion, latestVersion) {
     }
     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).
- */
 function handleCheck(ctx, info, currentVersion, latestVersion) {
     if (!info.upgradeable) {
         printNonUpgradeableSummary(ctx, info, currentVersion, latestVersion);
@@ -84,9 +66,9 @@ function handleCheck(ctx, info, currentVersion, latestVersion) {
     return 0;
 }
 /**
- * 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.
+ * Main handler for the `upgrade` subcommand. Parses arguments and orchestrates the appropriate upgrade flow through the UpgradeContext. Pure orchestrator over
+ * UpgradeContext - decision logic depends only on context methods plus the synchronous getPackageVersion() lookup, never on direct subprocess, registry, or
+ * process-state I/O.
  * @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).
@@ -112,7 +94,7 @@ export async function handleUpgradeCommand(args, ctx = createDefaultUpgradeConte
         return 0;
     }
     // 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.
+    // because we should not blindly run npm install when we cannot see whether it would do anything.
     if (!force && latestVersion && !isVersionLessThan(currentVersion, latestVersion)) {
         ctx.stdout("PrismCast v" + currentVersion + " is already the latest version.");
         ctx.stdout("Use --force to upgrade anyway.");
@@ -127,17 +109,34 @@ export async function handleUpgradeCommand(args, ctx = createDefaultUpgradeConte
     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) {
+    // Dispatch to the platform-aware lifecycle. The returned UpgradeStep tells us whether the upgrade ran in-process synchronously (POSIX path) or was handed
+    // off to a detached helper (Windows path); we narrow on `kind` and handle each variant's messaging and exit behavior. packageDir flows through to the
+    // lifecycle as part of InstallInfo (only npm-local declares a resolver that sets it).
+    const step = ctx.performUpgrade(info);
+    if (step.kind === "handed-off") {
+        // The Windows handoff strategy has spawned a detached helper that is waiting for the current process to exit so file locks on the prismcast directory
+        // release before npm install runs. We must exit immediately; the helper handles the upgrade and (conditionally) the service-task restart on its own. The
+        // log path is surfaced so the user has somewhere to look while the upgrade runs.
+        //
+        // The restart message is deliberately phrased as a conditional rather than an unconditional promise. The helper only restarts the scheduled task when one
+        // is registered; a user who invokes `prismcast upgrade` against a non-service install will need to restart PrismCast manually after the helper finishes.
+        // We cannot know which branch will apply without probing Task Scheduler from our process, and that would add a synchronous PowerShell call to every
+        // upgrade. The honest two-clause message keeps both audiences correctly informed without that cost.
+        ctx.stdout("Upgrade is running in the background.");
+        ctx.stdout("If PrismCast is registered as a Windows service, the helper will restart it when the upgrade completes; otherwise, restart PrismCast manually.");
+        ctx.stdout("Helper log: " + step.logPath);
+        ctx.exit(0);
+    }
+    // In-process path: the upgrade ran synchronously and the result is the runner's outcome.
+    if (!step.success) {
         ctx.stderr("");
         ctx.stderr("Upgrade failed. Check the output above for details.");
         return 1;
     }
     ctx.stdout("");
     ctx.stdout("Upgrade complete.");
-    // Service-managed processes restart automatically when we exit; manual installs need a user-driven restart.
+    // Service-managed processes restart automatically when we exit; manual installs need a user-driven restart. The handoff branch above does not reach this
+    // code because its helper owns the restart; only the in-process branch falls through here.
     if (ctx.isService) {
         ctx.stdout("Restarting PrismCast via service manager...");
         ctx.exit(0);

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

@@ -4,3 +4,4 @@ import type { DetectionContext } from "./detection.ts";
  * @returns A DetectionContext populated from the live process.
  */
 export declare function createDefaultDetectionContext(): DetectionContext;
+//# sourceMappingURL=detection.context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detection.context.d.ts","sourceRoot":"","sources":["../../src/upgrade/detection.context.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,gBAAgB,CAoBhE"}

package/dist/upgrade/detection.context.js

@@ -1,3 +1,4 @@
+import { createPathHandle } from "./pathHandle.js";
 import { execSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { isRunningInContainer } from "../utils/platform.js";
@@ -8,11 +9,13 @@ import url from "node:url";
  */
 export function createDefaultDetectionContext() {
     return {
-        currentFile: url.fileURLToPath(import.meta.url),
+        currentFile: createPathHandle(url.fileURLToPath(import.meta.url)),
         fileExists: existsSync,
         isContainer: isRunningInContainer(),
         runCommand: (cmd) => {
             try {
+                // We cap each detection probe at five seconds so that a hung command (for example, a stalled "npm prefix -g") cannot stall install-method detection. A
+                // probe that exceeds the ceiling throws, which we treat the same as any other failure by returning null below.
                 return execSync(cmd, { encoding: "utf-8", timeout: 5000 }).trim();
             }
             catch {

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

@@ -1 +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"}
+{"version":3,"file":"detection.context.js","sourceRoot":"","sources":["../../src/upgrade/detection.context.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,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,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjE,UAAU,EAAE,UAAU;QACtB,WAAW,EAAE,oBAAoB,EAAE;QACnC,UAAU,EAAE,CAAC,GAAW,EAAiB,EAAE;YAEzC,IAAI,CAAC;gBAEH,uJAAuJ;gBACvJ,+GAA+G;gBAC/G,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,10 +1,11 @@
+import type { PathHandle } from "./pathHandle.ts";
 /**
  * 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 DetectionContext {
-    readonly currentFile: string;
+    readonly currentFile: PathHandle;
     readonly fileExists: (path: string) => boolean;
     readonly isContainer: boolean;
     readonly runCommand: (cmd: string) => string | null;
@@ -46,8 +47,8 @@ export interface NonUpgradeableInstallStrategy<M extends string = string> extend
     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.
+ * Discriminated union of install-method strategies. The field that marks the kind 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 [{
@@ -91,7 +92,7 @@ export type RegisteredMethod = typeof STRATEGY_TUPLE[number]["id"];
 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.
+ * registered. Consumers that need exhaustive coverage over the full method set get it via this type.
  */
 export type InstallMethod = RegisteredMethod | "unknown";
 /**
@@ -131,9 +132,9 @@ export type InstallInfo = UpgradeableInstallInfo | NonUpgradeableInstallInfo;
 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.
+ * resolver output with the strategy's constant fields. The resolver's return type is restricted to ResolvableFields, so it cannot override method, displayName,
+ * or upgradeCommand; the spread order also places constants after the resolved fields as belt-and-suspenders. The strategy's `upgradeable`
+ * field 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.
@@ -143,3 +144,4 @@ export declare const UNKNOWN_INSTALL: NonUpgradeableInstallInfo;
  */
 export declare function detectInstallMethod(ctx?: DetectionContext): InstallInfo;
 export {};
+//# sourceMappingURL=detection.d.ts.map