superlab 0.1.10 → 0.1.12

package/README.md

@@ -149,6 +149,36 @@ superlab doctor
 - LaTeX-first paper output layout under `<deliverables_root>/paper/`
 - boundary violations such as durable run outputs stored under `.lab/changes/*/runs`
 
+## Auto Mode
+
+First fill `.lab/context/auto-mode.md` with the bounded contract, the per-stage commands, the stage output contracts, and the policy check commands for the campaign, then arm it for the current project:
+
+```bash
+superlab auto start
+```
+
+Inspect the live auto-mode state:
+
+```bash
+superlab auto status
+```
+
+Stop the current auto-mode run:
+
+```bash
+superlab auto stop
+```
+
+`/lab:auto` is an orchestration mode layered on top of approved execution stages. It reuses `run`, `iterate`, `review`, `report`, and optional `write` inside the limits defined by `.lab/context/auto-mode.md` and `.lab/context/auto-status.md`. `superlab auto start` runs the configured stage commands in the foreground, polls for completion, enforces `success/stop/promotion` check commands, guards the configured frozen core, and validates stage-specific contracts:
+
+- `run` and `iterate` must change persistent outputs under `results_root`
+- `review` must update canonical review context
+- `report` must write `<deliverables_root>/report.md`
+- `write` must produce LaTeX output under `<deliverables_root>/paper/`
+- a successful promotion must write back into `.lab/context/data-decisions.md`, `.lab/context/decisions.md`, `.lab/context/state.md`, and `.lab/context/session-brief.md`
+
+It does not replace manual `idea`, `data`, `framing`, or `spec` decisions.
+
 ## Version
 
 Show the CLI version and the current project asset version:
@@ -207,6 +237,7 @@ Stages should follow that file rather than guess language locally.
 - `/lab:idea` researches an idea, critiques it, and writes the initial research framing.
 - `/lab:data` turns the approved idea into a dataset and benchmark package with years, paper usage, source audit, download plans, explicit benchmark-role rationale for classic-public, recent-strong-public, and claim-specific benchmarks, and explicit comparison rationale for canonical baselines, strong historical baselines, recent strong public methods, and closest prior work.
 - `/lab:framing` locks paper-facing method names, module names, titles, and contribution wording before drafting.
+- `/lab:auto` orchestrates approved `run`, `iterate`, `review`, `report`, and optional `write` stages inside a bounded contract and can promote exploratory additions to the primary package when the promotion policy is satisfied.
 - `/lab:spec` converts the approved idea into one `.lab/changes/<change-id>/` directory.
 - `/lab:run` executes a small-scale validation run and establishes the evaluation pipeline.
 - Durable run outputs should go under the configured `results_root`, not `.lab/changes/`.

package/README.zh-CN.md

@@ -147,6 +147,36 @@ superlab doctor
 - `<deliverables_root>/paper/` 下是否仍然满足 LaTeX-first 输出约束
 - 是否把长期 run 输出错误地堆在 `.lab/changes/*/runs`
 
+## 自动模式
+
+先填写 `.lab/context/auto-mode.md`，明确本次自治执行的边界契约、各阶段命令、阶段产物约束，以及 success/stop/promotion 的检查命令，再启动当前项目的自动模式：
+
+```bash
+superlab auto start
+```
+
+查看自动模式当前状态：
+
+```bash
+superlab auto status
+```
+
+停止当前自动模式：
+
+```bash
+superlab auto stop
+```
+
+`/lab:auto` 是叠加在现有执行阶段之上的编排模式。它会在 `.lab/context/auto-mode.md` 和 `.lab/context/auto-status.md` 的约束下，复用 `run`、`iterate`、`review`、`report`，以及可选的 `write`。`superlab auto start` 会在前台执行这些已配置阶段命令、轮询完成情况，并真正执行 success/stop/promotion 检查命令，同时保护已声明的 frozen core，并校验各阶段的产物约束：
+
+- `run` 和 `iterate` 必须更新 `results_root` 下的持久输出
+- `review` 必须更新规范的审查上下文
+- `report` 必须写出 `<deliverables_root>/report.md`
+- `write` 必须写出 `<deliverables_root>/paper/` 下的 LaTeX 论文产物
+- promotion 成功后必须写回 `.lab/context/data-decisions.md`、`.lab/context/decisions.md`、`.lab/context/state.md` 和 `.lab/context/session-brief.md`
+
+它不会替代手动的 `idea`、`data`、`framing`、`spec` 决策。
+
 ## 版本查询
 
 查看当前 CLI 版本和当前目录项目的资产版本：
@@ -205,6 +235,7 @@ superlab init --lang en
 - `/lab:idea` 调研 idea、文献、数据集、指标和 baseline，并输出初始方案。
 - `/lab:data` 把已批准的 idea 收敛成数据集与 benchmark 方案，要求记录年份、使用论文、来源审计、下载计划，并明确 classic-public、recent-strong-public、claim-specific 三类 benchmark 的纳入理由，以及 canonical baselines、strong historical baselines、recent strong public methods、closest prior work 四类对比方法的纳入理由。
 - `/lab:framing` 在正式写作前收紧方法名、模块名、论文题目和 contribution wording。
+- `/lab:auto` 在已批准边界内编排 `run`、`iterate`、`review`、`report` 和可选 `write`，并在升格策略满足时允许把 exploratory additions 自动升级为 primary package。
 - `/lab:spec` 把批准后的方案转换成一个统一的 `.lab/changes/<change-id>/` 目录。
 - `/lab:run` 执行最小可运行实验，并建立首版评估链路。
 - 持久 run 输出应写到 `results_root`，不要写进 `.lab/changes/`。

package/bin/superlab.cjs

@@ -15,6 +15,11 @@ const {
   pruneContext,
   refreshContext,
 } = require("../lib/context.cjs");
+const {
+  getAutoStatus,
+  startAutoMode,
+  stopAutoMode,
+} = require("../lib/auto.cjs");
 const { promptSelect } = require("../lib/init_tui.cjs");
 
 function restartReminder(lang) {
@@ -31,6 +36,9 @@ Usage:
   superlab init [--target <dir>] [--platform codex|claude|both|all] [--lang en|zh] [--force]
   superlab install [--target <dir>] [--platform codex|claude|both|all] [--lang en|zh] [--force]
   superlab paper attach-template --path <dir> [--target <dir>]
+  superlab auto start [--target <dir>]
+  superlab auto status [--target <dir>]
+  superlab auto stop [--target <dir>]
   superlab update [--target <dir>]
   superlab update --all-projects
   superlab version [--target <dir>] [--global|--project]
@@ -44,6 +52,7 @@ Commands:
   init      Initialize /lab commands, skills, templates, and scripts in a target
   install   Backward-compatible alias for init
   paper     Attach and validate a user-provided LaTeX template directory
+  auto      Manage the bounded auto-mode contract and live state
   update    Refresh an initialized project or all registered projects
   version   Show installed CLI version and project asset version
   handoff   Print the minimal context handoff bundle for a project
@@ -205,6 +214,17 @@ function parsePaperArgs(argv) {
   return options;
 }
 
+function parseAutoArgs(argv) {
+  const [action, ...rest] = argv;
+  if (!["start", "status", "stop"].includes(action || "")) {
+    throw new Error(`Unknown auto action: ${action || "(missing)"}`);
+  }
+  return {
+    action,
+    ...parseTargetOnlyArgs(rest),
+  };
+}
+
 function printVersion(options) {
   const lines = [];
   if (!options.projectOnly) {
@@ -539,6 +559,17 @@ function validateDataDecisions(targetDir) {
   return [`missing dataset rationale fields: ${missing.join(", ")}`];
 }
 
+function printAutoStatus(options) {
+  const { mode, status, issues } = getAutoStatus({ targetDir: options.targetDir });
+  console.log(`target: ${options.targetDir}`);
+  console.log(`status: ${status.status || "idle"}`);
+  console.log(`objective: ${mode.objective || "TBD"}`);
+  console.log(`allowed stages: ${mode.allowedStages.join(", ") || "TBD"}`);
+  console.log(`current stage: ${status.currentStage || "TBD"}`);
+  console.log(`decision: ${status.decision || "TBD"}`);
+  console.log(`issues: ${issues.length > 0 ? issues.join(" | ") : "none"}`);
+}
+
 function attachPaperTemplate({ targetDir, templatePath }) {
   const configPath = path.join(targetDir, ".lab", "config", "workflow.json");
   if (!fs.existsSync(configPath)) {
@@ -708,6 +739,8 @@ function printDoctor(options) {
     ".lab/context/evidence-index.md",
     ".lab/context/open-questions.md",
     ".lab/context/data-decisions.md",
+    ".lab/context/auto-mode.md",
+    ".lab/context/auto-status.md",
     ".lab/context/terminology-lock.md",
     ".lab/context/summary.md",
     ".lab/context/next-action.md",
@@ -721,6 +754,8 @@ function printDoctor(options) {
   const templateIssues = validatePaperTemplateRoot(options.targetDir, config);
   const dataDecisionIssues = validateDataDecisions(options.targetDir);
   const rootIssues = validateProjectRoots(options.targetDir, config);
+  const autoStatus = getAutoStatus({ targetDir: options.targetDir });
+  const autoIssues = autoStatus.issues;
 
   if (projectInfo.status === "missing") {
     console.log("status: missing");
@@ -735,7 +770,8 @@ function printDoctor(options) {
     deliverableIssues.length > 0 ||
     templateIssues.length > 0 ||
     dataDecisionIssues.length > 0 ||
-    rootIssues.length > 0
+    rootIssues.length > 0 ||
+    autoIssues.length > 0
   ) {
     console.log("status: degraded");
     console.log(`target: ${options.targetDir}`);
@@ -744,7 +780,7 @@ function printDoctor(options) {
     console.log(`language: ${projectInfo.lang}`);
     console.log(`missing: ${missing.length > 0 ? missing.join(", ") : "none"}`);
     console.log(`config: ${configIssues.length > 0 ? configIssues.join(" | ") : "none"}`);
-    const outputIssues = deliverableIssues.concat(templateIssues, dataDecisionIssues, rootIssues);
+    const outputIssues = deliverableIssues.concat(templateIssues, dataDecisionIssues, rootIssues, autoIssues);
     console.log(`outputs: ${outputIssues.length > 0 ? outputIssues.join(" | ") : "none"}`);
     return;
   }
@@ -811,7 +847,7 @@ async function main() {
     return;
   }
 
-  if (!["init", "install", "paper", "update", "version", "handoff", "doctor", "context"].includes(command)) {
+  if (!["init", "install", "paper", "auto", "update", "version", "handoff", "doctor", "context"].includes(command)) {
     throw new Error(`Unknown command: ${command}`);
   }
 
@@ -859,6 +895,27 @@ async function main() {
     return;
   }
 
+  if (command === "auto") {
+    const options = parseAutoArgs(rest);
+    if (options.action === "status") {
+      printAutoStatus(options);
+      return;
+    }
+    if (options.action === "start") {
+      const result = await startAutoMode({ targetDir: options.targetDir });
+      const verb = result.status.status === "stopped" ? "stopped" : "completed";
+      console.log(`auto mode ${verb} in ${options.targetDir}`);
+      console.log(`objective: ${result.mode.objective}`);
+      console.log(`stages executed: ${result.executedStages.join(", ")}`);
+      console.log(`status: ${result.status.status}`);
+      return;
+    }
+    const status = stopAutoMode({ targetDir: options.targetDir });
+    console.log(`auto mode stopped in ${options.targetDir}`);
+    console.log(`status: ${status.status}`);
+    return;
+  }
+
   if (command === "update") {
     const options = parseUpdateArgs(rest);
     if (options.allProjects) {