mn-ws 0.1.0 → 0.2.1

package/dist/core/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/errors/index.ts"],"names":[],"mappings":"AAoBA,eAAO,MAAM,KAAK;;;;;;;;CAQR,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,OAAO,KAAK,CAAC,CAAC;AAyB3D,qBAAa,OAAQ,SAAQ,KAAK;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEN,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAMhE;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAElD;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,YAAY,CAOzD;AAID,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACP,CAAC;AACrD,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACX,CAAC;AACjD,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACZ,CAAC;AAChD,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACZ,CAAC;AAC/C,eAAO,MAAM,QAAQ,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACZ,CAAC;AAKhD,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,EAAE,UAAU,OAAO,YACX,CAAC"}

package/dist/core/errors/index.js

@@ -0,0 +1,88 @@
+// 错误契约：**失败抛 NxError，业务结果返回 {status}**。
+//
+// 这条边界是整个项目最重要的一条约定，判定标准是「调用方要不要处理它」：
+//
+// - 失败（参数非法、目标不存在、外部命令挂掉、数据损坏）
+//   → throw。调用方无从处理，只能中断当前操作并上报。API 映射成 4xx/5xx，
+//     CLI 映射成 exit 1 + 可解析文本。
+// - 业务结果（同步遇到冲突等待选侧、幂等跳过、规则阻止删除）
+//   → return { status: 'ok' | 'skipped' | 'conflict' | 'blocked', ... }。
+//     这不是错误——UI 要拿它弹窗让用户决策，所以绝不能抛。
+//
+// 历史教训：改造前同一层里并存 throw / {ok:false} / {status} / {available} 四种
+// 表达，上层只能靠字符串猜，无法程序化分支。
+//
+// 命名说明：类名是 NxError 而非 AppError——「App」在这个家族里指代不明
+// （哪个 app？），而这类项目通名是 nx-xx，NxError 表意更准。
+//
+// 兼容约束：assets 里的 agent 文档教 agent 用错误文本中的「用法:」「未设置」
+// 「不存在」三个子串分类失败。message 可以追加内容，但不得删除它们。
+export const CODES = {
+    INVALID_INPUT: 'INVALID_INPUT', // 参数缺失/非法/越界
+    NOT_FOUND: 'NOT_FOUND', // 目标不存在
+    CONFLICT: 'CONFLICT', // 状态冲突，需调用方决策
+    BLOCKED: 'BLOCKED', // 业务规则主动阻止
+    EXTERNAL: 'EXTERNAL', // 外部命令（git / gh）失败
+    SPEC_ERROR: 'SPEC_ERROR', // action 声明本身有误（写错了，不是用户输入错）
+    INTERNAL: 'INTERNAL', // 兜底
+};
+// code -> HTTP 状态。只在这里映射一次，api.js 不再自行判断。
+// Record 穷尽性：新增错误码漏映射，编译期立即报错。
+const HTTP_STATUS = {
+    [CODES.INVALID_INPUT]: 400,
+    [CODES.NOT_FOUND]: 404,
+    [CODES.CONFLICT]: 409,
+    [CODES.BLOCKED]: 409,
+    [CODES.EXTERNAL]: 502,
+    [CODES.SPEC_ERROR]: 500, // 声明写错是开发者的错，不是调用方的错
+    [CODES.INTERNAL]: 500,
+};
+// code -> 进程退出码。CLI 只区分「成功 / 失败」，保持 agent-workflow.md 声明的契约。
+const EXIT_CODE = {
+    [CODES.INVALID_INPUT]: 1,
+    [CODES.NOT_FOUND]: 1,
+    [CODES.CONFLICT]: 1,
+    [CODES.BLOCKED]: 1,
+    [CODES.EXTERNAL]: 1,
+    [CODES.SPEC_ERROR]: 1,
+    [CODES.INTERNAL]: 1,
+};
+export class NxError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'NxError';
+        this.code = code;
+        if (details !== undefined)
+            this.details = details;
+    }
+}
+export function httpStatusOf(code) {
+    return HTTP_STATUS[code] ?? 500;
+}
+export function exitCodeOf(code) {
+    return EXIT_CODE[code] ?? 1;
+}
+// 把任意抛出物归一成 ErrorPayload，供 API / CLI 统一序列化。
+// 非 NxError 一律归为 INTERNAL——不把内部堆栈细节泄漏给 agent。
+export function toErrorPayload(err) {
+    if (err instanceof NxError) {
+        const out = { code: err.code, message: err.message };
+        if (err.details !== undefined)
+            out.details = err.details;
+        return out;
+    }
+    return { code: CODES.INTERNAL, message: String(err?.message || err) };
+}
+// ---- 构造快捷方式：让 service 层读起来是「为什么失败」而不是「怎么构造」 ----
+export const badInput = (message, details) => new NxError(CODES.INVALID_INPUT, message, details);
+export const notFound = (message, details) => new NxError(CODES.NOT_FOUND, message, details);
+export const conflict = (message, details) => new NxError(CODES.CONFLICT, message, details);
+export const blocked = (message, details) => new NxError(CODES.BLOCKED, message, details);
+export const external = (message, details) => new NxError(CODES.EXTERNAL, message, details);
+// action 声明写错了（不是用户输入错）。
+// 由 core 抛出、spec.js 调用——这正是把它放在 core 的原因：spec 是 runtime 层，
+// core 不能依赖它，而「声明有误」这个错误码是两层共用的名词。
+export const specError = (message, details) => new NxError(CODES.SPEC_ERROR, message, details);
+//# sourceMappingURL=index.js.map

package/dist/core/errors/index.js.map

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

package/dist/core/open.d.ts

@@ -0,0 +1,3 @@
+export declare function openBrowser(url: string): void;
+export declare function openPath(dir: string): void;
+//# sourceMappingURL=open.d.ts.map

package/dist/core/open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.d.ts","sourceRoot":"","sources":["../../src/core/open.ts"],"names":[],"mappings":"AAmBA,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE1C"}

package/dist/core/open.js

@@ -0,0 +1,27 @@
+// 交给操作系统的两个动作：打开浏览器、在文件管理器里打开目录。
+// 零业务语义，且刻意不抛错——打不开就算了，调用方已经打印了地址。
+import { spawn } from 'node:child_process';
+function open(target) {
+    try {
+        const plat = process.platform;
+        if (plat === 'win32') {
+            spawn('cmd', ['/c', 'start', '', target], { detached: true, stdio: 'ignore' }).unref();
+        }
+        else if (plat === 'darwin') {
+            spawn('open', [target], { detached: true, stdio: 'ignore' }).unref();
+        }
+        else {
+            spawn('xdg-open', [target], { detached: true, stdio: 'ignore' }).unref();
+        }
+    }
+    catch {
+        // 静默降级：调用方已经把 URL / 路径打印到终端
+    }
+}
+export function openBrowser(url) {
+    open(url);
+}
+export function openPath(dir) {
+    open(dir);
+}
+//# sourceMappingURL=open.js.map

package/dist/core/open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open.js","sourceRoot":"","sources":["../../src/core/open.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,mCAAmC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,SAAS,IAAI,CAAC,MAAc;IAC1B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;QAC9B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACzF,CAAC;aAAM,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,CAAC,CAAC;AACZ,CAAC"}

package/dist/core/paths.d.ts

@@ -0,0 +1,15 @@
+import type { SafeRelPath } from './brand.js';
+export declare const APP_NAME = "mn-ws";
+export declare const APP_TITLE = "mn-ws";
+export declare const APP_DESC = "HTTP \u4E0E WebSocket \u53CC\u5411\u6865\u7684\u5BA2\u6237\u7AEF\u534A\uFF1A\u628A\u672C\u673A nx \u670D\u52A1\u6865\u7ED9\u8FDC\u7AEF HTTP \u5BA2\u6237\u7AEF";
+export declare const APP_DIR: string;
+export declare const STORE_PATH: string;
+export declare const DEFAULT_PORT = 7777;
+export declare const STORE_ENV = "MN_WS_STORE";
+export declare function storePathFromEnv(): string;
+export declare function assertSafeName(name: unknown, label?: string): string;
+export declare function assertSafeRelPath(input: unknown, { label, allowSubdir }?: {
+    label?: string;
+    allowSubdir?: boolean;
+}): SafeRelPath;
+//# sourceMappingURL=paths.d.ts.map

package/dist/core/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,QAAQ,UAAU,CAAC;AAChC,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,QAAQ,mKAAqD,CAAC;AAG3E,eAAO,MAAM,OAAO,QAA4B,CAAC;AACjD,eAAO,MAAM,UAAU,QAA8B,CAAC;AAKtD,eAAO,MAAM,YAAY,OAAO,CAAC;AAGjC,eAAO,MAAM,SAAS,gBAAgB,CAAC;AAEvC,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAQD,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,SAAO,GAAG,MAAM,CAMlE;AAGD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,EAAE,KAAc,EAAE,WAAkB,EAAE,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACrF,WAAW,CAUb"}

package/dist/core/paths.js

@@ -0,0 +1,50 @@
+// 路径与安全校验：项目里所有「东西放哪」都从这里取，不在别处拼字符串。
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { badInput } from './errors/index.js';
+// ---- 项目标识（生成时由模板变量替换）----
+export const APP_NAME = 'mn-ws';
+export const APP_TITLE = 'mn-ws';
+export const APP_DESC = 'HTTP 与 WebSocket 双向桥的客户端半：把本机 nx 服务桥给远端 HTTP 客户端';
+// ---- 数据目录（用户主目录下，可用环境变量覆盖）----
+export const APP_DIR = join(homedir(), '.mn-ws');
+export const STORE_PATH = join(APP_DIR, 'store.json');
+// ---- 端口 ----
+// serve 的 HTTP 端口（生成时写入探测到的空闲端口）。
+// vite dev server 的端口在 vite.config.ts 里单独配。
+export const DEFAULT_PORT = 7777;
+// 测试必须能指向临时目录，否则会写脏用户的真实数据。
+export const STORE_ENV = 'MN_WS_STORE';
+export function storePathFromEnv() {
+    return process.env[STORE_ENV] || STORE_PATH;
+}
+// ---- 输入校验 ----
+//
+// 名称与路径分开校验：名称禁前导点（`.foo` 不像个名字），
+// 路径允许（`.gitignore` 是完全正常的文件）。
+// 早期把两者混用一套规则，结果拒绝了 `.gitignore`。
+export function assertSafeName(name, label = '名称') {
+    if (!name || typeof name !== 'string')
+        throw badInput(`${label}不能为空`);
+    if (/[\\/]/.test(name) || name.includes('..') || name.startsWith('.')) {
+        throw badInput(`非法 ${label}: ${name}`);
+    }
+    return name;
+}
+// 校验通过即品牌类型 SafeRelPath：下游拿到它就知道路径已经过安全检查。
+export function assertSafeRelPath(input, { label = '文件路径', allowSubdir = true } = {}) {
+    if (!input || typeof input !== 'string')
+        throw badInput(label + '不能为空');
+    if (/^([a-zA-Z]:|[\\/])/.test(input))
+        throw badInput(label + '必须是相对路径: ' + input);
+    const segments = input.split(/[\\/]+/).filter((x) => x !== '' && x !== '.');
+    if (!segments.length)
+        throw badInput('非法 ' + label + ': ' + input);
+    if (segments.includes('..'))
+        throw badInput(label + '不得包含 ..: ' + input);
+    if (!allowSubdir && segments.length > 1) {
+        throw badInput(label + '不能包含路径分隔符: ' + input);
+    }
+    return segments.join('/');
+}
+//# sourceMappingURL=paths.js.map

package/dist/core/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,4BAA4B;AAC5B,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAChC,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,kDAAkD,CAAC;AAE3E,iCAAiC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,CAAC;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAEtD,eAAe;AACf,kCAAkC;AAClC,4CAA4C;AAC5C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AAEjC,4BAA4B;AAC5B,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;AAEvC,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC;AAC9C,CAAC;AAED,iBAAiB;AACjB,EAAE;AACF,kCAAkC;AAClC,+BAA+B;AAC/B,kCAAkC;AAElC,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,KAAK,GAAG,IAAI;IACxD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,MAAM,QAAQ,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;IACtE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,QAAQ,CAAC,MAAM,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,iBAAiB,CAC/B,KAAc,EACd,EAAE,KAAK,GAAG,MAAM,EAAE,WAAW,GAAG,IAAI,KAAgD,EAAE;IAEtF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IACxE,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,MAAM,QAAQ,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAC5E,IAAI,CAAC,QAAQ,CAAC,MAAM;QAAE,MAAM,QAAQ,CAAC,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,QAAQ,CAAC,KAAK,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC;IACzE,IAAI,CAAC,WAAW,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,QAAQ,CAAC,KAAK,GAAG,aAAa,GAAG,KAAK,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAgB,CAAC;AAC3C,CAAC"}

package/dist/core/serve-port.d.ts

@@ -0,0 +1,73 @@
+/**
+ * 所有 nx-xx 项目共享的关闭开关。
+ * 设成 1 / true / yes / on 即禁止 `serve` 自动打开浏览器（正常启动与端口复用都算）。
+ * 命令行 `--no-open` 只影响这一次；这个环境变量对整个 shell 生效。
+ */
+export declare const NO_OPEN_ENV = "NX_SERVE_NO_OPEN";
+/**
+ * 探测面板时给的应答窗口。
+ *
+ * 1500ms 而不是更短：面板的 bootstrap 不一定是纯本机计算——nx-kv 登录后要去后端
+ * 拉分组，链路一慢就超过 800ms。窗口太窄的后果不是「探测失败」这么轻，
+ * 而是**把自己的面板误判成别人的服务**，于是白起一个实例、占掉第二个端口——
+ * 恰好是这套机制要消灭的那种体验。
+ */
+export declare const PROBE_TIMEOUT_MS = 1500;
+/** 真值判定：1 / true / yes / on（大小写不敏感）算开，其他一律算关。 */
+export declare function isEnvTruthy(value: string | undefined | null): boolean;
+/**
+ * 是否允许自动打开浏览器。
+ * 优先级：`--no-open` 命令行开关 > NX_SERVE_NO_OPEN 环境变量 > 默认允许。
+ */
+export declare function autoOpenEnabled(flagNoOpen?: boolean): boolean;
+/** 探测到的面板身份：bootstrap 响应里的 app 段。 */
+export interface PanelIdentity {
+    name?: string;
+    version?: string;
+    [key: string]: unknown;
+}
+/** 探测到的 bootstrap 负载（只用到 app 段，其余字段原样带回）。 */
+export interface PanelProbe {
+    app?: PanelIdentity;
+    [key: string]: unknown;
+}
+/**
+ * 探测端口上有没有面板在跑：GET /api/bootstrap，短超时。
+ *
+ * 所有 nx-xx 面板都暴露 /api/bootstrap，响应里带 app.name / app.version ——
+ * 这就是跨项目唯一的认领签名（别的服务不会恰好返回它）。
+ * 不是面板、无响应、超时一律返回 null。
+ *
+ * headers 形参给需要鉴权的项目用（nx-as 的管理面要 Bearer 密钥）；
+ * 默认不传，匿名探测。
+ */
+export declare function probePanel(port: number, host?: string, timeoutMs?: number, headers?: Record<string, string> | null): Promise<PanelProbe | null>;
+/**
+ * 从 start 起逐个试，返回第一个能监听的端口（最多试 50 个）。
+ * 用临时 net.Server 探测、立刻关闭；与 startServer 走同一套 EADDRINUSE 判定。
+ */
+export declare function findFreePort(start: number, host?: string): Promise<number>;
+/** 端口冲突的处置方式。 */
+export type PortConflictAction = 'reuse' | 'shift';
+/** 端口冲突的统一决策结果。 */
+export interface PortConflictDecision {
+    /** reuse —— 端口上跑的就是本项目的面板；shift —— 顺延到下一个空闲端口。 */
+    action: PortConflictAction;
+    /** reuse 时是原端口；shift 时是下一个空闲端口。 */
+    port: number;
+    /** 占用者的 app 名（探测不到就是 null）。 */
+    occupant: string | null;
+    /** 探测到的 bootstrap 负载（探测不到就是 null）。 */
+    existing: PanelProbe | null;
+}
+/**
+ * 端口冲突的统一决策。
+ *
+ * reuse —— 端口上跑的就是本项目的面板：复用它，不再起第二个进程。
+ *          起第二个会让「切项目」变成「切端口」，而用户想看的其实是已经开着的那一个。
+ * shift —— 端口被别的东西占着：顺延到下一个空闲端口，再起自己的面板。
+ */
+export declare function resolvePortConflict(port: number, appName: string, host?: string, headers?: Record<string, string> | null): Promise<PortConflictDecision>;
+/** 占用者的一句话描述，用于终端提示。探测不到就是「未知服务」。 */
+export declare function describeOccupant(occupant: string | null): string;
+//# sourceMappingURL=serve-port.d.ts.map

package/dist/core/serve-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-port.d.ts","sourceRoot":"","sources":["../../src/core/serve-port.ts"],"names":[],"mappings":"AASA;;;;GAIG;AACH,eAAO,MAAM,WAAW,qBAAqB,CAAC;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AAErC,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAIrE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AA0CD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,SAAc,EAClB,SAAS,SAAmB,EAC5B,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAW,GAC5C,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAG5B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB/E;AAED,iBAAiB;AACjB,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,mBAAmB;AACnB,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sCAAsC;IACtC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,IAAI,SAAc,EAClB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAW,GAC5C,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAEhE"}

package/dist/core/serve-port.js

@@ -0,0 +1,134 @@
+// serve 的端口协商 + 浏览器打开策略。
+//
+// 零业务语义：所有 nx-xx 面板共用这一份，靠环境变量 NX_SERVE_NO_OPEN 统一关闭自动开浏览器。
+// 放 core/ 是因为它只依赖 Node 内置模块与「本项目的 app 名」，不涉及任何功能域。
+//
+// 这份文件在所有 nx-xx 项目之间**逐字节相同**——改一处就要全量同步，
+// 否则「口径统一」这件事本身会悄悄分叉。
+import net from 'node:net';
+/**
+ * 所有 nx-xx 项目共享的关闭开关。
+ * 设成 1 / true / yes / on 即禁止 `serve` 自动打开浏览器（正常启动与端口复用都算）。
+ * 命令行 `--no-open` 只影响这一次；这个环境变量对整个 shell 生效。
+ */
+export const NO_OPEN_ENV = 'NX_SERVE_NO_OPEN';
+/**
+ * 探测面板时给的应答窗口。
+ *
+ * 1500ms 而不是更短：面板的 bootstrap 不一定是纯本机计算——nx-kv 登录后要去后端
+ * 拉分组，链路一慢就超过 800ms。窗口太窄的后果不是「探测失败」这么轻，
+ * 而是**把自己的面板误判成别人的服务**，于是白起一个实例、占掉第二个端口——
+ * 恰好是这套机制要消灭的那种体验。
+ */
+export const PROBE_TIMEOUT_MS = 1500;
+/** 真值判定：1 / true / yes / on（大小写不敏感）算开，其他一律算关。 */
+export function isEnvTruthy(value) {
+    if (value === undefined || value === null)
+        return false;
+    const s = String(value).trim().toLowerCase();
+    return s === '1' || s === 'true' || s === 'yes' || s === 'on';
+}
+/**
+ * 是否允许自动打开浏览器。
+ * 优先级：`--no-open` 命令行开关 > NX_SERVE_NO_OPEN 环境变量 > 默认允许。
+ */
+export function autoOpenEnabled(flagNoOpen) {
+    if (flagNoOpen)
+        return false;
+    return !isEnvTruthy(process.env[NO_OPEN_ENV]);
+}
+/**
+ * 探一次端口，返回 { data, timedOut }。
+ *
+ * 把「超时」和「不是面板」分开，是因为两者的后续动作不同：
+ * 超时说明端口上可能正是一个应答慢的面板，值得再等一次；
+ * 明确不是面板就没有再等的必要。
+ */
+async function probePanelOnce(port, host, timeoutMs, headers) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let res;
+        try {
+            res = await fetch(`http://${host}:${port}/api/bootstrap`, {
+                signal: controller.signal,
+                headers: headers || undefined,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (!res.ok)
+            return { data: null, timedOut: false };
+        const body = (await res.json());
+        return { data: (body && body.data) || null, timedOut: false };
+    }
+    catch (err) {
+        const e = err;
+        return { data: null, timedOut: !!(e && e.name === 'AbortError') };
+    }
+}
+/**
+ * 探测端口上有没有面板在跑：GET /api/bootstrap，短超时。
+ *
+ * 所有 nx-xx 面板都暴露 /api/bootstrap，响应里带 app.name / app.version ——
+ * 这就是跨项目唯一的认领签名（别的服务不会恰好返回它）。
+ * 不是面板、无响应、超时一律返回 null。
+ *
+ * headers 形参给需要鉴权的项目用（nx-as 的管理面要 Bearer 密钥）；
+ * 默认不传，匿名探测。
+ */
+export async function probePanel(port, host = '127.0.0.1', timeoutMs = PROBE_TIMEOUT_MS, headers = null) {
+    const { data } = await probePanelOnce(port, host, timeoutMs, headers);
+    return data;
+}
+/**
+ * 从 start 起逐个试，返回第一个能监听的端口（最多试 50 个）。
+ * 用临时 net.Server 探测、立刻关闭；与 startServer 走同一套 EADDRINUSE 判定。
+ */
+export function findFreePort(start, host = '127.0.0.1') {
+    return new Promise((resolve_, reject) => {
+        const tryPort = (p) => {
+            if (p > start + 50) {
+                reject(new Error(`找不到空闲端口（从 ${start} 起连续 50 个被占）`));
+                return;
+            }
+            const probe = net.createServer();
+            probe.once('error', (err) => {
+                if (err && err.code === 'EADDRINUSE')
+                    tryPort(p + 1);
+                else
+                    reject(err);
+            });
+            probe.listen(p, host, () => probe.close(() => resolve_(p)));
+        };
+        tryPort(start);
+    });
+}
+/**
+ * 端口冲突的统一决策。
+ *
+ * reuse —— 端口上跑的就是本项目的面板：复用它，不再起第二个进程。
+ *          起第二个会让「切项目」变成「切端口」，而用户想看的其实是已经开着的那一个。
+ * shift —— 端口被别的东西占着：顺延到下一个空闲端口，再起自己的面板。
+ */
+export async function resolvePortConflict(port, appName, host = '127.0.0.1', headers = null) {
+    let probe = await probePanelOnce(port, host, PROBE_TIMEOUT_MS, headers);
+    if (probe.timedOut) {
+        // 慢应答的面板也认：再等一次。别把「自己的面板」误判成「别人的服务」，
+        // 白白再起一个实例——那正是这套机制要消灭的行为。
+        probe = await probePanelOnce(port, host, PROBE_TIMEOUT_MS, headers);
+    }
+    const existing = probe.data;
+    const occupant = existing && existing.app ? existing.app.name || null : null;
+    if (existing && occupant === appName) {
+        return { action: 'reuse', port, occupant, existing };
+    }
+    const next = await findFreePort(port + 1, host);
+    return { action: 'shift', port: next, occupant, existing };
+}
+/** 占用者的一句话描述，用于终端提示。探测不到就是「未知服务」。 */
+export function describeOccupant(occupant) {
+    return occupant || '未知服务';
+}
+//# sourceMappingURL=serve-port.js.map

package/dist/core/serve-port.js.map

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

package/dist/core/session.d.ts

@@ -0,0 +1,78 @@
+import { isExpired, type ClientConfig } from './config.js';
+/**
+ * 面板的登录态。
+ *
+ * ## 「必须登录才能用」到底指什么
+ *
+ * 面板跑在 127.0.0.1 上，但它**握着桥的凭据** —— 能连 server、能改白名单。
+ * 所以「打开就能用」等于「任何能访问这个端口的东西都能用」。
+ *
+ * 门禁因此落在**服务端的登录态**上：
+ *   · 没有有效登录态 → 所有业务 API 回 401，前端渲染登录页
+ *   · 有有效登录态 → 放行
+ *
+ * 两种拿登录态的方式（按优先级）：
+ *   1. **复用 CLI 的设备令牌** —— 本机 `mn-ws auth login` 存下来的那一份。
+ *      面板启动时读账号簿，有未过期的设备令牌就直接进入登录态（via=cli）。
+ *      这样「命令行登一次，面板直接能用」，不必登两遍。
+ *   2. **面板里现登** —— 前端点「登录」→ 弹浏览器 → PKCE 回环回调到
+ *      面板自己的 `/callback` → 换到设备令牌 → 存进账号簿（via=panel）。
+ *
+ * 凭据一律存在**服务端**，浏览器页面自己不发凭据 ——
+ * 页面里没有任何可以泄漏的令牌。
+ */
+/** 面板当前的登录态。 */
+export interface PanelSession {
+    loggedIn: boolean;
+    userId?: string;
+    email?: string;
+    nickname?: string;
+    deviceToken?: string;
+    expiresAt?: number;
+    /** 登录态的来源：复用 CLI / 面板里现登 / 没有 */
+    via: 'cli' | 'panel' | 'none';
+}
+/** 设备令牌是否已过期（实现在 core/config.ts，与账号簿同源）。 */
+export { isExpired };
+export declare class SessionManager {
+    private cfg;
+    session: PanelSession;
+    private pending;
+    constructor(cfg: ClientConfig);
+    /**
+     * 复用 CLI 已存的设备令牌。
+     *
+     * 读的是**激活账号**那一条：CLI 切了账号（auth switch），面板跟着切，
+     * 不然会出现「命令行是 A、面板是 B」的分裂状态。
+     */
+    adoptFromAccountStore(): boolean;
+    /** 当前登录态（对外只给必要字段）。 */
+    snapshot(): {
+        loggedIn: boolean;
+        userId?: string;
+        email?: string;
+        nickname?: string;
+        via: string;
+    };
+    /** 当前用的凭据（注册到 server 半时用）。 */
+    credential(): string;
+    /**
+     * 面板里点「登录」：起一次授权码流程并弹浏览器。
+     *
+     * 回调地址是**面板自己的** `http://127.0.0.1:<port>/callback` ——
+     * go-ah 里 mn-ws-client 的回调白名单是「127.0.0.1 + 任意端口 + /callback」，
+     * 端口通配、路径固定，所以面板端口运行时怎么选都能回调。
+     */
+    startLogin(panelPort: number): Promise<{
+        authorizeUrl: string;
+    }>;
+    /**
+     * 面板的 `/callback` 路由调用它：收回调 → 换 access_token → 换设备令牌。
+     */
+    completeLogin(code: string, state: string): Promise<PanelSession>;
+    /** 登录失败/超时后清掉进行中的流程。 */
+    cancelLogin(): void;
+    /** 清除登录态（logout 用）。 */
+    reset(): void;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/core/session.ts"],"names":[],"mappings":"AAIA,OAAO,EACwD,SAAS,EACtE,KAAK,YAAY,EAClB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,gBAAgB;AAChB,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,GAAG,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,CAAC;CAC/B;AAWD,4CAA4C;AAC5C,OAAO,EAAE,SAAS,EAAE,CAAC;AAErB,qBAAa,cAAc;IAIb,OAAO,CAAC,GAAG;IAHvB,OAAO,EAAE,YAAY,CAAoC;IACzD,OAAO,CAAC,OAAO,CAA6B;gBAExB,GAAG,EAAE,YAAY;IAErC;;;;;OAKG;IACH,qBAAqB,IAAI,OAAO;IAkBhC,uBAAuB;IACvB,QAAQ,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAUlG,8BAA8B;IAC9B,UAAU,IAAI,MAAM;IAIpB;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBtE;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAwCvE,wBAAwB;IACxB,WAAW,IAAI,IAAI;IAInB,uBAAuB;IACvB,KAAK,IAAI,IAAI;CAId"}

package/dist/core/session.js

@@ -0,0 +1,124 @@
+import { beginOauth, finishOauth, fetchIdpConfig, openBrowser, verifyExchange, } from './auth.js';
+import { listAccounts, saveAuthAccount, withAccounts, readConfigFile, isExpired, } from './config.js';
+/** 设备令牌是否已过期（实现在 core/config.ts，与账号簿同源）。 */
+export { isExpired };
+export class SessionManager {
+    cfg;
+    session = { loggedIn: false, via: 'none' };
+    pending = null;
+    constructor(cfg) {
+        this.cfg = cfg;
+    }
+    /**
+     * 复用 CLI 已存的设备令牌。
+     *
+     * 读的是**激活账号**那一条：CLI 切了账号（auth switch），面板跟着切，
+     * 不然会出现「命令行是 A、面板是 B」的分裂状态。
+     */
+    adoptFromAccountStore() {
+        const raw = readConfigFile();
+        const view = withAccounts(raw);
+        const active = view.activeAccountKey ? view.accounts[view.activeAccountKey] : undefined;
+        const entry = active || listAccounts(view)[0]?.entry;
+        if (!entry || !entry.deviceToken || isExpired(entry))
+            return false;
+        this.session = {
+            loggedIn: true,
+            userId: entry.userId,
+            email: entry.email,
+            nickname: entry.nickname,
+            deviceToken: entry.deviceToken,
+            expiresAt: entry.expiresAt,
+            via: 'cli',
+        };
+        return true;
+    }
+    /** 当前登录态（对外只给必要字段）。 */
+    snapshot() {
+        return {
+            loggedIn: this.session.loggedIn,
+            userId: this.session.userId,
+            email: this.session.email,
+            nickname: this.session.nickname,
+            via: this.session.via,
+        };
+    }
+    /** 当前用的凭据（注册到 server 半时用）。 */
+    credential() {
+        return this.session.deviceToken || this.cfg.token;
+    }
+    /**
+     * 面板里点「登录」：起一次授权码流程并弹浏览器。
+     *
+     * 回调地址是**面板自己的** `http://127.0.0.1:<port>/callback` ——
+     * go-ah 里 mn-ws-client 的回调白名单是「127.0.0.1 + 任意端口 + /callback」，
+     * 端口通配、路径固定，所以面板端口运行时怎么选都能回调。
+     */
+    async startLogin(panelPort) {
+        if (this.pending)
+            throw new Error('已有一个登录在进行中');
+        const serverHttp = this.cfg.serverHttp;
+        const cfg = await fetchIdpConfig(serverHttp);
+        const redirectUri = `http://127.0.0.1:${panelPort}/callback`;
+        const { authorizeUrl, req } = beginOauth(cfg, redirectUri);
+        this.pending = {
+            cfg,
+            req,
+            serverHttp,
+            clientId: this.cfg.clientId,
+            deviceName: this.cfg.deviceName,
+        };
+        openBrowser(authorizeUrl);
+        return { authorizeUrl };
+    }
+    /**
+     * 面板的 `/callback` 路由调用它：收回调 → 换 access_token → 换设备令牌。
+     */
+    async completeLogin(code, state) {
+        const pending = this.pending;
+        if (!pending)
+            throw new Error('没有进行中的登录（可能已超时或重复回调）');
+        this.pending = null;
+        const tok = await finishOauth(pending.cfg, pending.req, { code, state });
+        const res = await verifyExchange({
+            serverHttp: pending.serverHttp,
+            accessToken: tok.accessToken,
+            clientId: pending.clientId,
+            deviceName: pending.deviceName,
+        });
+        const entry = {
+            userId: res.userId,
+            email: res.email,
+            username: res.username,
+            nickname: res.nickname,
+            deviceToken: res.token,
+            expiresAt: res.tokenExpiresAt,
+            deviceName: res.deviceName || pending.deviceName,
+            clientId: res.clientId || pending.clientId,
+            url: this.cfg.url,
+            serverHttp: this.cfg.serverHttp,
+            loginAt: Date.now(),
+        };
+        saveAuthAccount({ entry, setActive: true });
+        this.session = {
+            loggedIn: true,
+            userId: res.userId,
+            email: res.email,
+            nickname: res.nickname,
+            deviceToken: res.token,
+            expiresAt: res.tokenExpiresAt,
+            via: 'panel',
+        };
+        return this.session;
+    }
+    /** 登录失败/超时后清掉进行中的流程。 */
+    cancelLogin() {
+        this.pending = null;
+    }
+    /** 清除登录态（logout 用）。 */
+    reset() {
+        this.session = { loggedIn: false, via: 'none' };
+        this.pending = null;
+    }
+}
+//# sourceMappingURL=session.js.map