jules-orchestrator-kit 0.32.6 → 0.32.8

package/README.md

@@ -120,7 +120,7 @@ Autonomous coding agents can write software at 100× human speed—but unconstra
 
 * **🚀 Zero-Test Bootstrapping (`agentctl bootstrap`):** Synthesizes deterministic syntax-check and smoke-test verification oracles for untested legacy repositories so agents always operate against a falsifiable feedback loop.
 
-* **📈 Proven Scale & Reliability:** Empirically tested with **458 unit tests across 66 suites passing in < 10.0s**, supporting 300+ daily agent sessions per repository. An adversarial red-team suite (`test/adversarial-claims.test.mjs`) continuously attempts to falsify the safety guarantees documented above — including cross-platform probes for the case-insensitive filesystems on macOS and Windows — and a documentation-sync gate (`scripts/doc-sync-check.mjs`) blocks any release whose docs have drifted from the code.
+* **📈 Proven Scale & Reliability:** Empirically tested with **461 unit tests across 66 suites passing in < 10.0s**, supporting 300+ daily agent sessions per repository. An adversarial red-team suite (`test/adversarial-claims.test.mjs`) continuously attempts to falsify the safety guarantees documented above — including cross-platform probes for the case-insensitive filesystems on macOS and Windows — and a documentation-sync gate (`scripts/doc-sync-check.mjs`) blocks any release whose docs have drifted from the code.
 
 <br/>
 

package/bin/agentctl.mjs

@@ -12,11 +12,11 @@ import { reapOrphanedIntents, reapStaleMutexDirs } from "../src/journal.mjs";
 const args = process.argv.slice(2);
 const command = args[0];
 
-export const VERSION = "0.32.6";
+export const VERSION = "0.32.8";
 
 export function printHelp() {
   console.log(`
-🚀 agentctl v0.32.6 — Universal Agent Orchestrator & Safety Gatekeeper
+🚀 agentctl v0.32.8 — Universal Agent Orchestrator & Safety Gatekeeper
 
 Usage: agentctl <command> [options]
 
@@ -62,6 +62,7 @@ Options:
 `);
 }
 
+
 async function main() {
   if (!command || command === "--help" || command === "-h") {
     printHelp();
@@ -69,7 +70,14 @@ async function main() {
   }
 
   if (command === "version" || command === "--version" || command === "-v") {
-    console.log("agentctl v0.32.6");
+    console.log(`agentctl v${VERSION}`);
+    process.exit(0);
+  }
+
+  // Intercept --help / -h on any subcommand (e.g. `agentctl init --help`)
+  const subArgs = args.slice(1);
+  if (subArgs.includes("--help") || subArgs.includes("-h")) {
+    printHelp();
     process.exit(0);
   }
 
@@ -171,6 +179,7 @@ async function main() {
           fix: { type: "boolean" },
           "allow-protected": { type: "boolean" },
           json: { type: "boolean", short: "j" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });
@@ -304,7 +313,7 @@ async function main() {
     }
 
     case "doctor": {
-      console.log(`\n🔍 agentctl System Diagnostics (v0.29.1)`);
+      console.log(`\n🔍 agentctl System Diagnostics (v${VERSION})`);
       console.log(`--------------------------------------------------`);
       console.log(`  Project Root     : ${root}`);
       console.log(`  Config File      : ${config._file || "None (Using defaults)"}`);
@@ -323,6 +332,7 @@ async function main() {
         args: args.slice(1),
         options: {
           force: { type: "boolean", short: "f" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });
@@ -372,6 +382,7 @@ async function main() {
           interactive: { type: "boolean", short: "i" },
           tier: { type: "string", short: "t" },
           json: { type: "boolean", short: "j" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });
@@ -412,6 +423,7 @@ async function main() {
             "require-plan-approval": { type: "boolean" },
             repoless: { type: "boolean" },
             json: { type: "boolean", short: "j" },
+            "dry-run": { type: "boolean", short: "d" },
           },
           allowPositionals: true,
         });
@@ -449,6 +461,7 @@ async function main() {
             list: { type: "boolean", short: "l" },
             json: { type: "boolean", short: "j" },
             "verify-cmd": { type: "string", short: "v" },
+            "dry-run": { type: "boolean", short: "d" },
           },
           allowPositionals: true,
         });
@@ -497,6 +510,7 @@ async function main() {
             web: { type: "boolean", short: "w" },
             json: { type: "boolean", short: "j" },
             "verify-cmd": { type: "string", short: "v" },
+            "dry-run": { type: "boolean" },
           },
           allowPositionals: true,
         });
@@ -559,7 +573,7 @@ async function main() {
     case "status": {
       const queueDir = getQueueDir(root);
       const files = existsSync(queueDir) ? readdirSync(queueDir).filter((f) => isTaskFile(f, queueDir)) : [];
-      console.log(`\n📊 agentctl Status Summary (v0.29.1)`);
+      console.log(`\n📊 agentctl Status Summary (v${VERSION})`);
       console.log(`--------------------------------------------------`);
       console.log(`  Project Root     : ${root}`);
       console.log(`  Pending Tasks    : ${files.length}`);
@@ -653,6 +667,7 @@ async function main() {
           spec: { type: "string", short: "s" },
           run: { type: "boolean", short: "r" },
           json: { type: "boolean", short: "j" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });
@@ -698,6 +713,7 @@ async function main() {
           options: {
             target: { type: "string", short: "t", default: "all" },
             json: { type: "boolean", short: "j" },
+            "dry-run": { type: "boolean", short: "d" },
           },
           allowPositionals: true,
         });
@@ -746,6 +762,7 @@ async function main() {
           task: { type: "string" },
           agent: { type: "string" },
           json: { type: "boolean", short: "j" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });
@@ -798,6 +815,7 @@ async function main() {
           manifest: { type: "string", short: "m" },
           markdown: { type: "string" },
           json: { type: "boolean", short: "j" },
+          "dry-run": { type: "boolean", short: "d" },
         },
         allowPositionals: true,
       });

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * Google Jules Orchestrator Kit - Node.js SDK (v0.29.1)
+ * Google Jules Orchestrator Kit - Node.js SDK
  *
  * Exposes core orchestrator functions for programmatically driving agent tasks,
  * security auditing, repo gating, and state operations.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jules-orchestrator-kit",
-  "version": "0.32.6",
+  "version": "0.32.8",
   "description": "Orchestration kit for running Google Jules autonomous agents.",
   "repository": {
     "type": "git",

package/scripts/utils.mjs

@@ -135,9 +135,15 @@ export function checkDailyBudget(arg1 = resolveRoot(), arg2 = 300) {
   return res;
 }
 
-export function reserveDailyBudget(maxSessions = 300, taskKey = "") {
-  appendLedger({ event: "budget_reserved", key: taskKey });
-  const check = checkDailyBudget(maxSessions);
+/**
+ * @param {number} [maxSessions=300]
+ * @param {string} [taskKey=""]
+ * @param {string} [root] - Ledger root. Defaults to the git toplevel. Pass an
+ *   explicit root to keep callers (notably tests) off the operator's real ledger.
+ */
+export function reserveDailyBudget(maxSessions = 300, taskKey = "", root = resolveRoot()) {
+  appendLedger({ event: "budget_reserved", key: taskKey }, root);
+  const check = checkDailyBudget(root, maxSessions);
   return { ok: check.ok, used: check.used, budget: maxSessions };
 }
 

package/src/dashboard.mjs

@@ -4,10 +4,15 @@
  */
 
 import http from "node:http";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { join, dirname } from "node:path";
 import { readTelemetry, verifyTelemetryIntegrity } from "./telemetry.mjs";
 import { readVerifyRuns, flakyVerdict } from "./flaky-ledger.mjs";
 import { lockStatus } from "./state.mjs";
 
+const pkgVersion = JSON.parse(readFileSync(join(dirname(fileURLToPath(import.meta.url)), "..", "package.json"), "utf-8")).version;
+
 export function getDashboardHtml(root = process.cwd()) {
   return `<!DOCTYPE html>
 <html lang="en">
@@ -32,7 +37,7 @@ export function getDashboardHtml(root = process.cwd()) {
   </style>
 </head>
 <body>
-  <h1>🚀 jules-orchestrator-kit Dashboard (v0.29.1)</h1>
+  <h1>🚀 jules-orchestrator-kit Dashboard (v${pkgVersion})</h1>
   <div class="subtitle">Repository: <code>${root}</code></div>
 
   <div class="grid">

package/src/engine.mjs

@@ -695,7 +695,12 @@ export async function dispatch(task = {}, opts = {}) {
   }
   const root = opts.config?._root || opts.root || process.cwd();
   const config = opts.config || loadConfig(root);
-  const { provider, routed, classification } = resolveRoutedProvider(task, config);
+  // opts.provider mirrors gate()'s existing injection point, so a caller can
+  // exercise dispatch without reaching a live provider.
+  const resolved = resolveRoutedProvider(task, config);
+  const provider = opts.provider || resolved.provider;
+  const routed = opts.provider ? false : resolved.routed;
+  const classification = opts.provider ? null : resolved.classification;
   if (routed && classification) {
     appendTelemetry(root, "router_decision", {
       tier: classification.tier,
@@ -739,12 +744,16 @@ export async function dispatch(task = {}, opts = {}) {
 
   const cleanTask = { ...task, prompt: envelopedPrompt };
 
+  const runDispatch = () => provider.dispatch(cleanTask, { root, dryRun: opts.dryRun });
+
   try {
-    const session = await withBudget(
-      () => provider.dispatch(cleanTask, { root, dryRun: opts.dryRun }),
-      root,
-      config.limits.dailyTasks
-    );
+    // A dry run performs no provider call and produces no work, so it must not
+    // consume one of the operator's finite daily task slots. Reserving here also
+    // made every `npm test` burn real budget, which eventually exhausted the
+    // ledger and turned the suite red for reasons unrelated to any code change.
+    const session = opts.dryRun
+      ? await runDispatch()
+      : await withBudget(runDispatch, root, config.limits.dailyTasks);
     return classification ? { ...session, _routeTier: classification.tier, _routeReason: classification.reason } : session;
   } catch (err) {
     if (err instanceof ProviderRateLimitError || err instanceof ProviderUnavailableError) {