superlab 0.1.48 → 0.1.49

package/bin/superlab.cjs

@@ -39,7 +39,8 @@ 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>] [--objective <text>] [--campaign-kind <kind>] [--allowed-stages <csv>] [--autonomy-level <L1|L2|L3>]
+  superlab auto start [--target <dir>] [--campaign-kind <kind>] [--allowed-stages <csv>] [--autonomy-level <L1|L2|L3>|--l1|--l2|--l3] [--objective <text>|<objective>]
+  superlab auto experiment [--target <dir>] [--l1|--l2|--l3] <objective>
   superlab auto status [--target <dir>]
   superlab auto stop [--target <dir>]
   superlab update [--target <dir>]
@@ -219,7 +220,7 @@ function parsePaperArgs(argv) {
 
 function parseAutoArgs(argv) {
   const [action, ...rest] = argv;
-  if (!["start", "status", "stop"].includes(action || "")) {
+  if (!["start", "status", "stop", "experiment"].includes(action || "")) {
     throw new Error(`Unknown auto action: ${action || "(missing)"}`);
   }
   const options = {
@@ -230,13 +231,14 @@ function parseAutoArgs(argv) {
     requestedAllowedStages: "",
     requestedAutonomyLevel: "",
   };
+  const positionalObjectiveParts = [];
 
   for (let index = 0; index < rest.length; index += 1) {
     const value = rest[index];
     if (value === "--target") {
       options.targetDir = path.resolve(rest[index + 1]);
       index += 1;
-    } else if (action === "start" && value === "--objective") {
+    } else if ((action === "start" || action === "experiment") && value === "--objective") {
       options.requestedObjective = rest[index + 1] || "";
       index += 1;
     } else if (action === "start" && value === "--campaign-kind") {
@@ -245,14 +247,25 @@ function parseAutoArgs(argv) {
     } else if (action === "start" && value === "--allowed-stages") {
       options.requestedAllowedStages = rest[index + 1] || "";
       index += 1;
-    } else if (action === "start" && value === "--autonomy-level") {
+    } else if ((action === "start" || action === "experiment") && value === "--autonomy-level") {
       options.requestedAutonomyLevel = (rest[index + 1] || "").trim();
       index += 1;
+    } else if ((action === "start" || action === "experiment") && ["--l1", "--l2", "--l3"].includes(value)) {
+      options.requestedAutonomyLevel = value.slice(2).toUpperCase();
+    } else if (action === "start" || action === "experiment") {
+      positionalObjectiveParts.push(value);
     } else {
       throw new Error(`Unknown option: ${value}`);
     }
   }
 
+  if (!options.requestedObjective && positionalObjectiveParts.length > 0) {
+    options.requestedObjective = positionalObjectiveParts.join(" ").trim();
+  }
+  if (action === "experiment" && !options.requestedCampaignKind) {
+    options.requestedCampaignKind = "experiment-loop";
+  }
+
   return options;
 }
 
@@ -990,7 +1003,7 @@ async function main() {
       printAutoStatus(options);
       return;
     }
-    if (options.action === "start") {
+    if (options.action === "start" || options.action === "experiment") {
       const result = await startAutoMode({
         targetDir: options.targetDir,
         requestedContract: {

package/lib/auto_contracts.cjs

@@ -23,6 +23,12 @@ const AUTO_LEVEL_STAGE_ENVELOPES = {
 };
 const VALID_APPROVAL_STATUSES = new Set(["draft", "approved"]);
 const VALID_TERMINAL_GOAL_TYPES = new Set(["rounds", "metric-threshold", "task-completion"]);
+const CAMPAIGN_KIND_DEFAULT_STAGES = {
+  planning: ["idea", "data", "framing", "spec", "review", "report"],
+  spec: ["idea", "data", "framing", "spec", "review", "report"],
+  "experiment-loop": ["run", "iterate", "review", "report"],
+  "report-polish": ["review", "report", "write"],
+};
 const FROZEN_CORE_ALIASES = {
   mission: [path.join(".lab", "context", "mission.md")],
   framing: [
@@ -82,19 +88,23 @@ function inferCampaignKind({ campaignKind = "", allowedStages = [] }) {
 }
 
 function normalizeRequestedAutoContract(requested = {}) {
-  const allowedStages = Array.isArray(requested.allowedStages)
+  const rawAllowedStages = Array.isArray(requested.allowedStages)
     ? requested.allowedStages.map((stage) => String(stage).trim().toLowerCase()).filter(Boolean)
     : normalizeList(requested.allowedStages || "").map((stage) => stage.toLowerCase());
+  const normalizedCampaignKind =
+    isMeaningful(requested.campaignKind || "") || rawAllowedStages.length > 0
+      ? inferCampaignKind({
+          campaignKind: requested.campaignKind || "",
+          allowedStages: rawAllowedStages,
+        })
+      : "";
+  const allowedStages = rawAllowedStages.length > 0
+    ? rawAllowedStages
+    : [...(CAMPAIGN_KIND_DEFAULT_STAGES[normalizedCampaignKind] || [])];
   return {
     objective: (requested.objective || "").trim(),
     autonomyLevel: normalizeScalar(requested.autonomyLevel || ""),
-    campaignKind:
-      isMeaningful(requested.campaignKind || "") || allowedStages.length > 0
-        ? inferCampaignKind({
-            campaignKind: requested.campaignKind || "",
-            allowedStages,
-          })
-        : "",
+    campaignKind: normalizedCampaignKind,
     allowedStages,
   };
 }
@@ -539,6 +549,7 @@ module.exports = {
   REVIEW_CONTEXT_FILES,
   VALID_APPROVAL_STATUSES,
   VALID_TERMINAL_GOAL_TYPES,
+  CAMPAIGN_KIND_DEFAULT_STAGES,
   classifyAutoContractFit,
   changedSnapshotPaths,
   detectFrozenCoreChanges,

package/package.json

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