@llm4ts/shell 2.40.1 → 2.42.0

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",
+    "  --task-concurrency <n> coders one story may hold at once (default 2): a task the plan",
+    "                      says needs nothing still running goes to a free coder in its own",
+    "                      worktree; 1 runs every task in order. LLM4TS_TASK_CONCURRENCY 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",
@@ -87,6 +90,7 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
     let judgeRounds;
     let deferFindings = false;
     let mergeRevisions;
+    let taskConcurrency;
     let land;
     let keepWorktrees = false;
     let list = false;
@@ -146,6 +150,21 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
             }
             concurrency = parsed;
         }
+        else if (argument === "--task-concurrency" || argument.startsWith("--task-concurrency=")) {
+            const raw = argument.includes("=")
+                ? argument.slice("--task-concurrency=".length)
+                : argv[index + 1];
+            if (!argument.includes("=")) {
+                index += 1;
+            }
+            const parsed = Number.parseInt(raw ?? "", 10);
+            if (!Number.isInteger(parsed) || parsed < 1 || String(parsed) !== (raw ?? "").trim()) {
+                return yield* ScriptUsage.make({
+                    message: `--task-concurrency requires a positive integer\n${epicUsage}`
+                });
+            }
+            taskConcurrency = parsed;
+        }
         else if (argument === "--merge-revisions" || argument.startsWith("--merge-revisions=")) {
             const raw = argument.includes("=")
                 ? argument.slice("--merge-revisions=".length)
@@ -187,6 +206,7 @@ export const parseEpicArgs = (argv) => Effect.gen(function* () {
         judgeRounds,
         deferFindings,
         mergeRevisions,
+        taskConcurrency,
         land,
         keepWorktrees,
         list,
@@ -206,6 +226,18 @@ export const mergeRevisionsOption = (flag, environment) => {
     const raw = environment.LLM4TS_MERGE_REVISIONS?.trim() ?? "";
     return /^\d+$/u.test(raw) ? { mergeRevisions: Number.parseInt(raw, 10) } : {};
 };
+/**
+ * Coders per story (ADR 0034): `--task-concurrency`, else
+ * `LLM4TS_TASK_CONCURRENCY`, else the executor's default. An unusable
+ * environment value falls back.
+ */
+export const taskConcurrencyOption = (flag, environment) => {
+    if (flag !== undefined) {
+        return { taskConcurrency: flag };
+    }
+    const raw = environment.LLM4TS_TASK_CONCURRENCY?.trim() ?? "";
+    return /^[1-9]\d*$/u.test(raw) ? { taskConcurrency: 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() ?? "");
 /**
@@ -1690,6 +1722,7 @@ export const runEpicStories = (options) => Effect.gen(function* () {
             ].join("\n")),
             ...judgeRoundsOption(flags.judgeRounds, process.env),
             ...mergeRevisionsOption(flags.mergeRevisions, process.env),
+            ...taskConcurrencyOption(flags.taskConcurrency, process.env),
             concurrency,
             ...(deferring ? { deferNonBlocking: true } : {}),
             failFast: flags.failFast

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llm4ts/shell",
-  "version": "2.40.1",
+  "version": "2.42.0",
   "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.40.1",
-    "@llm4ts/runner": "2.40.1",
-    "@llm4ts/flow": "2.40.1"
+    "@llm4ts/core": "2.42.0",
+    "@llm4ts/flow": "2.42.0",
+    "@llm4ts/runner": "2.42.0"
   },
   "peerDependencies": {
     "effect": "4.0.0"