@chenmk/superflow 0.2.5 → 0.4.0

package/dist/platform/agent-process.js

@@ -0,0 +1,308 @@
+import { existsSync, readFileSync, unlinkSync } from "fs";
+import path from "path";
+import spawn from "cross-spawn";
+import { managedText } from "../domains/managed-work/i18n.js";
+export class LocalAgentInvoker {
+    async invoke(invocation) {
+        return runAgentProcess(invocation);
+    }
+}
+export function buildAgentCommand(invocation) {
+    if (invocation.agent === "codex")
+        return buildCodexCommand(invocation);
+    return buildClaudeCommand(invocation);
+}
+async function runAgentProcess(invocation) {
+    const command = buildAgentCommand(invocation);
+    if (command.outputFile && existsSync(command.outputFile))
+        unlinkSync(command.outputFile);
+    return new Promise((resolve, reject) => {
+        const child = spawn(command.command, command.args, {
+            cwd: invocation.projectRoot,
+            env: {
+                ...process.env,
+                SUPERFLOW_MANAGED_TASK_ID: invocation.taskId,
+                SUPERFLOW_MANAGED_RUN_ID: invocation.runId,
+                SUPERFLOW_MANAGED_ROLE: invocation.role,
+                SUPERFLOW_MANAGED_PROJECT_ROOT: invocation.projectRoot,
+            },
+            detached: process.platform !== "win32",
+            stdio: ["pipe", "pipe", "pipe"],
+            shell: false,
+        });
+        let stdout = "";
+        let stderr = "";
+        let lineBuffer = "";
+        let sessionId = invocation.sessionId;
+        let lastOutputAt = Date.now();
+        let finished = false;
+        const warningTimer = setTimeout(() => {
+            invocation.onProgress?.(managedText(invocation.language, "连续一段时间没有新进展，后台仍在观察进程", "No new progress for a while; the background service is still observing the process"));
+        }, invocation.timeout.warningMs);
+        let stalledTimer = setTimeout(onStalled, invocation.timeout.stalledMs);
+        const hardTimer = setTimeout(() => {
+            stopChild(child.pid);
+            finishError(new Error(managedText(invocation.language, `单次 Agent 调用超过 ${invocation.timeout.hardMs}ms`, `Single Agent invocation exceeded ${invocation.timeout.hardMs}ms`)));
+        }, invocation.timeout.hardMs);
+        if (invocation.sessionId)
+            invocation.onSession?.(invocation.sessionId);
+        child.stdout?.on("data", (chunk) => {
+            const text = chunk.toString();
+            stdout += text;
+            lastOutputAt = Date.now();
+            clearTimeout(stalledTimer);
+            stalledTimer = setTimeout(onStalled, invocation.timeout.stalledMs);
+            lineBuffer += text;
+            const lines = lineBuffer.split(/\r?\n/);
+            lineBuffer = lines.pop() ?? "";
+            for (const line of lines) {
+                const event = safeJson(line);
+                const discoveredSession = extractSessionId(event);
+                if (!sessionId && discoveredSession) {
+                    sessionId = discoveredSession;
+                    invocation.onSession?.(discoveredSession);
+                }
+                const progress = extractProgress(event);
+                if (progress)
+                    invocation.onProgress?.(progress);
+            }
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk.toString();
+            lastOutputAt = Date.now();
+        });
+        child.on("error", finishError);
+        child.on("close", (code) => {
+            if (finished)
+                return;
+            cleanupTimers();
+            finished = true;
+            if ((code ?? 1) !== 0) {
+                reject(new Error(formatAgentFailure(invocation.agent, code, stdout, stderr, invocation.language)));
+                return;
+            }
+            try {
+                const output = extractStructuredOutput(invocation.agent, stdout, command.outputFile, invocation.language);
+                const resolvedSession = sessionId ??
+                    extractSessionFromLines(stdout) ??
+                    command.initialSessionId;
+                if (!resolvedSession)
+                    throw new Error(managedText(invocation.language, "Agent 输出中缺少可恢复 session ID", "Agent output is missing a resumable session ID"));
+                resolve({
+                    sessionId: resolvedSession,
+                    output,
+                    stdout,
+                    stderr,
+                    exitCode: code ?? 0,
+                });
+            }
+            catch (error) {
+                reject(error);
+            }
+        });
+        child.stdin?.end(invocation.prompt);
+        function onStalled() {
+            if (Date.now() - lastOutputAt < invocation.timeout.stalledMs)
+                return;
+            stopChild(child.pid);
+            finishError(new Error(managedText(invocation.language, "Agent 长时间没有输出，已保存现场并中断", "Agent produced no output for too long; state was preserved and the process was interrupted")));
+        }
+        function finishError(error) {
+            if (finished)
+                return;
+            finished = true;
+            cleanupTimers();
+            reject(error);
+        }
+        function cleanupTimers() {
+            clearTimeout(warningTimer);
+            clearTimeout(stalledTimer);
+            clearTimeout(hardTimer);
+        }
+    });
+}
+export function formatAgentFailure(agent, code, stdout, stderr, language) {
+    const details = [stderr.trim(), extractFailureFromEvents(stdout)]
+        .filter(Boolean)
+        .join("\n")
+        .slice(-2_000);
+    return managedText(language, `${agent} 调用失败，退出码 ${code ?? 1}: ${redactFailure(details) || "未返回错误详情"}`, `${agent} invocation failed with exit code ${code ?? 1}: ${redactFailure(details) || "no error details returned"}`);
+}
+function extractFailureFromEvents(stdout) {
+    const lines = stdout.split(/\r?\n/).filter(Boolean);
+    const messages = [];
+    for (let index = lines.length - 1; index >= 0 && messages.length < 4; index--) {
+        const event = safeJson(lines[index]);
+        if (!event)
+            continue;
+        for (const key of ["error", "message", "result", "reason"]) {
+            const value = event[key];
+            if (typeof value === "string" && value.trim())
+                messages.push(value.trim());
+        }
+    }
+    return messages.join("\n");
+}
+function redactFailure(value) {
+    return value
+        .replace(/(authorization\s*[:=]\s*bearer\s+)[^\s"']+/gi, "$1<redacted>")
+        .replace(/(["']?(?:token|password|secret|cookie|api[_-]?key)["']?\s*[:=]\s*["']?)[^\s"',}]+/gi, "$1<redacted>");
+}
+function buildCodexCommand(invocation) {
+    const outputFile = path.join(path.dirname(invocation.schemaPath), `${invocation.role}-last.json`);
+    if (invocation.sessionId) {
+        return {
+            command: "codex",
+            args: [
+                "exec",
+                "resume",
+                invocation.sessionId,
+                "--json",
+                "--output-schema",
+                invocation.schemaPath,
+                "-o",
+                outputFile,
+                "-",
+            ],
+            outputFile,
+            initialSessionId: invocation.sessionId,
+        };
+    }
+    const additionalRoots = invocation.writableRoots.flatMap((root) => [
+        "--add-dir",
+        root,
+    ]);
+    return {
+        command: "codex",
+        args: [
+            "exec",
+            "-C",
+            invocation.projectRoot,
+            "--sandbox",
+            invocation.role === "supervisor" ? "read-only" : "workspace-write",
+            ...additionalRoots,
+            "--json",
+            "--output-schema",
+            invocation.schemaPath,
+            "-o",
+            outputFile,
+            "-",
+        ],
+        outputFile,
+        initialSessionId: null,
+    };
+}
+function buildClaudeCommand(invocation) {
+    const schema = readFileSync(invocation.schemaPath, "utf-8");
+    const args = ["-p"];
+    let initialSessionId = invocation.sessionId;
+    if (invocation.sessionId)
+        args.push("--resume", invocation.sessionId);
+    else {
+        initialSessionId = cryptoRandomUuid();
+        args.push("--session-id", initialSessionId);
+    }
+    args.push("--output-format", "stream-json", "--verbose", "--json-schema", schema, "--permission-mode", invocation.role === "supervisor" ? "plan" : "auto");
+    for (const root of invocation.writableRoots)
+        args.push("--add-dir", root);
+    return { command: "claude", args, outputFile: null, initialSessionId };
+}
+function extractStructuredOutput(agent, stdout, outputFile, language) {
+    if (agent === "codex" && outputFile && existsSync(outputFile)) {
+        return parseStructuredValue(readFileSync(outputFile, "utf-8"), language);
+    }
+    const events = stdout.split(/\r?\n/).map(safeJson).filter(Boolean);
+    for (let index = events.length - 1; index >= 0; index--) {
+        const event = events[index];
+        for (const key of ["structured_output", "structuredOutput", "result"]) {
+            if (event[key] !== undefined)
+                return parseStructuredValue(event[key], language);
+        }
+    }
+    return parseStructuredValue(stdout, language);
+}
+function parseStructuredValue(value, language) {
+    if (typeof value === "object" && value !== null)
+        return value;
+    if (typeof value !== "string") {
+        throw new Error(managedText(language, "Agent 未返回结构化结果", "Agent did not return structured output"));
+    }
+    const trimmed = value.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        const match = trimmed.match(/\{[\s\S]*\}/);
+        if (!match) {
+            throw new Error(managedText(language, "Agent 最终输出不是 JSON", "Agent final output is not JSON"));
+        }
+        return JSON.parse(match[0]);
+    }
+}
+function extractSessionFromLines(stdout) {
+    for (const line of stdout.split(/\r?\n/)) {
+        const sessionId = extractSessionId(safeJson(line));
+        if (sessionId)
+            return sessionId;
+    }
+    return null;
+}
+function extractSessionId(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const object = value;
+    for (const key of ["session_id", "sessionId", "thread_id", "threadId"]) {
+        if (typeof object[key] === "string" && isUuid(object[key]))
+            return object[key];
+    }
+    for (const child of Object.values(object)) {
+        const nested = extractSessionId(child);
+        if (nested)
+            return nested;
+    }
+    return null;
+}
+function extractProgress(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const object = value;
+    for (const key of ["message", "summary", "text"]) {
+        if (typeof object[key] === "string" && object[key].length > 0) {
+            return object[key].slice(0, 240);
+        }
+    }
+    return null;
+}
+function safeJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+function stopChild(pid) {
+    if (!pid)
+        return;
+    try {
+        if (process.platform === "win32")
+            process.kill(pid, "SIGTERM");
+        else
+            process.kill(-pid, "SIGTERM");
+    }
+    catch {
+        try {
+            process.kill(pid, "SIGTERM");
+        }
+        catch {
+            // Process already exited.
+        }
+    }
+}
+function isUuid(value) {
+    return (typeof value === "string" && /^[0-9a-f]{8}-[0-9a-f-]{27}$/i.test(value));
+}
+function cryptoRandomUuid() {
+    return globalThis.crypto.randomUUID();
+}
+//# sourceMappingURL=agent-process.js.map

package/dist/platform/agent-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-process.js","sourceRoot":"","sources":["../../src/platform/agent-process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,KAAK,MAAM,aAAa,CAAC;AAOhC,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAG9D,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,MAAM,CACV,UAA2B;QAE3B,OAAO,eAAe,CAAI,UAAU,CAAC,CAAC;IACxC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB,CAAC,UAA2B;IAM3D,IAAI,UAAU,CAAC,KAAK,KAAK,OAAO;QAAE,OAAO,iBAAiB,CAAC,UAAU,CAAC,CAAC;IACvE,OAAO,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACxC,CAAC;AAED,KAAK,UAAU,eAAe,CAC5B,UAA2B;IAE3B,MAAM,OAAO,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC;QACtD,UAAU,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;YACjD,GAAG,EAAE,UAAU,CAAC,WAAW;YAC3B,GAAG,EAAE;gBACH,GAAG,OAAO,CAAC,GAAG;gBACd,yBAAyB,EAAE,UAAU,CAAC,MAAM;gBAC5C,wBAAwB,EAAE,UAAU,CAAC,KAAK;gBAC1C,sBAAsB,EAAE,UAAU,CAAC,IAAI;gBACvC,8BAA8B,EAAE,UAAU,CAAC,WAAW;aACvD;YACD,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;YACtC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;YAC/B,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACrC,IAAI,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,IAAI,QAAQ,GAAG,KAAK,CAAC;QAErB,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,EAAE;YACnC,UAAU,CAAC,UAAU,EAAE,CACrB,WAAW,CACT,UAAU,CAAC,QAAQ,EACnB,sBAAsB,EACtB,oFAAoF,CACrF,CACF,CAAC;QACJ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACjC,IAAI,YAAY,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAChC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,WAAW,CACT,IAAI,KAAK,CACP,WAAW,CACT,UAAU,CAAC,QAAQ,EACnB,iBAAiB,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,EAC9C,oCAAoC,UAAU,CAAC,OAAO,CAAC,MAAM,IAAI,CAClE,CACF,CACF,CAAC;QACJ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,UAAU,CAAC,SAAS;YAAE,UAAU,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEvE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,IAAI,CAAC;YACf,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,GAAG,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YACnE,UAAU,IAAI,IAAI,CAAC;YACnB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxC,UAAU,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC7B,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAClD,IAAI,CAAC,SAAS,IAAI,iBAAiB,EAAE,CAAC;oBACpC,SAAS,GAAG,iBAAiB,CAAC;oBAC9B,UAAU,CAAC,SAAS,EAAE,CAAC,iBAAiB,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;gBACxC,IAAI,QAAQ;oBAAE,UAAU,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACjC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC3B,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,QAAQ;gBAAE,OAAO;YACrB,aAAa,EAAE,CAAC;YAChB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,MAAM,CACJ,IAAI,KAAK,CACP,kBAAkB,CAChB,UAAU,CAAC,KAAK,EAChB,IAAI,EACJ,MAAM,EACN,MAAM,EACN,UAAU,CAAC,QAAQ,CACpB,CACF,CACF,CAAC;gBACF,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,uBAAuB,CACpC,UAAU,CAAC,KAAK,EAChB,MAAM,EACN,OAAO,CAAC,UAAU,EAClB,UAAU,CAAC,QAAQ,CACpB,CAAC;gBACF,MAAM,eAAe,GACnB,SAAS;oBACT,uBAAuB,CAAC,MAAM,CAAC;oBAC/B,OAAO,CAAC,gBAAgB,CAAC;gBAC3B,IAAI,CAAC,eAAe;oBAClB,MAAM,IAAI,KAAK,CACb,WAAW,CACT,UAAU,CAAC,QAAQ,EACnB,2BAA2B,EAC3B,gDAAgD,CACjD,CACF,CAAC;gBACJ,OAAO,CAAC;oBACN,SAAS,EAAE,eAAe;oBAC1B,MAAM;oBACN,MAAM;oBACN,MAAM;oBACN,QAAQ,EAAE,IAAI,IAAI,CAAC;iBACpB,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAEpC,SAAS,SAAS;YAChB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS;gBAAE,OAAO;YACrE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACrB,WAAW,CACT,IAAI,KAAK,CACP,WAAW,CACT,UAAU,CAAC,QAAQ,EACnB,wBAAwB,EACxB,4FAA4F,CAC7F,CACF,CACF,CAAC;QACJ,CAAC;QAED,SAAS,WAAW,CAAC,KAAY;YAC/B,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,aAAa,EAAE,CAAC;YAChB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAED,SAAS,aAAa;YACpB,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,CAAC,YAAY,CAAC,CAAC;YAC3B,YAAY,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,KAAmB,EACnB,IAAmB,EACnB,MAAc,EACd,MAAc,EACd,QAAmB;IAEnB,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,MAAM,CAAC,CAAC;SAC9D,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC;SACV,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACjB,OAAO,WAAW,CAChB,QAAQ,EACR,GAAG,KAAK,aAAa,IAAI,IAAI,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,SAAS,EAAE,EACxE,GAAG,KAAK,qCAAqC,IAAI,IAAI,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,2BAA2B,EAAE,CACnH,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9E,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;YACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK;SACT,OAAO,CAAC,8CAA8C,EAAE,cAAc,CAAC;SACvE,OAAO,CACN,qFAAqF,EACrF,cAAc,CACf,CAAC;AACN,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA2B;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAC1B,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EACnC,GAAG,UAAU,CAAC,IAAI,YAAY,CAC/B,CAAC;IACF,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE;gBACJ,MAAM;gBACN,QAAQ;gBACR,UAAU,CAAC,SAAS;gBACpB,QAAQ;gBACR,iBAAiB;gBACjB,UAAU,CAAC,UAAU;gBACrB,IAAI;gBACJ,UAAU;gBACV,GAAG;aACJ;YACD,UAAU;YACV,gBAAgB,EAAE,UAAU,CAAC,SAAS;SACvC,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACjE,WAAW;QACX,IAAI;KACL,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE;YACJ,MAAM;YACN,IAAI;YACJ,UAAU,CAAC,WAAW;YACtB,WAAW;YACX,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;YAClE,GAAG,eAAe;YAClB,QAAQ;YACR,iBAAiB;YACjB,UAAU,CAAC,UAAU;YACrB,IAAI;YACJ,UAAU;YACV,GAAG;SACJ;QACD,UAAU;QACV,gBAAgB,EAAE,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,UAA2B;IACrD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,gBAAgB,GAAG,UAAU,CAAC,SAAS,CAAC;IAC5C,IAAI,UAAU,CAAC,SAAS;QAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;SACjE,CAAC;QACJ,gBAAgB,GAAG,gBAAgB,EAAE,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,gBAAgB,CAAC,CAAC;IAC9C,CAAC;IACD,IAAI,CAAC,IAAI,CACP,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,MAAM,EACN,mBAAmB,EACnB,UAAU,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CACnD,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,aAAa;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC1E,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC;AACzE,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAmB,EACnB,MAAc,EACd,UAAyB,EACzB,QAAmB;IAEnB,IAAI,KAAK,KAAK,OAAO,IAAI,UAAU,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9D,OAAO,oBAAoB,CAAI,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC9E,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAG9D,CAAC;IACJ,KAAK,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,KAAK,MAAM,GAAG,IAAI,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EAAE,CAAC;YACtE,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;gBAAE,OAAO,oBAAoB,CAAI,KAAK,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,oBAAoB,CAAI,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,oBAAoB,CAAI,KAAc,EAAE,QAAmB;IAClE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAU,CAAC;IACnE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wCAAwC,CAAC,CAClF,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CACb,WAAW,CAAC,QAAQ,EAAE,mBAAmB,EAAE,gCAAgC,CAAC,CAC7E,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAM,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAc;IAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,IAAI,SAAS;YAAE,OAAO,SAAS,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;QACvE,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACxD,OAAO,MAAM,CAAC,GAAG,CAAW,CAAC;IACjC,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;IAC5B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACrD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,KAAK,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC;QACjD,IAAI,OAAO,MAAM,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9D,OAAQ,MAAM,CAAC,GAAG,CAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,QAAQ,CAAC,KAAa;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAA4B,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,GAAuB;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO;IACjB,IAAI,CAAC;QACH,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,0BAA0B;QAC5B,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CACxE,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;AACxC,CAAC"}

package/dist/platform/assets.js

@@ -0,0 +1,9 @@
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// src/platform/assets.ts and dist/platform/assets.js are both two levels
+// below the package root.
+export const PACKAGE_ROOT = path.resolve(__dirname, '..', '..');
+export const ASSETS_DIR = path.join(PACKAGE_ROOT, 'assets');
+//# sourceMappingURL=assets.js.map

package/dist/platform/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/platform/assets.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,yEAAyE;AACzE,0BAA0B;AAC1B,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC"}

package/dist/platform/process-liveness.js

@@ -0,0 +1,10 @@
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+}
+//# sourceMappingURL=process-liveness.js.map

package/dist/platform/process-liveness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-liveness.js","sourceRoot":"","sources":["../../src/platform/process-liveness.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/platform/version-check.js

@@ -1,5 +1,5 @@
-import { runCommand } from './process.js';
-const PACKAGE_NAME = '@chenmk/superflow';
+import { runCommand } from "./process.js";
+const PACKAGE_NAME = "@chenmk/superflow";
 const CHECK_INTERVAL_MS = 1000 * 60 * 60 * 24; // 一天检查一次
 let lastCheck = 0;
 let cachedLatest = null;
@@ -9,13 +9,13 @@ let cachedLatest = null;
  */
 export async function checkForUpdates(currentVersion) {
     if (Date.now() - lastCheck < CHECK_INTERVAL_MS && cachedLatest) {
-        if (cachedLatest !== currentVersion) {
+        if (isNewerVersion(cachedLatest, currentVersion)) {
             printUpdateHint(currentVersion, cachedLatest);
         }
         return;
     }
     try {
-        const result = await runCommand('npm', ['view', PACKAGE_NAME, 'version'], {
+        const result = await runCommand("npm", ["view", PACKAGE_NAME, "version"], {
             timeout: 5000,
         });
         if (result.code !== 0)
@@ -23,7 +23,7 @@ export async function checkForUpdates(currentVersion) {
         const latest = result.stdout.trim();
         lastCheck = Date.now();
         cachedLatest = latest;
-        if (latest !== currentVersion) {
+        if (isNewerVersion(latest, currentVersion)) {
             printUpdateHint(currentVersion, latest);
         }
     }
@@ -31,15 +31,36 @@ export async function checkForUpdates(currentVersion) {
         // npm view failed（无网络、npm 未安装等），静默跳过
     }
 }
+export function isNewerVersion(candidate, current) {
+    const left = parseVersion(candidate);
+    const right = parseVersion(current);
+    if (!left || !right)
+        return false;
+    for (let index = 0; index < 3; index++) {
+        if (left[index] !== right[index])
+            return left[index] > right[index];
+    }
+    return left.prerelease === null && right.prerelease !== null;
+}
+function parseVersion(value) {
+    const match = value
+        .trim()
+        .match(/^v?(\d+)\.(\d+)\.(\d+)(?:-([^+]+))?(?:\+.+)?$/);
+    if (!match)
+        return null;
+    const result = [Number(match[1]), Number(match[2]), Number(match[3])];
+    result.prerelease = match[4] ?? null;
+    return result;
+}
 function printUpdateHint(current, latest) {
     // 只在终端输出（stderr 避免干扰 --json 输出）
     const msg = [
-        '',
+        "",
         `\x1b[33m⚠  superflow ${latest} 可用（当前 ${current}）\x1b[0m`,
         `   升级: \x1b[36mnpm install -g ${PACKAGE_NAME}@latest\x1b[0m`,
         `   或: \x1b[36msuperflow update --with-package\x1b[0m`,
-        '',
-    ].join('\n');
-    process.stderr.write(msg + '\n');
+        "",
+    ].join("\n");
+    process.stderr.write(msg + "\n");
 }
 //# sourceMappingURL=version-check.js.map

package/dist/platform/version-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/platform/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,YAAY,GAAG,mBAAmB,CAAC;AACzC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS;AAExD,IAAI,SAAS,GAAG,CAAC,CAAC;AAClB,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,cAAsB;IAC1D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,iBAAiB,IAAI,YAAY,EAAE,CAAC;QAC/D,IAAI,YAAY,KAAK,cAAc,EAAE,CAAC;YACpC,eAAe,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE;YACxE,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,YAAY,GAAG,MAAM,CAAC;QAEtB,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,MAAc;IACtD,gCAAgC;IAChC,MAAM,GAAG,GAAG;QACV,EAAE;QACF,wBAAwB,MAAM,UAAU,OAAO,UAAU;QACzD,iCAAiC,YAAY,gBAAgB;QAC7D,sDAAsD;QACtD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/platform/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,YAAY,GAAG,mBAAmB,CAAC;AACzC,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,SAAS;AAExD,IAAI,SAAS,GAAG,CAAC,CAAC;AAClB,IAAI,YAAY,GAAkB,IAAI,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,cAAsB;IAC1D,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,iBAAiB,IAAI,YAAY,EAAE,CAAC;QAC/D,IAAI,cAAc,CAAC,YAAY,EAAE,cAAc,CAAC,EAAE,CAAC;YACjD,eAAe,CAAC,cAAc,EAAE,YAAY,CAAC,CAAC;QAChD,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE;YACxE,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE9B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,YAAY,GAAG,MAAM,CAAC;QAEtB,IAAI,cAAc,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YAC3C,eAAe,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qCAAqC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAiB,EAAE,OAAe;IAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAClC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QACvC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;AAC/D,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IAKjC,MAAM,KAAK,GAAG,KAAK;SAChB,IAAI,EAAE;SACN,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAInC,CAAC;IAClC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,OAAe,EAAE,MAAc;IACtD,gCAAgC;IAChC,MAAM,GAAG,GAAG;QACV,EAAE;QACF,wBAAwB,MAAM,UAAU,OAAO,UAAU;QACzD,iCAAiC,YAAY,gBAAgB;QAC7D,sDAAsD;QACtD,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chenmk/superflow",
-  "version": "0.2.5",
+  "version": "0.4.0",
   "description": "SuperBridge Flow workflow CLI for Claude Code, Codex, and OpenCode",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,8 @@
     "dev": "tsx watch src/cli/index.ts",
     "postinstall": "node scripts/postinstall.js",
     "prepack": "npm run build",
-    "prepublishOnly": "npm test && npm run build",
+    "prepublishOnly": "npm run release:check && npm test && npm run build",
+    "release:check": "node scripts/release-notes-check.js",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/ test/",

package/scripts/release-notes-check.js

@@ -0,0 +1,102 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+function runGit(args, cwd) {
+  return execFileSync("git", args, {
+    cwd,
+    encoding: "utf8",
+    stdio: ["ignore", "pipe", "pipe"],
+  }).trim();
+}
+
+function findPreviousTag(tag, cwd) {
+  try {
+    return runGit(["describe", "--tags", "--abbrev=0", `${tag}^`], cwd);
+  } catch {
+    return "";
+  }
+}
+
+export function validateReleaseMetadata(metadata) {
+  const { tag, objectType, subject, body, previousTag } = metadata;
+  if (!/^v\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(tag)) {
+    throw new Error(`版本标签格式错误：${tag}，应使用 vX.Y.Z`);
+  }
+  if (objectType !== "tag") {
+    throw new Error(`版本标签 ${tag} 必须是 annotated tag，不能是轻量标签`);
+  }
+
+  const version = tag.slice(1);
+  if (!subject.includes(version)) {
+    throw new Error(`标签标题必须包含当前版本 ${version}`);
+  }
+  if (!body) {
+    throw new Error(`标签 ${tag} 缺少版本升级说明`);
+  }
+  if (!/(升级内容|upgrade from|changes since)/i.test(body)) {
+    throw new Error("版本说明必须明确标注“升级内容”或对应英文表述");
+  }
+
+  const requiredSections = [
+    ["升级摘要", /^## (升级摘要|Upgrade Summary)$/im],
+    ["主要更新", /^## (主要更新|Highlights|What's Changed)$/im],
+    ["验证结果", /^## (验证结果|Quality Verification|Validation)$/im],
+    ["升级方式", /^## (升级方式|Upgrade)$/im],
+  ];
+  for (const [label, pattern] of requiredSections) {
+    if (!pattern.test(body)) {
+      throw new Error(`版本说明缺少“## ${label}”章节`);
+    }
+  }
+  const bulletCount = body.match(/^[-*] .+/gm)?.length ?? 0;
+  if (bulletCount < 3) {
+    throw new Error("版本说明的主要更新和验证结果至少需要 3 条清晰条目");
+  }
+
+  if (previousTag) {
+    const previousVersion = previousTag.replace(/^v/, "");
+    if (!body.includes(previousVersion)) {
+      throw new Error(`版本说明必须包含上一版本 ${previousVersion}`);
+    }
+  }
+}
+
+export function inspectReleaseTag(tag, cwd = process.cwd()) {
+  const ref = `refs/tags/${tag}`;
+  const metadata = {
+    tag,
+    objectType: runGit(["cat-file", "-t", ref], cwd),
+    subject: runGit(["for-each-ref", ref, "--format=%(contents:subject)"], cwd),
+    body: runGit(["for-each-ref", ref, "--format=%(contents:body)"], cwd),
+    previousTag: findPreviousTag(tag, cwd),
+  };
+  validateReleaseMetadata(metadata);
+  return metadata;
+}
+
+function currentPackageTag() {
+  const packageJson = JSON.parse(
+    readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+  );
+  return `v${packageJson.version}`;
+}
+
+function main() {
+  const tag = process.argv[2] ?? currentPackageTag();
+  const metadata = inspectReleaseTag(tag);
+  const from = metadata.previousTag || "首个版本";
+  process.stdout.write(`版本发布说明校验通过：${from} → ${tag}\n`);
+}
+
+const entryPath = process.argv[1] ? path.resolve(process.argv[1]) : "";
+if (entryPath === fileURLToPath(import.meta.url)) {
+  try {
+    main();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`版本发布说明校验失败：${message}\n`);
+    process.exitCode = 1;
+  }
+}