superlab 0.1.43 → 0.1.44

package/lib/auto_contracts.cjs

@@ -134,6 +134,11 @@ function validateAutoMode(mode, status = null, evalProtocol = null) {
     ["terminal goal type", mode.terminalGoalType],
     ["terminal goal target", mode.terminalGoalTarget],
     ["required terminal artifact", mode.requiredTerminalArtifact],
+    ["primary gate", mode.primaryGate],
+    ["secondary guard", mode.secondaryGuard],
+    ["promotion condition", mode.promotionCondition],
+    ["stop reason", mode.stopReason],
+    ["escalation reason", mode.escalationReason],
     ["max iterations", mode.maxIterations],
     ["max wall-clock time", mode.maxWallClockTime],
     ["max failures", mode.maxFailures],

package/lib/auto_runner.cjs

@@ -21,6 +21,7 @@ const {
   verifyStageContract,
 } = require("./auto_contracts.cjs");
 const {
+  listMissingCurrentAutoModeFields,
   parseAutoLedger,
   parseAutoMode,
   parseAutoStatus,
@@ -337,6 +338,12 @@ async function startAutoMode({ targetDir, now = new Date() }) {
   const existingStatus = parseAutoStatus(targetDir);
   const existingLedger = parseAutoLedger(targetDir);
   const evalProtocol = parseEvalProtocol(targetDir);
+  const missingSchemaFields = listMissingCurrentAutoModeFields(mode);
+  if (missingSchemaFields.length > 0) {
+    throw new Error(
+      `auto-mode.md is missing current contract fields: ${missingSchemaFields.join(", ")}; run \`superlab update --target ${targetDir}\` to apply the managed schema migration, then fill the new fields before starting auto mode`
+    );
+  }
   const issues = validateAutoMode(mode, null, evalProtocol);
   if (issues.length > 0) {
     throw new Error(issues.join(" | "));

package/lib/auto_state.cjs

@@ -24,6 +24,11 @@ function parseAutoMode(targetDir) {
     terminalGoalType: normalizeScalar(extractValue(text, ["Terminal goal type", "终止目标类型"])),
     terminalGoalTarget: extractValue(text, ["Terminal goal target", "终止目标目标值"]),
     requiredTerminalArtifact: extractValue(text, ["Required terminal artifact", "终止目标工件"]),
+    primaryGate: extractValue(text, ["Primary gate", "主 gate"]),
+    secondaryGuard: extractValue(text, ["Secondary guard", "次级 guard"]),
+    promotionCondition: extractValue(text, ["Promotion condition", "升格条件"]),
+    stopReason: extractValue(text, ["Stop reason", "停止原因"]),
+    escalationReason: extractValue(text, ["Escalation reason", "升级原因"]),
     maxIterations: extractValue(text, ["Max iterations", "最大迭代轮次"]),
     maxWallClockTime: extractValue(text, ["Max wall-clock time", "最大运行时长"]),
     maxFailures: extractValue(text, ["Max failures", "最大失败次数"]),
@@ -47,6 +52,25 @@ function parseAutoMode(targetDir) {
   };
 }
 
+const CURRENT_AUTO_MODE_SCHEMA_FIELDS = [
+  ["Autonomy level", "autonomyLevel"],
+  ["Approval status", "approvalStatus"],
+  ["Terminal goal type", "terminalGoalType"],
+  ["Terminal goal target", "terminalGoalTarget"],
+  ["Required terminal artifact", "requiredTerminalArtifact"],
+  ["Primary gate", "primaryGate"],
+  ["Secondary guard", "secondaryGuard"],
+  ["Promotion condition", "promotionCondition"],
+  ["Stop reason", "stopReason"],
+  ["Escalation reason", "escalationReason"],
+];
+
+function listMissingCurrentAutoModeFields(mode) {
+  return CURRENT_AUTO_MODE_SCHEMA_FIELDS
+    .filter(([, key]) => !isMeaningful(mode[key]))
+    .map(([label]) => label);
+}
+
 function parseAutoStatus(targetDir) {
   const text = readFileIfExists(contextFile(targetDir, "auto-status.md"));
   return {
@@ -369,6 +393,8 @@ function resolveRequiredArtifact(targetDir, configuredPath) {
 }
 
 module.exports = {
+  CURRENT_AUTO_MODE_SCHEMA_FIELDS,
+  listMissingCurrentAutoModeFields,
   parseAutoLedger,
   parseAutoMode,
   parseAutoStatus,

package/lib/i18n.cjs

@@ -2210,15 +2210,27 @@ const zhRecipeQuickPathLine =
 ZH_CONTENT[path.join(".codex", "prompts", "lab.md")] = ZH_CONTENT[
   path.join(".codex", "prompts", "lab.md")
 ].replace(
+  "\n\n## 子命令\n\n",
+  "\n\n## 可接受的阶段写法\n\n- `/lab:idea ...`、`/lab: idea ...`、`/lab idea ...`、`/lab-idea`、`/lab：idea ...`\n- `/lab:data ...`、`/lab: data ...`、`/lab data ...`、`/lab-data`、`/lab：data ...`\n- `/lab:auto ...`、`/lab: auto ...`、`/lab auto ...`、`/lab-auto`、`/lab：auto ...`\n- `/lab:framing ...`、`/lab: framing ...`、`/lab framing ...`、`/lab-framing`、`/lab：framing ...`\n- `/lab:spec ...`、`/lab: spec ...`、`/lab spec ...`、`/lab-spec`、`/lab：spec ...`\n- `/lab:run ...`、`/lab: run ...`、`/lab run ...`、`/lab-run`、`/lab：run ...`\n- `/lab:iterate ...`、`/lab: iterate ...`、`/lab iterate ...`、`/lab-iterate`、`/lab：iterate ...`\n- `/lab:review ...`、`/lab: review ...`、`/lab review ...`、`/lab-review`、`/lab：review ...`\n- `/lab:report ...`、`/lab: report ...`、`/lab report ...`、`/lab-report`、`/lab：report ...`\n- `/lab:write ...`、`/lab: write ...`、`/lab write ...`、`/lab-write`、`/lab：write ...`\n\n## 子命令\n\n"
+).replace(
   "- 始终使用 `skills/lab/SKILL.md` 作为工作流合同。\n",
   `- 始终使用 \`skills/lab/SKILL.md\` 作为工作流合同。\n${zhRecipeQuickPathLine}`
+).replace(
+  "- 用户显式调用 `/lab:<stage>` 时，要立刻执行该 stage，而不是只推荐别的 `/lab` stage。\n",
+  "- 用户只要显式调用某个 stage，无论写成 `/lab:<stage>`、`/lab: <stage>`、`/lab <stage>`、`/lab-<stage>` 还是 `/lab：<stage>`，都要立刻执行该 stage，而不是只推荐别的 `/lab` stage。\n"
 );
 
 ZH_CONTENT[path.join(".claude", "commands", "lab.md")] = ZH_CONTENT[
   path.join(".claude", "commands", "lab.md")
 ].replace(
+  "\n\n## 阶段别名\n\n",
+  "\n\n## 可接受的阶段写法\n\n- `/lab:idea ...`、`/lab: idea ...`、`/lab idea ...`、`/lab-idea`、`/lab：idea ...`\n- `/lab:data ...`、`/lab: data ...`、`/lab data ...`、`/lab-data`、`/lab：data ...`\n- `/lab:auto ...`、`/lab: auto ...`、`/lab auto ...`、`/lab-auto`、`/lab：auto ...`\n- `/lab:framing ...`、`/lab: framing ...`、`/lab framing ...`、`/lab-framing`、`/lab：framing ...`\n- `/lab:spec ...`、`/lab: spec ...`、`/lab spec ...`、`/lab-spec`、`/lab：spec ...`\n- `/lab:run ...`、`/lab: run ...`、`/lab run ...`、`/lab-run`、`/lab：run ...`\n- `/lab:iterate ...`、`/lab: iterate ...`、`/lab iterate ...`、`/lab-iterate`、`/lab：iterate ...`\n- `/lab:review ...`、`/lab: review ...`、`/lab review ...`、`/lab-review`、`/lab：review ...`\n- `/lab:report ...`、`/lab: report ...`、`/lab report ...`、`/lab-report`、`/lab：report ...`\n- `/lab:write ...`、`/lab: write ...`、`/lab write ...`、`/lab-write`、`/lab：write ...`\n\n## 阶段别名\n\n"
+).replace(
   "- 始终使用 `skills/lab/SKILL.md` 作为工作流合同。\n",
   `- 始终使用 \`skills/lab/SKILL.md\` 作为工作流合同。\n${zhRecipeQuickPathLine}`
+).replace(
+  "- 用户显式调用 `/lab <stage> ...` 或 `/lab-<stage>` 时，要立刻执行该 stage，而不是只推荐别的阶段。\n",
+  "- 用户只要显式调用某个 stage，无论写成 `/lab:<stage>`、`/lab: <stage>`、`/lab <stage>`、`/lab-<stage>` 还是 `/lab：<stage>`，都要立刻执行该 stage，而不是只推荐别的阶段。\n"
 );
 
 ZH_CONTENT[path.join(".codex", "skills", "lab", "SKILL.md")] = `---

package/lib/install.cjs

@@ -1,6 +1,7 @@
 const fs = require("node:fs");
 const os = require("node:os");
 const path = require("node:path");
+const { CURRENT_AUTO_MODE_SCHEMA_FIELDS } = require("./auto_state.cjs");
 const { getLocalizedContent } = require("./i18n.cjs");
 
 const REPO_ROOT = path.resolve(__dirname, "..");
@@ -132,6 +133,68 @@ function installLabAssets(targetDir, force) {
   );
 }
 
+function autoModeSchemaFieldLine(label, lang) {
+  if (lang === "zh") {
+    const zhDefaults = {
+      "Autonomy level": "- 自治级别: L2",
+      "Approval status": "- 批准状态: draft",
+      "Terminal goal type": "- 终止目标类型: ",
+      "Terminal goal target": "- 终止目标目标值: ",
+      "Required terminal artifact": "- 终止目标工件: ",
+      "Primary gate": "- 主 gate: ",
+      "Secondary guard": "- 次级 guard: ",
+      "Promotion condition": "- 升格条件: ",
+      "Stop reason": "- 停止原因: ",
+      "Escalation reason": "- 升级原因: ",
+    };
+    return zhDefaults[label] || "";
+  }
+
+  const defaults = {
+    "Autonomy level": "- Autonomy level: L2",
+    "Approval status": "- Approval status: draft",
+    "Terminal goal type": "- Terminal goal type: ",
+    "Terminal goal target": "- Terminal goal target: ",
+    "Required terminal artifact": "- Required terminal artifact: ",
+    "Primary gate": "- Primary gate: ",
+    "Secondary guard": "- Secondary guard: ",
+    "Promotion condition": "- Promotion condition: ",
+    "Stop reason": "- Stop reason: ",
+    "Escalation reason": "- Escalation reason: ",
+  };
+  return defaults[label] || "";
+}
+
+function migrateAutoModeContext(targetDir, lang) {
+  const filePath = path.join(targetDir, ".lab", "context", "auto-mode.md");
+  if (!fs.existsSync(filePath)) {
+    return;
+  }
+
+  const existing = fs.readFileSync(filePath, "utf8");
+  const missing = CURRENT_AUTO_MODE_SCHEMA_FIELDS
+    .map(([label]) => label)
+    .filter((label) => {
+      const localizedLabel = autoModeSchemaFieldLine(label, lang).replace(/^- /, "").split(":")[0];
+      return !existing.includes(`${label}:`) && !existing.includes(`${localizedLabel}:`);
+    });
+  if (missing.length === 0) {
+    return;
+  }
+
+  const trimmed = existing.trimEnd();
+  const header =
+    lang === "zh"
+      ? "## Managed schema migration\n\n- 这段由 `superlab update` 补齐，用于把旧版 auto 契约升级到当前 schema。保留现有内容，只补缺失字段。\n"
+      : "## Managed schema migration\n\n- This block was added by `superlab update` to bring a legacy auto contract up to the current schema without overwriting your existing content.\n";
+  const body = missing
+    .map((label) => autoModeSchemaFieldLine(label, lang))
+    .filter(Boolean)
+    .join("\n");
+
+  fs.writeFileSync(filePath, `${trimmed}\n\n${header}${body}\n`);
+}
+
 function ensureConfiguredProjectDirs(targetDir) {
   const workflowConfigPath = path.join(targetDir, ".lab", "config", "workflow.json");
   if (!fs.existsSync(workflowConfigPath)) {
@@ -605,6 +668,7 @@ function installSuperlab({
   writePlatformShims(targetDir, resolvedLang, force);
   writeManagedCoreFile(targetDir, resolvedLang, { force });
   localizeInstalledAssets(targetDir, resolvedLang, { newlyCreatedProjectOwnedPaths });
+  migrateAutoModeContext(targetDir, resolvedLang);
   ensureConfiguredProjectDirs(targetDir);
   chmodScripts(targetDir);
   const metadata = {

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

@@ -13,6 +13,21 @@ argument-hint: [stage] [target]
 
 Use the same repository artifacts and stage boundaries every time.
 
+## Accepted Stage Spellings
+
+Treat all of these as equivalent stage requests:
+
+- `/lab:idea ...`, `/lab: idea ...`, `/lab idea ...`, `/lab-idea`, `/lab：idea ...`
+- `/lab:data ...`, `/lab: data ...`, `/lab data ...`, `/lab-data`, `/lab：data ...`
+- `/lab:auto ...`, `/lab: auto ...`, `/lab auto ...`, `/lab-auto`, `/lab：auto ...`
+- `/lab:framing ...`, `/lab: framing ...`, `/lab framing ...`, `/lab-framing`, `/lab：framing ...`
+- `/lab:spec ...`, `/lab: spec ...`, `/lab spec ...`, `/lab-spec`, `/lab：spec ...`
+- `/lab:run ...`, `/lab: run ...`, `/lab run ...`, `/lab-run`, `/lab：run ...`
+- `/lab:iterate ...`, `/lab: iterate ...`, `/lab iterate ...`, `/lab-iterate`, `/lab：iterate ...`
+- `/lab:review ...`, `/lab: review ...`, `/lab review ...`, `/lab-review`, `/lab：review ...`
+- `/lab:report ...`, `/lab: report ...`, `/lab report ...`, `/lab-report`, `/lab：report ...`
+- `/lab:write ...`, `/lab: write ...`, `/lab write ...`, `/lab-write`, `/lab：write ...`
+
 ## Stage Aliases
 
 - `/lab idea ...` or `/lab-idea`
@@ -50,7 +65,7 @@ Use the same repository artifacts and stage boundaries every time.
 
 - Always use `skills/lab/SKILL.md` as the workflow contract.
 - Use `skills/lab/references/recipes.md` as the quick path for common stage chains; do not invent new slash commands or aliases from it.
-- When the user explicitly invokes `/lab <stage> ...` or a direct `/lab-<stage>` alias, execute that stage now against the provided argument instead of only recommending another lab stage.
+- When the user explicitly invokes a stage through `/lab:<stage>`, `/lab: <stage>`, `/lab <stage>`, `/lab-<stage>`, or `/lab：<stage>`, execute that stage now against the provided argument instead of only recommending another lab stage.
 - Start by giving the user a concise stage summary. Materialize managed artifacts immediately when the stage contract requires them, then report the output path and next step.
 - When ambiguity matters, ask one clarifying question at a time; when multiple paths are viable, present 2-3 approaches before converging.
 - `spec` is not complete until the approved change is frozen under `.lab/changes/<change-id>/`.

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

@@ -7,7 +7,22 @@ argument-hint: workflow question or stage choice
 
 `/lab` is a strict research workflow command family. Use the same repository artifacts and stage boundaries every time.
 
-## Subcommands
+## Accepted Stage Spellings
+
+Treat all of these as equivalent stage requests:
+
+- `/lab:idea ...`, `/lab: idea ...`, `/lab idea ...`, `/lab-idea`, `/lab：idea ...`
+- `/lab:data ...`, `/lab: data ...`, `/lab data ...`, `/lab-data`, `/lab：data ...`
+- `/lab:auto ...`, `/lab: auto ...`, `/lab auto ...`, `/lab-auto`, `/lab：auto ...`
+- `/lab:framing ...`, `/lab: framing ...`, `/lab framing ...`, `/lab-framing`, `/lab：framing ...`
+- `/lab:spec ...`, `/lab: spec ...`, `/lab spec ...`, `/lab-spec`, `/lab：spec ...`
+- `/lab:run ...`, `/lab: run ...`, `/lab run ...`, `/lab-run`, `/lab：run ...`
+- `/lab:iterate ...`, `/lab: iterate ...`, `/lab iterate ...`, `/lab-iterate`, `/lab：iterate ...`
+- `/lab:review ...`, `/lab: review ...`, `/lab review ...`, `/lab-review`, `/lab：review ...`
+- `/lab:report ...`, `/lab: report ...`, `/lab report ...`, `/lab-report`, `/lab：report ...`
+- `/lab:write ...`, `/lab: write ...`, `/lab write ...`, `/lab-write`, `/lab：write ...`
+
+## Stage Aliases
 
 - `/lab:idea`
   Research the idea through two brainstorm passes and two literature sweeps, define the problem and failure case, compare against closest prior work, then end with a source-backed recommendation and an explicit approval gate before any implementation.
@@ -44,7 +59,7 @@ argument-hint: workflow question or stage choice
 
 - Always use `skills/lab/SKILL.md` as the workflow contract.
 - Use `skills/lab/references/recipes.md` as the quick path for common stage chains; do not invent new slash commands or aliases from it.
-- When the user explicitly invokes `/lab:<stage>`, execute that stage now against the provided argument instead of only recommending another `/lab` stage.
+- When the user explicitly invokes a stage through `/lab:<stage>`, `/lab: <stage>`, `/lab <stage>`, `/lab-<stage>`, or `/lab：<stage>`, execute that stage now against the provided argument instead of only recommending another `/lab` stage.
 - Start by giving the user a concise stage summary. Materialize managed artifacts immediately when the stage contract requires them, then report the output path and next step.
 - When ambiguity matters, ask one clarifying question at a time; when multiple paths are viable, present 2-3 approaches before converging.
 - `/lab:spec` is not complete until the approved change is frozen under `.lab/changes/<change-id>/`.

package/package.json

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