helixlife-expert-cli 0.1.0

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

@@ -0,0 +1,141 @@
+/**
+ * SCI Yellow 预检结果跨进程缓存
+ *
+ * 非交互 Agent 在 awaiting_precheck_choice 后带 --precheck-choice yes|no
+ * 续跑时，须复用首次预检的 level/content，对齐官网 PracticalPrecheck.onOk
+ * （选是/否后直接生成提纲，不二次预检）。
+ *
+ * 与 article-cache 同目录 helixlife-sci-cache/，前缀 precheck-。
+ */
+import { randomBytes } from "node:crypto";
+import { chmod, mkdir, readFile, rename, rm, writeFile, } from "node:fs/promises";
+import { join } from "node:path";
+import { getSciArticleCacheDir } from "./article-cache.js";
+const CACHE_FILE_PREFIX = "precheck-";
+const CACHE_FILE_EXT = ".json";
+/** 测试时可覆盖；默认与 article-cache 共用目录 */
+let CACHE_DIR_OVERRIDE = null;
+export function __setSciPrecheckCacheDirForTesting(dir) {
+    CACHE_DIR_OVERRIDE = dir;
+}
+function resolveCacheDir() {
+    return CACHE_DIR_OVERRIDE ?? getSciArticleCacheDir();
+}
+function sanitizeOrderId(orderId) {
+    return orderId.replace(/[^a-zA-Z0-9_.-]/g, "_");
+}
+export function resolveSciPrecheckCachePath(orderId) {
+    return join(resolveCacheDir(), `${CACHE_FILE_PREFIX}${sanitizeOrderId(orderId)}${CACHE_FILE_EXT}`);
+}
+async function ensureCacheDir() {
+    await mkdir(resolveCacheDir(), { recursive: true });
+}
+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 persistSciPrecheckCache(payload) {
+    if (!payload.orderId?.trim()) {
+        throw new Error("orderId 不能为空");
+    }
+    if (!payload.precheck) {
+        throw new Error("precheck 不能为空");
+    }
+    await ensureCacheDir();
+    const finalPath = resolveSciPrecheckCachePath(payload.orderId);
+    const nonce = randomBytes(6).toString("hex");
+    const tempPath = `${finalPath}.${nonce}.tmp`;
+    await writeFile(tempPath, JSON.stringify(payload), "utf8");
+    await atomicReplace(tempPath, finalPath);
+    await chmod(finalPath, 0o600);
+}
+/**
+ * 写入 Yellow 闸门预检缓存。失败仅 stderr 警告，不阻断主流程。
+ */
+export async function saveSciPrecheckCache(payload) {
+    try {
+        await persistSciPrecheckCache(payload);
+        return true;
+    }
+    catch (error) {
+        console.warn(`[sci-precheck-cache] 写入失败 orderId=${payload.orderId}: ${error.message}`);
+        return false;
+    }
+}
+function parseCachePayload(raw, orderId) {
+    try {
+        const entry = JSON.parse(raw);
+        if (!entry.precheck ||
+            typeof entry.methods !== "string" ||
+            typeof entry.results !== "string") {
+            return null;
+        }
+        return {
+            orderId: entry.orderId ?? orderId,
+            template: entry.template ?? "basic",
+            methods: entry.methods,
+            results: entry.results,
+            precheck: entry.precheck,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** 读取预检缓存；不存在 / 非法返回 null */
+export async function loadSciPrecheckCache(orderId) {
+    if (!orderId?.trim()) {
+        return null;
+    }
+    const path = resolveSciPrecheckCachePath(orderId);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    return parseCachePayload(raw, orderId);
+}
+/** 取走并删除预检缓存（提纲生成成功后调用） */
+export async function popSciPrecheckCache(orderId) {
+    if (!orderId?.trim()) {
+        return null;
+    }
+    const path = resolveSciPrecheckCachePath(orderId);
+    let raw;
+    try {
+        raw = await readFile(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+    await rm(path, { force: true }).catch(() => {
+        /* 删失败不影响主流程 */
+    });
+    return parseCachePayload(raw, orderId);
+}
+/** 仅删除缓存文件（retry 放弃续跑提纲时） */
+export async function deleteSciPrecheckCache(orderId) {
+    if (!orderId?.trim()) {
+        return;
+    }
+    const path = resolveSciPrecheckCachePath(orderId);
+    await rm(path, { force: true }).catch(() => {
+        /* ignore */
+    });
+}
+/** 供单元测试：当前缓存目录 */
+export function getSciPrecheckCacheDirForTesting() {
+    return resolveCacheDir();
+}
+//# sourceMappingURL=precheck-cache.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { type SciLanguage } from "./constants.js";
+export interface SciArticleSelection {
+    language: SciLanguage;
+}
+export interface SciArticleSelectionInput {
+    language?: string;
+}
+export declare function parseSciLanguage(raw?: string): SciLanguage;
+export declare function normalizeSciArticleSelection(options: SciArticleSelectionInput): SciArticleSelection;
+export declare function promptSciArticleSelection(options: SciArticleSelectionInput): Promise<SciArticleSelection>;
+export declare function resolveSciArticleSelection(options: SciArticleSelectionInput, interactive: boolean): Promise<SciArticleSelection>;
+//# sourceMappingURL=prompt-article.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-article.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/prompt-article.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAGD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,WAAW,CAK1D;AAGD,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,wBAAwB,GAChC,mBAAmB,CAIrB;AAGD,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,mBAAmB,CAAC,CAc9B;AAGD,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,OAAO,GACnB,OAAO,CAAC,mBAAmB,CAAC,CAO9B"}

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

@@ -0,0 +1,37 @@
+import { createInteractiveInterface, askOptionWithRl, parseEnumOption, } from "../../core/index.js";
+import { SCI_LANGUAGE_OPTIONS, } from "./constants.js";
+// 解析全文语言
+export function parseSciLanguage(raw) {
+    return parseEnumOption(raw, SCI_LANGUAGE_OPTIONS, {
+        label: "语言",
+        defaultValue: "中文",
+    });
+}
+// 非交互场景：按 CLI flags 归一化选型
+export function normalizeSciArticleSelection(options) {
+    return {
+        language: parseSciLanguage(options.language),
+    };
+}
+// 交互式选择语言
+export async function promptSciArticleSelection(options) {
+    const defaultLang = parseSciLanguage(options.language);
+    const rl = createInteractiveInterface();
+    try {
+        const language = await askOptionWithRl(rl, "输出语言", SCI_LANGUAGE_OPTIONS, defaultLang);
+        return { language };
+    }
+    finally {
+        rl.close();
+    }
+}
+// 统一入口：有 --language 参数则使用指定值，否则弹出选择器让用户选择
+export async function resolveSciArticleSelection(options, interactive) {
+    // 有 --language 参数：使用指定值，无需交互
+    if (options.language) {
+        return normalizeSciArticleSelection(options);
+    }
+    // 无 --language 参数：弹出选择器让用户选择（交互模式或 Agent 模式均如此）
+    return promptSciArticleSelection(options);
+}
+//# sourceMappingURL=prompt-article.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-article.js","sourceRoot":"","sources":["../../../src/modules/sci/prompt-article.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,GAErB,MAAM,gBAAgB,CAAC;AAYxB,SAAS;AACT,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,eAAe,CAAC,GAAG,EAAE,oBAAoB,EAAE;QAChD,KAAK,EAAE,IAAI;QACX,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;AACL,CAAC;AAED,0BAA0B;AAC1B,MAAM,UAAU,4BAA4B,CAC1C,OAAiC;IAEjC,OAAO;QACL,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,UAAU;AACV,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAiC;IAEjC,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,EAAE,GAAG,0BAA0B,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,EAAE,EACF,MAAM,EACN,oBAAoB,EACpB,WAAW,CACZ,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAiC,EACjC,WAAoB;IAEpB,6BAA6B;IAC7B,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,4BAA4B,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,gDAAgD;IAChD,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/cli/dist/modules/sci/prompt-precheck.d.ts

@@ -0,0 +1,16 @@
+import { type SciPrecheckChoice } from "./constants.js";
+export declare const PRECHECK_WARN_LABELS: Record<SciPrecheckChoice, string>;
+export declare const PRECHECK_WARN_DESCRIPTIONS: Record<SciPrecheckChoice, string>;
+export declare function listPrecheckWarnChoices(): Array<{
+    value: SciPrecheckChoice;
+    label: string;
+    description: string;
+}>;
+export declare function promptPrecheckChoice(): Promise<SciPrecheckChoice>;
+export declare function printPrecheckResult(params: {
+    level: string;
+    result: string;
+    content: string;
+    format: "markdown" | "json";
+}): void;
+//# sourceMappingURL=prompt-precheck.d.ts.map

package/cli/dist/modules/sci/prompt-precheck.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-precheck.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/prompt-precheck.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAGxB,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAIlE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAIxE,CAAC;AAEF,wBAAgB,uBAAuB,IAAI,KAAK,CAAC;IAC/C,KAAK,EAAE,iBAAiB,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAMD;AAGD,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAiBvE;AAGD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B,GAAG,IAAI,CAuBP"}

package/cli/dist/modules/sci/prompt-precheck.js

@@ -0,0 +1,61 @@
+// SCI 预检交互选择器：预检通过并选择（Yellow 级别）时的用户选择
+import { createInteractiveInterface, askOptionWithRl, } from "../../core/index.js";
+import { SCI_PRECHECK_CHOICE_OPTIONS, } from "./constants.js";
+// Yellow 级别时的三个选项（与 sci.md / 官网文案对齐，禁止改写）
+export const PRECHECK_WARN_LABELS = {
+    yes: "允许 AI 优化我的方法和结果",
+    no: "不希望 AI 修改我的方法和结果",
+    retry: "重新修改方法和结果",
+};
+export const PRECHECK_WARN_DESCRIPTIONS = {
+    yes: "AI 将参考优化建议，对方法和结果进行补充完善，并用于后续生成提纲和初稿",
+    no: "AI 将不修改方法和结果，仅基于您已输入的内容生成提纲和初稿",
+    retry: "请返回修改方法和结果，修改完成后再次提交预检",
+};
+export function listPrecheckWarnChoices() {
+    return SCI_PRECHECK_CHOICE_OPTIONS.map((value) => ({
+        value,
+        label: PRECHECK_WARN_LABELS[value],
+        description: PRECHECK_WARN_DESCRIPTIONS[value],
+    }));
+}
+// 交互式预检选择（Yellow 级别时）
+export async function promptPrecheckChoice() {
+    const rl = createInteractiveInterface();
+    try {
+        const choice = await askOptionWithRl(rl, "预检结果", SCI_PRECHECK_CHOICE_OPTIONS, "yes", (_value, index) => {
+            const opt = SCI_PRECHECK_CHOICE_OPTIONS[index];
+            return `${index + 1}) ${PRECHECK_WARN_LABELS[opt]} — ${PRECHECK_WARN_DESCRIPTIONS[opt]}`;
+        });
+        return choice;
+    }
+    finally {
+        rl.close();
+    }
+}
+// 打印预检结果的格式化输出
+export function printPrecheckResult(params) {
+    const log = (msg) => {
+        if (params.format === "json") {
+            process.stderr.write(msg + "\n");
+        }
+        else {
+            console.log(msg);
+        }
+    };
+    log("\n--- 预检结果 ---\n");
+    if (params.level === "Green") {
+        log("✅ 预检通过：无缺失信息，格式与内容审核通过");
+    }
+    else if (params.level === "Yellow") {
+        log("⚠️  预检成功（有优化建议）：有待补全或优化内容");
+    }
+    else {
+        log("❌ 预检失败：根据预检分析，当前内容不符合提交规范");
+    }
+    if (params.content) {
+        log("\n预检详情：\n");
+        log(params.content);
+    }
+}
+//# sourceMappingURL=prompt-precheck.js.map

package/cli/dist/modules/sci/prompt-precheck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-precheck.js","sourceRoot":"","sources":["../../../src/modules/sci/prompt-precheck.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,OAAO,EACL,0BAA0B,EAC1B,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,2BAA2B,GAE5B,MAAM,gBAAgB,CAAC;AAExB,0CAA0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAsC;IACrE,GAAG,EAAE,iBAAiB;IACtB,EAAE,EAAE,kBAAkB;IACtB,KAAK,EAAE,WAAW;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAsC;IAC3E,GAAG,EAAE,sCAAsC;IAC3C,EAAE,EAAE,gCAAgC;IACpC,KAAK,EAAE,wBAAwB;CAChC,CAAC;AAEF,MAAM,UAAU,uBAAuB;IAKrC,OAAO,2BAA2B,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACjD,KAAK;QACL,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC;QAClC,WAAW,EAAE,0BAA0B,CAAC,KAAK,CAAC;KAC/C,CAAC,CAAC,CAAC;AACN,CAAC;AAED,sBAAsB;AACtB,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,GAAG,0BAA0B,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,EAAE,EACF,MAAM,EACN,2BAA2B,EAC3B,KAAK,EACL,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAChB,MAAM,GAAG,GAAG,2BAA2B,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,GAAG,KAAK,GAAG,CAAC,KAAK,oBAAoB,CAAC,GAAG,CAAC,MAAM,0BAA0B,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3F,CAAC,CACF,CAAC;QACF,OAAO,MAA2B,CAAC;IACrC,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,eAAe;AACf,MAAM,UAAU,mBAAmB,CAAC,MAKnC;IACC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE;QAC1B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAExB,IAAI,MAAM,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;QAC7B,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,GAAG,CAAC,WAAW,CAAC,CAAC;QACjB,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/cli/dist/modules/sci/sse-utils.d.ts

@@ -0,0 +1,50 @@
+import { type OutputFormat } from "../../core/index.js";
+export interface SciStreamOptions {
+    path: string;
+    body: unknown;
+    format?: OutputFormat;
+    startLabel: string;
+    progressLabel: string;
+    finishLabel: string;
+    failureMessage: string;
+    emptyMessage: string;
+}
+export interface SciStreamResult {
+    text: string;
+    elapsedTime?: number;
+    workflowRunId?: string;
+    outputs?: Record<string, unknown>;
+}
+export interface SciPrecheckStreamResult {
+    text: string;
+    level: string;
+    result: string;
+    content: string;
+    elapsedTime?: number;
+    workflowRunId?: string;
+}
+export interface SciOutlineStreamResult {
+    text: string;
+    elapsedTime?: number;
+    workflowRunId?: string;
+}
+export declare function streamSseWorkflow(options: SciStreamOptions): Promise<SciStreamResult>;
+export declare function pickWorkflowOutputText(outputs: Record<string, unknown>): string;
+/**
+ * 对齐官网 Writing/Outline：`Object.values(outputs)[0]`
+ * 跳过 reference 字段，避免误取参考文献；再取第一个非空字符串。
+ * 若短字段抢先于长正文，再回退取最长非 reference 字符串。
+ */
+export declare function pickWebsiteWorkflowOutputText(outputs: Record<string, unknown>): string;
+/**
+ * 对齐官网 Outline.tsx existing：
+ * `outline || Object.values(outputs)[0]`
+ * existing 正文 outputs 常含 { outline, methods, results }；必须优先 outline，
+ * 否则会把较短的 methods/results 当成提纲（结构不符、内容偏少）。
+ */
+export declare function pickSciExistingOutlineOutput(outputs: Record<string, unknown>): string;
+export declare function extractFallbackTextFromOutputs(outputs: Record<string, unknown>[], existingChunks: string[]): string[];
+export declare function extractSciPrecheckResult(outputs: Record<string, unknown> | undefined): SciPrecheckStreamResult;
+export declare function formatElapsedHint(elapsedTime?: number): string;
+export { extractReferences } from "../../core/index.js";
+//# sourceMappingURL=sse-utils.d.ts.map

package/cli/dist/modules/sci/sse-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-utils.d.ts","sourceRoot":"","sources":["../../../src/modules/sci/sse-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAI7B,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAGD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAGD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAGD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAiG1B;AAID,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAiCR;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAgCR;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAUR;AA+BD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAcV;AAGD,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,uBAAuB,CAQzB;AAGD,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAGD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/cli/dist/modules/sci/sse-utils.js

@@ -0,0 +1,207 @@
+// SCI SSE 流式请求工具：预检与提纲生成共用增量打印、进度心跳与结束态收集逻辑
+import { ApiClient, helixlifeError, helixlifeErrorCode, createStderrProgress, createFormatLogger, extractSseText, assertWorkflowSucceeded, } from "../../core/index.js";
+// 通用 SSE workflow 流式请求
+export async function streamSseWorkflow(options) {
+    const client = new ApiClient();
+    const chunks = [];
+    let receivedLength = 0;
+    let overrideText;
+    let succeeded = false;
+    let elapsedTime;
+    let workflowRunId;
+    let finishedOutputs;
+    let streamedAny = false;
+    const streamToStdout = options.format !== "json";
+    const log = createFormatLogger(options.format ?? "markdown");
+    if (streamToStdout) {
+        console.log(`${options.startLabel}\n`);
+    }
+    else {
+        process.stderr.write(`\n${options.startLabel}\n`);
+    }
+    const progress = createStderrProgress(!streamToStdout);
+    progress.start(options.progressLabel);
+    try {
+        await client.requestSse(options.path, { method: "POST", body: options.body }, (payload) => {
+            assertWorkflowSucceeded(payload, options.failureMessage, [
+                "workflow_finished",
+            ]);
+            const chunk = extractSseText(payload, { nested: true });
+            if (chunk) {
+                chunks.push(chunk);
+                receivedLength += chunk.length;
+                progress.update(receivedLength);
+                if (streamToStdout) {
+                    process.stdout.write(chunk);
+                    streamedAny = true;
+                }
+            }
+            if (payload.event === "workflow_finished") {
+                const data = payload.data;
+                if (typeof data === "object" && data !== null) {
+                    const record = data;
+                    if (record.status === "succeeded") {
+                        succeeded = true;
+                    }
+                    if (typeof record.elapsed_time === "number") {
+                        elapsedTime = record.elapsed_time;
+                    }
+                    const outputs = record.outputs;
+                    if (typeof outputs === "object" && outputs !== null) {
+                        finishedOutputs = outputs;
+                        const finishedText = pickWorkflowOutputText(finishedOutputs);
+                        if (finishedText) {
+                            overrideText = finishedText;
+                            if (streamToStdout && !streamedAny) {
+                                process.stdout.write(`${finishedText}\n`);
+                                streamedAny = true;
+                            }
+                        }
+                    }
+                }
+                if (typeof payload.workflow_run_id === "string") {
+                    workflowRunId = payload.workflow_run_id;
+                }
+            }
+        });
+    }
+    catch (error) {
+        progress.dispose();
+        throw error;
+    }
+    progress.finish(options.finishLabel);
+    const text = overrideText ?? chunks.join("");
+    if (!text) {
+        // 提纲生成接口返回空，可能是后端问题或超时
+        throw new helixlifeError(helixlifeErrorCode.INVALID_RESPONSE, `${options.emptyMessage}（后端可能未返回有效输出内容，或接口响应超时）`);
+    }
+    if (!succeeded) {
+        throw new helixlifeError(helixlifeErrorCode.REQUEST_FAILED, options.failureMessage);
+    }
+    return { text, elapsedTime, workflowRunId, outputs: finishedOutputs };
+}
+// 从 workflow outputs 提取正文（核心逻辑）
+// 支持多种字段名称和嵌套结构
+export function pickWorkflowOutputText(outputs) {
+    // 字段优先级：result > text > output > content > answer
+    const prioritizedFields = ["result", "text", "output", "content", "answer"];
+    for (const field of prioritizedFields) {
+        if (typeof outputs[field] === "string" &&
+            outputs[field].trim()) {
+            return outputs[field];
+        }
+    }
+    // 递归查找嵌套对象
+    const nestedResult = pickWorkflowOutputTextRecursive(outputs, 0, 3);
+    if (nestedResult) {
+        return nestedResult;
+    }
+    // 收集所有字符串字段（排除 reference 相关的）
+    const stringParts = Object.entries(outputs)
+        .filter(([key, value]) => key.toLowerCase().indexOf("reference") === -1 &&
+        typeof value === "string" &&
+        value.trim())
+        .map(([, value]) => value);
+    if (stringParts.length > 0) {
+        return stringParts.join("\n\n");
+    }
+    return "";
+}
+/**
+ * 对齐官网 Writing/Outline：`Object.values(outputs)[0]`
+ * 跳过 reference 字段，避免误取参考文献；再取第一个非空字符串。
+ * 若短字段抢先于长正文，再回退取最长非 reference 字符串。
+ */
+export function pickWebsiteWorkflowOutputText(outputs) {
+    const stringEntries = Object.entries(outputs).filter(([key, value]) => !key.toLowerCase().includes("reference") &&
+        typeof value === "string" &&
+        value.trim());
+    if (stringEntries.length === 0) {
+        for (const value of Object.values(outputs)) {
+            if (typeof value === "string" && value.trim()) {
+                return value;
+            }
+        }
+        return "";
+    }
+    const first = stringEntries[0][1];
+    let longest = first;
+    for (const [, value] of stringEntries) {
+        if (value.length > longest.length) {
+            longest = value;
+        }
+    }
+    // 若首字段明显短于最长字段（如短 result vs 长 text），取最长
+    if (longest.length > first.length * 2 &&
+        longest.length - first.length > 500) {
+        return longest;
+    }
+    return first;
+}
+/**
+ * 对齐官网 Outline.tsx existing：
+ * `outline || Object.values(outputs)[0]`
+ * existing 正文 outputs 常含 { outline, methods, results }；必须优先 outline，
+ * 否则会把较短的 methods/results 当成提纲（结构不符、内容偏少）。
+ */
+export function pickSciExistingOutlineOutput(outputs) {
+    if (typeof outputs.outline === "string" && outputs.outline.trim()) {
+        return outputs.outline.trim();
+    }
+    for (const value of Object.values(outputs)) {
+        if (typeof value === "string" && value.trim()) {
+            return value.trim();
+        }
+    }
+    return "";
+}
+function pickWorkflowOutputTextRecursive(obj, depth, maxDepth) {
+    if (depth > maxDepth) {
+        return "";
+    }
+    for (const value of Object.values(obj)) {
+        if (typeof value === "string" && value.trim()) {
+            return value;
+        }
+        if (typeof value === "object" && value !== null) {
+            const result = pickWorkflowOutputTextRecursive(value, depth + 1, maxDepth);
+            if (result) {
+                return result;
+            }
+        }
+    }
+    return "";
+}
+// 从 outputs 中提取正文作为 fallback（当 chunks 为空时使用）
+export function extractFallbackTextFromOutputs(outputs, existingChunks) {
+    if (existingChunks.join("").trim()) {
+        return existingChunks;
+    }
+    const fallback = [];
+    for (const out of outputs) {
+        const values = Object.values(out);
+        for (const value of values) {
+            if (typeof value === "string" && value.trim()) {
+                fallback.push(value);
+            }
+        }
+    }
+    return fallback;
+}
+// 从 SSE payload 中提取 SCI 预检结果
+export function extractSciPrecheckResult(outputs) {
+    const out = outputs ?? {};
+    return {
+        text: pickWorkflowOutputText(out),
+        level: String(out.level ?? ""),
+        result: String(out.result ?? "failed"),
+        content: String(out.content ?? ""),
+    };
+}
+// 生成结果耗时提示文案
+export function formatElapsedHint(elapsedTime) {
+    return elapsedTime !== undefined ? `，耗时 ${elapsedTime.toFixed(1)} 秒` : "";
+}
+// 从 workflow outputs 提取参考文献列表
+export { extractReferences } from "../../core/index.js";
+//# sourceMappingURL=sse-utils.js.map

package/cli/dist/modules/sci/sse-utils.js.map

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

package/cli/dist/modules/shared/result-wrapper.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Workbench 统一结果包装器
+ *
+ * 设计目标：
+ * 1. 对外 JSON 输出（--format=json）统一包装为 WorkbenchResult，不暴露内部 ID
+ * 2. Markdown 输出（--format=markdown）由各命令自行控制展示内容（无包装）
+ * 3. 禁止在非 JSON 模式下向用户暴露 orderId/workflowRunId/runnerId/nodeId
+ *
+ * 使用方式：
+ *   import { wrapWorkbenchResult } from "../../shared/result-wrapper.js";
+ *   const wrapped = wrapWorkbenchResult(result, { step: "outline", subType: "jova" });
+ *   printOutput(wrapped, "json");
+ *
+ * 包装后的 JSON 结构：
+ * {
+ *   "_meta": { "step": "...", "subType": "...", "timestamp": "..." },
+ *   "_handoff": { "orderId": "...", "workflowRunId": "...", "cacheReady": true },  // 可选，仅供 Agent 内存串联
+ *   "data": { ...业务结果字段（已剔除禁止对外的内部 ID） }
+ * }
+ */
+/** 对外 JSON 输出禁止出现的内部 ID 字段 */
+export declare const FORBIDDEN_FIELDS: readonly ["orderId", "sessionId", "workflowRunId", "runnerId", "nodeId", "order", "data", "success", "message"];
+export type ForbiddenField = (typeof FORBIDDEN_FIELDS)[number];
+export interface WorkbenchResultMeta {
+    step: string;
+    subType?: string;
+    timestamp: string;
+}
+export interface WorkbenchResultHandoff {
+    orderId?: string;
+    /** CLI 本地流程缓存键，不对应后端订单 */
+    sessionId?: string;
+    workflowRunId?: string;
+    /** 步骤② 全文是否已成功写入系统临时目录缓存（供 Agent 步骤③ 前自检） */
+    cacheReady?: boolean;
+    /** 基金 Step1：blank（无假说）| existing（已有假说） */
+    hasHypothesis?: string;
+    /** 基金 Step1→Step2 子路径：background_genes | hypothesis_pick | research_path */
+    nextSubStep?: string;
+    /** 基金：blank 时为 "-none-hypothesis"，existing 时为空串 */
+    outlineAppSuffix?: string;
+    /** 基金 Step2：路径 1/2 pick 后可进提纲；路径 3 analyze 时缺失信息是否为空 */
+    readyForOutline?: boolean;
+    missingInfoEmpty?: boolean;
+    /** 基金 Step3：提纲已确认，可进全文 */
+    readyForArticle?: boolean;
+    /** 课题方案基础研究：newidea 任务记录 ID，供 result 轮询串联 */
+    runRecordId?: string;
+}
+export interface WorkbenchResult<T> {
+    _meta: WorkbenchResultMeta;
+    _handoff?: WorkbenchResultHandoff;
+    data: Omit<T, ForbiddenField>;
+}
+/**
+ * 统一包装 workbench 命令结果
+ *
+ * @param result   业务结果对象（各命令的 result 类型）
+ * @param meta     元信息：step（如 "outline" | "article"），subType（如 "jova" | "sci" | "meta"）
+ * @param handoff  可选：Agent 串联用的内部 ID（不出现在 data，禁止展示给用户）
+ */
+export declare function wrapWorkbenchResult<T extends object>(result: T, meta: {
+    step: string;
+    subType?: string;
+}, handoff?: WorkbenchResultHandoff): WorkbenchResult<T>;
+/**
+ * 统一包装 workbench 命令结果（无 meta，仅做字段清理）
+ * 用于不需要 step/subType 信息的简单包装场景
+ */
+export declare function sanitizeWorkbenchResult<T extends object>(result: T): Omit<T, ForbiddenField>;
+//# sourceMappingURL=result-wrapper.d.ts.map

package/cli/dist/modules/shared/result-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-wrapper.d.ts","sourceRoot":"","sources":["../../../src/modules/shared/result-wrapper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,8BAA8B;AAC9B,eAAO,MAAM,gBAAgB,iHAUnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0BAA0B;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,CAAC,EAAE,sBAAsB,CAAC;IAClC,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;CAC/B;AA4BD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,eAAe,CAAC,CAAC,CAAC,CA0BpB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,MAAM,EAAE,CAAC,GACR,IAAI,CAAC,CAAC,EAAE,cAAc,CAAC,CAEzB"}