evolcore 0.0.1 → 0.0.3

package/dist/utils/instance-registry.js

@@ -0,0 +1,444 @@
+/**
+ * Instance registry — manages {HOME}/data/instance/ directory.
+ *
+ * 真相源：每个进程写一份带 PID 的 record 文件。判定"是否已有实例运行"时，
+ * 遍历所有 record，根据 (pid, startedAt) 对每个 record 做存活校验。
+ *
+ * 不使用 lock 文件——record 文件本身就是登记簿，"互斥"由 post-write 自检
+ * （写完 record 立刻扫一遍，比自己早的赢）保证。这样 6 个并发进程同时启动
+ * 也不会互相覆盖（PID 不同名字也不同），最终通过 startedAt 比较选出唯一赢家。
+ */
+import fs from 'fs';
+import path from 'path';
+import { spawnSync } from 'child_process';
+import { resolvePaths } from '../paths.js';
+import { isProcessRunning, killProcess, isWindows, findProcesses } from './cross-platform.js';
+import { getProcessStartTime, startTimeMatches } from './process-introspect.js';
+import { isConfirmedLeakedTestDaemon, runtimeHomeFromEnv } from './restart-safety.js';
+// ── Helpers ──
+function instanceDir() {
+    return resolvePaths().instanceDir;
+}
+function writeAtomic(filePath, data) {
+    const tmp = filePath + '.tmp';
+    fs.writeFileSync(tmp, data);
+    fs.renameSync(tmp, filePath);
+}
+function safeParseJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+function isAlive(pid, recordedStartedAt) {
+    if (!isProcessRunning(pid))
+        return false;
+    const actual = getProcessStartTime(pid);
+    // 拿不到启动时间时保守认为是我们的进程（宁可误判活着，不误杀）
+    if (actual === null)
+        return true;
+    return startTimeMatches(recordedStartedAt, actual);
+}
+// ── Main record ──
+function mainFileName(pid) {
+    return `main-${pid}.json`;
+}
+export function writeMain(launchedBy) {
+    const dir = instanceDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const startedAt = getProcessStartTime(process.pid) ?? Date.now();
+    const record = {
+        pid: process.pid,
+        startedAt,
+        startedAtIso: new Date(startedAt).toISOString(),
+        launchedBy,
+    };
+    const filePath = path.join(dir, mainFileName(process.pid));
+    writeAtomic(filePath, JSON.stringify(record, null, 2));
+    return filePath;
+}
+export function removeMain(pid) {
+    const target = pid ?? process.pid;
+    const filePath = path.join(instanceDir(), mainFileName(target));
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch { }
+}
+/**
+ * Post-write 自检：写完 main record 后立刻扫一次目录。
+ * 如果发现别的活 main，按 (startedAt, pid) 选最早的赢家。
+ *
+ * @returns 当前进程是否赢家。false 表示应该让出（删自己的 record + exit）。
+ */
+export function isMainWinner() {
+    const status = scanInstances();
+    const aliveMains = status.mains.filter(m => m.alive);
+    if (aliveMains.length <= 1)
+        return { winner: true };
+    const self = aliveMains.find(m => m.record.pid === process.pid);
+    if (!self)
+        return { winner: true }; // 自己的记录都没了，让别人去争吧
+    // (startedAt, pid) 字典序最小者赢
+    const winnerEntry = aliveMains.reduce((best, cur) => {
+        if (cur.record.startedAt < best.record.startedAt)
+            return cur;
+        if (cur.record.startedAt > best.record.startedAt)
+            return best;
+        return cur.record.pid < best.record.pid ? cur : best;
+    });
+    if (winnerEntry.record.pid === process.pid)
+        return { winner: true };
+    return { winner: false, conflictingPid: winnerEntry.record.pid };
+}
+// ── Restart monitor record ──
+function restartMonitorFileName(pid) {
+    return `restart-monitor-${pid}.json`;
+}
+export function writeRestartMonitor() {
+    const dir = instanceDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const startedAt = getProcessStartTime(process.pid) ?? Date.now();
+    const record = {
+        pid: process.pid,
+        startedAt,
+        startedAtIso: new Date(startedAt).toISOString(),
+        launchedBy: 'restart-monitor',
+    };
+    const filePath = path.join(dir, restartMonitorFileName(process.pid));
+    writeAtomic(filePath, JSON.stringify(record, null, 2));
+    return filePath;
+}
+export function removeRestartMonitor(pid) {
+    const target = pid ?? process.pid;
+    const filePath = path.join(instanceDir(), restartMonitorFileName(target));
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch { }
+}
+/**
+ * Post-write 自检：与 isMainWinner 同语义，用于 restart-monitor。
+ */
+export function isRestartMonitorWinner() {
+    const status = scanInstances();
+    const alive = status.restartMonitors.filter(m => m.alive);
+    if (alive.length <= 1)
+        return { winner: true };
+    const self = alive.find(m => m.record.pid === process.pid);
+    if (!self)
+        return { winner: true };
+    const winnerEntry = alive.reduce((best, cur) => {
+        if (cur.record.startedAt < best.record.startedAt)
+            return cur;
+        if (cur.record.startedAt > best.record.startedAt)
+            return best;
+        return cur.record.pid < best.record.pid ? cur : best;
+    });
+    if (winnerEntry.record.pid === process.pid)
+        return { winner: true };
+    return { winner: false, conflictingPid: winnerEntry.record.pid };
+}
+// ─ AID event log ──
+function aidFileName(pid) {
+    return `aid-${pid}.jsonl`;
+}
+export function appendAidEvent(event, pid) {
+    const target = pid ?? process.pid;
+    const dir = instanceDir();
+    fs.mkdirSync(dir, { recursive: true });
+    const filePath = path.join(dir, aidFileName(target));
+    const line = JSON.stringify(event) + '\n';
+    fs.appendFileSync(filePath, line);
+}
+export function removeAidLog(pid) {
+    const target = pid ?? process.pid;
+    const filePath = path.join(instanceDir(), aidFileName(target));
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch { }
+}
+/**
+ * 读取 aid jsonl 文件尾部，提取每个 AID 的最后活动时间和事件类型。
+ */
+export function readAidLastActivity(pid) {
+    const filePath = path.join(instanceDir(), aidFileName(pid));
+    const result = new Map();
+    if (!fs.existsSync(filePath))
+        return result;
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        const lines = content.trim().split('\n');
+        for (const line of lines) {
+            if (!line)
+                continue;
+            try {
+                const ev = JSON.parse(line);
+                if (ev.aid && ev.ts) {
+                    result.set(ev.aid, { ts: ev.ts, event: ev.event });
+                }
+            }
+            catch { }
+        }
+    }
+    catch { }
+    return result;
+}
+// ── Scan & cleanup ──
+/**
+ * 扫描 instance/ 目录，返回所有实例记录（含死活状态）。
+ *
+ * 损坏的 JSON 文件直接删除。aid-*.jsonl 在 scan 时不解析，由调用方按需读取。
+ */
+export function scanInstances() {
+    const status = {
+        mains: [],
+        restartMonitors: [],
+        aidLastActivity: new Map(),
+    };
+    const dir = instanceDir();
+    if (!fs.existsSync(dir))
+        return status;
+    let files;
+    try {
+        files = fs.readdirSync(dir);
+    }
+    catch {
+        return status;
+    }
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        if (file.startsWith('main-') && file.endsWith('.json')) {
+            const record = safeParseJson(filePath);
+            if (record && record.pid && record.startedAt) {
+                const alive = isAlive(record.pid, record.startedAt);
+                status.mains.push({ record, alive });
+                if (alive) {
+                    // 合并所有活 main 的 AID 活动记录（按 ts 取最新）
+                    for (const [aid, info] of readAidLastActivity(record.pid)) {
+                        const prev = status.aidLastActivity.get(aid);
+                        if (!prev || info.ts > prev.ts) {
+                            status.aidLastActivity.set(aid, info);
+                        }
+                    }
+                }
+            }
+            else {
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { }
+            }
+        }
+        else if (file.startsWith('restart-monitor-') && file.endsWith('.json')) {
+            const record = safeParseJson(filePath);
+            if (record && record.pid && record.startedAt) {
+                const alive = isAlive(record.pid, record.startedAt);
+                status.restartMonitors.push({ record, alive });
+            }
+            else {
+                try {
+                    fs.unlinkSync(filePath);
+                }
+                catch { }
+            }
+        }
+    }
+    return status;
+}
+/**
+ * 清理所有非自己 PID 的残留文件。仍活着的旧实例进程会被 SIGKILL。
+ * 返回被杀掉的 PID 列表。
+ */
+export function cleanupInstances() {
+    const dir = instanceDir();
+    if (!fs.existsSync(dir))
+        return [];
+    let files;
+    try {
+        files = fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+    const killed = [];
+    for (const file of files) {
+        const filePath = path.join(dir, file);
+        if (file.startsWith('main-') && file.endsWith('.json')) {
+            const record = safeParseJson(filePath);
+            if (record?.pid) {
+                if (record.pid === process.pid)
+                    continue;
+                if (isProcessRunning(record.pid)) {
+                    const actual = getProcessStartTime(record.pid);
+                    if (startTimeMatches(record.startedAt, actual)) {
+                        killPid(record.pid);
+                        killed.push(record.pid);
+                    }
+                }
+            }
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { }
+        }
+        else if (file.startsWith('restart-monitor-') && file.endsWith('.json')) {
+            const record = safeParseJson(filePath);
+            if (record?.pid) {
+                if (record.pid === process.pid)
+                    continue;
+                if (isProcessRunning(record.pid)) {
+                    const actual = getProcessStartTime(record.pid);
+                    if (startTimeMatches(record.startedAt, actual)) {
+                        killPid(record.pid);
+                        killed.push(record.pid);
+                    }
+                }
+            }
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { }
+        }
+        else if (file.startsWith('aid-') && file.endsWith('.jsonl')) {
+            // aid-<pid>.jsonl：自己的不动，其他的清掉
+            const m = file.match(/^aid-(\d+)\.jsonl$/);
+            if (m && parseInt(m[1], 10) === process.pid)
+                continue;
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { }
+        }
+        else if (file.endsWith('.tmp')) {
+            try {
+                fs.unlinkSync(filePath);
+            }
+            catch { }
+        }
+    }
+    return killed;
+}
+/**
+ * 删除当前进程拥有的所有 instance 文件（正常关闭时调用）。
+ */
+export function removeAll(pid) {
+    const target = pid ?? process.pid;
+    removeMain(target);
+    removeAidLog(target);
+}
+// ── Internal ──
+function killPid(pid) {
+    killProcess(pid, true);
+}
+/**
+ * 扫所有 node 进程中跑 dist/index.js 的 PID，减去当前 HOME 已登记的 main PID。
+ *
+ * 用途：检测跨 HOME 残留的 evolcore 主进程（例如测试套件 spawn 后未清理、
+ * 旧版本 pidfile 模式遗留等），由 cmdStart/cmdRestart 在启动前提示用户。
+ *
+ * Linux 下额外读取 /proc/<pid>/environ 提取 EVOLCORE_HOME，
+ * 并对 Vitest 泄漏的 restart-monitor daemon 做严格标记。
+ * Windows / macOS 取不到环境变量时 evolcoreHome 为 null。
+ *
+ * 不会主动 kill——清理由调用方决定。
+ */
+export function findOrphanProcesses() {
+    // 1. 已登记 PID（自己 HOME 下的 main + 自己进程）
+    const known = new Set([process.pid]);
+    const status = scanInstances();
+    for (const m of status.mains)
+        known.add(m.record.pid);
+    for (const m of status.restartMonitors)
+        known.add(m.record.pid);
+    // 2. 系统中所有跑 dist/index.js 的 node 进程
+    const candidates = findProcesses('node.*dist/index.js');
+    const orphans = [];
+    for (const pid of candidates) {
+        if (known.has(pid))
+            continue;
+        if (!isProcessRunning(pid))
+            continue;
+        const cmdline = readCmdline(pid);
+        // 二次验证：确实是 evolcore 的 dist/index.js
+        if (!/dist[\\/]index\.js/.test(cmdline))
+            continue;
+        // 三次验证：排除 ecweb（/ecweb/dist/index.js）
+        if (/[\\/]ecweb[\\/]dist[\\/]index\.js/.test(cmdline))
+            continue;
+        const processEnv = readProcessEnvironment(pid);
+        orphans.push({
+            pid,
+            evolcoreHome: processEnv ? runtimeHomeFromEnv(processEnv) : null,
+            cmdline,
+            confirmedTestDaemon: processEnv ? isConfirmedLeakedTestDaemon(processEnv) : false,
+        });
+    }
+    return orphans;
+}
+/**
+ * SIGKILL 所有传入的孤儿 PID。返回成功杀掉的 PID 列表（即调用后已停的）。
+ */
+export function killOrphans(orphans) {
+    const killed = [];
+    for (const o of orphans) {
+        try {
+            killProcess(o.pid, true);
+            killed.push(o.pid);
+        }
+        catch { }
+    }
+    return killed;
+}
+function readCmdline(pid) {
+    if (isWindows) {
+        try {
+            const result = spawnSync('wmic', ['process', 'where', `ProcessId=${pid}`, 'get', 'CommandLine', '/value'], { encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+            const out = result.stdout || '';
+            const m = out.match(/CommandLine=([^\r\n]+)/);
+            return m ? m[1].trim() : '';
+        }
+        catch {
+            return '';
+        }
+    }
+    try {
+        return fs.readFileSync(`/proc/${pid}/cmdline`, 'utf-8').replace(/\0/g, ' ').trim();
+    }
+    catch {
+        try {
+            const result = spawnSync('ps', ['-p', String(pid), '-o', 'args='], {
+                encoding: 'utf-8',
+                timeout: 3000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return result.stdout?.trim() || '';
+        }
+        catch {
+            return '';
+        }
+    }
+}
+function readProcessEnvironment(pid) {
+    // Linux: /proc/<pid>/environ
+    if (!isWindows && process.platform !== 'darwin') {
+        try {
+            const env = fs.readFileSync(`/proc/${pid}/environ`, 'utf-8');
+            const result = {};
+            for (const entry of env.split('\0')) {
+                const separator = entry.indexOf('=');
+                if (separator <= 0)
+                    continue;
+                result[entry.slice(0, separator)] = entry.slice(separator + 1);
+            }
+            return result;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}

package/dist/utils/locale.js

@@ -0,0 +1,21 @@
+/**
+ * locale.ts — 宿主机系统语言判定（单一事实来源）。
+ *
+ * 依据进程环境的 locale 变量（LANG / LC_ALL / LANGUAGE），
+ * 回退到 Intl 解析出的运行时 locale。用于面向用户的系统文案在中/英之间切换。
+ *
+ * 注意：这是「宿主机/守护进程」语言，不是「对端用户」语言——
+ * 系统当前没有 per-peer 语言偏好；若将来引入，应在调用点覆盖此判定。
+ */
+/** 解析宿主机 locale 字符串（小写），无则返回空串。 */
+export function resolveHostLocale() {
+    return (process.env.LANG ||
+        process.env.LC_ALL ||
+        process.env.LANGUAGE ||
+        Intl.DateTimeFormat().resolvedOptions().locale ||
+        '').toLowerCase();
+}
+/** 宿主机系统语言是否为中文（zh / zh-CN / zh_CN.UTF-8 等）。 */
+export function isHostChinese() {
+    return resolveHostLocale().includes('zh');
+}