jules-orchestrator-kit 0.23.0 → 0.25.0

package/.agent/jules.yml

@@ -1,13 +0,0 @@
-# Google Jules Repository Configuration (Version 2)
-version: 2
-test_cmd: "npm test"
-build_cmd: ""
-forbidden_paths:
-  - ".github/**"
-  - "**/secrets/**"
-  - "**/*.pem"
-  - "**/lock-manager/**"
-  - "scripts/jules-self-audit.mjs"
-  - ".agent/jules.yml"
-allow_paths: []
-

package/.env.example

@@ -1,73 +0,0 @@
-# Google Jules Orchestration Kit - Environment Configuration Example
-# Copy this file to .env and populate with your credentials/settings.
-
-# --- Authentication & Core Settings ---
-# Google Jules API Key (Required for direct REST API dispatches)
-JULES_API_KEY=your_google_jules_api_key_here
-
-# Alias for API key (fallback if JULES_API_KEY is not set)
-# GEMINI_API_KEY=your_gemini_api_key_here
-
-# Override the Jules REST API URL
-# JULES_API_URL=https://jules.googleapis.com/v1alpha/sessions
-
-# Target GitHub Repository (Format: owner/repo)
-JULES_REPO=owner/repo
-
-# Set to "true" or "1" to run in repoless/serverless mode
-# JULES_REPOLESS=false
-
-# Enable Dry-Run mode to simulate payload dispatch without making API calls
-# JULES_DRY_RUN=false
-
-# --- Budget & Security Gatekeeper ---
-# Daily max session limit for autonomous dispatches (Default: 300)
-# JULES_DAILY_BUDGET=300
-
-# Allow modifications to command-defining files (package.json, Cargo.toml, etc.) in PRs (Default: false)
-# JULES_ALLOW_COMMAND_FILE_CHANGES=false
-
-# Allow modifications to agent rule files (AGENTS.md, JULES_RULES_TEMPLATE.md, .agent/rules/**) in PRs (Default: false)
-# JULES_ALLOW_AGENT_RULE_CHANGES=false
-
-# --- Execution Scope & Git ---
-# Base Branch for PR Audits & Merge-Base Calculations (Default: main)
-BASE_BRANCH=main
-
-# PR Head Branch (Used by CI to dynamically target branches during OODA repair)
-# GITHUB_HEAD_REF=my-feature-branch
-
-# Root directory of the project (Auto-assigned during swarm executions)
-# JULES_PROJECT_ROOT=/path/to/project
-
-# --- Swarm & Concurrency ---
-# Maximum parallel dispatches for swarm runs (Default: 3)
-JULES_SWARM_CONCURRENCY=3
-
-# Dispatch Stagger Interval in Milliseconds (Default: 1500)
-JULES_SWARM_STAGGER_MS=1500
-
-# Rate-limit for the jules:queue command (Default: 500)
-# JULES_PACE_MS=500
-
-# Use Git Worktrees instead of cloning for swarm isolation
-# JULES_USE_WORKTREES=false
-
-# Current slot index for partitioning tasks (Swarm mode)
-# JULES_SLOT_INDEX=1
-
-# Total number of slots for partitioning tasks (Swarm mode)
-# JULES_SLOT_TOTAL=3
-
-# --- CI & Output ---
-# Is this running in a CI environment? (Changes log output and fail-fast behaviors)
-# CI=true
-
-# Allow OODA Auto-Repair even in CI environments
-# ALLOW_AUTO_REPAIR=true
-
-# GitHub Actions Step Summary File Path
-# GITHUB_STEP_SUMMARY=/path/to/step_summary.md
-
-# Disable color in terminal output
-# NO_COLOR=true

package/.github/workflows/jules-audit.yml

@@ -1,49 +0,0 @@
-name: Jules PR Audit & Test Gatekeeper
-
-on:
-  push:
-    branches: [ main ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  audit-and-test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: ['20.x', '22.x', '24.x']
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-
-      - name: Cache OODA state & ledgers
-        uses: actions/cache@v4
-        with:
-          path: .agent/state/
-          key: ooda-state-${{ runner.os }}-${{ github.run_id }}
-          restore-keys: |
-            ooda-state-${{ runner.os }}-
-
-      - name: Install dependencies
-        run: npm install
-
-      - name: Run Linter
-        run: npm run lint --if-present
-
-      - name: Run Unit Tests
-        run: npm test --if-present
-
-      - name: Run Jules PR Self-Audit Gatekeeper
-        if: matrix.node-version == '22.x' && github.event_name == 'pull_request'
-        run: node scripts/jules-self-audit.mjs
-        env:
-          CI: "true"
-          BASE_BRANCH: "main"
-

package/scripts/jules-cleanup.mjs

@@ -1,49 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Backward compatibility shim for jules-cleanup.mjs in v0.9.0.
- */
-
-export function extractPrUrls(outputs = []) {
-  const prs = [];
-  const regex = /https:\/\/github\.com\/[^\s/]+\/[^\s/]+\/pull\/\d+/g;
-  for (const item of outputs) {
-    const text = typeof item === "string" ? item : item?.link || JSON.stringify(item);
-    const matches = text.match(regex);
-    if (matches) {
-      for (const m of matches) {
-        if (!prs.includes(m)) prs.push(m);
-      }
-    }
-  }
-  return prs;
-}
-
-export function auditSessions(sessions = [], opts = {}) {
-  const staleHoursThreshold = opts.staleHoursThreshold || 24;
-  const now = Date.now();
-  const merged = [];
-  const active = [];
-  const stale = [];
-
-  for (const s of sessions) {
-    if (s.state === "MERGED") {
-      merged.push(s);
-    } else {
-      const updatedMs = s.updateTime ? new Date(s.updateTime).getTime() : now;
-      const ageHours = (now - updatedMs) / (1000 * 60 * 60);
-      if (ageHours > staleHoursThreshold) {
-        stale.push(s);
-      } else {
-        active.push(s);
-      }
-    }
-  }
-
-  return { merged, active, stale };
-}
-
-if (process.argv[1] && process.argv[1].endsWith("jules-cleanup.mjs")) {
-  console.log("[Shim] Cleanup audit completed.");
-  process.exit(0);
-}

package/scripts/jules-swarm.mjs

@@ -1,38 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Backward compatibility shim for jules-swarm.mjs in v0.9.0.
- */
-
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-
-export function buildSyncManifest(tasks = []) {
-  const reservations = tasks.map((t) => ({ id: t.id, title: t.title, scope: t.scope }));
-  return {
-    version: 1,
-    totalTasks: tasks.length,
-    reservations,
-  };
-}
-
-export async function pushReservationManifest(manifest, projectRoot = process.cwd()) {
-  const isDry = process.env.JULES_DRY_RUN === "true" || process.env.JULES_DRY_RUN === "1";
-  const isRemote = process.env.JULES_SWARM_REMOTE_PUSH === "true";
-
-  const agentDir = join(projectRoot, ".agent");
-  if (!existsSync(agentDir)) {
-    try { mkdirSync(agentDir, { recursive: true }); } catch (_) {}
-  }
-  const manifestPath = join(agentDir, "sync-manifest.json");
-  try { writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), "utf-8"); } catch (_) {}
-
-  if (isDry) return { status: "DRY_RUN", path: manifestPath };
-  if (isRemote) return { status: "PUSHED", path: manifestPath };
-  return { status: "SAVED_LOCAL", path: manifestPath };
-}
-
-if (process.argv[1] && process.argv[1].endsWith("jules-swarm.mjs")) {
-  console.log("[Shim] Running swarm via engine.run()...");
-  process.exit(0);
-}

package/scripts/lock-manager.mjs

@@ -1,22 +0,0 @@
-/**
- * Backward compatibility shim for lock-manager.mjs in v0.9.0.
- * Delegates to src/state.mjs.
- */
-
-import { acquireLock, releaseLock, lockStatus } from "../src/state.mjs";
-
-export function acquire(agent, taskId, filePaths = [], opts = {}) {
-  return acquireLock(agent, taskId, filePaths, opts);
-}
-
-export function release(agent, taskId, opts = {}) {
-  return releaseLock(agent, taskId, opts);
-}
-
-export function status(opts = {}) {
-  return lockStatus(opts);
-}
-
-export function cleanup() {
-  return { removed: 0 };
-}