scientify 2.1.0 → 3.1.0

package/dist/src/release-gate.js

@@ -0,0 +1,124 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+function isReleaseVerdict(value) {
+    return value === "HOLD" || value === "CONDITIONAL_GO" || value === "GO";
+}
+function normalizeStringArray(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string" && item.length > 0)
+        : [];
+}
+function defaultReleaseGateInputs(workspace) {
+    const candidates = [
+        "paper/draft.md",
+        "paper/claim_inventory.md",
+        "paper/figures_manifest.md",
+        "paper/manuscript.tex",
+        "README.md",
+        "docs/index.html",
+    ];
+    return candidates.filter((relativePath) => fs.existsSync(path.join(workspace, relativePath)));
+}
+function resolveWorkspacePath(workspace, candidate) {
+    return path.isAbsolute(candidate) ? candidate : path.join(workspace, candidate);
+}
+export function hasReleaseFacingArtifacts(workspace) {
+    return defaultReleaseGateInputs(workspace).length > 0;
+}
+export function readReleaseGateStatus(workspace) {
+    const gatePath = path.join(workspace, "review", "release_gate.json");
+    if (!fs.existsSync(gatePath)) {
+        return {
+            state: "missing",
+            gatePath,
+            checkedFiles: [],
+            staleReasons: [],
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(gatePath, "utf-8"));
+    }
+    catch {
+        return {
+            state: "invalid",
+            gatePath,
+            checkedFiles: [],
+            staleReasons: ["release_gate.json is not valid JSON"],
+        };
+    }
+    if (!isReleaseVerdict(parsed.release_verdict)) {
+        return {
+            state: "invalid",
+            gatePath,
+            checkedFiles: [],
+            staleReasons: ["release_gate.json is missing a valid release_verdict"],
+        };
+    }
+    const checkedFiles = normalizeStringArray(parsed.checked_files);
+    const freshnessInputs = normalizeStringArray(parsed.stale_if_any_newer_than);
+    const trackedInputs = freshnessInputs.length > 0
+        ? freshnessInputs
+        : checkedFiles.length > 0
+            ? checkedFiles
+            : defaultReleaseGateInputs(workspace);
+    const gateMtimeMs = fs.statSync(gatePath).mtimeMs;
+    const staleReasons = [];
+    for (const candidate of trackedInputs) {
+        const candidatePath = resolveWorkspacePath(workspace, candidate);
+        const displayPath = path.isAbsolute(candidate) ? candidate : candidate;
+        if (!fs.existsSync(candidatePath)) {
+            staleReasons.push(`${displayPath} is missing`);
+            continue;
+        }
+        if (fs.statSync(candidatePath).mtimeMs > gateMtimeMs) {
+            staleReasons.push(`${displayPath} changed after the last gate`);
+        }
+    }
+    return {
+        state: staleReasons.length > 0 ? "stale" : "fresh",
+        verdict: parsed.release_verdict,
+        gatePath,
+        checkedFiles,
+        staleReasons,
+        generatedAt: parsed.generated_at,
+    };
+}
+export function formatReleaseGateStatus(status) {
+    switch (status.state) {
+        case "missing":
+            return "not run";
+        case "invalid":
+            return "invalid";
+        case "stale":
+            return status.verdict ? `${status.verdict} (stale)` : "stale";
+        case "fresh":
+            return status.verdict ? `${status.verdict} (fresh)` : "fresh";
+        default:
+            return status.state;
+    }
+}
+export function getReleaseGateNextStep(workspace, status) {
+    if (!hasReleaseFacingArtifacts(workspace) && status.state === "missing") {
+        return null;
+    }
+    switch (status.state) {
+        case "missing":
+            return "Run `/artifact-review` before sharing the current paper, figures, or release page.";
+        case "invalid":
+            return "Rerun `/artifact-review` to regenerate a valid `review/release_gate.json`.";
+        case "stale":
+            return "Rerun `/artifact-review` because one or more reviewed artifacts changed after the last gate.";
+        case "fresh":
+            if (status.verdict === "HOLD") {
+                return "Fix the blocking findings in `review/artifact_review.md`, then rerun `/artifact-review`.";
+            }
+            if (status.verdict === "CONDITIONAL_GO") {
+                return "Resolve the remaining P1 findings or explicitly accept a conditional release before sharing.";
+            }
+            return "Release gate is fresh. You can proceed to `/release-layout` or share the reviewed artifacts.";
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=release-gate.js.map

package/dist/src/release-gate.js.map

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

package/dist/src/templates/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/templates/bootstrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA6C7D;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAexD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAqFvC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../../src/templates/bootstrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CA4D7D;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAaxD;AAED,wBAAgB,cAAc,IAAI,MAAM,CAuIvC"}

package/dist/src/templates/bootstrap.js

@@ -5,63 +5,76 @@
 export function renderBootstrapMd(projectName) {
     return `# Research Agent Bootstrap
 
-你刚刚被创建为课题「${projectName}」的研究 agent。你需要完成首次配置。
-
-## 引导流程
-
-1. 向用户问好，说明你是课题「${projectName}」的研究 agent，请用户描述研究方向
-2. 根据用户回答，提取：
-   - 核心域关键词（3-5 个）
-   - 建议的 arXiv 分类（如 cs.LG, cs.AI）
-   - 建议的监测带相邻领域分类
-3. 向用户确认以上配置，接受调整
-4. 确认后执行以下写入操作：
-   - 更新 SOUL.md：填写研究方向、核心域、监测带各字段
-   - 生成 metabolism/config.json（参考下方模板）
-5. 询问用户是否立即执行 Day 0（构建初始知识状态 K(T0)）
-   - 如果是，使用 arxiv_search 按配置的关键词检索论文，执行 skills/metabolism/SKILL.md 中的四步循环
-6. 删除本文件（BOOTSTRAP.md）
-
-## config.json 模板
+You were just created as the research agent for project "${projectName}". Complete the initial setup before starting downstream work.
+
+## Bootstrap Flow
+
+1. Greet the user, explain that you are the research agent for project "${projectName}", and ask them to describe the research direction.
+2. Based on the user's answer, extract:
+   - core-domain keywords (3-5)
+   - suggested arXiv categories (for example "cs.LG", "cs.AI"); leave empty if the topic is outside arXiv coverage
+   - preferred literature sources ("arxiv", "openalex", or both)
+3. Discuss scope and priorities with the user, confirm the configuration, and accept adjustments.
+4. Once confirmed, write the following files:
+   - update SOUL.md with the project direction and domain fields
+   - generate config.json using the template below
+5. Ask whether the user wants to run Day 0 immediately to build the initial knowledge state.
+   - If yes, run /metabolism to perform the first literature retrieval and knowledge-base construction pass.
+6. If the project already has partial outputs, use the shortest matching path instead of restarting from Day 0:
+   - existing papers/ -> /research-survey
+   - existing survey_res.md, but route still undecided -> /algorithm-selection
+   - existing survey_res.md -> /research-plan
+   - existing plan_res.md, but data quality still needs review -> /dataset-validate
+   - existing plan_res.md, and matched baseline evidence is needed -> /baseline-runner
+   - existing implementation code -> /research-review
+   - existing review PASS -> /research-experiment
+   - existing experiment_res.md plus figures -> /write-paper
+   - existing paper/draft.md -> /artifact-review
+   - existing figures with inconsistent captions or style -> /figure-standardize
+   - preparing README.md or release-facing docs -> /release-layout after a fresh release gate exists
+7. After the initial setup, tell the user the recommended next command and expected output files, then delete this file (BOOTSTRAP.md).
+
+## Common Entry Paths
+
+- I only have a research direction and no materials yet -> finish setup, then run /metabolism
+- I already have a batch of papers -> run /research-survey
+- I finished the survey but have not chosen a model route -> run /algorithm-selection
+- I already have a plan and want to validate the data first -> run /dataset-validate
+- I already have a plan and want honest baseline numbers first -> run /baseline-runner
+- I already have implementation code -> run /research-review
+- I already have experiment results and figures -> run /write-paper
+- I already have a draft that needs review -> run /artifact-review
+
+## config.json Template
 
 \`\`\`json
 {
   "projectId": "${projectName}",
-  "coreQuery": {
-    "keywords": ["关键词1", "关键词2"],
-    "arxivCategories": ["cs.LG"],
-    "dateMode": "daily-new"
-  },
-  "monitorZone": {
-    "categories": ["相邻领域分类"],
-    "enabled": true
-  },
-  "heartbeat": {
-    "cronExpression": "0 6 * * *",
-    "timezone": "Asia/Shanghai",
-    "enabled": true
-  },
-  "agentId": "research-${projectName}",
+  "keywords": ["keyword-1", "keyword-2"],
+  "arxivCategories": ["cs.LG"],
+  "sources": ["arxiv", "openalex"],
   "currentDay": 0,
+  "processed_ids": [],
   "createdAt": "${new Date().toISOString()}"
 }
 \`\`\`
+
+> **Note:** Configure \`arxivCategories\` and \`sources\` based on the research domain.
+> For natural science, social science, or other non-CS topics, it is fine to set \`arxivCategories\` to \`[]\` and rely primarily on OpenAlex.
 `;
 }
 export function renderSoulMd(projectName) {
     return `# Project Agent — ${projectName}
 
-你是课题「${projectName}」的研究 agent。
-
-## 研究方向
-{由 BOOTSTRAP 流程填写}
+You are the research agent for project "${projectName}".
 
-## 核心域
-关键词: {由 BOOTSTRAP 流程填写}
-arXiv 分类: {由 BOOTSTRAP 流程填写}
+## Research Direction
+{Filled during the BOOTSTRAP flow}
 
-## 监测带
-相邻领域: {由 BOOTSTRAP 流程填写}
+## Core Domain
+Keywords: {Filled during the BOOTSTRAP flow}
+arXiv Categories: {Filled during the BOOTSTRAP flow; leave empty if not applicable}
+Literature Sources: {arXiv / OpenAlex / both}
 `;
 }
 export function renderAgentsMd() {
@@ -69,85 +82,135 @@ export function renderAgentsMd() {
 
 ## Workspace Layout
 
-本 agent 的工作目录即为项目根目录（\`$W\`）。所有文件相对于 \`$W\` 组织：
+The agent workspace root is the project root (\`$W\`). All files are organized relative to \`$W\`:
 
 \`\`\`
 $W/
-├── SOUL.md                      # 身份 + 研究方向
-├── AGENTS.md                    # 本文档
-├── metabolism/                  # 知识新陈代谢
-│   ├── config.json              # 项目配置（关键词、分类、heartbeat）
-│   ├── knowledge/               # K(t) 持久知识状态
-│   │   ├── _index.md            # 全景索引
-│   │   └── topic-*.md           # 主题文件（上限 50）
-│   ├── diffs/                   # 每日 diff 报告
-│   ├── hypotheses/              # 生成的假设
-│   └── log/                     # 运行日志
-├── survey/                      # /research-collect outputs
-│   ├── search_terms.json
-│   └── report.md
-├── papers/                      # 下载的论文
-│   ├── _downloads/              # 原始下载
-│   ├── _meta/                   # 元数据 {arxiv_id}.json
-│   └── {direction}/             # 按方向分类
-├── repos/                       # 参考代码仓库
-├── notes/                       # /research-survey: 逐篇深度笔记
-│   └── paper_{arxiv_id}.md
-├── ideas/                       # /idea-generation outputs
-├── review/                      # /write-review-paper outputs
-├── survey_res.md                # /research-survey: 方法对比报告
-├── plan_res.md                  # /research-plan: 实现计划
-├── project/                     # /research-implement: 代码实现
-├── ml_res.md                    # /research-implement: 执行报告
-├── iterations/                  # /research-review: 审查迭代
-│   └── judge_v*.md
-├── experiment_res.md            # /research-experiment: 实验报告
-└── skills/                      # workspace skills (metabolism 等)
+├── SOUL.md                      # identity and project direction
+├── AGENTS.md                    # this document
+├── config.json                  # project config (keywords, categories, current day)
+├── progress_status.json         # agent-defined task progress for the current goal
+│
+├── papers/                      # literature artifacts
+│   ├── {arxiv_id}/              # arXiv source files
+│   └── {doi_slug}.pdf           # PDF files
+│
+├── knowledge/                   # persistent knowledge state
+│   ├── _index.md                # global index
+│   └── topic-*.md               # topic files (limit 50)
+│
+├── ideas/                       # hypotheses and research ideas
+│   ├── hyp-*.md                 # generated hypotheses
+│   └── selected_idea.md         # selected research idea
+│
+├── experiments/                 # experiment code and assets
+│   ├── run.py                   # entry script
+│   ├── requirements.txt
+│   └── results/                 # experiment outputs
+│
+├── review/                      # review, audit, and writing outputs
+├── paper/                       # experiment-driven paper outputs
+│   ├── manuscript.tex           # top-level LaTeX entry
+│   ├── build_paper.sh           # PDF build script
+│   ├── references.bib           # bibliography placeholder
+│   ├── sections/                # section-by-section TeX drafts
+│   ├── figures/                 # paper-local figures
+│   ├── assets/                  # supporting assets for paper generation
+│   └── build/                   # PDF, logs, and build errors
+│
+├── log/                         # run logs
+│   └── {YYYY-MM-DD}.md
+│
+└── skills/                      # workspace skills
 \`\`\`
 
 ## Session Context
 
-你可能在不同类型的 session 中被唤醒：
-- **Main session**：与人类直接对话，可触发 research-pipeline 等编排 skill
-- **Cron session**：定时触发，执行周期性任务（如每日 metabolism）
-- **Spawn session**：被 main session 调度（sessions_spawn），执行一次性重任务
+You may be activated in different session types:
+- **Main session**: direct interaction with a human; can trigger orchestration skills such as \`research-pipeline\`
+- **Cron session**: scheduled execution for recurring work such as daily metabolism
+- **Spawn session**: dispatched by the main session (\`sessions_spawn\`) for one-off heavy tasks
 
-任务指令会在 session 启动时注入，按指令执行即可。
+Task instructions are injected when the session starts. Follow the injected instructions for that session.
 
 ## Conventions
 
 ### File Existence = Step Completion
-检查产出文件是否存在再执行。已存在则跳过。支持崩溃恢复和增量推进。
+Check whether the output file already exists before running a step. If it exists, skip it. This enables crash recovery and incremental progress.
 
 ### Immutability
-产出文件一旦写入不修改，除非用户明确要求。例外：\`project/\` 在 implement-review 迭代中可变。
+Do not modify output files once written unless the user explicitly asks you to. Exception: \`project/\` may change during implement-review iteration.
+
+### Progress Tracking
+- Do not assume every project follows the same fixed stages.
+- Define progress in \`progress_status.json\` based on the user's current goal.
+- Update \`progress_status.json\` whenever the total task, current focus, subtask states, or next step changes.
+- Recommended fields: \`overall_goal\`, \`current_focus\`, \`next_step\`, \`completed_tasks\`, \`total_tasks\`, \`subtasks\`.
 
 ### Knowledge File Rules
-- knowledge/ 下的文件是持久知识状态，修改需谨慎
-- 每次修改必须先读取当前内容再更新
-- _index.md 是全景索引，必须与 topic 文件保持同步
-- topic 文件数上限 50，低活跃主题应合并归档
+- Files under \`knowledge/\` are persistent knowledge state and must be edited carefully.
+- Always read the current file before updating it.
+- \`_index.md\` is the global index and must stay in sync with the topic files.
+- Limit topic files to 50. Merge or archive low-activity topics when needed.
 
 ## Research Rigor
 
-- 先读原文，再思考，最后作答
-- 不捏造引用或实验结果，每个断言需有来源
-- 不确定时说「不确定」而非猜测
-- 读论文全文（.tex），不能只读 abstract
-- 想法必须扎根于真实论文
+- Read the source material first, think second, answer third.
+- Do not fabricate citations or experiment results. Every claim needs a source.
+- Say "uncertain" when uncertain instead of guessing.
+- Read the full paper source (\`.tex\`) when available; do not rely on the abstract alone.
+- Ground ideas in real papers rather than unsupported intuition.
 
 ## Skill Outputs Summary
 
 | Skill | Primary Outputs |
 |-------|-----------------|
-| /research-collect | survey/, papers/ |
-| /research-survey | notes/paper_*.md, survey_res.md |
+| /metabolism | Day 0: config.json, knowledge/ / Day 1+: papers/, knowledge/, ideas/hyp-*.md, log/ |
+| /research-collect | papers/ |
+| /research-survey | knowledge/, survey_res.md |
+| /algorithm-selection | selection_res.md |
 | /research-plan | plan_res.md |
-| /research-implement | project/, ml_res.md |
-| /research-review | iterations/judge_v*.md |
-| /research-experiment | experiment_res.md |
+| /dataset-validate | data_validation.md |
+| /baseline-runner | baseline_res.md, experiments/baselines/ |
+| /research-implement | experiments/ |
+| /research-review | experiments/review/ |
+| /research-experiment | experiments/results/, experiment_res.md |
 | /idea-generation | ideas/ |
 | /write-review-paper | review/ |
+| /write-paper | paper/claim_inventory.md, paper/figures_manifest.md, paper/draft.md, paper/manuscript.tex, paper/build/manuscript.pdf |
+| /artifact-review | review/artifact_review.md, review/release_checklist.md, review/release_gate.json |
+| /figure-standardize | reports/figures/figure_spec.md or project/figures/figure_spec.md |
+| /release-layout | README.md, docs/index.html, release-facing pages |
+
+## Common ML Midstream Paths
+
+- Survey exists but route choice is still unclear:
+  - run \`/algorithm-selection\`
+  - expected output: \`selection_res.md\`
+- Plan exists and the project needs a dedicated data-quality check:
+  - run \`/dataset-validate\`
+  - expected output: \`data_validation.md\`
+- Plan exists and the project needs honest comparison numbers:
+  - run \`/baseline-runner\`
+  - expected outputs: \`baseline_res.md\`, optional baseline artifacts under \`experiments/baselines/\`
+
+## Writing and Release Entry Points
+
+Use these entry points when the project already has partial outputs and does not need to restart the full research pipeline:
+
+- If you already have \`experiment_res.md\` and one or more result figures:
+  - run \`/write-paper\`
+  - expected outputs: \`paper/claim_inventory.md\`, \`paper/figures_manifest.md\`, \`paper/draft.md\`, \`paper/manuscript.tex\`, \`paper/build/manuscript.pdf\`
+- If you already have \`paper/draft.md\` or another draft artifact that is about to be shared:
+  - run \`/artifact-review\`
+  - expected outputs: \`review/artifact_review.md\`, \`review/release_checklist.md\`, \`review/release_gate.json\`
+- If you already have figures but their style, captioning, units, or evidence labels are inconsistent:
+  - run \`/figure-standardize\`
+  - expected outputs: figure specs, caption updates, and standardized release-facing figures
+- If you are preparing a \`README.md\` or release-facing page for sharing:
+  - run \`/release-layout\`
+  - expected outputs: README updates, docs landing-page updates, and clearer release entry surfaces
+  - do this only after \`/artifact-review\` has produced a fresh release gate for the current artifacts
 `;
 }
 //# sourceMappingURL=bootstrap.js.map

package/dist/src/templates/bootstrap.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/templates/bootstrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO;;YAEG,WAAW;;;;kBAIL,WAAW;;;;;;;;;;;;;;;;;kBAiBX,WAAW;;;;;;;;;;;;;;;yBAeJ,WAAW;;kBAElB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;CAGzC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,qBAAqB,WAAW;;OAElC,WAAW;;;;;;;;;;;CAWjB,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmFR,CAAC;AACF,CAAC"}
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../src/templates/bootstrap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO;;2DAEkD,WAAW;;;;0EAII,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwCnE,WAAW;;;;;;kBAMX,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;;;;;CAMzC,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,qBAAqB,WAAW;;0CAEC,WAAW;;;;;;;;;CASpD,CAAC;AACF,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqIR,CAAC;AACF,CAAC"}

package/dist/src/types.d.ts

@@ -1,16 +1,8 @@
 /**
  * Re-export SDK types and derive types not directly exported.
- *
- * OpenClaw plugin-entry exports OpenClawPluginApi, PluginCommandContext,
- * PluginLogger, etc. — but not PluginRuntime, PluginCommandResult, or
- * RunCommandResult. We derive those from the exported interfaces.
  */
-import type { OpenClawPluginApi, PluginCommandContext, PluginLogger, OpenClawPluginCommandDefinition } from "openclaw/plugin-sdk/plugin-entry";
-export type { OpenClawPluginApi, PluginCommandContext, PluginLogger, OpenClawPluginCommandDefinition, };
-/** Derived from OpenClawPluginApi["runtime"] */
-export type PluginRuntime = OpenClawPluginApi["runtime"];
+import type { OpenClawPluginApi, PluginCommandContext, OpenClawPluginCommandDefinition } from "openclaw/plugin-sdk/plugin-entry";
+export type { OpenClawPluginApi, PluginCommandContext };
 /** Derived from the return type of command handlers */
 export type PluginCommandResult = Awaited<ReturnType<OpenClawPluginCommandDefinition["handler"]>>;
-/** Derived from runtime.system.runCommandWithTimeout return type */
-export type RunCommandResult = Awaited<ReturnType<PluginRuntime["system"]["runCommandWithTimeout"]>>;
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,+BAA+B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,YAAY,EACZ,+BAA+B,GAChC,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;AAEzD,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CACvD,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,gBAAgB,GAAG,OAAO,CACpC,UAAU,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAC7D,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACpB,+BAA+B,EAChC,MAAM,kCAAkC,CAAC;AAE1C,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,CAAC;AAExD,uDAAuD;AACvD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,UAAU,CAAC,+BAA+B,CAAC,SAAS,CAAC,CAAC,CACvD,CAAC"}

package/openclaw.plugin.json

@@ -1,25 +1,16 @@
 {
   "id": "scientify",
   "name": "Scientify",
-  "description": "AI-powered research workflow automation for OpenClaw",
+  "description": "Continuous AI research workflow for survey, planning, implementation, review, experimentation, and writing",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
-    "properties": {
-      "autoUpdate": {
-        "type": "boolean",
-        "default": true,
-        "description": "Automatically check and install updates (default: true)"
-      }
-    }
-  },
-  "uiHints": {
-    "autoUpdate": {
-      "label": "Auto Update",
-      "description": "Silently check for and install Scientify updates"
-    }
+    "properties": {}
   },
   "skills": [
+    "skills/algorithm-selection",
+    "skills/baseline-runner",
+    "skills/dataset-validate",
     "skills/idea-generation",
     "skills/research-pipeline",
     "skills/research-survey",
@@ -28,9 +19,12 @@
     "skills/research-review",
     "skills/research-experiment",
     "skills/research-collect",
+    "skills/paper-download",
     "skills/write-review-paper",
-    "skills/research-subscription",
-    "skills/metabolism",
-    "skills/metabolism-init"
+    "skills/write-paper",
+    "skills/artifact-review",
+    "skills/figure-standardize",
+    "skills/release-layout",
+    "skills/metabolism"
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scientify",
-  "version": "2.1.0",
+  "version": "3.1.0",
   "description": "Scientify - AI-powered research workflow automation for OpenClaw. Includes idea generation, literature review, research pipeline skills, and arxiv tool.",
   "type": "module",
   "main": "dist/index.js",
@@ -40,8 +40,7 @@
     "release": "npm version patch && git push && git push --tags"
   },
   "dependencies": {
-    "@sinclair/typebox": "^0.32.0",
-    "tar": "^7.0.0"
+    "@sinclair/typebox": "^0.32.0"
   },
   "devDependencies": {
     "@semantic-release/changelog": "^6.0.3",

package/skills/algorithm-selection/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: algorithm-selection
+description: "Use this when the user needs to choose between multiple ML routes after survey but before committing to implementation. Compares candidate approaches, selects one, records rejected routes, and keeps a fallback."
+metadata:
+  {
+    "openclaw":
+      {
+        "emoji": "🧭",
+      },
+  }
+---
+
+# Algorithm Selection
+
+**Don't ask permission. Just do it.**
+
+Use this skill after `/research-survey` when there are several plausible ML approaches and the project needs a deliberate route choice instead of jumping straight into implementation.
+
+Outputs go to the workspace root.
+
+## Use This When
+
+- `survey_res.md` already exists
+- there are at least 2 plausible methods or model families
+- the user wants a chosen route plus backups
+
+## Do Not Use This When
+
+- the project has no survey yet
+- the team already decided the model route and only needs implementation details
+
+## Required Inputs
+
+- `SOUL.md`
+- `survey_res.md`
+- `knowledge/paper_*.md` when available
+
+If `survey_res.md` is missing, stop and say: `Run /research-survey first to complete the deep analysis.`
+
+## Required Output
+
+- `selection_res.md`
+
+## Workflow
+
+### Step 1: Read the Current Project Direction
+
+Read:
+
+- `SOUL.md`
+- `survey_res.md`
+- relevant `knowledge/paper_*.md`
+
+Extract:
+
+- the task and evaluation target
+- method families mentioned in survey
+- constraints such as compute, data, latency, interpretability, or deployment needs
+
+### Step 2: Build 2-3 Candidate Routes
+
+Create 2-3 realistic candidate routes only. For each route, record:
+
+- route name
+- core idea
+- supporting papers
+- expected strengths
+- expected risks
+- implementation cost
+- baseline compatibility
+
+Use `references/candidate-template.md`.
+
+### Step 3: Select One Route and Keep Backups
+
+Choose:
+
+- one `Chosen Route`
+- one or more `Rejected Routes`
+- one `Fallback Route`
+
+The fallback should be the route most likely to work if the chosen route underperforms or proves too expensive to implement.
+
+### Step 4: Write `selection_res.md`
+
+Use `references/selection-template.md`.
+
+The final output must include:
+
+- project goal
+- decision criteria
+- candidate options table
+- chosen route
+- rejected routes
+- fallback route
+- next recommended command
+
+## Rules
+
+1. Do not present only one route unless the survey truly leaves no meaningful alternative.
+2. Every route must cite at least one paper or survey-derived basis.
+3. The chosen route must match the project constraints in `SOUL.md`.
+4. The fallback route must be different from the chosen route.