superlab 0.1.20 → 0.1.21

package/lib/context.cjs

@@ -29,6 +29,35 @@ const EVAL_COLLABORATOR_FIELDS = [
   { name: "Metric source papers", labels: ["Metric source papers", "指标来源论文"] },
   { name: "Required output artifacts", labels: ["Required output artifacts", "必要输出工件"] },
 ];
+const REPORT_REQUIRED_SECTIONS = [
+  { name: "Report Status", patterns: [/^##\s+Report Status\s*$/m, /^##\s+报告状态\s*$/m] },
+  { name: "Reader Summary", patterns: [/^##\s+Reader Summary\s*$/m, /^##\s+给用户看的总结\s*$/m] },
+  { name: "Problem and Background", patterns: [/^##\s+Problem and Background\s*$/m, /^##\s+问题与背景\s*$/m] },
+  { name: "Dataset Scene Notes", patterns: [/^##\s+Dataset Scene Notes\s*$/m, /^##\s+数据集场景说明\s*$/m] },
+  { name: "Contribution Summary", patterns: [/^##\s+Contribution Summary\s*$/m, /^##\s+贡献总结\s*$/m] },
+  { name: "Method Overview", patterns: [/^##\s+Method Overview\s*$/m, /^##\s+方法概述\s*$/m] },
+  { name: "Selected Metrics", patterns: [/^##\s+Selected Metrics\s*$/m, /^##\s+选定指标\s*$/m] },
+  { name: "Metric Guide", patterns: [/^##\s+Metric Guide\s*$/m, /^##\s+指标白话释义\s*$/m] },
+  { name: "Background Sources", patterns: [/^##\s+Background Sources\s*$/m, /^##\s+背景来源\s*$/m] },
+  {
+    name: "Method and Baseline Sources",
+    patterns: [/^##\s+Method and Baseline Sources\s*$/m, /^##\s+方法与基线来源\s*$/m],
+  },
+  { name: "Metric Sources", patterns: [/^##\s+Metric Sources\s*$/m, /^##\s+指标来源\s*$/m] },
+];
+const MAIN_TABLES_REQUIRED_SECTIONS = [
+  { name: "Reader Summary", patterns: [/^##\s+Reader Summary\s*$/m, /^##\s+给用户看的总结\s*$/m] },
+  { name: "Selected Metrics", patterns: [/^##\s+Selected Metrics\s*$/m, /^##\s+选定指标\s*$/m] },
+  { name: "Metric Guide", patterns: [/^##\s+Metric Guide\s*$/m, /^##\s+指标白话释义\s*$/m] },
+  {
+    name: "Final Performance Summary",
+    patterns: [/^##\s+Final Performance Summary\s*$/m, /^##\s+最终表现摘要\s*$/m],
+  },
+  {
+    name: "How to Read These Tables",
+    patterns: [/^##\s+How to Read These Tables\s*$/m, /^##\s+怎么读这些表\s*$/m],
+  },
+];
 const REPORT_FIELDS = {
   problem: ["Research problem in plain language", "研究问题白话解释", "研究问题"],
   whyItMatters: ["Why this problem matters", "为什么这个问题重要"],
@@ -191,6 +220,36 @@ function collaboratorEvalIssues(targetDir) {
     : [];
 }
 
+function missingRequiredSections(text, sections) {
+  if (!text) {
+    return sections.map((section) => section.name);
+  }
+  return sections
+    .filter((section) => !section.patterns.some((pattern) => pattern.test(text)))
+    .map((section) => section.name);
+}
+
+function collaboratorReportIssues(targetDir) {
+  if (!hasCollaboratorFacingDeliverables(targetDir)) {
+    return [];
+  }
+  const { reportPath, mainTablesPath } = getCollaboratorDeliverablePaths(targetDir);
+  const issues = [];
+  if (fs.existsSync(reportPath)) {
+    const missing = missingRequiredSections(readFileIfExists(reportPath), REPORT_REQUIRED_SECTIONS);
+    if (missing.length > 0) {
+      issues.push(`report.md is missing required collaborator-facing sections: ${missing.join(", ")}`);
+    }
+  }
+  if (fs.existsSync(mainTablesPath)) {
+    const missing = missingRequiredSections(readFileIfExists(mainTablesPath), MAIN_TABLES_REQUIRED_SECTIONS);
+    if (missing.length > 0) {
+      issues.push(`main-tables.md is missing required collaborator-facing sections: ${missing.join(", ")}`);
+    }
+  }
+  return issues;
+}
+
 function extractReportValue(reportText, key) {
   return extractValue(reportText, REPORT_FIELDS[key] || []);
 }
@@ -611,7 +670,8 @@ function hydrateEvalProtocol(targetDir) {
 function getCollaboratorReportStatus(targetDir) {
   const missionIssues = collaboratorMissionIssues(targetDir);
   const evalIssues = collaboratorEvalIssues(targetDir);
-  const issues = missionIssues.concat(evalIssues);
+  const reportIssues = collaboratorReportIssues(targetDir);
+  const issues = missionIssues.concat(evalIssues, reportIssues);
   if (issues.length > 0) {
     return {
       mode: "artifact-anchored interim",
@@ -1318,6 +1378,7 @@ module.exports = {
   archiveContext,
   collaboratorEvalIssues,
   collaboratorMissionIssues,
+  collaboratorReportIssues,
   getCollaboratorReportStatus,
   hasCollaboratorFacingDeliverables,
   hydrateCanonicalContext,

package/lib/i18n.cjs

@@ -338,6 +338,7 @@ const ZH_SKILL_FILES = {
 - 在起草报告前，先检查 \`.lab/context/mission.md\` 和 \`.lab/context/eval-protocol.md\` 是否仍是模板空壳。
 - 如果 canonical context 还是空壳，要先根据 frozen result artifacts、data-decisions、evidence-index 和已批准上下文回填“最小可信版本”，再写报告。
 - 如果回填后仍缺少协作者可读所需的关键字段，就必须把输出降级成 \`artifact-anchored interim report\`，不能冒充最终协作者报告。
+- 如果现有的 \`report.md\` 或 \`main-tables.md\` 缺少受管模板要求的协作者可读章节，也必须视为报告缺陷；rerun 需要补齐这些缺失块，不能直接宣称“正文无变化”或把这次 rerun 当成 no-op。
 - 如果报告依赖了对原始指标或原始实现的偏差，必须明确写出这个偏差。
 - workflow 工件状态、rerun id 或 LaTeX 骨架状态不能混进“已验证主结果”；这些内容必须单列到工件状态部分。
 - 如果 workflow language 是中文，\`report.md\` 和 \`<deliverables_root>/main-tables.md\` 也应使用中文，除非文件路径、代码标识符或字面指标名必须保持原样。

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

@@ -58,6 +58,7 @@
 - Before drafting the report, inspect `.lab/context/mission.md` and `.lab/context/eval-protocol.md` for skeletal template fields.
 - If either canonical context file is still skeletal, hydrate the smallest trustworthy version from frozen result artifacts, dataset decisions, evidence-index, and prior approved context, and write that back before finalizing the report.
 - If collaborator-critical fields still remain missing after hydration, downgrade the output to an `artifact-anchored interim report` instead of presenting it as a final collaborator-ready report.
+- If the existing `report.md` or `main-tables.md` is missing required collaborator-facing sections from the managed templates, treat that as a report deficiency. A rerun must repair the missing sections instead of declaring "no content change" or treating the rerun as a no-op.
 - Do not mix workflow deliverable status, rerun ids, or manuscript skeleton status into validated scientific findings; keep those in a separate artifact-status section.
 - If `.lab/config/workflow.json` sets the workflow language to Chinese, write `report.md` and `<deliverables_root>/main-tables.md` in Chinese unless a file path, code identifier, or literal metric name must remain unchanged.
 - Prefer conservative interpretation over marketing language.

package/package.json

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