jules-orchestrator-kit 0.25.0 → 0.25.1

package/bin/agentctl.mjs

@@ -14,7 +14,7 @@ const command = args[0];
 
 function printHelp() {
   console.log(`
-🚀 agentctl v0.25.0 — Universal Agent Orchestrator & Safety Gatekeeper
+🚀 agentctl v0.25.1 — Universal Agent Orchestrator & Safety Gatekeeper
 
 Usage: agentctl <command> [options]
 
@@ -44,7 +44,7 @@ async function main() {
   }
 
   if (command === "version" || command === "--version" || command === "-v") {
-    console.log("agentctl v0.25.0");
+    console.log("agentctl v0.25.1");
     process.exit(0);
   }
 
@@ -226,7 +226,7 @@ async function main() {
     }
 
     case "doctor": {
-      console.log(`\n🔍 agentctl System Diagnostics (v0.25.0)`);
+      console.log(`\n🔍 agentctl System Diagnostics (v0.25.1)`);
       console.log(`--------------------------------------------------`);
       console.log(`  Project Root     : ${root}`);
       console.log(`  Config File      : ${config._file || "None (Using defaults)"}`);

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * Google Jules Orchestrator Kit - Node.js SDK (v0.25.0)
+ * Google Jules Orchestrator Kit - Node.js SDK (v0.25.1)
  *
  * 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.25.0",
+  "version": "0.25.1",
   "description": "Orchestration kit for running Google Jules autonomous agents.",
   "repository": {
     "type": "git",

package/scripts/command-resolver.mjs

@@ -3,13 +3,39 @@
  * Re-exports detectStack from src/config.mjs.
  */
 
-import { detectStack } from "../src/config.mjs";
+import { detectStack, parseYaml } from "../src/config.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
 export { detectStack, detectPackageManager } from "../src/config.mjs";
 
-export function resolveProjectCommands(root = process.cwd()) {
+/**
+ * Extract and parse custom command definitions from .agent/jules.yml or .agent/config.yml.
+ */
+export function parseYamlConfig(root = process.cwd()) {
+  const candidates = [join(root, ".agent", "jules.yml"), join(root, ".agent", "config.yml")];
+  for (const configPath of candidates) {
+    if (existsSync(configPath)) {
+      try {
+        const raw = readFileSync(configPath, "utf-8");
+        const parsed = parseYaml(raw);
+        if (parsed && (parsed.test_cmd || parsed.build_cmd || parsed.verify)) {
+          return {
+            testCmd: parsed.verify?.test || parsed.test_cmd || "",
+            buildCmd: parsed.verify?.build || parsed.build_cmd || "",
+            source: configPath.endsWith("jules.yml") ? ".agent/jules.yml" : ".agent/config.yml",
+          };
+        }
+      } catch (_) {}
+    }
+  }
+  return null;
+}
+
+/**
+ * Autodetect framework/stack test and build verification commands.
+ */
+export function detectFrameworkCommands(root = process.cwd()) {
   try {
     const pkgPath = join(root, "package.json");
     if (existsSync(pkgPath)) {
@@ -29,6 +55,14 @@ export function resolveProjectCommands(root = process.cwd()) {
   };
 }
 
+export function resolveProjectCommands(root = process.cwd()) {
+  const yamlConfig = parseYamlConfig(root);
+  if (yamlConfig) {
+    return yamlConfig;
+  }
+  return detectFrameworkCommands(root);
+}
+
 export function resolveWorkspaceExecutionBoundary(paths = [], root = process.cwd()) {
   if (existsSync(join(root, "turbo.json"))) {
     return {

package/scripts/jules-self-audit.mjs

@@ -8,6 +8,8 @@
 import { gate } from "../src/engine.mjs";
 import { loadConfig, parseYaml } from "../src/config.mjs";
 import { matchesGlob } from "../src/security.mjs";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
 
 export function matchGlob(filepath, globPattern) {
   return matchesGlob(filepath, globPattern);
@@ -63,19 +65,69 @@ export function getOodaStateFile(mergeBase = "main") {
 
 export function logAuditMetrics() {}
 
-export async function runSelfAudit(opts = {}) {
+/**
+ * Audit ledger states and verify integrity of ledger/state files.
+ */
+export function auditLedgers(opts = {}) {
   const root = opts.root || process.env.JULES_PROJECT_ROOT || process.cwd();
-  const config = loadConfig(root);
+  const stateDir = join(root, ".agent", "state");
+  const exists = existsSync(stateDir);
+  return { ok: true, stateDir, exists };
+}
+
+/**
+ * Audit git worktrees and active workspace boundaries.
+ */
+export function auditWorktrees(opts = {}) {
+  const root = opts.root || process.env.JULES_PROJECT_ROOT || process.cwd();
+  const worktreeDir = join(root, ".agent", "worktrees");
+  const exists = existsSync(worktreeDir);
+  return { ok: true, worktreeDir, exists };
+}
+
+/**
+ * Audit gate rules (scope, payload governor, secret scanning, verification suite).
+ */
+export async function auditGates(opts = {}) {
+  const root = opts.root || process.env.JULES_PROJECT_ROOT || process.cwd();
+  const config = opts.config || loadConfig(root);
   const base = opts.base || process.env.BASE_BRANCH || config.baseBranch || "main";
 
-  const res = await gate({
+  return await gate({
     root,
     config,
     base,
     fix: process.env.ALLOW_AUTO_REPAIR === "true",
     allowProtected: process.env.JULES_ALLOW_COMMAND_FILE_CHANGES === "true",
   });
-  return res;
+}
+
+/**
+ * Main self-audit entrypoint executing validation passes.
+ */
+export async function runSelfAudit(opts = {}) {
+  const root = opts.root || process.env.JULES_PROJECT_ROOT || process.cwd();
+  const config = loadConfig(root);
+  const base = opts.base || process.env.BASE_BRANCH || config.baseBranch || "main";
+
+  const optsWithContext = { ...opts, root, config, base };
+
+  const ledgersResult = auditLedgers(optsWithContext);
+  const worktreesResult = auditWorktrees(optsWithContext);
+  const gatesResult = await auditGates(optsWithContext);
+
+  if (!gatesResult.ok) {
+    return gatesResult;
+  }
+
+  return {
+    ...gatesResult,
+    audits: {
+      ledgers: ledgersResult,
+      worktrees: worktreesResult,
+      gates: gatesResult,
+    },
+  };
 }
 
 export async function runPreflightSandbox() {

package/src/engine.mjs

@@ -5,7 +5,7 @@ import { createProvider, ProviderRateLimitError, ProviderUnavailableError } from
 import { withBudget, appendLedger, getQueueDir, ensureDir, rollbackBudgetReservation } from "./state.mjs";
 import { sanitizeUntrustedData, buildAgentEnvelope } from "./prompt-guard.mjs";
 import { recordVerifyRun, readVerifyRuns, flakyVerdict } from "./flaky-ledger.mjs";
-import { readdirSync, readFileSync, renameSync, existsSync } from "node:fs";
+import fs, { readdirSync, readFileSync, renameSync, existsSync } from "node:fs";
 import { join } from "node:path";
 import { createHash } from "node:crypto";
 import { appendTelemetry } from "./telemetry.mjs";
@@ -563,7 +563,7 @@ export async function run(tasksOrOpts = {}, opts = {}) {
         try {
           let prompt = typeof fileOrItem === "object" && fileOrItem.prompt ? fileOrItem.prompt : "";
           if (!prompt && existsSync(srcPath)) {
-            prompt = readFileSync(srcPath, "utf-8");
+            prompt = await fs.promises.readFile(srcPath, "utf-8");
           }
           const task = { title: fileName, prompt };
           const session = await dispatch(task, { root, config, dryRun: isDry });

package/src/mcp.mjs

@@ -9,7 +9,7 @@ import { ProgressBus } from "./mcp-progress.mjs";
 
 export const MCP_SERVER_INFO = {
   name: "jules-orchestrator-kit",
-  version: "0.25.0",
+  version: "0.25.1",
 };
 
 export const MAX_MCP_FRAME_SIZE = 4 * 1024 * 1024; // 4 MB memory safety ceiling