llm-orchestrator 1.2.7 → 1.2.8

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "llm-orchestrator",
   "description": "Write /task once — it plans the work, shards it across parallel subagents, gates every phase and verifies before claiming done. Claude Code, Codex, OpenCode, Kilo.",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "author": {
     "name": "Bogdan-Gabriel Torcescu",
     "url": "https://www.linkedin.com/in/bogdantorcescu/"

package/README.md

@@ -365,8 +365,8 @@ more instructions:
   it, runs opened without a PlanShard count, runs that planned several shards but started no
   subagents, and runs still open.
 - Trivial is the narrow exception — a one-line change such as a typo or a version bump. A run
-  declared trivial that then edits a second file, touches tests, or keeps working past eight calls
-  (an investigation is not trivial) gets one reminder to reopen it as
+  declared trivial that then edits a second file, touches tests, queries a live source twice, or keeps
+  working past eight calls (an investigation is not trivial) gets one reminder to reopen it as
   a typed run, and counts as `trivial_overreach` in the audit. Trivial runs close at the end of the
   turn (`Stop` hook), so single-prompt sessions still reach the history. Typed runs stay open across
   turns and close when the session ends (`SessionEnd`), so an unclosed run is never lost.

package/lib/flow-gate.mjs

@@ -52,6 +52,11 @@ export function overreachWorkNudgeFor(cli = 'llm-orchestrator', calls = 9) {
   return `This task was declared trivial, but it has now made ${calls} work calls — trivial is a one-line change, not an investigation. Reopen it as a typed run (\`${cli} run start --type <TYPE> --shards <n>\`) so it is classified, planned and verified like one.`;
 }
 
+/** A run declared trivial that is querying live sources. */
+export function overreachLiveNudgeFor(cli = 'llm-orchestrator', live = 2) {
+  return `This task was declared trivial, but it has now queried live sources ${live} times — an investigation over production evidence is not trivial. Reopen it as a typed run (\`${cli} run start --type INCIDENT|INVESTIGATION --shards <n>\`), where independent live sources are shards for collectors.`;
+}
+
 // Edit-shaped tools, per harness. Only a short hash of each path is kept.
 const EDIT_TOOLS = new Set(['edit', 'write', 'multiedit', 'notebookedit', 'str_replace_based_edit_tool', 'apply_patch', 'patch']);
 const TEST_PATH = /(^|\/)(test|tests|__tests__|spec|specs)\/|[._-](test|spec)\.[a-z0-9]+$|(^|\/)test_[^/]+\.py$|_spec\.rb$/i;
@@ -122,6 +127,8 @@ export const INLINE_REASON = /^stateful:\s*\S/;
 
 // A: a trivial run is a one-line change, not an investigation.
 export const TRIVIAL_WORK_LIMIT = 8;
+// Querying a live source more than once is an investigation, however few calls it takes.
+export const TRIVIAL_LIVE_LIMIT = 2;
 
 // C: sources whose reads cost real time and live remotely — the reads that pay to fan out.
 const LIVE_SOURCE = /(^|[\s;&|(])(rtk\s+)?(ssh|scp|psql|mysql|mongosh|mongo|redis-cli|kubectl|docker\s+(exec|logs)|aws|gcloud|az|curl|wget|http|httpie)(\s|$)/;
@@ -428,20 +435,24 @@ export function decide(previous, event, now) {
   if (session.run) {
     const current = session.run;
     current.main_work_calls = (current.main_work_calls ?? 0) + 1;
+    // Live reads count on every run, trivial ones included — they are what fan-out is for.
+    if (event.live) current.live_calls = (current.live_calls ?? 0) + 1;
     if (current.trivial) {
       current.edited_files = [...new Set([...(current.edited_files ?? []), ...event.edits.map((entry) => entry.hash)])];
       current.touched_tests = Boolean(current.touched_tests) || event.edits.some((entry) => entry.test);
       const grewByEdits = current.edited_files.length >= 2 || current.touched_tests;
       const grewByWork = current.main_work_calls > TRIVIAL_WORK_LIMIT;
-      if (!current.overreach_nudged && (grewByEdits || grewByWork)) {
+      const grewByLive = (current.live_calls ?? 0) >= TRIVIAL_LIVE_LIMIT;
+      if (!current.overreach_nudged && (grewByEdits || grewByWork || grewByLive)) {
         current.overreach_nudged = true;
         output = grewByEdits
           ? { additionalContext: overreachNudgeFor(undefined, current.edited_files.length), kind: 'overreach', files: current.edited_files.length }
-          : { additionalContext: overreachWorkNudgeFor(undefined, current.main_work_calls), kind: 'overreach', calls: current.main_work_calls };
+          : grewByLive
+            ? { additionalContext: overreachLiveNudgeFor(undefined, current.live_calls), kind: 'overreach', live: current.live_calls }
+            : { additionalContext: overreachWorkNudgeFor(undefined, current.main_work_calls), kind: 'overreach', calls: current.main_work_calls };
       }
       return { session, output, history };
     }
-    if (event.live) current.live_calls = (current.live_calls ?? 0) + 1;
     const evidence = EVIDENCE_TYPES.has(current.task_type);
     const step = (evidence ? EVIDENCE_CALLS_PER_SHARD : DISPATCH_CALLS_PER_SHARD) * (current.planned_shards ?? 0);
     const nudges = current.dispatch_nudges ?? (current.dispatch_nudged ? 1 : 0);
@@ -593,7 +604,8 @@ export async function handleHook({ payload, project, now = Date.now(), cli = 'll
   // decide() speaks in the default CLI spelling; the hook swaps in the runnable path.
   const text = result.output.kind === 'dispatch' ? dispatchNudgeFor(cli, result.output.planned, result.output.taskType)
     : result.output.kind === 'dispatch_followup' ? dispatchFollowupFor(cli, result.output.planned, result.output.taskType)
-    : result.output.kind === 'overreach' ? (result.output.calls ? overreachWorkNudgeFor(cli, result.output.calls) : overreachNudgeFor(cli, result.output.files))
+    : result.output.kind === 'overreach' ? (result.output.live ? overreachLiveNudgeFor(cli, result.output.live)
+      : result.output.calls ? overreachWorkNudgeFor(cli, result.output.calls) : overreachNudgeFor(cli, result.output.files))
       : nudgeFor(cli);
   return { hookSpecificOutput: { hookEventName: 'PreToolUse', additionalContext: text } };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-orchestrator",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Write /task once — it plans the work, shards it across parallel subagents, gates every phase and verifies before claiming done. Claude Code, Codex, OpenCode, Kilo.",
   "type": "module",
   "engines": {