@llm4ts/shell 2.39.0 → 2.40.1

package/flows/lib/epic-stories.js

@@ -60,6 +60,9 @@ export const epicUsage = [
     "  --fail-fast         stop the epic at the first failed story",
     "  --judge-rounds <n>  judge attempts per story (default 2 = one revision); a story the judge",
     "                      has not cleared after n attempts fails. LLM4TS_JUDGE_ROUNDS sets it too",
+    "  --merge-revisions <n> times a story whose merge turns the epic gates red goes back to",
+    "                      catch up and fix it before failing (default 1; 0 fails at once).",
+    "                      LLM4TS_MERGE_REVISIONS sets it too",
     "  --defer-findings    lighter review: only Critical findings are fixed in place (reviews",
     "                      settle, the judge clears without them); the rest are deferred and, once",
     "                      every story is merged, planned and run as one refine round.",
@@ -83,6 +86,7 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
     let concurrency;
     let judgeRounds;
     let deferFindings = false;
+    let mergeRevisions;
     let land;
     let keepWorktrees = false;
     let list = false;
@@ -142,6 +146,21 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
             }
             concurrency = parsed;
         }
+        else if (argument === "--merge-revisions" || argument.startsWith("--merge-revisions=")) {
+            const raw = argument.includes("=")
+                ? argument.slice("--merge-revisions=".length)
+                : argv[index + 1];
+            if (!argument.includes("=")) {
+                index += 1;
+            }
+            const parsed = Number.parseInt(raw ?? "", 10);
+            if (!Number.isInteger(parsed) || parsed < 0 || String(parsed) !== (raw ?? "").trim()) {
+                return yield* ScriptUsage.make({
+                    message: `--merge-revisions requires a non-negative integer\n${epicUsage}`
+                });
+            }
+            mergeRevisions = parsed;
+        }
         else if (argument === "--judge-rounds" || argument.startsWith("--judge-rounds=")) {
             const raw = argument.includes("=")
                 ? argument.slice("--judge-rounds=".length)
@@ -167,6 +186,7 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
         concurrency,
         judgeRounds,
         deferFindings,
+        mergeRevisions,
         land,
         keepWorktrees,
         list,
@@ -175,6 +195,17 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
         rest
     };
 });
+/**
+ * Merge revisions per story: `--merge-revisions`, else `LLM4TS_MERGE_REVISIONS`,
+ * else the executor's default. An unusable environment value falls back.
+ */
+export const mergeRevisionsOption = (flag, environment) => {
+    if (flag !== undefined) {
+        return { mergeRevisions: flag };
+    }
+    const raw = environment.LLM4TS_MERGE_REVISIONS?.trim() ?? "";
+    return /^\d+$/u.test(raw) ? { mergeRevisions: Number.parseInt(raw, 10) } : {};
+};
 /** `--defer-findings`, or `LLM4TS_DEFER_FINDINGS` set to 1/true/on/yes (ADR 0031). */
 export const deferFindingsEnabled = (flag, environment) => flag || /^(1|true|on|yes)$/i.test(environment.LLM4TS_DEFER_FINDINGS?.trim() ?? "");
 /**
@@ -1658,6 +1689,7 @@ export const runEpicStories = (options) => Effect.gen(function* () {
                 ...(orientation === undefined ? [] : ["", orientation])
             ].join("\n")),
             ...judgeRoundsOption(flags.judgeRounds, process.env),
+            ...mergeRevisionsOption(flags.mergeRevisions, process.env),
             concurrency,
             ...(deferring ? { deferNonBlocking: true } : {}),
             failFast: flags.failFast

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm4ts/shell",
-  "version": "2.39.0",
+  "version": "2.40.1",
   "description": "Interactive shell and CLI for llm4ts: flow discovery, run-a-flow, and view",
   "license": "MIT",
   "type": "module",
@@ -52,9 +52,9 @@
   "dependencies": {
     "@effect/platform-node": "4.0.0",
     "@effect/platform-node-shared": "4.0.0",
-    "@llm4ts/core": "2.39.0",
-    "@llm4ts/flow": "2.39.0",
-    "@llm4ts/runner": "2.39.0"
+    "@llm4ts/core": "2.40.1",
+    "@llm4ts/runner": "2.40.1",
+    "@llm4ts/flow": "2.40.1"
   },
   "peerDependencies": {
     "effect": "4.0.0"