prismcast 1.10.2 → 1.11.0

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

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

package/dist/upgrade/detection.js

@@ -1,40 +1,4 @@
-/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
- *
- * detection.ts: Installation method detection for PrismCast upgrade.
- *
- * The architecture is ports-and-adapters with a strategy registry whose entries are the single source of truth for everything PrismCast knows about its
- * installation methods - including the InstallMethod type, which is derived from the registry rather than declared in parallel with it.
- *
- *   - DetectionContext (this file) - the runtime-input port; what every strategy needs to make its decision
- *   - ResolvableFields (this file) - the narrow set of InstallInfo fields a strategy's resolver may compute (today: packageDir)
- *   - InstallStrategy<M> (this file) - a discriminated union over `upgradeable`; non-upgradeable variants carry manualUpgradeMessage
- *   - INSTALL_STRATEGIES (this file) - the registry; the SSOT for what install methods PrismCast recognizes, in priority order
- *   - RegisteredMethod, InstallMethod (derived) - the literal-union types produced from the registry; cannot drift from the strategies
- *   - InstallInfo (this file) - the dispatcher's output; mirrors the strategy union so non-upgradeable infos carry the message
- *   - detectInstallMethod (this file) - the dispatcher; a fold over the registry that builds the right InstallInfo variant
- *   - createDefaultDetectionContext (detection.context) - the adapter; the only place that reads import.meta.url, runs subprocesses, or touches the FS
- *
- * Adding a new install method is appending one record to INSTALL_STRATEGIES. The InstallMethod type updates automatically. The dispatcher and the adapter never
- * change. Tests construct DetectionContext literals inline; production calls detectInstallMethod() with no arguments and the default-argument wires through to
- * createDefaultDetectionContext.
- *
- * Why the discriminated union on `upgradeable`. Boolean flags that gate the presence of other fields are a smell - they let callers ask for fields that are not
- * meaningful in the current state, and they push the responsibility for "is this field present?" onto every consumer's runtime check. Splitting the strategy
- * (and its corresponding InstallInfo) into upgradeable vs non-upgradeable variants lets TypeScript enforce that manualUpgradeMessage exists exactly when
- * upgradeable is false. Consumers narrow on `if(!info.upgradeable)` and read the message field with full type safety; the structural impossibility of an
- * upgradeable strategy carrying manual instructions, or a non-upgradeable one omitting them, is enforced at the type level rather than by convention.
- */
 import { createDefaultDetectionContext } from "./detection.context.js";
-import path from "node:path";
-// Path marker that distinguishes Homebrew formula installs from npm-on-Homebrew installs. The npm global directory under Homebrew lives at /opt/homebrew/lib/
-// node_modules/prismcast/ on Apple Silicon, which would otherwise produce a false-positive homebrew match; checking for /Cellar/prismcast/ specifically avoids
-// that.
-const HOMEBREW_MARKER = "/Cellar/prismcast/";
-// Path marker for npm local installs. The package's source files live under <project>/node_modules/prismcast/...; the npm-local resolver extracts the project
-// root by slicing the path before this marker. The npm-global strategy also uses the broader "/node_modules/" substring as a cheap prefilter to skip the
-// subprocess call when the path could not possibly be an npm install.
-const NPM_LOCAL_MARKER = "/node_modules/prismcast/";
-const ANY_NODE_MODULES = "/node_modules/";
 /**
  * Docker strategy. Matched via the container-environment probe rather than the path - inside a container, path-based detection is irrelevant because the path
  * looks like any other npm install but the upgrade flow is fundamentally different (recreate the container, not run a package manager). Carries the manual
@@ -52,50 +16,55 @@ const DOCKER_STRATEGY = {
     upgradeable: false
 };
 /**
- * Homebrew strategy. Matched via the /Cellar/prismcast/ path marker. Homebrew formula installs always live under <prefix>/Cellar/<formula>/<version>/, so the
- * marker is a reliable discriminator on both Intel (/usr/local/Cellar) and Apple Silicon (/opt/homebrew/Cellar) layouts.
+ * Homebrew strategy. Matched via the "Cellar" + "prismcast" segment chain. Homebrew formula installs always live under <prefix>/Cellar/<formula>/<version>/, so
+ * the pair reliably identifies Homebrew installs on both Intel (/usr/local/Cellar) and Apple Silicon (/opt/homebrew/Cellar) layouts. The chain is deliberately the pair
+ * rather than just "Cellar" so an npm-on-Homebrew install at /opt/homebrew/lib/node_modules/prismcast/ does not false-positive...that path contains "homebrew"
+ * but not "Cellar/prismcast".
  */
 const HOMEBREW_STRATEGY = {
     displayName: "Homebrew",
     id: "homebrew",
-    matches: (ctx) => ctx.currentFile.includes(HOMEBREW_MARKER),
+    matches: (ctx) => ctx.currentFile.hasSegmentChain("Cellar", "prismcast"),
     upgradeCommand: "brew update && brew upgrade prismcast",
     upgradeable: true
 };
 /**
- * npm global strategy. Matched in two stages: a cheap path prefilter (the running file must be under SOME node_modules tree), then the authoritative subprocess
- * call to `npm prefix -g`. The prefilter avoids spawning npm for paths that obviously can not be an npm install (e.g., a development checkout, a Homebrew Cellar
- * path), keeping the matches predicate inexpensive in the common no-match case.
+ * npm global strategy. Matched in two stages: a cheap path prefilter (the running file must contain a "node_modules" segment), then the authoritative subprocess
+ * call to `npm prefix -g` followed by a structural is-under check against the reported prefix. The prefilter avoids spawning npm for paths that obviously cannot
+ * be an npm install (e.g., a development checkout, a Homebrew Cellar path), keeping the matches predicate inexpensive in the common no-match case. Both checks
+ * flow through PathHandle so the predicate is platform-agnostic by construction.
  */
 const NPM_GLOBAL_STRATEGY = {
     displayName: "npm (global)",
     id: "npm-global",
     matches: (ctx) => {
-        if (!ctx.currentFile.includes(ANY_NODE_MODULES)) {
+        if (!ctx.currentFile.hasSegmentChain("node_modules")) {
             return false;
         }
         const globalPrefix = ctx.runCommand("npm prefix -g");
         if (!globalPrefix) {
             return false;
         }
-        return ctx.currentFile.startsWith(globalPrefix);
+        return ctx.currentFile.isUnder(globalPrefix);
     },
     upgradeCommand: "npm install -g prismcast@latest",
     upgradeable: true
 };
 /**
- * npm local strategy. Matched via the /node_modules/prismcast/ path marker; the resolver computes packageDir as the directory above node_modules, but only when
- * that directory actually has a package.json (some weird layouts have an orphaned node_modules without a manifest, and the upgrade runner needs the right cwd
- * for npm install).
+ * npm local strategy. Matched via the "node_modules" + "prismcast" segment chain; the resolver walks the same chain via parentBefore to recover the consumer's
+ * project root (the directory above node_modules) and confirms the manifest is actually there via fileExists. Some unusual layouts have an orphaned node_modules
+ * without a manifest, and the upgrade runner needs the right cwd for `npm install`, so we only surface packageDir when we can prove the manifest exists.
  */
 const NPM_LOCAL_STRATEGY = {
     displayName: "npm (local)",
     id: "npm-local",
-    matches: (ctx) => ctx.currentFile.includes(NPM_LOCAL_MARKER),
+    matches: (ctx) => ctx.currentFile.hasSegmentChain("node_modules", "prismcast"),
     resolve: (ctx) => {
-        const localIndex = ctx.currentFile.indexOf(NPM_LOCAL_MARKER);
-        const projectRoot = ctx.currentFile.slice(0, localIndex);
-        return ctx.fileExists(path.join(projectRoot, "package.json")) ? { packageDir: projectRoot } : {};
+        const projectRoot = ctx.currentFile.parentBefore("node_modules", "prismcast");
+        if (!projectRoot) {
+            return {};
+        }
+        return ctx.fileExists(projectRoot.join("package.json")) ? { packageDir: projectRoot.raw } : {};
     },
     upgradeCommand: "npm install prismcast@latest",
     upgradeable: true
@@ -131,9 +100,9 @@ export const UNKNOWN_INSTALL = {
 };
 /**
  * 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.

package/dist/upgrade/detection.js.map

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

package/dist/upgrade/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./commands.ts";
 export * from "./detection.ts";
+export * from "./lifecycle.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAIA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/dist/upgrade/index.js

@@ -4,4 +4,5 @@
  */
 export * from "./commands.js";
 export * from "./detection.js";
+export * from "./lifecycle.js";
 //# sourceMappingURL=index.js.map

package/dist/upgrade/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/upgrade/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { UpgradeLifecycleContext } from "./lifecycle.ts";
+/**
+ * Builds the default UpgradeLifecycleContext from real runtime I/O.
+ *
+ * runCommand inherits the user's terminal so npm/brew output flows live; it captures only the exit outcome, not the captured stdio. spawnDetached launches a
+ * fully decoupled child process - detached, stdio ignored, windowsHide on - then unref's so the child can outlive the parent. The Windows handoff strategy is
+ * the sole caller; on POSIX the strategy never invokes it.
+ *
+ * serviceTaskName resolves to the documented PrismCast service identifier when running on Windows. It is the empty string on other platforms because the field
+ * is only consumed by the Windows handoff helper. We always send the identifier (rather than gating on isRunningAsService) because the helper itself probes
+ * Get-ScheduledTask for the running task and skips the stop/start steps cleanly when none is registered...the user may be running a global npm install of
+ * prismcast on Windows without having registered a service yet, and the upgrade flow must still work.
+ *
+ * upgradeLogPath sits inside the PrismCast data directory at `upgrade.log`. The helper appends timestamped lines and the upgrade command's captured stdout to
+ * this file; the user is told its location in the "handed-off" UpgradeStep so they can tail or read it.
+ *
+ * @returns An UpgradeLifecycleContext populated from the live process.
+ */
+export declare function createDefaultLifecycleContext(): UpgradeLifecycleContext;
+//# sourceMappingURL=lifecycle.context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.context.d.ts","sourceRoot":"","sources":["../../src/upgrade/lifecycle.context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,uBAAuB,EAAoB,MAAM,gBAAgB,CAAC;AAMhF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CAgCvE"}

package/dist/upgrade/lifecycle.context.js

@@ -0,0 +1,47 @@
+import { execSync, spawn } from "node:child_process";
+import { SERVICE_NAME } from "../identity.js";
+import { getDataDir } from "../config/paths.js";
+import path from "node:path";
+/**
+ * Builds the default UpgradeLifecycleContext from real runtime I/O.
+ *
+ * runCommand inherits the user's terminal so npm/brew output flows live; it captures only the exit outcome, not the captured stdio. spawnDetached launches a
+ * fully decoupled child process - detached, stdio ignored, windowsHide on - then unref's so the child can outlive the parent. The Windows handoff strategy is
+ * the sole caller; on POSIX the strategy never invokes it.
+ *
+ * serviceTaskName resolves to the documented PrismCast service identifier when running on Windows. It is the empty string on other platforms because the field
+ * is only consumed by the Windows handoff helper. We always send the identifier (rather than gating on isRunningAsService) because the helper itself probes
+ * Get-ScheduledTask for the running task and skips the stop/start steps cleanly when none is registered...the user may be running a global npm install of
+ * prismcast on Windows without having registered a service yet, and the upgrade flow must still work.
+ *
+ * upgradeLogPath sits inside the PrismCast data directory at `upgrade.log`. The helper appends timestamped lines and the upgrade command's captured stdout to
+ * this file; the user is told its location in the "handed-off" UpgradeStep so they can tail or read it.
+ *
+ * @returns An UpgradeLifecycleContext populated from the live process.
+ */
+export function createDefaultLifecycleContext() {
+    return {
+        parentPid: process.pid,
+        platform: process.platform,
+        runCommand: (cmd, options) => {
+            try {
+                execSync(cmd, { cwd: options.cwd, encoding: "utf-8", stdio: "inherit" });
+                return { success: true };
+            }
+            catch {
+                return { success: false };
+            }
+        },
+        serviceTaskName: (process.platform === "win32") ? SERVICE_NAME : "",
+        spawnDetached: (command, args) => {
+            const child = spawn(command, [...args], {
+                detached: true,
+                stdio: "ignore",
+                windowsHide: true
+            });
+            child.unref();
+        },
+        upgradeLogPath: path.join(getDataDir(), "upgrade.log")
+    };
+}
+//# sourceMappingURL=lifecycle.context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.context.js","sourceRoot":"","sources":["../../src/upgrade/lifecycle.context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,6BAA6B;IAE3C,OAAO;QAEL,SAAS,EAAE,OAAO,CAAC,GAAG;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,UAAU,EAAE,CAAC,GAAW,EAAE,OAAkC,EAAoB,EAAE;YAEhF,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,eAAe,EAAE,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE;QACnE,aAAa,EAAE,CAAC,OAAe,EAAE,IAAuB,EAAQ,EAAE;YAEhE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE;gBAEtC,QAAQ,EAAE,IAAI;gBACd,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;YAEH,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QACD,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,aAAa,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/upgrade/lifecycle.d.ts

@@ -0,0 +1,72 @@
+import type { InstallInfo } from "./detection.ts";
+/**
+ * Outcome of a single upgrade attempt. Discriminated union over `kind`. Consumers narrow on it to choose between "the upgrade ran in-process, here is the
+ * outcome" and "a detached helper is taking it from here, exit immediately and trust the helper to finish the job."
+ *
+ * The "handed-off" variant is structurally permissible only because the strategy that produced it has already spawned the helper before returning; the field
+ * `logPath` is the path the helper writes its progress to so the user has a place to look while the upgrade is running.
+ */
+export type UpgradeStep = {
+    readonly kind: "ran";
+    readonly success: boolean;
+} | {
+    readonly kind: "handed-off";
+    readonly logPath: string;
+};
+/**
+ * Result of running an upgrade subprocess. The in-process strategy passes this through verbatim into the UpgradeStep "ran" variant, so its success flag is what
+ * commands.ts narrows on and the outcome shape stays consistent across the two layers. The success flag distinguishes ran-without-error from
+ * threw-or-exited-non-zero; the runner does not surface the actual error because the user sees subprocess stderr directly on the terminal.
+ */
+export interface UpgradeRunResult {
+    readonly success: boolean;
+}
+/**
+ * Runtime context the lifecycle strategies consume. Each field is one narrow capability some strategy needs. POSIX strategies use only `runCommand`; the
+ * Windows handoff strategy uses `parentPid`, `serviceTaskName`, `spawnDetached`, `upgradeLogPath`. Splitting them onto one struct keeps the adapter (and the
+ * UpgradeLifecycleContext interface it satisfies for tests) a single object, even though no strategy uses every field.
+ */
+export interface UpgradeLifecycleContext {
+    readonly parentPid: number;
+    readonly platform: NodeJS.Platform;
+    readonly runCommand: (cmd: string, options: {
+        readonly cwd?: string;
+    }) => UpgradeRunResult;
+    readonly serviceTaskName: string;
+    readonly spawnDetached: (command: string, args: readonly string[]) => void;
+    readonly upgradeLogPath: string;
+}
+/**
+ * A platform-strategy record. The registry is a flat tuple of these; the dispatcher picks the first whose `platforms` list includes the current OS. Pure
+ * function over UpgradeLifecycleContext + InstallInfo; no state is owned by the strategy itself.
+ */
+export interface UpgradeLifecycleStrategy {
+    readonly id: string;
+    readonly platforms: readonly NodeJS.Platform[];
+    readonly perform: (ctx: UpgradeLifecycleContext, info: InstallInfo) => UpgradeStep;
+}
+/**
+ * The upgrade-lifecycle strategy registry. Same runtime data as STRATEGY_TUPLE; the public name carries the wide UpgradeLifecycleStrategy type so consumers
+ * and tests see one uniform shape. Adding a new platform-specific strategy is appending an entry to STRATEGY_TUPLE; the dispatcher and the adapter never
+ * change.
+ */
+export declare const UPGRADE_LIFECYCLES: readonly UpgradeLifecycleStrategy[];
+/**
+ * Selects the lifecycle strategy for a given platform. Falls back to the POSIX in-process strategy when no strategy lists the platform...this covers any
+ * Unix-like host that is not specifically called out and keeps the function total (no thrown error from a one-off platform name).
+ *
+ * @param platform - The OS platform identifier.
+ * @returns The matching strategy, or the POSIX default when no strategy serves the platform.
+ */
+export declare function selectLifecycle(platform: NodeJS.Platform): UpgradeLifecycleStrategy;
+/**
+ * Performs an upgrade by selecting the platform-appropriate strategy and invoking its `perform` callback. Pure dispatcher; all I/O happens inside the
+ * strategy's own callbacks (which themselves receive an UpgradeLifecycleContext that the adapter wires from real I/O). Tests inject context literals and
+ * exercise each strategy through this entry point.
+ *
+ * @param ctx - The lifecycle context.
+ * @param info - The detected install info.
+ * @returns The upgrade outcome.
+ */
+export declare function performUpgrade(ctx: UpgradeLifecycleContext, info: InstallInfo): UpgradeStep;
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/upgrade/lifecycle.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IAIxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B,GAAG;IAKF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAE/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IAItC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAI3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAInC,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,gBAAgB,CAAC;IAK3F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAKjC,QAAQ,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAI3E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IAIvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAIpB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC;IAI/C,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,WAAW,KAAK,WAAW,CAAC;CACpF;AA0KD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,wBAAwB,EAAmB,CAAC;AAEtF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,wBAAwB,CAGnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,uBAAuB,EAAE,IAAI,EAAE,WAAW,GAAG,WAAW,CAG3F"}

package/dist/upgrade/lifecycle.js

@@ -0,0 +1,175 @@
+/**
+ * The PowerShell helper that the Windows handoff strategy spawns. Reads five positional parameters: the parent process ID, the optional service task name
+ * (empty string when no service is registered), the upgrade command exactly as detection.ts produced it, the optional working directory for npm-local
+ * installs (empty string for npm-global), and the log path the helper appends its progress to.
+ *
+ * Sequence:
+ *
+ *   1. Wait for the parent process to exit. Wait-Process with -ErrorAction SilentlyContinue tolerates the (theoretical) case where the parent has already exited
+ *      between us being spawned and this line running.
+ *   2. If a service task is registered, disable it (so RestartOnFailure does not interfere) and stop it. Stop-ScheduledTask is non-blocking, so we
+ *      poll for the task to transition out of Running with a 30-second ceiling - the same poll pattern as service/generators.ts's WINDOWS_REGISTER_SCRIPT.
+ *   3. Run the upgrade command via cmd.exe /c so npm/brew shell-style command lines parse correctly. Output is captured for the log; the exit code is captured
+ *      so we can re-raise it as our own exit code at the very end.
+ *   4. If a service task is registered, re-enable it and start it. The re-enable is necessary because Disable-ScheduledTask persists across restarts; without
+ *      this step, the next reboot would silently leave the service disabled.
+ *   5. Exit with the upgrade's exit code so the helper's own exit reflects the upgrade outcome (visible in the log via $LASTEXITCODE).
+ *
+ * Logging is best-effort: a failed Add-Content call (e.g., the directory does not exist) is swallowed by SilentlyContinue so the helper still completes its
+ * primary job. The log itself is the only user-facing artifact of the helper, and we surface its path back to commands.ts as part of the UpgradeStep.
+ */
+const WINDOWS_HANDOFF_SCRIPT = [
+    "param($ParentPid, $TaskName, $UpgradeCommand, $WorkingDir, $LogPath)",
+    "function Write-UpgradeLog($message) {",
+    "  $stamp = Get-Date -Format 'yyyy-MM-dd HH:mm:ss'",
+    "  try { Add-Content -Path $LogPath -Value ('[' + $stamp + '] ' + $message) -Encoding utf8 -ErrorAction SilentlyContinue } catch {}",
+    "}",
+    "Write-UpgradeLog ('Helper started; waiting for parent PID ' + $ParentPid + ' to exit.')",
+    "try { Wait-Process -Id $ParentPid -ErrorAction SilentlyContinue } catch {}",
+    "Write-UpgradeLog 'Parent exited.'",
+    "if($TaskName) {",
+    "  $existing = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue",
+    "  if($existing) {",
+    "    Write-UpgradeLog ('Disabling and stopping task ' + $TaskName + '.')",
+    "    Disable-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue | Out-Null",
+    "    Stop-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue | Out-Null",
+    "    $deadline = (Get-Date).AddSeconds(30)",
+    "    while((Get-Date) -lt $deadline) {",
+    "      $state = (Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue).State",
+    "      if(($null -eq $state) -or ($state -ne 'Running')) { break }",
+    "      Start-Sleep -Milliseconds 250",
+    "    }",
+    "    Write-UpgradeLog ('Task state after stop: ' + $state + '.')",
+    "  } else {",
+    "    Write-UpgradeLog 'No matching scheduled task found; skipping stop/start.'",
+    "  }",
+    "}",
+    "if($WorkingDir) { Set-Location -Path $WorkingDir }",
+    "Write-UpgradeLog ('Running upgrade command: ' + $UpgradeCommand)",
+    "$upgradeOutput = (& cmd.exe /c $UpgradeCommand 2>&1) | Out-String",
+    "$upgradeExit = $LASTEXITCODE",
+    "try { Add-Content -Path $LogPath -Value $upgradeOutput -Encoding utf8 -ErrorAction SilentlyContinue } catch {}",
+    "Write-UpgradeLog ('Upgrade exit code: ' + $upgradeExit + '.')",
+    "if($TaskName) {",
+    "  $existing = Get-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue",
+    "  if($existing) {",
+    "    Write-UpgradeLog ('Re-enabling and starting task ' + $TaskName + '.')",
+    "    Enable-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue | Out-Null",
+    "    Start-ScheduledTask -TaskName $TaskName -ErrorAction SilentlyContinue | Out-Null",
+    "  }",
+    "}",
+    "Write-UpgradeLog 'Helper finished.'",
+    "exit $upgradeExit"
+].join("\n");
+/**
+ * Escapes a value for embedding inside a single-quoted PowerShell string. PowerShell's single-quoted strings are literal (no interpolation, no backslash
+ * escapes); the only character that requires escaping is the single quote itself, written as two consecutive single quotes. Mirrors the same helper in
+ * service/generators.ts so the two PowerShell-emitting modules agree on the one escape rule that matters.
+ *
+ * @param value - The value to escape.
+ * @returns The value with internal single quotes doubled.
+ */
+function escapeSingleQuoted(value) {
+    return value.replaceAll("'", "''");
+}
+/**
+ * Wraps a value in a PowerShell single-quoted literal.
+ * @param value - The value to quote.
+ * @returns The literal including its surrounding quotes.
+ */
+function powerShellLiteral(value) {
+    return "'" + escapeSingleQuoted(value) + "'";
+}
+/**
+ * Builds the PowerShell command string that the Windows handoff strategy passes to powershell.exe via -Command. The script body is wrapped in `& { ... }` and
+ * the positional arguments are appended after the closing brace, exactly as PowerShell's parser expects. Each argument is single-quote-escaped via
+ * powerShellLiteral, so there is one - and only one - escape surface (the single-quote doubling rule).
+ *
+ * @param args - The positional arguments to pass to the helper script's param() block, in declaration order.
+ * @returns The fully composed `-Command` string.
+ */
+function buildHandoffCommand(args) {
+    const quoted = args.map((value) => powerShellLiteral(value)).join(" ");
+    return "& { " + WINDOWS_HANDOFF_SCRIPT + " } " + quoted;
+}
+/**
+ * POSIX in-process strategy. macOS and Linux can run `npm install -g` (or `brew upgrade`) directly from inside the running prismcast process because POSIX
+ * filesystems do not lock open files against directory rename. The strategy is a thin pass-through over ctx.runCommand. The caller (commands.ts) decides
+ * whether to exit afterward so the service manager (launchd KeepAlive, systemd Restart=) brings PrismCast back up.
+ */
+const POSIX_IN_PROCESS_LIFECYCLE = {
+    id: "posix-in-process",
+    perform: (ctx, info) => {
+        const result = ctx.runCommand(info.upgradeCommand, { cwd: info.packageDir });
+        return { kind: "ran", success: result.success };
+    },
+    platforms: ["darwin", "linux"]
+};
+/**
+ * Windows handoff strategy. Composes the PowerShell helper command line, hands it to ctx.spawnDetached, and returns "handed-off." The helper waits for the
+ * current process to exit (so the prismcast directory's file locks release), runs the upgrade, then restarts the scheduled task if one exists. This is the
+ * Windows EBUSY + auto-restart fix: the parent process exits cleanly with an "upgrade running in the background" message; the detached helper handles the rest.
+ *
+ * The PowerShell launch is identical to the rest of the codebase: -NoProfile / -NonInteractive for a clean shell, -ExecutionPolicy Bypass so installer-style
+ * scripted scenarios are not gated by the interactive-use policy, -WindowStyle Hidden so the user sees no console window pop up, and -Command with our
+ * single-quote-escaped script string. The launcher is spawned detached, with stdio ignored and windowsHide set, so it survives the parent's exit.
+ */
+const WINDOWS_HANDOFF_LIFECYCLE = {
+    id: "windows-handoff",
+    perform: (ctx, info) => {
+        const handoffCommand = buildHandoffCommand([
+            String(ctx.parentPid),
+            ctx.serviceTaskName,
+            info.upgradeCommand,
+            info.packageDir ?? "",
+            ctx.upgradeLogPath
+        ]);
+        ctx.spawnDetached("powershell.exe", [
+            "-NoProfile",
+            "-NonInteractive",
+            "-ExecutionPolicy", "Bypass",
+            "-WindowStyle", "Hidden",
+            "-Command", handoffCommand
+        ]);
+        return { kind: "handed-off", logPath: ctx.upgradeLogPath };
+    },
+    platforms: ["win32"]
+};
+/* The strategy registry as a narrow tuple. Declared `as const` so each entry retains its literal shape...the dispatcher walks this in order and picks the
+ * first match. POSIX comes first because it serves more platforms; Windows comes second because it serves only one. The default-fallback semantics live in
+ * selectLifecycle so an unknown platform (e.g., freebsd) falls back to the POSIX strategy because it serves the broadest platform set and keeps the
+ * dispatcher total.
+ */
+const STRATEGY_TUPLE = [
+    POSIX_IN_PROCESS_LIFECYCLE,
+    WINDOWS_HANDOFF_LIFECYCLE
+];
+/**
+ * The upgrade-lifecycle strategy registry. Same runtime data as STRATEGY_TUPLE; the public name carries the wide UpgradeLifecycleStrategy type so consumers
+ * and tests see one uniform shape. Adding a new platform-specific strategy is appending an entry to STRATEGY_TUPLE; the dispatcher and the adapter never
+ * change.
+ */
+export const UPGRADE_LIFECYCLES = STRATEGY_TUPLE;
+/**
+ * Selects the lifecycle strategy for a given platform. Falls back to the POSIX in-process strategy when no strategy lists the platform...this covers any
+ * Unix-like host that is not specifically called out and keeps the function total (no thrown error from a one-off platform name).
+ *
+ * @param platform - The OS platform identifier.
+ * @returns The matching strategy, or the POSIX default when no strategy serves the platform.
+ */
+export function selectLifecycle(platform) {
+    return UPGRADE_LIFECYCLES.find((strategy) => strategy.platforms.includes(platform)) ?? POSIX_IN_PROCESS_LIFECYCLE;
+}
+/**
+ * Performs an upgrade by selecting the platform-appropriate strategy and invoking its `perform` callback. Pure dispatcher; all I/O happens inside the
+ * strategy's own callbacks (which themselves receive an UpgradeLifecycleContext that the adapter wires from real I/O). Tests inject context literals and
+ * exercise each strategy through this entry point.
+ *
+ * @param ctx - The lifecycle context.
+ * @param info - The detected install info.
+ * @returns The upgrade outcome.
+ */
+export function performUpgrade(ctx, info) {
+    return selectLifecycle(ctx.platform).perform(ctx, info);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/upgrade/lifecycle.js.map

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

package/dist/upgrade/pathHandle.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A platform-aware handle on an absolute filesystem path. Strategies reason about install layout exclusively through this type; the underlying separator,
+ * case-folding rules, and segment topology are encapsulated. Adding a new structural query is an additive edit to this interface; the factory below is the only
+ * implementation site.
+ */
+export interface PathHandle {
+    readonly raw: string;
+    hasSegmentChain(...segments: readonly string[]): boolean;
+    isUnder(prefix: string): boolean;
+    join(...segments: readonly string[]): string;
+    parentBefore(...segments: readonly string[]): PathHandle | null;
+}
+/**
+ * Options accepted by createPathHandle. The platform override lets tests produce Windows-flavored handles on a Linux host.
+ */
+export interface PathHandleOptions {
+    readonly platform?: NodeJS.Platform;
+}
+/**
+ * Constructs a PathHandle from an absolute path string. The factory captures the platform once and dispatches every subsequent query through `path.win32` or
+ * `path.posix` accordingly, so behavior is independent of where the host process runs. The handle is logically immutable...returned fields are typed readonly
+ * and the closed-over state is never mutated.
+ *
+ * @param raw - The OS-native absolute path string. Empty input produces a degenerate handle whose queries return false/null; a relative input is not rejected
+ * (hasSegmentChain still matches its segments), so callers must supply an absolute path.
+ * @param options - Optional overrides; the platform override lets tests exercise cross-platform behavior deterministically.
+ * @returns A platform-aware PathHandle.
+ */
+export declare function createPathHandle(raw: string, options?: PathHandleOptions): PathHandle;
+//# sourceMappingURL=pathHandle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pathHandle.d.ts","sourceRoot":"","sources":["../../src/upgrade/pathHandle.ts"],"names":[],"mappings":"AAoBA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAIzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAIrB,eAAe,CAAC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IAKzD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAIjC,IAAI,CAAC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAAC;IAK7C,YAAY,CAAC,GAAG,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAIhC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA0GzF"}