superlab 0.1.26 → 0.1.27

package/lib/i18n.cjs

@@ -60,7 +60,7 @@ const ZH_CONTENT = {
   [path.join(".codex", "prompts", "lab-write.md")]: codexPrompt(
     "把验证过的研究工件转成论文 section，并按小步方式修订",
     "section or writing target",
-    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:write`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:write` 阶段。它必须先有来自 `/lab:framing` 的已批准 framing artifact，再读取 `.codex/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件；如果当前 section 有 bundled example bank，还必须继续读取 `.codex/skills/lab/references/paper-writing/examples/index.md`、对应的 examples index，以及 1-2 个具体 example 文件。然后结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，先规划该 section 需要的表、图和 citation，再只修改一个 section。最终定稿或导出轮次必须运行 `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper`。第一次进入会产出论文 `.tex` 的路径时，如果 `paper_template_root` 为空，必须先问一次：继续使用默认 LaTeX scaffold，还是先接入模板目录。"
+    "使用已安装的 `lab` 技能：`.codex/skills/lab/SKILL.md`。\n\n立刻针对用户当前给出的参数执行 `/lab:write`，不要只推荐别的 `/lab` 阶段。只有在缺少阻塞性前提时，才明确指出缺什么，并且一次最多追问一个问题。\n\n本命令运行 `/lab:write` 阶段。它必须先有来自 `/lab:framing` 的已批准 framing artifact，再读取 `.codex/skills/lab/references/paper-writing/` 下与当前 section 对应的参考文件；如果当前 section 有 bundled example bank，还必须继续读取 `.codex/skills/lab/references/paper-writing/examples/index.md`、对应的 examples index，以及 1-2 个具体 example 文件。然后结合 `paper-review.md` 与 `does-my-writing-flow-source.md`，先写 mini-outline，先规划该 section 需要的表、图和 citation，再只修改一个 section。在起草 `method`、`experiments`、`related work` 或 `conclusion` 之前，必须先运行 `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`。最终定稿或导出轮次必须运行 `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper`。第一次进入会产出论文 `.tex` 的路径时，如果 `paper_template_root` 为空，必须先问一次：继续使用默认 LaTeX scaffold，还是先接入模板目录。"
   ),
   [path.join(".claude", "commands", "lab-idea.md")]: claudeCommand(
     "lab-idea",
@@ -925,9 +925,10 @@ const ZH_SKILL_FILES = {
 
 ## 目标
 
-- Venue or audience:
-- Paper status:
+- 目标会议或读者:
+- 论文状态:
 - 一句话主线：
+- 已批准 framing artifact:
 - Terminology lock:
 
 ## Section 状态
@@ -946,6 +947,60 @@ const ZH_SKILL_FILES = {
 - Limitation sources:
 - 哪些 claim 还缺证据：
 
+## 表计划
+
+- 主结果表:
+  - 资产文件:
+  - 作用章节:
+  - 作用:
+  - 证据:
+  - 状态:
+- 消融表:
+  - 资产文件:
+  - 作用章节:
+  - 作用:
+  - 证据:
+  - 状态:
+
+## 图计划
+
+- 方法总览图:
+  - 资产文件:
+  - 作用章节:
+  - 图意图:
+  - 证据:
+  - 状态:
+- 结果总览图:
+  - 资产文件:
+  - 作用章节:
+  - 图意图:
+  - 证据:
+  - 状态:
+
+## 引用计划
+
+- 背景锚点:
+  - 引用或来源锚点:
+  - 作用章节:
+  - 为什么重要:
+  - 状态:
+- 最接近前作:
+  - 引用或来源锚点:
+  - 作用章节:
+  - 为什么重要:
+  - 状态:
+- 指标或 benchmark 来源:
+  - 引用或来源锚点:
+  - 作用章节:
+  - 为什么重要:
+  - 状态:
+
+## 章节到资产映射
+
+- 方法:
+- 实验:
+- 相关工作:
+
 ## 写作顺序
 
 1. 第一优先 section:
@@ -1586,13 +1641,16 @@ ZH_CONTENT[path.join(".codex", "skills", "lab", "stages", "write.md")] = `# \`/l
 - 如果当前 section 是 \`related work\`、\`experiments\` 或 \`conclusion\`，也要读取对应的本地 example bank：\`references/paper-writing/examples/index.md\`、对应的 examples index，以及 1-2 个具体 example 文件。
 - 例子只能复用结构、段落角色和句法逻辑，不能直接复用原句。
 - 先写 mini-outline 再写 prose。
-- 如果当前 section 带方法或实验 claim，先规划需要的表格、figure placeholders 和 citations，再写 prose。
+- 如果当前 section 带方法、实验、相关工作或结论 claim，先规划需要的表格、figure placeholders 和 citations，再写 prose。
+- 在起草 \`method\`、\`experiments\`、\`related work\` 或 \`conclusion\` 之前，必须先运行 \`.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md\`。
+- 如果 \`paper-plan\` 校验失败，就先补 \`.lab/writing/plan.md\`，不能直接跳去写 prose。
 - 最终定稿或导出轮次里，必须维护非空的 \`references.bib\`，并把关键实验结果物化成真正的 LaTeX 表格：
   - \`<deliverables_root>/paper/tables/main-results.tex\`
   - \`<deliverables_root>/paper/tables/ablations.tex\`
 - 方法或实验章节还必须物化带 caption、label 和图意图的 figure placeholders：
   - \`<deliverables_root>/paper/figures/method-overview.tex\`
   - \`<deliverables_root>/paper/figures/results-overview.tex\`
+- 只要论文资产发生变化，就同步更新 \`.lab/writing/plan.md\` 里的表计划、图计划、引用计划和章节到资产映射。
 - 不要把纯 prose section 当成论文交付完成。
 - 论文源码里不要出现绝对本地路径、workflow provenance、shell 日志或 \`+/-\` 这类工程记法；应改成 paper-facing LaTeX 表达。
 - 在最终定稿或导出轮次结束前，必须运行 \`.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper\`；如果失败，就继续补表、图、引用和正文。

package/package-assets/claude/commands/lab-write.md

@@ -7,4 +7,4 @@ argument-hint: section or writing target
 Use the installed `lab` skill at `.claude/skills/lab/SKILL.md`.
 
 Execute the requested `/lab-write` command against the user's argument now. Do not only recommend another lab stage. If a blocking prerequisite is missing, say exactly what is missing and ask at most one clarifying question.
-This command runs the `write` stage of the lab workflow. It requires an approved framing artifact from the `framing` stage, must read the matching section reference from `.claude/skills/lab/references/paper-writing/`, and for any section with a bundled example bank it must also read `.claude/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, plan the section's paper-facing tables/figures/citations, and revise only one section. Final-draft or export rounds must run `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper` before stopping.
+This command runs the `write` stage of the lab workflow. It requires an approved framing artifact from the `framing` stage, must read the matching section reference from `.claude/skills/lab/references/paper-writing/`, and for any section with a bundled example bank it must also read `.claude/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, plan the section's paper-facing tables/figures/citations, and revise only one section. Before drafting `method`, `experiments`, `related work`, or `conclusion`, it must run `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`. Final-draft or export rounds must run `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper` before stopping.

package/package-assets/claude/commands/lab.md

@@ -59,6 +59,7 @@ Use the same repository artifacts and stage boundaries every time.
 - `run`, `iterate`, `auto`, and `report` should all follow `.lab/context/eval-protocol.md`, including its recorded sources for metrics and comparison implementations.
 - `write` requires an approved framing artifact from the `framing` stage.
 - `write` requires stable report artifacts, a mini-outline, the active section guide, the matching bundled examples when available, `paper-review.md`, and `does-my-writing-flow-source.md`, and should only change one section per round.
+- Before drafting `method`, `experiments`, `related work`, or `conclusion`, `write` should validate `.lab/writing/plan.md` with `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`.
 - Final-draft or export rounds in `write` should materialize paper-facing tables, figure placeholders, a non-empty `references.bib`, and pass `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper`.
 
 ## How to Ask for `/lab auto`

package/package-assets/codex/prompts/lab-write.md

@@ -6,4 +6,4 @@ argument-hint: section or writing target
 Use the installed `lab` skill at `.codex/skills/lab/SKILL.md`.
 
 Execute the requested `/lab:write` stage against the user's argument now. Do not only recommend another lab stage. If a blocking prerequisite is missing, say exactly what is missing and ask at most one clarifying question.
-This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.codex/skills/lab/references/paper-writing/`, and for any section with a bundled example bank it must also read `.codex/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, plan the section's paper-facing tables/figures/citations, and revise only one section. Final-draft or export rounds must run `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper` before stopping.
+This command runs the `/lab:write` stage. It requires an approved framing artifact from `/lab:framing`, must read the matching section reference from `.codex/skills/lab/references/paper-writing/`, and for any section with a bundled example bank it must also read `.codex/skills/lab/references/paper-writing/examples/index.md` plus the matching examples index and 1-2 concrete example files. Then it should run `paper-review.md` and `does-my-writing-flow-source.md`, build a mini-outline, plan the section's paper-facing tables/figures/citations, and revise only one section. Before drafting `method`, `experiments`, `related work`, or `conclusion`, it must run `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`. Final-draft or export rounds must run `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper` before stopping.

package/package-assets/codex/prompts/lab.md

@@ -53,6 +53,7 @@ argument-hint: workflow question or stage choice
 - `/lab:run`, `/lab:iterate`, `/lab:auto`, and `/lab:report` should all follow `.lab/context/eval-protocol.md`, including its recorded sources for metrics and comparison implementations.
 - `/lab:write` requires an approved framing artifact from `/lab:framing`.
 - `/lab:write` requires stable report artifacts, a mini-outline, the active section guide, the matching bundled examples when available, `paper-review.md`, and `does-my-writing-flow-source.md`, and should only change one section per round.
+- Before drafting `method`, `experiments`, `related work`, or `conclusion`, `/lab:write` should validate `.lab/writing/plan.md` with `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`.
 - Final-draft or export rounds in `/lab:write` should materialize paper-facing tables, figure placeholders, a non-empty `references.bib`, and pass `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper`.
 
 ## How to Ask for `/lab:auto`

package/package-assets/shared/lab/.managed/scripts/validate_paper_plan.py

@@ -0,0 +1,228 @@
+#!/usr/bin/env python3
+import argparse
+import re
+import sys
+from pathlib import Path
+
+
+REQUIRED_SECTIONS = {
+    "Target": [r"^##\s+Target\s*$", r"^##\s+目标\s*$"],
+    "Section Status": [r"^##\s+Section Status\s*$", r"^##\s+Section 状态\s*$"],
+    "Evidence Map": [r"^##\s+Evidence Map\s*$", r"^##\s+证据地图\s*$"],
+    "Table Plan": [r"^##\s+Table Plan\s*$", r"^##\s+表计划\s*$"],
+    "Figure Plan": [r"^##\s+Figure Plan\s*$", r"^##\s+图计划\s*$"],
+    "Citation Plan": [r"^##\s+Citation Plan\s*$", r"^##\s+引用计划\s*$"],
+    "Section-to-Asset Map": [r"^##\s+Section-to-Asset Map\s*$", r"^##\s+章节到资产映射\s*$"],
+    "Writing Order": [r"^##\s+Writing Order\s*$", r"^##\s+写作顺序\s*$"],
+    "Five-Dimension Self-Review Status": [
+        r"^##\s+Five-Dimension Self-Review Status\s*$",
+        r"^##\s+五维自评状态\s*$",
+    ],
+}
+
+TARGET_FIELDS = (
+    "Venue or audience",
+    "Paper status",
+    "Core story in one sentence",
+    "Approved framing artifact",
+    "Terminology lock",
+    "目标会议或读者",
+    "论文状态",
+    "一句话主线",
+    "已批准 framing artifact",
+    "术语锁",
+)
+
+SECTION_STATUS_FIELDS = (
+    "Abstract",
+    "Introduction",
+    "Related Work",
+    "Method",
+    "Experiments",
+    "Conclusion",
+)
+
+EVIDENCE_FIELDS = (
+    "Main result sources",
+    "Ablation sources",
+    "Limitation sources",
+    "Claims that still need more evidence",
+    "主结果来源",
+    "消融来源",
+    "限制来源",
+    "还缺更多证据的 claim",
+)
+
+TABLE_DETAIL_FIELDS = (
+    "Asset file",
+    "Section",
+    "Message",
+    "Evidence",
+    "Status",
+    "资产文件",
+    "作用章节",
+    "作用",
+    "证据",
+    "状态",
+)
+FIGURE_DETAIL_FIELDS = (
+    "Asset file",
+    "Section",
+    "Figure intent",
+    "Evidence",
+    "Status",
+    "资产文件",
+    "作用章节",
+    "图意图",
+    "证据",
+    "状态",
+)
+CITATION_DETAIL_FIELDS = (
+    "Citation or source anchor",
+    "Section",
+    "Why it matters",
+    "Status",
+    "引用或来源锚点",
+    "作用章节",
+    "为什么重要",
+    "状态",
+)
+SECTION_MAP_FIELDS = ("Method", "Experiments", "Related Work", "方法", "实验", "相关工作")
+WRITING_ORDER_FIELDS = (
+    "First section target",
+    "Second section target",
+    "Deferred sections",
+    "第一优先 section",
+    "第二优先 section",
+    "延后 section",
+)
+SELF_REVIEW_FIELDS = (
+    "Contribution",
+    "Writing clarity",
+    "Experimental strength",
+    "Evaluation completeness",
+    "Method design soundness",
+)
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description="Validate that the managed paper plan contains concrete asset planning before prose drafting."
+    )
+    parser.add_argument("--paper-plan", required=True, help="Path to .lab/writing/plan.md")
+    return parser.parse_args()
+
+
+def read_text(path: Path) -> str:
+    return path.read_text(encoding="utf-8")
+
+
+def extract_section_body(text: str, patterns: list[str]) -> str:
+    for pattern in patterns:
+        match = re.search(pattern, text, flags=re.MULTILINE)
+        if not match:
+            continue
+        start = match.end()
+        next_heading = re.search(r"^##\s+", text[start:], flags=re.MULTILINE)
+        end = start + next_heading.start() if next_heading else len(text)
+        return text[start:end].strip()
+    return ""
+
+
+def missing_sections(text: str) -> list[str]:
+    missing = []
+    for section_name, patterns in REQUIRED_SECTIONS.items():
+        if not any(re.search(pattern, text, flags=re.MULTILINE) for pattern in patterns):
+            missing.append(section_name)
+    return missing
+
+
+def has_filled_field(body: str, field_labels: tuple[str, ...]) -> bool:
+    for label in field_labels:
+        pattern = re.compile(rf"^\s*(?:-|\d+\.)\s*{re.escape(label)}:[ \t]*([^\n]+?)\s*$", flags=re.MULTILINE)
+        for match in pattern.finditer(body):
+            value = match.group(1).strip()
+            if value and value not in {"TBD", "TODO", "待补", "待定"}:
+                return True
+    return False
+
+
+def count_filled_fields(body: str, field_labels: tuple[str, ...]) -> int:
+    count = 0
+    for label in field_labels:
+        pattern = re.compile(rf"^\s*(?:-|\d+\.)\s*{re.escape(label)}:[ \t]*([^\n]+?)\s*$", flags=re.MULTILINE)
+        for match in pattern.finditer(body):
+            value = match.group(1).strip()
+            if value and value not in {"TBD", "TODO", "待补", "待定"}:
+                count += 1
+    return count
+
+
+def validate_filled_fields(text: str) -> list[str]:
+    issues: list[str] = []
+
+    target_body = extract_section_body(text, REQUIRED_SECTIONS["Target"])
+    if not has_filled_field(target_body, TARGET_FIELDS):
+        issues.append("paper plan is missing filled target fields")
+
+    section_status_body = extract_section_body(text, REQUIRED_SECTIONS["Section Status"])
+    if count_filled_fields(section_status_body, SECTION_STATUS_FIELDS) < 6:
+        issues.append("paper plan is missing filled section-status entries")
+
+    evidence_body = extract_section_body(text, REQUIRED_SECTIONS["Evidence Map"])
+    if not has_filled_field(evidence_body, EVIDENCE_FIELDS):
+        issues.append("paper plan is missing filled evidence-map entries")
+
+    table_body = extract_section_body(text, REQUIRED_SECTIONS["Table Plan"])
+    if count_filled_fields(table_body, TABLE_DETAIL_FIELDS) < 10:
+        issues.append("paper plan must fill both required table-asset blocks")
+
+    figure_body = extract_section_body(text, REQUIRED_SECTIONS["Figure Plan"])
+    if count_filled_fields(figure_body, FIGURE_DETAIL_FIELDS) < 10:
+        issues.append("paper plan must fill both required figure-asset blocks")
+
+    citation_body = extract_section_body(text, REQUIRED_SECTIONS["Citation Plan"])
+    if count_filled_fields(citation_body, CITATION_DETAIL_FIELDS) < 12:
+        issues.append("paper plan must fill all required citation-plan blocks")
+
+    section_map_body = extract_section_body(text, REQUIRED_SECTIONS["Section-to-Asset Map"])
+    if not has_filled_field(section_map_body, SECTION_MAP_FIELDS):
+        issues.append("paper plan is missing filled section-to-asset mappings")
+
+    writing_order_body = extract_section_body(text, REQUIRED_SECTIONS["Writing Order"])
+    if count_filled_fields(writing_order_body, WRITING_ORDER_FIELDS) < 3:
+        issues.append("paper plan is missing filled writing-order entries")
+
+    self_review_body = extract_section_body(text, REQUIRED_SECTIONS["Five-Dimension Self-Review Status"])
+    if count_filled_fields(self_review_body, SELF_REVIEW_FIELDS) < 5:
+        issues.append("paper plan is missing filled self-review status entries")
+
+    return issues
+
+
+def main():
+    args = parse_args()
+    plan_path = Path(args.paper_plan)
+    if not plan_path.exists():
+        print(f"paper plan does not exist: {plan_path}", file=sys.stderr)
+        return 1
+
+    text = read_text(plan_path)
+    issues = []
+
+    missing = missing_sections(text)
+    if missing:
+        issues.append(f"paper plan is missing required sections: {', '.join(missing)}")
+    issues.extend(validate_filled_fields(text))
+
+    if issues:
+        for issue in issues:
+            print(issue, file=sys.stderr)
+        return 1
+
+    print("paper plan is valid")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/package-assets/shared/lab/.managed/templates/paper-plan.md

@@ -24,6 +24,60 @@
 - Limitation sources:
 - Claims that still need more evidence:
 
+## Table Plan
+
+- Main results table:
+  - Asset file:
+  - Section:
+  - Message:
+  - Evidence:
+  - Status:
+- Ablation table:
+  - Asset file:
+  - Section:
+  - Message:
+  - Evidence:
+  - Status:
+
+## Figure Plan
+
+- Method overview figure:
+  - Asset file:
+  - Section:
+  - Figure intent:
+  - Evidence:
+  - Status:
+- Results overview figure:
+  - Asset file:
+  - Section:
+  - Figure intent:
+  - Evidence:
+  - Status:
+
+## Citation Plan
+
+- Background anchor:
+  - Citation or source anchor:
+  - Section:
+  - Why it matters:
+  - Status:
+- Closest prior work:
+  - Citation or source anchor:
+  - Section:
+  - Why it matters:
+  - Status:
+- Metric or benchmark source:
+  - Citation or source anchor:
+  - Section:
+  - Why it matters:
+  - Status:
+
+## Section-to-Asset Map
+
+- Method:
+- Experiments:
+- Related Work:
+
 ## Writing Order
 
 1. First section target:

package/package-assets/shared/skills/lab/stages/write.md

@@ -76,10 +76,12 @@ Run these on every round:
 - Reuse example-bank structure, paragraph roles, sentence logic, and paper-facing LaTeX asset patterns when examples are bundled, but never copy wording verbatim.
 - Treat example cites and example file names as writing references, not as evidence for the current paper.
 - Build a compact mini-outline before prose.
-- Build the paper asset plan before prose when the section carries experimental or method claims:
-  - decide which tables the section needs
-  - decide which figure placeholders the section needs
-  - decide which citations must appear in the section
+- Build the paper asset plan before prose when the section carries experimental, method, related-work, or conclusion claims:
+  - record which table asset files the section needs, what each table should show, and which evidence supports it
+  - record which figure placeholder files the section needs, what each figure should show, and why the reader needs it
+  - record which citation anchors must appear in the section and why each anchor matters
+- Before drafting `method`, `experiments`, `related work`, or `conclusion`, run `.lab/.managed/scripts/validate_paper_plan.py --paper-plan .lab/writing/plan.md`.
+- If the paper-plan validator fails, stop and fill `.lab/writing/plan.md` first instead of drafting prose.
 - For each subsection, explicitly include motivation, design, and technical advantage when applicable.
 - Avoid a writing style that reads like incremental patching of a naive baseline.
 - Keep terminology stable across the full paper.
@@ -97,6 +99,7 @@ Run these on every round:
   - `<deliverables_root>/paper/figures/results-overview.tex`
 - Table assets must use paper-facing LaTeX structure with `booktabs`, caption, label, and consistent precision.
 - Figure placeholders must explain what the final figure should show and why the reader needs it.
+- Keep `.lab/writing/plan.md` synchronized with the current table plan, figure plan, citation plan, and section-to-asset map whenever manuscript assets change.
 - Run `.lab/.managed/scripts/validate_manuscript_delivery.py --paper-dir <deliverables_root>/paper` before accepting a final-draft or export round.
 - If the manuscript validator fails, keep editing and asset generation until it passes; do not stop at prose-only completion.
 - Run a LaTeX compile smoke test when a local LaTeX toolchain is available; if not available, record the missing verification in the write iteration artifact.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlab",
-  "version": "0.1.26",
+  "version": "0.1.27",
   "description": "Strict /lab research workflow installer for Codex and Claude",
   "keywords": [
     "codex",