@scopewatch/install-adapters 0.0.1

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+export type InstallErrorCategory = 'node_not_installed' | 'node_version_too_old' | 'npm_not_installed' | 'package_not_found' | 'network_unreachable' | 'permission_denied' | 'entry_point_broken' | 'unrecognized';
+export declare class InstallError extends Error {
+    category: InstallErrorCategory;
+    /** Raw underlying detail (npm stderr, spawn error, etc.), for diagnostics/logs. */
+    detail: string | undefined;
+    constructor(category: InstallErrorCategory, message: string, detail?: string);
+}
+export declare const MIN_NODE_VERSION = "22.0.0";
+export declare const RECOMMENDED_NODE_VERSION = "24.x";
+export declare function nodeNotInstalledError(): InstallError;
+export declare function nodeVersionTooOldError(found: string): InstallError;
+export declare function npmNotInstalledError(): InstallError;
+export declare function packageNotFoundError(name: string): InstallError;
+export declare function networkUnreachableError(): InstallError;
+export declare function permissionDeniedError(path: string): InstallError;
+/**
+ * Scope note: this category is intentionally minimal for Phase D. It confirms the
+ * package's declared entry point exists on disk and, for a plain Node script, that
+ * requiring/importing it doesn't throw synchronously. It does NOT attempt an MCP
+ * JSON-RPC handshake or any protocol-level connectivity check - that is the job of
+ * `scopewatch test <server>` and the diagnostics module (Phase I), which own
+ * connection validation. Do not extend this check into protocol testing; a broken
+ * or incompletely-published package is the failure this category exists to catch,
+ * not "does this server actually speak MCP correctly."
+ */
+export declare function entryPointBrokenError(name: string, detail: string): InstallError;
+export declare function unrecognizedInstallError(code: string | undefined, rawOutput: string): InstallError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,oBAAoB,GACpB,sBAAsB,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,GACpB,cAAc,CAAC;AAEnB,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,mFAAmF;IACnF,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;gBAEf,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAM7E;AAED,eAAO,MAAM,gBAAgB,WAAW,CAAC;AACzC,eAAO,MAAM,wBAAwB,SAAS,CAAC;AAE/C,wBAAgB,qBAAqB,IAAI,YAAY,CAMpD;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAMlE;AAED,wBAAgB,oBAAoB,IAAI,YAAY,CAMnD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM/D;AAED,wBAAgB,uBAAuB,IAAI,YAAY,CAMtD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAMhE;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAQhF;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAOlG"}

package/dist/errors.js

@@ -0,0 +1,61 @@
+export class InstallError extends Error {
+    category;
+    /** Raw underlying detail (npm stderr, spawn error, etc.), for diagnostics/logs. */
+    detail;
+    constructor(category, message, detail) {
+        super(message);
+        this.name = 'InstallError';
+        this.category = category;
+        this.detail = detail;
+    }
+}
+export const MIN_NODE_VERSION = '22.0.0';
+export const RECOMMENDED_NODE_VERSION = '24.x';
+export function nodeNotInstalledError() {
+    return new InstallError('node_not_installed', `Node.js is not installed or not on PATH. Install Node.js ${MIN_NODE_VERSION} or later ` +
+        `(${RECOMMENDED_NODE_VERSION} recommended) from https://nodejs.org, then run 'scopewatch doctor' again.`);
+}
+export function nodeVersionTooOldError(found) {
+    return new InstallError('node_version_too_old', `Node.js ${found} is installed, but Scopewatch requires ${MIN_NODE_VERSION} or later ` +
+        `(${RECOMMENDED_NODE_VERSION} recommended). Upgrade Node.js, then run 'scopewatch doctor' again.`);
+}
+export function npmNotInstalledError() {
+    return new InstallError('npm_not_installed', `npm is not installed or not on PATH. npm ships with Node.js - reinstalling Node.js ` +
+        `from https://nodejs.org should restore it.`);
+}
+export function packageNotFoundError(name) {
+    return new InstallError('package_not_found', `Package '${name}' was not found in the npm registry. Check the package name for typos, ` +
+        `or confirm it's published.`);
+}
+export function networkUnreachableError() {
+    return new InstallError('network_unreachable', `Could not reach the npm registry (network error). Check your internet connection and ` +
+        `proxy settings, then retry.`);
+}
+export function permissionDeniedError(path) {
+    return new InstallError('permission_denied', `Permission denied writing to ${path}. Scopewatch installs locally and should not require ` +
+        `elevated privileges - check ownership of ${path}.`);
+}
+/**
+ * Scope note: this category is intentionally minimal for Phase D. It confirms the
+ * package's declared entry point exists on disk and, for a plain Node script, that
+ * requiring/importing it doesn't throw synchronously. It does NOT attempt an MCP
+ * JSON-RPC handshake or any protocol-level connectivity check - that is the job of
+ * `scopewatch test <server>` and the diagnostics module (Phase I), which own
+ * connection validation. Do not extend this check into protocol testing; a broken
+ * or incompletely-published package is the failure this category exists to catch,
+ * not "does this server actually speak MCP correctly."
+ */
+export function entryPointBrokenError(name, detail) {
+    return new InstallError('entry_point_broken', `'${name}' installed successfully but its entry point failed a basic load check: ` +
+        `${truncate(detail, 300)}. This usually means a missing runtime dependency or an ` +
+        `incompatible Node version for this package.`, detail);
+}
+export function unrecognizedInstallError(code, rawOutput) {
+    return new InstallError('unrecognized', `Install failed with an unrecognized error${code ? ` (${code})` : ''}. ` +
+        `Raw npm output: ${truncate(rawOutput, 500)}`, rawOutput);
+}
+function truncate(s, max) {
+    const oneLine = s.replace(/\s+/g, ' ').trim();
+    return oneLine.length > max ? oneLine.slice(0, max) + '...' : oneLine;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAuB;IAC/B,mFAAmF;IACnF,MAAM,CAAqB;IAE3B,YAAY,QAA8B,EAAE,OAAe,EAAE,MAAe;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,YAAY,CACrB,oBAAoB,EACpB,4DAA4D,gBAAgB,YAAY;QACtF,IAAI,wBAAwB,4EAA4E,CAC3G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,OAAO,IAAI,YAAY,CACrB,sBAAsB,EACtB,WAAW,KAAK,0CAA0C,gBAAgB,YAAY;QACpF,IAAI,wBAAwB,qEAAqE,CACpG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,YAAY,CACrB,mBAAmB,EACnB,qFAAqF;QACnF,4CAA4C,CAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,OAAO,IAAI,YAAY,CACrB,mBAAmB,EACnB,YAAY,IAAI,yEAAyE;QACvF,4BAA4B,CAC/B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,YAAY,CACrB,qBAAqB,EACrB,uFAAuF;QACrF,6BAA6B,CAChC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,YAAY,CACrB,mBAAmB,EACnB,gCAAgC,IAAI,uDAAuD;QACzF,4CAA4C,IAAI,GAAG,CACtD,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAc;IAChE,OAAO,IAAI,YAAY,CACrB,oBAAoB,EACpB,IAAI,IAAI,0EAA0E;QAChF,GAAG,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,0DAA0D;QAClF,6CAA6C,EAC/C,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAwB,EAAE,SAAiB;IAClF,OAAO,IAAI,YAAY,CACrB,cAAc,EACd,4CAA4C,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QACtE,mBAAmB,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,EAC/C,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,GAAW;IACtC,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;AACxE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { checkPrerequisites, satisfiesMinVersion } from './prerequisites.js';
+export type { PrerequisiteCheckResult, CommandRunner } from './prerequisites.js';
+export { installPackage, categorizeNpmFailure, checkEntryPoint } from './npm-adapter.js';
+export type { InstallResult, InstallRunner } from './npm-adapter.js';
+export { InstallError, MIN_NODE_VERSION, RECOMMENDED_NODE_VERSION, nodeNotInstalledError, nodeVersionTooOldError, npmNotInstalledError, packageNotFoundError, networkUnreachableError, permissionDeniedError, entryPointBrokenError, unrecognizedInstallError, } from './errors.js';
+export type { InstallErrorCategory } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,YAAY,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { checkPrerequisites, satisfiesMinVersion } from './prerequisites.js';
+export { installPackage, categorizeNpmFailure, checkEntryPoint } from './npm-adapter.js';
+export { InstallError, MIN_NODE_VERSION, RECOMMENDED_NODE_VERSION, nodeNotInstalledError, nodeVersionTooOldError, npmNotInstalledError, packageNotFoundError, networkUnreachableError, permissionDeniedError, entryPointBrokenError, unrecognizedInstallError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE7E,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzF,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/dist/npm-adapter.d.ts

@@ -0,0 +1,34 @@
+import { InstallError } from './errors.js';
+import { type CommandRunner } from './prerequisites.js';
+export type InstallResult = {
+    ok: true;
+    installPath: string;
+} | {
+    ok: false;
+    error: InstallError;
+};
+/** Injected process runner for testability - avoids spawning real npm in unit tests. */
+export type InstallRunner = (command: string, args: string[]) => {
+    code: number;
+    stdout: string;
+    stderr: string;
+};
+/**
+ * Categorize an npm install failure from its exit output. Matches on npm's own
+ * stable error codes (E404, ETARGET, ENOTFOUND, etc.) rather than free-text
+ * pattern matching - codes are stable across npm versions, wording is not.
+ */
+export declare function categorizeNpmFailure(packageName: string, stderr: string, installPath: string): InstallError;
+/**
+ * Scope note: see errors.ts's entryPointBrokenError doc comment. This is a load
+ * smoke-check, not a protocol handshake. It confirms the entry point file exists
+ * and, if resolvable as a plain module, that importing it doesn't throw synchronously.
+ */
+export declare function checkEntryPoint(packageName: string, installPath: string, entryFile: string): Promise<InstallError | null>;
+/**
+ * Install a package via npm. Prerequisites are checked FIRST - a bad environment
+ * (missing Node/npm, wrong version) is reported before any install is attempted,
+ * never discovered midway through a partial install.
+ */
+export declare function installPackage(packageName: string, installPath: string, runner: InstallRunner, prereqRunner?: CommandRunner): InstallResult;
+//# sourceMappingURL=npm-adapter.d.ts.map

package/dist/npm-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-adapter.d.ts","sourceRoot":"","sources":["../src/npm-adapter.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,YAAY,EAMb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE5E,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAEvC,wFAAwF;AACxF,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,KACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAoB3G;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAa/H;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,aAAa,GAC3B,aAAa,CAaf"}

package/dist/npm-adapter.js

@@ -0,0 +1,62 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { packageNotFoundError, networkUnreachableError, permissionDeniedError, entryPointBrokenError, unrecognizedInstallError, } from './errors.js';
+import { checkPrerequisites } from './prerequisites.js';
+/**
+ * Categorize an npm install failure from its exit output. Matches on npm's own
+ * stable error codes (E404, ETARGET, ENOTFOUND, etc.) rather than free-text
+ * pattern matching - codes are stable across npm versions, wording is not.
+ */
+export function categorizeNpmFailure(packageName, stderr, installPath) {
+    const combined = stderr;
+    if (/\bE404\b/.test(combined) || /\bETARGET\b/.test(combined)) {
+        return packageNotFoundError(packageName);
+    }
+    if (/\bENOTFOUND\b/.test(combined) ||
+        /\bEAI_AGAIN\b/.test(combined) ||
+        /\bECONNREFUSED\b/.test(combined) ||
+        /\bETIMEDOUT\b/.test(combined)) {
+        return networkUnreachableError();
+    }
+    if (/\bEACCES\b/.test(combined) || /\bEPERM\b/.test(combined)) {
+        return permissionDeniedError(installPath);
+    }
+    const codeMatch = combined.match(/\bE[A-Z0-9]+\b/);
+    return unrecognizedInstallError(codeMatch?.[0], combined);
+}
+/**
+ * Scope note: see errors.ts's entryPointBrokenError doc comment. This is a load
+ * smoke-check, not a protocol handshake. It confirms the entry point file exists
+ * and, if resolvable as a plain module, that importing it doesn't throw synchronously.
+ */
+export async function checkEntryPoint(packageName, installPath, entryFile) {
+    const fullPath = join(installPath, 'node_modules', packageName, entryFile);
+    if (!existsSync(fullPath)) {
+        return entryPointBrokenError(packageName, `entry point file not found at ${fullPath}`);
+    }
+    try {
+        await import(pathToFileURL(fullPath).href);
+        return null;
+    }
+    catch (err) {
+        return entryPointBrokenError(packageName, err?.message ?? String(err));
+    }
+}
+/**
+ * Install a package via npm. Prerequisites are checked FIRST - a bad environment
+ * (missing Node/npm, wrong version) is reported before any install is attempted,
+ * never discovered midway through a partial install.
+ */
+export function installPackage(packageName, installPath, runner, prereqRunner) {
+    const prereqs = checkPrerequisites(prereqRunner);
+    if (!prereqs.ok) {
+        return { ok: false, error: prereqs.error };
+    }
+    const result = runner('npm', ['install', packageName, '--prefix', installPath]);
+    if (result.code !== 0) {
+        return { ok: false, error: categorizeNpmFailure(packageName, result.stderr, installPath) };
+    }
+    return { ok: true, installPath };
+}
+//# sourceMappingURL=npm-adapter.js.map

package/dist/npm-adapter.js.map

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

package/dist/prerequisites.d.ts

@@ -0,0 +1,21 @@
+import type { InstallError } from './errors.js';
+export type PrerequisiteCheckResult = {
+    ok: true;
+    nodeVersion: string;
+    npmVersion: string;
+} | {
+    ok: false;
+    error: InstallError;
+};
+/** Injected for testability - avoids spawning real processes in unit tests. */
+export type CommandRunner = (command: string, args: string[]) => string;
+/**
+ * Check that Node.js and npm are present and that Node meets the minimum version.
+ * Runs 'node --version' and 'npm --version' as external commands (not process.version)
+ * so this reflects what npm/npx will actually invoke on PATH, and so it stays testable
+ * via dependency injection without depending on the test runner's own Node version.
+ */
+export declare function checkPrerequisites(runner?: CommandRunner): PrerequisiteCheckResult;
+/** Minimal semver major.minor.patch comparison - sufficient for a floor check. */
+export declare function satisfiesMinVersion(version: string, minVersion: string): boolean;
+//# sourceMappingURL=prerequisites.d.ts.map

package/dist/prerequisites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerequisites.d.ts","sourceRoot":"","sources":["../src/prerequisites.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAEvC,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AASxE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,aAA6B,GAAG,uBAAuB,CAwBjG;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAQhF"}

package/dist/prerequisites.js

@@ -0,0 +1,56 @@
+import { execFileSync } from 'node:child_process';
+import { MIN_NODE_VERSION, nodeNotInstalledError, nodeVersionTooOldError, npmNotInstalledError } from './errors.js';
+// npm/npx ship as .cmd files on Windows, and Node's automatic bare-command
+// PATH resolution only searches for real executables (.exe/.com) without
+// shell: true - found via a real Windows CI run, see apps/cli/src/real-
+// runners.ts's identical fix for the full account of how this was missed.
+const defaultRunner = (command, args) => execFileSync(command, args, { encoding: 'utf-8', windowsHide: true, shell: process.platform === 'win32' });
+/**
+ * Check that Node.js and npm are present and that Node meets the minimum version.
+ * Runs 'node --version' and 'npm --version' as external commands (not process.version)
+ * so this reflects what npm/npx will actually invoke on PATH, and so it stays testable
+ * via dependency injection without depending on the test runner's own Node version.
+ */
+export function checkPrerequisites(runner = defaultRunner) {
+    let nodeVersionRaw;
+    try {
+        nodeVersionRaw = runner('node', ['--version']).trim();
+    }
+    catch (err) {
+        if (err?.code === 'ENOENT') {
+            return { ok: false, error: nodeNotInstalledError() };
+        }
+        return { ok: false, error: nodeNotInstalledError() };
+    }
+    const nodeVersion = nodeVersionRaw.replace(/^v/, '');
+    if (!satisfiesMinVersion(nodeVersion, MIN_NODE_VERSION)) {
+        return { ok: false, error: nodeVersionTooOldError(nodeVersion) };
+    }
+    let npmVersion;
+    try {
+        npmVersion = runner('npm', ['--version']).trim();
+    }
+    catch (err) {
+        return { ok: false, error: npmNotInstalledError() };
+    }
+    return { ok: true, nodeVersion, npmVersion };
+}
+/** Minimal semver major.minor.patch comparison - sufficient for a floor check. */
+export function satisfiesMinVersion(version, minVersion) {
+    const v = parseSemver(version);
+    const min = parseSemver(minVersion);
+    if (!v || !min)
+        return false;
+    if (v.major !== min.major)
+        return v.major > min.major;
+    if (v.minor !== min.minor)
+        return v.minor > min.minor;
+    return v.patch >= min.patch;
+}
+function parseSemver(version) {
+    const match = version.match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match)
+        return null;
+    return { major: Number(match[1]), minor: Number(match[2]), patch: Number(match[3]) };
+}
+//# sourceMappingURL=prerequisites.js.map

package/dist/prerequisites.js.map

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

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@scopewatch/install-adapters",
+  "version": "0.0.1",
+  "description": "npm/npx install adapter: prerequisite detection and categorized install diagnostics",
+  "license": "MIT",
+  "author": "Sathvik Putta <puttasathvik16@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PuttaSathvik16/scopewatch.git",
+    "directory": "packages/install-adapters"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "node --import tsx --test 'test/**/*.test.ts'",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "tsx": "^4.19.0"
+  }
+}