hunter-mate 0.1.15 → 0.1.17

package/dist/utils/local-http.d.ts

@@ -1,7 +0,0 @@
-export declare function isLocalServerUrl(url: string | undefined): boolean;
-/**
- * 全局 axios 请求拦截器:调用方未显式指定 proxy 且目标是本地地址时强制 proxy:false。
- * 在 CLI 入口(index.ts)注册一次,覆盖 status/doctor/extension 等所有探测路径;
- * 显式传了 proxy(含已有的 proxy:false)的请求不覆盖,尊重调用方意图。
- */
-export declare function installLocalProxyBypass(): void;

package/dist/utils/local-http.js

@@ -1,30 +0,0 @@
-// utils/local-http.ts — 本地 server 探测的代理绕过(Issue #24 P1)
-//
-// 事故:用户 shell 带 http_proxy=http://127.0.0.1:1087 时,CLI 探测
-// localhost:34570 被代理拦截(500)→ 误判 "server not running" → 自动启动
-// 与 start 的 "already running" 形成死循环。Node/axios 默认读 http_proxy 环境变量,
-// 只对 localhost/127.0.0.1/[::1] 禁用代理;远程 serverUrl(如 SaaS)保留代理行为。
-import axios from 'axios';
-const LOCAL_HOST_RE = /^(?:https?:)?\/\/(?:localhost|127\.0\.0\.1|\[::1\]|0\.0\.0\.0)(?::|\/|$)/i;
-export function isLocalServerUrl(url) {
-    if (!url)
-        return false;
-    return LOCAL_HOST_RE.test(url);
-}
-/**
- * 全局 axios 请求拦截器:调用方未显式指定 proxy 且目标是本地地址时强制 proxy:false。
- * 在 CLI 入口(index.ts)注册一次,覆盖 status/doctor/extension 等所有探测路径;
- * 显式传了 proxy(含已有的 proxy:false)的请求不覆盖,尊重调用方意图。
- */
-export function installLocalProxyBypass() {
-    axios.interceptors.request.use((config) => {
-        if (config.proxy === undefined) {
-            const url = config.baseURL
-                ? new URL(config.url ?? '', config.baseURL).toString()
-                : (config.url ?? '');
-            if (isLocalServerUrl(url))
-                config.proxy = false;
-        }
-        return config;
-    });
-}

package/dist/utils/proc.d.ts

@@ -1,35 +0,0 @@
-/**
- * Result of an attempted graceful termination.
- *
- * - `graceful`: the target acknowledged the signal and exited on its own
- *   before the grace deadline.
- * - `forced`: we had to escalate to `SIGKILL` / `taskkill /F` after the
- *   deadline elapsed.
- * - `esrch`: no such PID; the process was already gone (success).
- * - `error`: an unexpected failure happened (e.g. permission denied on
- *   `taskkill`). Caller should inspect stderr.
- */
-export type KillOutcome = "graceful" | "forced" | "esrch" | "error";
-/**
- * Synchronous variant — useful for `stop` commands that cannot easily be
- * turned into async functions. Returns `true` iff the first signal
- * attempt appeared to succeed (status 0 from `taskkill`, or `SIGTERM`
- * delivered without throwing on POSIX).
- */
-export declare function killGracefullySync(pid: number): boolean;
-/**
- * Async graceful termination.
- *
- * On Windows, `process.kill(pid, 'SIGTERM')` is a no-op (Node only supports
- * `SIGKILL`/`SIGINT`/`SIGQUIT`/etc as process-group signals on POSIX).
- * `taskkill /pid <pid> /T` without `/F` sends WM_CLOSE to GUI children and
- * CTRL_BREAK to console children — which NestJS + Next.js turn into a
- * graceful shutdown through `enableShutdownHooks()`. If the process is
- * still alive after `graceMs`, we escalate to `/F` (force).
- *
- * On POSIX we send SIGTERM, wait `graceMs`, then SIGKILL as a last resort.
- *
- * The polling interval (200ms) is intentionally short so the function
- * returns promptly when the child exits but does not busy-spin.
- */
-export declare function killGracefully(pid: number, graceMs?: number): Promise<KillOutcome>;

package/dist/utils/proc.js

@@ -1,81 +0,0 @@
-import { spawnSync } from "node:child_process";
-/**
- * Synchronous variant — useful for `stop` commands that cannot easily be
- * turned into async functions. Returns `true` iff the first signal
- * attempt appeared to succeed (status 0 from `taskkill`, or `SIGTERM`
- * delivered without throwing on POSIX).
- */
-export function killGracefullySync(pid) {
-    if (process.platform === "win32") {
-        return (spawnSync("taskkill", ["/pid", String(pid), "/T"], { encoding: "utf-8" })
-            .status === 0);
-    }
-    try {
-        process.kill(pid, "SIGTERM");
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Async graceful termination.
- *
- * On Windows, `process.kill(pid, 'SIGTERM')` is a no-op (Node only supports
- * `SIGKILL`/`SIGINT`/`SIGQUIT`/etc as process-group signals on POSIX).
- * `taskkill /pid <pid> /T` without `/F` sends WM_CLOSE to GUI children and
- * CTRL_BREAK to console children — which NestJS + Next.js turn into a
- * graceful shutdown through `enableShutdownHooks()`. If the process is
- * still alive after `graceMs`, we escalate to `/F` (force).
- *
- * On POSIX we send SIGTERM, wait `graceMs`, then SIGKILL as a last resort.
- *
- * The polling interval (200ms) is intentionally short so the function
- * returns promptly when the child exits but does not busy-spin.
- */
-export async function killGracefully(pid, graceMs = 5000) {
-    const deadline = Date.now() + graceMs;
-    const pollGone = async () => {
-        while (Date.now() < deadline) {
-            await new Promise((r) => setTimeout(r, 200));
-            try {
-                process.kill(pid, 0);
-            }
-            catch {
-                return true;
-            }
-        }
-        return false;
-    };
-    if (process.platform === "win32") {
-        const r1 = spawnSync("taskkill", ["/pid", String(pid), "/T"], {
-            encoding: "utf-8",
-        });
-        if (r1.status === 0)
-            return "graceful";
-        const out = `${r1.stdout ?? ""}${r1.stderr ?? ""}`;
-        if (/not found|找不到|0x.*找不到/i.test(out))
-            return "esrch";
-        if (await pollGone())
-            return "graceful";
-        const r2 = spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { encoding: "utf-8" });
-        return r2.status === 0 ? "forced" : "error";
-    }
-    // POSIX path
-    try {
-        process.kill(pid, "SIGTERM");
-    }
-    catch (err) {
-        const e = err;
-        return e.code === "ESRCH" ? "esrch" : "error";
-    }
-    if (await pollGone())
-        return "graceful";
-    try {
-        process.kill(pid, "SIGKILL");
-        return "forced";
-    }
-    catch {
-        return "error";
-    }
-}

package/dist/utils/proxy-detect.d.ts

@@ -1,20 +0,0 @@
-export interface ProxyEnvEntry {
-    varName: string;
-    value: string;
-}
-export interface DeadProxyFinding {
-    varName: string;
-    value: string;
-    host: string;
-    port: number;
-    reason: 'refused' | 'timeout' | 'unreachable';
-}
-/** 收集四个代理环境变量中已设置的项 */
-export declare function collectProxyEnv(): ProxyEnvEntry[];
-/**
- * 找出指向 loopback 但端口不通的死代理。
- * 远程代理(非 loopback)不探测,直接视为有效(由网络栈自己处理)。
- */
-export declare function findDeadProxies(timeoutMs?: number): Promise<DeadProxyFinding[]>;
-/** 生成各 shell 的清除指令提示(用户直接复制执行) */
-export declare function buildUnsetHint(findings: DeadProxyFinding[]): string;

package/dist/utils/proxy-detect.js

@@ -1,96 +0,0 @@
-/**
- * 死代理检测 — Windows/终端现场高频坑。
- *
- * 背景:用户的 shell 环境变量里可能残留指向已关闭本地代理的
- * HTTP_PROXY / HTTPS_PROXY / http_proxy / https_proxy(如 http://127.0.0.1:1962)。
- * 后果链(2026-09-02 现场):
- *   npm registry 查询失败 → CLI 自更新误判"已是最新"或报错;
- *   better-sqlite3 prebuild 下载失败 → 回退 node-gyp 源码编译 7 分钟+。
- * 本模块只检测 loopback 代理(远程代理探测需要出网,不属于"死代理"语义),
- * 且永不 throw —— 检测结果用于告警,不影响主流程。
- */
-import net from 'node:net';
-const PROXY_VARS = ['HTTP_PROXY', 'HTTPS_PROXY', 'http_proxy', 'https_proxy'];
-/** 收集四个代理环境变量中已设置的项 */
-export function collectProxyEnv() {
-    const out = [];
-    for (const varName of PROXY_VARS) {
-        const value = process.env[varName];
-        if (value)
-            out.push({ varName, value });
-    }
-    return out;
-}
-/** 解析代理值为 {host, port}(仅处理显式端口的 http(s) 代理) */
-function parseProxyUrl(value) {
-    try {
-        const u = new URL(value);
-        if ((u.protocol !== 'http:' && u.protocol !== 'https:') || !u.port)
-            return null;
-        return { host: u.hostname, port: Number(u.port) };
-    }
-    catch {
-        return null;
-    }
-}
-function isLoopback(host) {
-    return host === '127.0.0.1' || host === 'localhost' || host === '::1' || host === '[::1]';
-}
-function probePort(host, port, timeoutMs) {
-    return new Promise((resolve) => {
-        const socket = new net.Socket();
-        let settled = false;
-        const done = (r) => {
-            if (settled)
-                return;
-            settled = true;
-            socket.destroy();
-            resolve(r);
-        };
-        socket.setTimeout(timeoutMs);
-        socket.once('connect', () => done('open'));
-        socket.once('timeout', () => done('timeout'));
-        socket.once('error', (err) => done(err.code === 'ECONNREFUSED' ? 'refused' : 'unreachable'));
-        try {
-            socket.connect(port, host);
-        }
-        catch {
-            done('unreachable');
-        }
-    });
-}
-/**
- * 找出指向 loopback 但端口不通的死代理。
- * 远程代理(非 loopback)不探测,直接视为有效(由网络栈自己处理)。
- */
-export async function findDeadProxies(timeoutMs = 800) {
-    const findings = [];
-    for (const { varName, value } of collectProxyEnv()) {
-        const parsed = parseProxyUrl(value);
-        if (!parsed || !isLoopback(parsed.host))
-            continue;
-        const result = await probePort(parsed.host, parsed.port, timeoutMs);
-        if (result !== 'open') {
-            findings.push({
-                varName,
-                value,
-                host: parsed.host,
-                port: parsed.port,
-                reason: result === 'refused' ? 'refused' : result === 'timeout' ? 'timeout' : 'unreachable',
-            });
-        }
-    }
-    return findings;
-}
-/** 生成各 shell 的清除指令提示(用户直接复制执行) */
-export function buildUnsetHint(findings) {
-    const vars = [...new Set(findings.map((f) => f.varName))].join(', ');
-    return [
-        `死代理告警: ${findings.map((f) => `${f.varName}=${f.value} (${f.reason === 'refused' ? '连接被拒绝' : f.reason === 'timeout' ? '连接超时' : '不可达'})`).join('; ')}`,
-        `该代理端口已不可用,会导致 npm registry 查询失败 / prebuild 下载失败回退源码编译。清除(当前会话):`,
-        `  PowerShell:  Remove-Item Env:${vars.replace(/, /g, ', Env:')}`,
-        `  CMD:         set ${findings.map((f) => f.varName).join('= && set ')}=`,
-        `  bash/zsh:    unset ${findings.map((f) => f.varName).join(' ')}`,
-        `  npm 专用:    npm config delete proxy && npm config delete https-proxy`,
-    ].join('\n');
-}

package/dist/utils/script-path.d.ts

@@ -1,5 +0,0 @@
-export declare function resolveScriptPath(p: string | undefined): string | undefined;
-/** 可测形式:传入 argv[1] 判定入口(单测用,业务代码请用 isMainModule) */
-export declare function isInvokedAsEntry(metaUrl: string, argv1: string | undefined): boolean;
-/** 当前模块是否作为 node 独立入口执行(import 时不触发);argv 读取只应发生在本模块 */
-export declare function isMainModule(metaUrl: string): boolean;

package/dist/utils/script-path.js

@@ -1,27 +0,0 @@
-// utils/script-path.ts — 跨平台入口脚本路径解析(Windows .cmd shim 兼容)
-// Windows 下 node 经 .cmd shim 调用时 process.argv[1] 可能是 shim 路径/8.3 短路径,
-// 必须 realpath 后再与 import.meta.url 比对(AGENTS.md 平台兼容红线)
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-export function resolveScriptPath(p) {
-    if (!p)
-        return undefined;
-    try {
-        return fs.realpathSync(p);
-    }
-    catch {
-        return path.resolve(p);
-    }
-}
-/** 可测形式:传入 argv[1] 判定入口(单测用,业务代码请用 isMainModule) */
-export function isInvokedAsEntry(metaUrl, argv1) {
-    const entryPath = resolveScriptPath(argv1);
-    if (!entryPath)
-        return false;
-    return entryPath === resolveScriptPath(fileURLToPath(metaUrl));
-}
-/** 当前模块是否作为 node 独立入口执行(import 时不触发);argv 读取只应发生在本模块 */
-export function isMainModule(metaUrl) {
-    return isInvokedAsEntry(metaUrl, process.argv[1]);
-}

package/dist/utils/spawn.d.ts

@@ -1,19 +0,0 @@
-import { spawn, spawnSync, type ChildProcess } from "node:child_process";
-type SpawnOptionsAny = Parameters<typeof spawn>[2] & Parameters<typeof spawnSync>[2];
-/**
- * Cross-platform child_process wrapper.
- *
- * On Windows we set `shell: true` so that PATHEXT resolution and `.cmd` /
- * `.bat` execution work without an explicit path. The `%%` escape keeps
- * cmd.exe from interpreting `%FOO%` style variable expansions inside the
- * arguments (Windows expands `%` even inside quoted strings).
- *
- * On POSIX we keep the original behavior: direct `execve`, no shell,
- * no argument transformation — identical to a plain `spawn` call.
- */
-export declare function spawnSafe(bin: string, args?: readonly string[], opts?: SpawnOptionsAny): ChildProcess;
-/**
- * Synchronous variant. Same semantics as {@link spawnSafe}.
- */
-export declare function spawnSyncSafe(bin: string, args?: readonly string[], opts?: SpawnOptionsAny): import("child_process").SpawnSyncReturns<string | NonSharedBuffer>;
-export {};

package/dist/utils/spawn.js

@@ -1,60 +0,0 @@
-import { spawn, spawnSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-/**
- * On Windows, PATHEXT is honored by `cmd.exe` but not by Node's `spawn`.
- * Without this resolver, `spawn("npm", ...)` returns ENOENT because the
- * real binary is `npm.cmd`. We walk PATH and pick the first extension that
- * matches an existing file. POSIX behavior is unchanged: return as-is.
- */
-function resolveBin(bin) {
-    if (process.platform !== "win32")
-        return bin;
-    if (/\.(cmd|bat|exe|com)$/i.test(bin))
-        return bin;
-    const pathEnv = process.env.PATH ?? "";
-    const exts = (process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";");
-    for (const dir of pathEnv.split(path.delimiter)) {
-        if (!dir)
-            continue;
-        for (const ext of exts) {
-            const candidate = path.join(dir, bin + ext);
-            try {
-                if (fs.existsSync(candidate))
-                    return candidate;
-            }
-            catch {
-                /* FS errors fall through to the next candidate */
-            }
-        }
-    }
-    return bin;
-}
-/**
- * Cross-platform child_process wrapper.
- *
- * On Windows we set `shell: true` so that PATHEXT resolution and `.cmd` /
- * `.bat` execution work without an explicit path. The `%%` escape keeps
- * cmd.exe from interpreting `%FOO%` style variable expansions inside the
- * arguments (Windows expands `%` even inside quoted strings).
- *
- * On POSIX we keep the original behavior: direct `execve`, no shell,
- * no argument transformation — identical to a plain `spawn` call.
- */
-export function spawnSafe(bin, args = [], opts = {}) {
-    if (process.platform === "win32") {
-        const escaped = args.map((a) => a.replace(/%/g, "%%"));
-        return spawn(bin, escaped, { ...opts, shell: true });
-    }
-    return spawn(resolveBin(bin), [...args], opts);
-}
-/**
- * Synchronous variant. Same semantics as {@link spawnSafe}.
- */
-export function spawnSyncSafe(bin, args = [], opts = {}) {
-    if (process.platform === "win32") {
-        const escaped = args.map((a) => a.replace(/%/g, "%%"));
-        return spawnSync(bin, escaped, { ...opts, shell: true });
-    }
-    return spawnSync(resolveBin(bin), [...args], opts);
-}

package/dist/version.d.ts

@@ -1,16 +0,0 @@
-import { ConsistencyActions, InstalledVersions, SystemVersions } from '@hunter-mate/shared';
-export declare function readInstalledVersions(): InstalledVersions;
-export declare function readRuntimeStateFile(): unknown;
-export declare function fetchLiveVersions(timeoutMs?: number): Promise<SystemVersions | null>;
-export declare function decideConsistencyActions(installed: InstalledVersions, live: SystemVersions | null): ConsistencyActions;
-export interface ConsistencyReport {
-    checked: boolean;
-    reason?: string;
-    actions: ConsistencyActions;
-    performed: string[];
-}
-export declare function ensureRuntimeConsistency(opts?: {
-    force?: boolean;
-    verbose?: boolean;
-}): Promise<ConsistencyReport>;
-export declare function shouldCheckNow(): boolean;