helixlife-expert-cli 0.1.0

package/cli/dist/modules/proposal/parse.js

@@ -0,0 +1,173 @@
+/**
+ * newidea invocation 输出解析（纯函数，便于单测）
+ *
+ * newidea CLI 的 --json 输出前后可能夹带非 JSON 噪声行（更新提示、进度日志），
+ * 因此不能直接 JSON.parse(stdout)。
+ */
+import { helixlifeError, helixlifeErrorCode } from "../../core/index.js";
+const SUCCESS_STATUSES = new Set([
+    "success",
+    "succeeded",
+    "completed",
+    "complete",
+    "finished",
+]);
+const FAILED_STATUSES = new Set([
+    "failed",
+    "failure",
+    "error",
+    "cancelled",
+    "canceled",
+    "timeout",
+]);
+// 从首个 '{' 或 '[' 起做括号配对扫描，跳过字符串字面量内的括号
+function findBalancedEnd(text, start) {
+    const open = text[start];
+    const close = open === "{" ? "}" : "]";
+    let depth = 0;
+    let inString = false;
+    let escaped = false;
+    for (let i = start; i < text.length; i += 1) {
+        const ch = text[i];
+        if (inString) {
+            if (escaped) {
+                escaped = false;
+            }
+            else if (ch === "\\") {
+                escaped = true;
+            }
+            else if (ch === '"') {
+                inString = false;
+            }
+            continue;
+        }
+        if (ch === '"') {
+            inString = true;
+        }
+        else if (ch === open) {
+            depth += 1;
+        }
+        else if (ch === close) {
+            depth -= 1;
+            if (depth === 0) {
+                return i;
+            }
+        }
+    }
+    return -1;
+}
+/**
+ * 从 CLI stdout 中提取首个完整 JSON 值（对象或数组）。
+ */
+export function extractJsonFromStdout(stdout) {
+    const text = stdout ?? "";
+    for (let i = 0; i < text.length; i += 1) {
+        const ch = text[i];
+        if (ch !== "{" && ch !== "[") {
+            continue;
+        }
+        const end = findBalancedEnd(text, i);
+        if (end < 0) {
+            break;
+        }
+        try {
+            return JSON.parse(text.slice(i, end + 1));
+        }
+        catch {
+            // 该候选不是合法 JSON（例如日志里的花括号），继续向后找
+        }
+    }
+    throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, `无法从 newidea 输出中解析 JSON：${text.slice(0, 300)}`);
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : null;
+}
+function pickString(source, keys) {
+    for (const key of keys) {
+        const value = source[key];
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+    }
+    return undefined;
+}
+/**
+ * 从 `invocation start` / `last` 的返回中提取 run_record_id。
+ * 兼容下划线与驼峰，并向下一层 data / record / result 探一层。
+ */
+export function parseRunRecordId(raw) {
+    const record = asRecord(raw);
+    if (!record) {
+        return undefined;
+    }
+    const direct = pickString(record, [
+        "run_record_id",
+        "runRecordId",
+        "record_id",
+        "recordId",
+    ]);
+    if (direct) {
+        return direct;
+    }
+    for (const key of ["data", "record", "result"]) {
+        const nested = asRecord(record[key]);
+        if (nested) {
+            const found = pickString(nested, [
+                "run_record_id",
+                "runRecordId",
+                "record_id",
+                "recordId",
+            ]);
+            if (found) {
+                return found;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * 归一 `invocation process` 返回：状态、错误、产物链接与事件条数。
+ */
+export function normalizeInvocationProcess(raw) {
+    const record = asRecord(raw);
+    if (!record) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "newidea 进度查询返回结构异常（非对象）");
+    }
+    const source = asRecord(record.data) ?? record;
+    const rawStatus = typeof source.status === "string" ? source.status.trim() : "";
+    const normalized = rawStatus.toLowerCase();
+    const errorValue = source.error;
+    let error = null;
+    if (typeof errorValue === "string" && errorValue.trim()) {
+        error = errorValue.trim();
+    }
+    else if (asRecord(errorValue)) {
+        const nested = asRecord(errorValue);
+        error = pickString(nested, ["message", "detail", "reason"]) ?? null;
+    }
+    let status;
+    if (SUCCESS_STATUSES.has(normalized)) {
+        status = "success";
+    }
+    else if (FAILED_STATUSES.has(normalized) || error) {
+        // 未标记失败但带 error 文本时同样按失败处理，避免无限轮询
+        status = "failed";
+    }
+    else {
+        status = "running";
+    }
+    const artifactsValue = source.artifacts;
+    let artifacts = null;
+    if (typeof artifactsValue === "string" && artifactsValue.trim()) {
+        artifacts = artifactsValue.trim();
+    }
+    else if (Array.isArray(artifactsValue)) {
+        const first = artifactsValue.find((item) => typeof item === "string" && Boolean(item.trim()));
+        artifacts = first ? first.trim() : null;
+    }
+    const itemCount = Array.isArray(source.items) ? source.items.length : 0;
+    return { status, rawStatus, error, artifacts, itemCount };
+}
+//# sourceMappingURL=parse.js.map

package/cli/dist/modules/proposal/parse.js.map

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

package/cli/dist/modules/sci/apps.d.ts

@@ -0,0 +1,48 @@
+export interface CreateSciOrderBody {
+    index: number;
+    count: number;
+    query?: string;
+    inputs?: Record<string, string | number>;
+    files?: string[];
+    parent_order_id: string | null;
+}
+export interface CreateSciOrderResult {
+    success?: boolean;
+    data?: {
+        msg?: string;
+        data?: {
+            order_id?: string;
+        };
+    };
+    message?: string;
+    [key: string]: unknown;
+}
+export interface SciExecuteBody {
+    response_mode: "streaming";
+    query: string;
+    inputs: Record<string, string | number>;
+    app_id: string;
+    app_name: string;
+    app_mode: "workflow";
+    app_type: 0 | 1;
+    index: number;
+    order_id: string;
+    end: boolean;
+    count: number;
+    parent_order_id: string | null;
+}
+export declare function buildSciExecuteBody(params: {
+    query: string;
+    inputs: Record<string, string | number>;
+    appId: string;
+    appName: string;
+    appType?: 0 | 1;
+    index: number;
+    orderId: string;
+    end: boolean;
+    count?: number;
+    parentOrderId?: string | null;
+}): SciExecuteBody;
+export declare function createSciOrder(body: CreateSciOrderBody): Promise<CreateSciOrderResult>;
+export declare function extractSciOrderId(order: CreateSciOrderResult): string;
+//# sourceMappingURL=apps.d.ts.map

package/cli/dist/modules/sci/apps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/apps.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAGD,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE;YACL,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,CAAC;KACH,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,WAAW,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GAAG,cAAc,CAejB;AAGD,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,oBAAoB,CAAC,CAM/B;AAGD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAkBrE"}

package/cli/dist/modules/sci/apps.js

@@ -0,0 +1,43 @@
+// SCI /apps/* 接口共享层：订单创建与 SSE execute 请求体基底
+import { ApiClient, helixlifeError, helixlifeErrorCode, } from "../../core/index.js";
+import { SCI_ORDER_API_PATH } from "./constants.js";
+// 组装 SSE execute 请求体
+export function buildSciExecuteBody(params) {
+    return {
+        response_mode: "streaming",
+        query: params.query,
+        inputs: params.inputs,
+        app_id: params.appId,
+        app_name: params.appName,
+        app_mode: "workflow",
+        app_type: params.appType ?? 1,
+        index: params.index,
+        order_id: params.orderId,
+        end: params.end,
+        count: params.count ?? 1,
+        parent_order_id: params.parentOrderId ?? null,
+    };
+}
+// 调用后台创建 SCI 订单
+export async function createSciOrder(body) {
+    const client = new ApiClient();
+    return client.request(SCI_ORDER_API_PATH, {
+        method: "POST",
+        body,
+    });
+}
+// 从订单响应中提取 order_id
+export function extractSciOrderId(order) {
+    const orderId = order.data?.data?.order_id;
+    if (typeof orderId === "string" && orderId) {
+        return orderId;
+    }
+    if (order.success === false) {
+        const message = (typeof order.message === "string" && order.message) ||
+            order.data?.msg ||
+            "SCI 订单创建失败，请稍后重试";
+        throw new helixlifeError(helixlifeErrorCode.REQUEST_FAILED, message);
+    }
+    throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "SCI 订单响应缺少 order_id，请重试");
+}
+//# sourceMappingURL=apps.js.map

package/cli/dist/modules/sci/apps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apps.js","sourceRoot":"","sources":["../../../src/modules/sci/apps.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EACL,SAAS,EACT,cAAc,EACd,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAyCpD,qBAAqB;AACrB,MAAM,UAAU,mBAAmB,CAAC,MAWnC;IACC,OAAO;QACL,aAAa,EAAE,WAAW;QAC1B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,KAAK;QACpB,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,QAAQ,EAAE,UAAU;QACpB,QAAQ,EAAE,MAAM,CAAC,OAAO,IAAI,CAAC;QAC7B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,OAAO;QACxB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC,aAAa,IAAI,IAAI;KAC9C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;IAC/B,OAAO,MAAM,CAAC,OAAO,CAAuB,kBAAkB,EAAE;QAC9D,MAAM,EAAE,MAAM;QACd,IAAI;KACL,CAAC,CAAC;AACL,CAAC;AAED,oBAAoB;AACpB,MAAM,UAAU,iBAAiB,CAAC,KAA2B;IAC3D,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC;IAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,EAAE,CAAC;QAC3C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC5B,MAAM,OAAO,GACX,CAAC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC;YACpD,KAAK,CAAC,IAAI,EAAE,GAAG;YACf,kBAAkB,CAAC;QACrB,MAAM,IAAI,cAAc,CAAC,kBAAkB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,yBAAyB,CAC1B,CAAC;AACJ,CAAC"}

package/cli/dist/modules/sci/article-cache.d.ts

@@ -0,0 +1,32 @@
+import type { SciTemplateType } from "./constants.js";
+export interface SciArticleCachePayload {
+    orderId: string;
+    template: SciTemplateType;
+    language: string;
+    article: string;
+    references: string[];
+    workflowRunId?: string;
+}
+export declare function __setSciArticleCacheDirForTesting(dir: string): void;
+export declare function getSciArticleCacheDir(): string;
+export declare function resolveSciArticleCachePath(orderId: string): string;
+/**
+ * 写入缓存并等待落盘完成。
+ *
+ * 步骤② 必须 await 本函数，确保进程退出前临时文件已可见（跨进程步骤③ 才能命中）。
+ * 返回 true 表示落盘成功；失败仅 stderr 警告，不抛错阻断主流程。
+ */
+export declare function saveSciArticleCache(payload: SciArticleCachePayload): Promise<boolean>;
+/**
+ * 读取缓存条目。文件不存在 / 读失败 / 载荷非法一律返回 null。
+ */
+export declare function loadSciArticleCache(orderId: string): Promise<SciArticleCachePayload | null>;
+/**
+ * 取走缓存条目（读后即删）。步骤③ docx/md 成功落盘后调用。
+ */
+export declare function popSciArticleCache(orderId: string): Promise<SciArticleCachePayload | null>;
+/**
+ * 删除指定 orderId 的全文缓存（若存在）。步骤② 开始前清理脏缓存。
+ */
+export declare function clearSciArticleCache(orderId: string): Promise<void>;
+//# sourceMappingURL=article-cache.d.ts.map

package/cli/dist/modules/sci/article-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-cache.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/article-cache.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAStD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEnE;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAGD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlE;AAqDD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAYxC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAexC;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQzE"}

package/cli/dist/modules/sci/article-cache.js

@@ -0,0 +1,163 @@
+/**
+ * SCI 全文系统临时目录缓存
+ *
+ * 设计目标：跨 CLI 进程传递步骤② 生成的全文 Markdown，步骤③ 成功后立即清理。
+ *
+ * 与 JOVA 综述工作台 helixlife-jova-cache/ 对齐：
+ *   - 存储路径为系统临时目录 helixlife-sci-cache/（不污染用户目录）
+ *   - 删除时机为步骤③ docx/md 成功后 pop，而非持久化到用户目录
+ *
+ * 跨进程可见性：helixlife 每条命令是独立 Node 进程，必须落盘才能跨进程复用。
+ */
+import { randomBytes } from "node:crypto";
+import { chmod, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { isCompleteSciArticleMarkdown } from "./article-validate.js";
+// 系统临时目录：mac/linux /tmp/helixlife-sci-cache/；Windows %TEMP%\helixlife-sci-cache\
+let CACHE_DIR = join(tmpdir(), "helixlife-sci-cache");
+const CACHE_FILE_PREFIX = "article-";
+const CACHE_FILE_EXT = ".json";
+// 仅供单元测试：覆盖缓存目录，避免污染真实系统临时目录
+export function __setSciArticleCacheDirForTesting(dir) {
+    CACHE_DIR = dir;
+}
+export function getSciArticleCacheDir() {
+    return CACHE_DIR;
+}
+// 根据 orderId 计算缓存文件路径（供 E2E / 诊断使用）
+export function resolveSciArticleCachePath(orderId) {
+    return join(CACHE_DIR, `${CACHE_FILE_PREFIX}${sanitizeOrderId(orderId)}${CACHE_FILE_EXT}`);
+}
+async function ensureCacheDir() {
+    await mkdir(CACHE_DIR, { recursive: true });
+}
+// 安全过滤 orderId，避免路径穿越
+function sanitizeOrderId(orderId) {
+    return orderId.replace(/[^a-zA-Z0-9_.-]/g, "_");
+}
+// 原子替换：先写 .tmp 再 rename；Windows 目标已存在时先删再 rename
+async function atomicReplace(tempPath, finalPath) {
+    try {
+        await rename(tempPath, finalPath);
+    }
+    catch (error) {
+        if (process.platform === "win32") {
+            await rm(finalPath, { force: true });
+            await rename(tempPath, finalPath);
+            return;
+        }
+        throw error;
+    }
+}
+// 实际落盘逻辑，失败时抛错
+async function persistSciArticleCache(payload) {
+    if (!payload.orderId?.trim()) {
+        throw new Error("orderId 不能为空");
+    }
+    if (!payload.article?.trim()) {
+        throw new Error("article 不能为空");
+    }
+    await ensureCacheDir();
+    const finalPath = resolveSciArticleCachePath(payload.orderId);
+    const nonce = randomBytes(6).toString("hex");
+    const tempPath = `${finalPath}.${nonce}.tmp`;
+    const normalized = {
+        ...payload,
+        language: payload.language ?? "中文",
+        references: Array.isArray(payload.references) ? payload.references : [],
+    };
+    await writeFile(tempPath, JSON.stringify(normalized), "utf8");
+    await atomicReplace(tempPath, finalPath);
+    // 仅当前用户可读，避免同机其他用户读取临时全文
+    await chmod(finalPath, 0o600);
+}
+/**
+ * 写入缓存并等待落盘完成。
+ *
+ * 步骤② 必须 await 本函数，确保进程退出前临时文件已可见（跨进程步骤③ 才能命中）。
+ * 返回 true 表示落盘成功；失败仅 stderr 警告，不抛错阻断主流程。
+ */
+export async function saveSciArticleCache(payload) {
+    try {
+        await persistSciArticleCache(payload);
+        return true;
+    }
+    catch (error) {
+        console.warn(`[sci-cache] 写入失败 orderId=${payload.orderId}: ${error.message}`);
+        return false;
+    }
+}
+/**
+ * 读取缓存条目。文件不存在 / 读失败 / 载荷非法一律返回 null。
+ */
+export async function loadSciArticleCache(orderId) {
+    if (!orderId?.trim()) {
+        return null;
+    }
+    const path = resolveSciArticleCachePath(orderId);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    return parseCachePayload(raw, orderId);
+}
+/**
+ * 取走缓存条目（读后即删）。步骤③ docx/md 成功落盘后调用。
+ */
+export async function popSciArticleCache(orderId) {
+    if (!orderId?.trim()) {
+        return null;
+    }
+    const path = resolveSciArticleCachePath(orderId);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    await rm(path, { force: true }).catch(() => {
+        /* 删失败不影响主流程 */
+    });
+    return parseCachePayload(raw, orderId);
+}
+/**
+ * 删除指定 orderId 的全文缓存（若存在）。步骤② 开始前清理脏缓存。
+ */
+export async function clearSciArticleCache(orderId) {
+    if (!orderId?.trim()) {
+        return;
+    }
+    const path = resolveSciArticleCachePath(orderId);
+    await rm(path, { force: true }).catch(() => {
+        /* 不存在或删失败不影响主流程 */
+    });
+}
+// 解析磁盘 JSON 为缓存载荷；仅标题无正文的脏缓存视为无效
+function parseCachePayload(raw, orderId) {
+    try {
+        const entry = JSON.parse(raw);
+        if (typeof entry.article !== "string" || !entry.article) {
+            return null;
+        }
+        if (!isCompleteSciArticleMarkdown(entry.article)) {
+            return null;
+        }
+        return {
+            orderId: entry.orderId ?? orderId,
+            template: entry.template ?? "basic",
+            language: entry.language ?? "中文",
+            article: entry.article,
+            references: Array.isArray(entry.references) ? entry.references : [],
+            workflowRunId: entry.workflowRunId,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=article-cache.js.map

package/cli/dist/modules/sci/article-cache.js.map

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

package/cli/dist/modules/sci/article-validate.d.ts

@@ -0,0 +1,11 @@
+/** 正文最短字符数：低于此且无二级标题则视为不完整 */
+export declare const SCI_ARTICLE_BODY_MIN_CHARS = 100;
+/**
+ * 判断合并后的全文是否完整（标题 + 实质正文，拒绝仅 H1）。
+ */
+export declare function isCompleteSciArticleMarkdown(article: string): boolean;
+/**
+ * 校验 title/body 两段均完整；不通过则抛错（禁止写缓存）。
+ */
+export declare function assertSciArticleComplete(sections: string[]): void;
+//# sourceMappingURL=article-validate.d.ts.map

package/cli/dist/modules/sci/article-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-validate.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/article-validate.ts"],"names":[],"mappings":"AAEA,8BAA8B;AAC9B,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAoBrE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAwBjE"}

package/cli/dist/modules/sci/article-validate.js

@@ -0,0 +1,43 @@
+import { helixlifeError, helixlifeErrorCode } from "../../core/index.js";
+/** 正文最短字符数：低于此且无二级标题则视为不完整 */
+export const SCI_ARTICLE_BODY_MIN_CHARS = 100;
+/**
+ * 判断合并后的全文是否完整（标题 + 实质正文，拒绝仅 H1）。
+ */
+export function isCompleteSciArticleMarkdown(article) {
+    const trimmed = article.trim();
+    if (!trimmed) {
+        return false;
+    }
+    const lines = trimmed.split(/\r?\n/);
+    const h1Index = lines.findIndex((line) => /^#\s+\S/.test(line.trim()));
+    if (h1Index < 0) {
+        return false;
+    }
+    const body = lines
+        .slice(h1Index + 1)
+        .join("\n")
+        .trim();
+    if (!body) {
+        return false;
+    }
+    return (body.length >= SCI_ARTICLE_BODY_MIN_CHARS || /^##\s+\S/m.test(body));
+}
+/**
+ * 校验 title/body 两段均完整；不通过则抛错（禁止写缓存）。
+ */
+export function assertSciArticleComplete(sections) {
+    if (sections.length < 2) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "全文生成不完整：缺少标题或正文，请重试 outline confirm create");
+    }
+    const title = sections[0]?.trim() ?? "";
+    const body = sections[1]?.trim() ?? "";
+    if (!title) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "全文生成不完整：标题为空，请重试 outline confirm create");
+    }
+    if (!body ||
+        (body.length < SCI_ARTICLE_BODY_MIN_CHARS && !/^##\s+\S/m.test(body))) {
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, "全文生成不完整：正文为空或过短（仅有标题不能视为成功），请重试 outline confirm create");
+    }
+}
+//# sourceMappingURL=article-validate.js.map

package/cli/dist/modules/sci/article-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-validate.js","sourceRoot":"","sources":["../../../src/modules/sci/article-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,8BAA8B;AAC9B,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,KAAK;SACf,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;SAClB,IAAI,CAAC,IAAI,CAAC;SACV,IAAI,EAAE,CAAC;IACV,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,CACL,IAAI,CAAC,MAAM,IAAI,0BAA0B,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAkB;IACzD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,IACE,CAAC,IAAI;QACL,CAAC,IAAI,CAAC,MAAM,GAAG,0BAA0B,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EACrE,CAAC;QACD,MAAM,IAAI,cAAc,CACtB,kBAAkB,CAAC,gBAAgB,EACnC,wDAAwD,CACzD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/cli/dist/modules/sci/commands/article-create.d.ts

@@ -0,0 +1,46 @@
+import { type OutputFormat } from "../../../core/index.js";
+import { type SciLanguage } from "../constants.js";
+export type { SciArticleCreateResult } from "../constants.js";
+export interface CreateSciArticleOptions {
+    orderId?: string;
+    template?: string;
+    file?: string;
+    content?: string;
+    stdin?: boolean;
+    language?: string;
+    /** Step1 方法段落，与官网 Writing.getParams.methods 对齐 */
+    methods?: string;
+    /** Step1 结果段落，与官网 Writing.getParams.results 对齐 */
+    results?: string;
+    methodsFile?: string;
+    resultsFile?: string;
+    /** blank 默认空；existing 模式可传合并后的方法结果 */
+    methodAndResult?: string;
+    yes?: boolean;
+    format?: OutputFormat;
+}
+/** 检查是否为有效 Markdown（提纲格式：至少含 # 标题） */
+export declare function isValidOutlineMarkdown(text: string): boolean;
+/** 从提纲 Markdown 提取首个标题文本（对齐官网 outline_title） */
+export declare function extractOutlineTitle(outline: string): string;
+/**
+ * 组装全文 execute inputs（对齐官网 Writing.getParams SCI existing）
+ * keywords ≈ outlineParams.query（existing 常为空，不用 results 冒充）
+ */
+export declare function buildSciArticleInputs(options: {
+    outline: string;
+    language: SciLanguage;
+    methods: string;
+    results: string;
+    methodAndResult?: string;
+}): Record<string, string | number>;
+/**
+ * 标题段规范化：官网 title 工作流前强制写入 "# "
+ */
+export declare function normalizeSciTitleSection(text: string): string;
+/**
+ * 合并 title + body 各段（官网 list.join("\\n")）
+ */
+export declare function assembleSciArticleMarkdown(sections: string[]): string;
+export declare function runCreateSciArticle(options?: CreateSciArticleOptions): Promise<void>;
+//# sourceMappingURL=article-create.d.ts.map

package/cli/dist/modules/sci/commands/article-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article-create.d.ts","sourceRoot":"","sources":["../../../../src/modules/sci/commands/article-create.ts"],"names":[],"mappings":"AAAA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EAOL,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AAqDzB,YAAY,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG9D,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAMD,sCAAsC;AACtC,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,gDAAgD;AAChD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D;AAOD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAWlC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS7D;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAKrE;AA0OD,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgGf"}