baro-ai 0.23.6 → 0.25.0

package/dist/cli.mjs

@@ -8049,11 +8049,13 @@ function normalizePrd(input, source) {
   const branchName = typeof input.branchName === "string" ? input.branchName : "";
   const description = typeof input.description === "string" ? input.description : "";
   const stories = Array.isArray(input.userStories) ? input.userStories : [];
+  const decisionDocument = typeof input.decisionDocument === "string" && input.decisionDocument.trim().length > 0 ? input.decisionDocument : void 0;
   return {
     project,
     branchName,
     description,
-    userStories: stories.map((s, i) => normalizeStory(s, i, source))
+    userStories: stories.map((s, i) => normalizeStory(s, i, source)),
+    decisionDocument
   };
 }
 function normalizeStory(input, index, source) {
@@ -8794,6 +8796,12 @@ var Conductor = class extends Participant {
   spawnQueue = [];
   /** Stories currently in flight in the active level. */
   inFlight = /* @__PURE__ */ new Set();
+  /**
+   * Timer handle when we're deliberately spacing out intra-level
+   * spawns. Re-entering `fillSpawnSlots` while this is set is a
+   * no-op; the timer callback resumes pumping.
+   */
+  pendingNextSpawn = null;
   /** Resolved when the run terminates, exposed for callers that need it. */
   done;
   resolveDone;
@@ -8803,8 +8811,12 @@ var Conductor = class extends Participant {
       parallel: 0,
       timeoutSecs: 600,
       defaultModel: "sonnet",
+      intraLevelDelaySecs: 10,
       ...opts
     };
+    if (this.opts.intraLevelDelaySecs == null) {
+      this.opts.intraLevelDelaySecs = 10;
+    }
     this.done = new Promise((resolve2) => {
       this.resolveDone = resolve2;
     });
@@ -8950,10 +8962,25 @@ var Conductor = class extends Participant {
   }
   async fillSpawnSlots() {
     if (!this.currentLevel) return;
+    if (this.pendingNextSpawn) return;
     const cap = this.opts.parallel > 0 ? this.opts.parallel : Number.MAX_SAFE_INTEGER;
+    const delaySecs = this.opts.intraLevelDelaySecs ?? 0;
     while (this.spawnQueue.length > 0 && this.inFlight.size < cap) {
       const story = this.spawnQueue.shift();
       await this.requestStorySpawn(story);
+      if (this.spawnQueue.length > 0 && this.inFlight.size < cap && delaySecs > 0) {
+        this.pendingNextSpawn = setTimeout(() => {
+          this.pendingNextSpawn = null;
+          if (this.phase === "done") return;
+          this.fillSpawnSlots().catch((err) => {
+            process.stderr.write(
+              `[conductor] fillSpawnSlots resume failed: ${err?.stack ?? String(err)}
+`
+            );
+          });
+        }, delaySecs * 1e3);
+        return;
+      }
     }
   }
   async requestStorySpawn(story) {
@@ -9085,13 +9112,32 @@ ${prompt}`;
   }
   resolvePrompt(story) {
     const candidatePath = this.opts.promptTemplatePath ?? join(this.opts.cwd, "prompt.md");
+    let prompt;
     if (existsSync(candidatePath)) {
       const tpl = readFileSyncSafe(candidatePath);
-      if (tpl) {
-        return applyTemplate(tpl, story);
-      }
-    }
-    return buildDefaultStoryPrompt(story);
+      prompt = tpl ? applyTemplate(tpl, story) : buildDefaultStoryPrompt(story);
+    } else {
+      prompt = buildDefaultStoryPrompt(story);
+    }
+    const doc = this.prd?.decisionDocument;
+    if (doc && doc.trim().length > 0) {
+      const header = [
+        "## Design spec (authoritative \u2014 already decided)",
+        "",
+        "The Architect made these decisions before any story started.",
+        "Treat them as fixed: use these exact file paths, names,",
+        "schemas, API shapes, and dependency choices. Do NOT",
+        "improvise alternatives \u2014 your siblings are working from",
+        "the same spec and divergence breaks the build.",
+        "",
+        doc.trim(),
+        "",
+        "---",
+        ""
+      ].join("\n");
+      prompt = header + prompt;
+    }
+    return prompt;
   }
   emit(item) {
     this.envRef?.deliverContextItem(this, item);
@@ -9785,15 +9831,21 @@ var EXPLORATION_TOOLS = /* @__PURE__ */ new Set([
   "WebFetch",
   "WebSearch"
 ]);
+var BROADCAST_TOOLS = /* @__PURE__ */ new Set(["Read", "Grep", "Glob", "LSP"]);
 var Librarian = class extends Participant {
   opts;
   pending = /* @__PURE__ */ new Map();
   knowledge = [];
+  // Mid-flight bookkeeping
+  inFlight = /* @__PURE__ */ new Set();
+  storyHints = /* @__PURE__ */ new Map();
+  broadcastBytes = /* @__PURE__ */ new Map();
   constructor(opts = {}) {
     super();
     this.opts = {
       maxContentChars: opts.maxContentChars ?? 4e3,
-      maxInjectedChars: opts.maxInjectedChars ?? 8e3
+      maxInjectedChars: opts.maxInjectedChars ?? 2e4,
+      maxBroadcastBytesPerStory: opts.maxBroadcastBytesPerStory ?? 5e4
     };
   }
   /** All indexed knowledge entries, in order discovered. */
@@ -9834,9 +9886,11 @@ var Librarian = class extends Participant {
     }
     if (lines.length === 0) return null;
     return [
-      "[librarian] Findings from prior agents in this run that may save",
-      "you time. Do not re-fetch what's already here unless you suspect",
-      "the file changed.",
+      "## Codebase context (current as of this run)",
+      "",
+      "The following file contents and discovery results are authoritative",
+      "and up-to-date. Do not re-read or re-search unless you have specific",
+      "reason to suspect a file has changed since these were captured.",
       "",
       ...lines
     ].join("\n");
@@ -9850,6 +9904,18 @@ var Librarian = class extends Participant {
       this.completeWithOutput(source, item);
       return;
     }
+    if (item instanceof StorySpawnRequestItem) {
+      this.storyHints.set(item.storyId, tokenizeHints(item.prompt));
+      return;
+    }
+    if (item instanceof StorySpawnedItem) {
+      this.inFlight.add(item.storyId);
+      return;
+    }
+    if (item instanceof StoryResultItem) {
+      this.inFlight.delete(item.storyId);
+      return;
+    }
   }
   recordPending(source, item) {
     if (!EXPLORATION_TOOLS.has(item.name)) return;
@@ -9896,6 +9962,51 @@ var Librarian = class extends Participant {
         )
       );
     }
+    if (BROADCAST_TOOLS.has(entry.tool)) {
+      this.broadcastFinding(entry);
+    }
+  }
+  broadcastFinding(finding) {
+    if (this.inFlight.size === 0) return;
+    const envs = this.getEnvironments();
+    if (envs.length === 0) return;
+    const findingTokens = new Set(
+      [...finding.tags, finding.summary].join(" ").toLowerCase().split(/[^a-z0-9_/.\\-]+/).filter((t) => t.length >= 3)
+    );
+    const block = formatEntry(finding);
+    const text = [
+      "## Just-in-time codebase context",
+      "",
+      `Another agent in this run (${finding.sourceAgentId}) just`,
+      "discovered the following. It is authoritative and current;",
+      "use it directly without re-fetching.",
+      "",
+      block
+    ].join("\n");
+    const bytes = text.length;
+    for (const recipientId of this.inFlight) {
+      if (recipientId === finding.sourceAgentId) continue;
+      const recipientHints = this.storyHints.get(recipientId) ?? [];
+      if (recipientHints.length > 0) {
+        const overlap = recipientHints.some(
+          (h) => findingTokens.has(h.toLowerCase())
+        );
+        if (!overlap) continue;
+      }
+      const already = this.broadcastBytes.get(recipientId) ?? 0;
+      if (already + bytes > this.opts.maxBroadcastBytesPerStory) continue;
+      this.broadcastBytes.set(recipientId, already + bytes);
+      for (const env of envs) {
+        env.deliverContextItem(
+          this,
+          new AgentTargetedMessageItem(recipientId, text, {
+            source: "librarian",
+            finding: finding.summary,
+            from_agent: finding.sourceAgentId
+          })
+        );
+      }
+    }
   }
 };
 function describeCall(tool, args) {
@@ -9948,6 +10059,9 @@ function formatEntry(k) {
     ""
   ].join("\n");
 }
+function tokenizeHints(prompt) {
+  return prompt.toLowerCase().split(/[^a-z0-9_/.\-]+/).filter((t) => t.length >= 3);
+}
 
 // ../baro-orchestrator/src/participants/operator.ts
 var Operator = class extends Participant {
@@ -10412,6 +10526,7 @@ async function orchestrate(config) {
     timeoutSecs: config.timeoutSecs ?? 600,
     overrideModel: config.overrideModel ?? void 0,
     defaultModel: config.defaultModel ?? "opus",
+    intraLevelDelaySecs: config.intraLevelDelaySecs,
     onRunStart: useGit ? async (prd) => {
       baseSha = await getHeadSha(config.cwd);
       if (prd.branchName) {
@@ -10750,6 +10865,12 @@ function parseArgs(argv) {
       case "--surgeon-model":
         args.surgeonModel = required(argv, ++i, "--surgeon-model");
         break;
+      case "--intra-level-delay":
+        args.intraLevelDelaySecs = parseInt(
+          required(argv, ++i, "--intra-level-delay"),
+          10
+        );
+        break;
       default:
         process.stderr.write(`[cli] unknown flag: ${a}
 `);
@@ -10791,6 +10912,7 @@ function printHelp() {
       "  --with-surgeon        Enable Surgeon (adaptive DAG mutation)",
       "  --surgeon-use-llm     Use LLM evaluation in Surgeon (default: deterministic)",
       "  --surgeon-model <name> Model for Surgeon LLM (default: opus)",
+      "  --intra-level-delay <secs>  Stagger story spawns within a level (default: 10, 0 disables)",
       "  -h, --help            Show this message",
       ""
     ].join("\n")
@@ -10825,7 +10947,8 @@ async function main() {
     withSentry: args.noSentry ? false : void 0,
     withSurgeon: args.withSurgeon,
     surgeonUseLlm: args.surgeonUseLlm,
-    surgeonModel: args.surgeonModel
+    surgeonModel: args.surgeonModel,
+    intraLevelDelaySecs: args.intraLevelDelaySecs
   };
   process.stderr.write(
     `[cli] starting orchestrator: prd=${prdPath} cwd=${cwd} parallel=${args.parallel} timeout=${args.timeout}s