jules-orchestrator-kit 0.23.0 → 0.25.0

package/README.md

@@ -1,24 +1,33 @@
-# jules-orchestrator-kit
+<div align="center">
 
-*Disclaimer: This is an independent open-source orchestration tool for Google Jules and is not officially affiliated with or endorsed by Google.*
+# 🚀 jules-orchestrator-kit
+
+### High-Volume Autonomous AI Agent Orchestration Engine for Google Jules
 
 [![Jules PR Audit](https://github.com/FullThrottle83/jules-orchestrator-kit/actions/workflows/jules-audit.yml/badge.svg)](https://github.com/FullThrottle83/jules-orchestrator-kit/actions/workflows/jules-audit.yml)
 [![npm version](https://img.shields.io/npm/v/jules-orchestrator-kit.svg)](https://www.npmjs.com/package/jules-orchestrator-kit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Version](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg)](https://nodejs.org)
+[![Zero Dependencies](https://img.shields.io/badge/dependencies-0%20native-blue.svg)](https://nodejs.org)
+
+<p align="center">
+  <b>Zero-dependency safety kernel and high-throughput orchestration engine for autonomous AI agent swarms.</b><br/>
+  Built specifically to execute 300+ daily agent sessions and parallel worktree swarms safely on native Node.js 20+ ESM.
+</p>
 
-> **High-Volume Autonomous Orchestration Engine for Google Jules**  
-> Built specifically to execute 300+ daily agent sessions and parallel swarms safely. Zero external runtime dependencies. Built strictly on native Node.js 20+ ESM.
+</div>
 
 ---
 
-![Autonomous Orchestration Pipeline](docs/assets/hero-flow.svg?v=3)
+<p align="center">
+  <img src="docs/assets/hero-flow.svg?v=3" alt="Autonomous Orchestration Pipeline" width="100%" />
+</p>
 
 ---
 
 ## ⚡ 2-Minute Quickstart
 
-Get up and running in under 2 minutes with zero complex configuration:
+> 💡 **TIP**: **New to Google Jules or agent automation?** You don't need any complex setup! `jules-orchestrator-kit` works out of the box with standard `npm test` and zero external dependencies.
 
 ```bash
 # 1. Initialize orchestrator structure in your target codebase
@@ -36,7 +45,7 @@ npx agentctl gate
 npx agentctl mcp
 ```
 
-> 📖 **Looking for production deployment patterns?**  
+> 📖 **NOTE**: **Looking for production deployment patterns?**  
 > Check out [**EXAMPLES.md**](./EXAMPLES.md) for 6 real-world recipes (Nightly TODO Scanner, Composite CI Action, Multi-Worktree Swarms, OODA Auto-Fix, MCP IDE setup, and Specialist Rosters).
 
 ---
@@ -55,17 +64,19 @@ Whether you are dispatching your first automated coding task or managing high-th
 
 ---
 
+## 🏛️ System Architecture & Visual Diagrams
+
 <details open>
-<summary><b>⚙️ Control Plane Architecture & Deep Dive</b></summary>
+<summary><b>📐 1. Control Plane Architecture Layers</b></summary>
 
 <br/>
 
-![Control Plane Architecture Layers](docs/assets/architecture-layers.svg?v=3)
+<p align="center">
+  <img src="docs/assets/architecture-layers.svg?v=3" alt="Control Plane Architecture Layers" width="100%" />
+</p>
 
 <br/>
 
-![Self-Healing OODA Loop](docs/assets/ooda-loop-cycle.svg?v=3)
-
 ### Engine System Highlights
 
 - **Native Task DAG Executor (`src/dag-engine.mjs`)**: Zero-dependency `DagExecutor` with Kahn's topological sort algorithm, SHA-256 interface fingerprinting post-task execution, and pre-execution cycle detection (`DagCycleError`).
@@ -80,12 +91,31 @@ Whether you are dispatching your first automated coding task or managing high-th
 
 </details>
 
-<details>
-<summary><b>🛡️ Zero-Trust Security Gatekeeper</b></summary>
+<details open>
+<summary><b>🔁 2. Self-Healing OODA Loop Cycle</b></summary>
 
 <br/>
 
-![Zero-Trust Security Guarantees](docs/assets/security-shield.svg?v=3)
+<p align="center">
+  <img src="docs/assets/ooda-loop-cycle.svg?v=3" alt="Self-Healing OODA Loop" width="100%" />
+</p>
+
+<br/>
+
+> 🚨 **IMPORTANT**: The OODA (Observe-Orient-Decide-Act) loop executes up to 3 repair attempts when tests fail. If the failure output oscillates deterministically without progress, the OODA engine halts repair to save API tokens and returns Exit Code 4.
+
+</details>
+
+<details open>
+<summary><b>🛡️ 3. Zero-Trust Security Shield & 4-Phase Gate</b></summary>
+
+<br/>
+
+<p align="center">
+  <img src="docs/assets/security-shield.svg?v=3" alt="Zero-Trust Security Guarantees" width="100%" />
+</p>
+
+<br/>
 
 ### The 4-Phase Safety Audit & Security Boundary (`agentctl gate`)
 
@@ -96,17 +126,35 @@ Whether you are dispatching your first automated coding task or managing high-th
 5. **Prompt Guard Boundary (`src/prompt-guard.mjs`)**: `sanitizeUntrustedData` strips bidi control characters, ANSI escape sequences, zero-width unicode, and neutralizes prompt injection tags (`<|im_start|>`, `[INST]`).
 6. **MCP Stream Isolation (`src/mcp.mjs`)**: Seals `process.stdout.write` framing stream to prevent log output from corrupting JSON-RPC stdio frames.
 
-> [!NOTE]
-> All security rules are fetched strictly from `origin/main` (never untrusted PR branches) to prevent prompt-injection attacks from altering security rules.
+> ⚠️ **WARNING**: All security rules are fetched strictly from `origin/main` (never untrusted PR branches) to prevent prompt-injection attacks from altering security rules.
 
 </details>
 
-<details>
-<summary><b>🔌 Model Context Protocol (MCP) & IDE Integration</b></summary>
+<details open>
+<summary><b>🐝 4. Parallel Swarm Topology & Isolated Worktrees</b></summary>
+
+<br/>
+
+<p align="center">
+  <img src="docs/assets/swarm-topology.svg?v=3" alt="Multi-Agent Swarm Topology" width="100%" />
+</p>
 
 <br/>
 
-![Dual-Way MCP Integration](docs/assets/mcp-integration.svg?v=3)
+> 📌 **NOTE**: Swarm execution spawns dedicated git worktrees for each task in parallel, isolated by VFS locks. Completed tasks are verified and merged back using 3-way AST/JSON structural merging (`agentctl swarm`).
+
+</details>
+
+<details open>
+<summary><b>🔌 5. Model Context Protocol (MCP) & IDE Integration</b></summary>
+
+<br/>
+
+<p align="center">
+  <img src="docs/assets/mcp-integration.svg?v=3" alt="Dual-Way MCP Integration" width="100%" />
+</p>
+
+<br/>
 
 ### Connecting to Claude Desktop, Cursor, or Antigravity
 
@@ -121,15 +169,40 @@ npx agentctl mcp
 - `audit_jules_gate`: Execute the 4-phase safety gate against the workspace.
 - `check_risk_tier`: Classify workspace changes into Risk Tiers (R0 Cosmetic to R3 Restricted).
 - `get_jules_status`: Fetch real-time status of active, pending, and completed tasks.
+- `telemetry_tail`: Query last N real-time telemetry events from the SHA-256 hash spine.
 
 </details>
 
-<details>
-<summary><b>🤖 Specialist Agent Prompt Presets (.agent/prompts/)</b></summary>
+<details open>
+<summary><b>💳 6. Subscription Tier Presets Matrix</b></summary>
+
+<br/>
+
+<p align="center">
+  <img src="docs/assets/tier-presets.svg?v=3" alt="Subscription Tier Presets Matrix" width="100%" />
+</p>
 
 <br/>
 
-Specialized prompt presets enforcement payload limits (< 75 KB) and domain guardrails out of the box:
+Tailor session limits and rate-limiting behavior to your Google Jules API subscription tier:
+
+| Tier | `dailyTasks` | `repairAttempts` | `concurrency` | `staggerMs` | Target Usage |
+| :--- | :---: | :---: | :---: | :---: | :--- |
+| **`free`** | `15` | `1` | `1` | `3000 ms` | **Hobby / Free Tier:** Conserves quota, prevents HTTP 429 rate limits. |
+| **`pro`** | `100` | `2` | `2` | `1500 ms` | **Developer Pro:** Balanced throughput for everyday work. |
+| **`ultra`** *(default)* | `300` | `3` | `3` | `1000 ms` | **Swarm / Enterprise:** Maximum parallel throughput & CI/CD. |
+
+**How to activate:**
+- **Environment Variable:** `export JULES_TIER=free` (or set in `.env`)
+- **Config File (`.agent/jules.yml`):** Set `tier: free`
+
+</details>
+
+---
+
+## 🤖 Specialist Agent Prompt Presets (`.agent/prompts/`)
+
+Specialized prompt presets enforce payload limits (< 75 KB) and domain guardrails out of the box:
 
 | Preset | Role & Domain | Primary Focus |
 | :--- | :--- | :--- |
@@ -144,12 +217,9 @@ npx agentctl dispatch \
   --prompt "$(cat .agent/prompts/Janitor.md) Prune unused helper methods in src/utils.mjs"
 ```
 
-</details>
-
-<details>
-<summary><b>⚡ GitHub Actions Composite Action (.github/actions/setup-jules)</b></summary>
+---
 
-<br/>
+## ⚡ GitHub Actions Composite Action (`.github/actions/setup-jules`)
 
 Integrate `jules-orchestrator-kit` into any GitHub Actions workflow with 3 lines of YAML:
 
@@ -165,12 +235,9 @@ steps:
       JULES_API_KEY: ${{ secrets.JULES_API_KEY }}
 ```
 
-</details>
-
-<details>
-<summary><b>🛠️ CLI Command Reference (`agentctl`)</b></summary>
+---
 
-<br/>
+## 🛠️ CLI Command Reference (`agentctl`)
 
 | Command | Usage Example | Description |
 | :--- | :--- | :--- |
@@ -185,35 +252,9 @@ steps:
 | **`scan`** | `agentctl scan` | Scans codebase for `TODO` and `FIXME` comments and generates task queue |
 | **`clean`** | `agentctl clean` | Audits and cleans up stale git worktrees, orphaned intents, locks, and temporary state files |
 
-</details>
-
-<details>
-<summary><b>💳 Subscription Tier Presets (Free / Pro / Ultra)</b></summary>
-
-<br/>
-
-![Subscription Tier Presets Matrix](docs/assets/tier-presets.svg?v=3)
-
-<br/>
-
-Tailor session limits and rate-limiting behavior to your Google Jules API subscription tier:
-
-| Tier | `dailyTasks` | `repairAttempts` | `concurrency` | `staggerMs` | Target Usage |
-| :--- | :---: | :---: | :---: | :---: | :--- |
-| **`free`** | `15` | `1` | `1` | `3000 ms` | **Hobby / Free Tier:** Conserves quota, prevents HTTP 429 rate limits. |
-| **`pro`** | `100` | `2` | `2` | `1500 ms` | **Developer Pro:** Balanced throughput for everyday work. |
-| **`ultra`** *(default)* | `300` | `3` | `3` | `1000 ms` | **Swarm / Enterprise:** Maximum parallel throughput & CI/CD. |
-
-**How to activate:**
-- **Environment Variable:** `export JULES_TIER=free` (or set in `.env`)
-- **Config File (`.agent/jules.yml`):** Set `tier: free`
-
-</details>
-
-<details>
-<summary><b>📝 Configuration Reference (`.agent/jules.yml`)</b></summary>
+---
 
-<br/>
+## 📝 Configuration Reference (`.agent/jules.yml`)
 
 Auto-generated by `agentctl init` at the root of your project:
 
@@ -233,16 +274,13 @@ limits:
   diffKb: 75
 ```
 
-</details>
-
-<details>
-<summary><b>🚦 Exit Code Registry & Troubleshooting</b></summary>
+---
 
-<br/>
+## 🚦 Exit Code Registry & Troubleshooting
 
-Standardized exit codes enforced across all CLI utilities:
+Standardized exit codes enforced across all CLI utilities and CI pipelines:
 
-| Exit Code | Status | Description & Immediate Action |
+| Exit Code | Classification | Description & Immediate Remediation Action |
 | :---: | :--- | :--- |
 | `0` | **Success** | Task completed cleanly; PR opened or verification passed. |
 | `1` | **Pre-Dispatch / Arg Error** | Invalid arguments, prompt > 50 KB, or pre-dispatch validation error. |
@@ -250,15 +288,15 @@ Standardized exit codes enforced across all CLI utilities:
 | `3` | **Scope Violation** | Attempted modification of restricted files (`.github/`, command files, agent rules). |
 | `4` | **OODA Exhausted / Thrash** | Verification suite failed after 3 repair attempts or hit deterministic regression. |
 | `5` | **Diff Payload Limit** | Post-change git diff exceeds payload budget (`limits.diffKb`, default 75 KB). |
-| `6` | **Secret Detected** | High-confidence secret or private key detected in patch diff. |
+| `6` | **Secret Detected** | High-confidence secret or private key detected in patch diff (Shannon entropy > 3.6 bits). |
 | `7` | **Budget Exhausted** | Daily task session quota limit reached (`limits.dailyTasks`, default 300). |
+| `8` | **FLAKY_QUARANTINE** | Statistical test flakiness detected (oscillation >= 0.4, Wilson CI); OODA repair suppressed. |
+| `124` | **Execution Timeout** | Subprocess execution exceeded hard timeout limit (default 10 minutes). |
+| `188` | **ERR_UNMOCKED_NET** | Unmocked outbound HTTP/HTTPS egress intercepted by hermetic network guard. |
 
-</details>
-
-<details>
-<summary><b>🔐 Environment Variables Reference</b></summary>
+---
 
-<br/>
+## 🔐 Environment Variables Reference
 
 | Variable | Description | Default |
 | :--- | :--- | :--- |
@@ -273,12 +311,9 @@ Standardized exit codes enforced across all CLI utilities:
 | `BASE_BRANCH` | Base branch for PR Audits & Merge-Base checks | `main` |
 | `NO_COLOR` | Set to `true` to disable ANSI color output | `false` |
 
-</details>
-
-<details>
-<summary><b>🌐 Supported Tech Stacks & Auto-Detection</b></summary>
+---
 
-<br/>
+## 🌐 Supported Tech Stacks & Auto-Detection
 
 The orchestrator automatically infers verification and build commands across ecosystems:
 
@@ -295,8 +330,6 @@ The orchestrator automatically infers verification and build commands across eco
 | **Elixir / Ruby** | `mix.exs` / `Gemfile` | `mix test` / `rake test` | *(standard build)* |
 | **Java / C / C++** | `pom.xml` / `Makefile` | `mvn test` / `make test` | `mvn compile` / `make` |
 
-</details>
-
 ---
 
 ## 🤝 Contributing & Standards

package/bin/agentctl.mjs

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

package/bin/init.js

@@ -248,13 +248,12 @@ if (fs.existsSync(targetPkgPath) && targetDir !== kitRoot) {
     let updated = false;
     const julesScripts = {
       "jules:dispatch": "node scripts/jules-dispatch.mjs",
-      "jules:queue": "node scripts/jules-queue-runner.mjs",
+      "jules:queue": "node bin/agentctl.mjs queue",
       "jules:create": "node scripts/jules-create.mjs",
       "jules:status": "node scripts/jules-status.mjs",
       "jules:audit": "node scripts/jules-self-audit.mjs",
-      "jules:cleanup": "node scripts/jules-cleanup.mjs",
       "jules:scan": "node scripts/jules-scan-todos.mjs",
-      "jules:swarm": "node scripts/jules-swarm.mjs",
+      "jules:swarm": "node bin/agentctl.mjs swarm",
       "jules:nightly": "node scripts/jules-nightly.mjs"
     };
 

package/index.mjs

@@ -1,5 +1,5 @@
 /**
- * Google Jules Orchestrator Kit - Node.js SDK (v0.9.0)
+ * Google Jules Orchestrator Kit - Node.js SDK (v0.25.0)
  *
  * Exposes core orchestrator functions for programmatically driving agent tasks,
  * security auditing, repo gating, and state operations.
@@ -17,7 +17,16 @@ export {
 export { sanitizeUntrustedData, buildAgentEnvelope } from "./src/prompt-guard.mjs";
 export { isolateMcpStdout, writeMcpFrame } from "./src/mcp.mjs";
 export { git, runCmd, resolveBase, changedFiles, diffBytes, diffText } from "./src/git.mjs";
-export { createProvider, JULES_PRESET, CLAUDE_PRESET, CODEX_PRESET } from "./src/provider.mjs";
+export {
+  createProvider,
+  JULES_PRESET,
+  CLAUDE_PRESET,
+  CODEX_PRESET,
+  ProviderRateLimitError,
+  ProviderUnavailableError,
+  ProviderSchemaError,
+  parseRetryAfter,
+} from "./src/provider.mjs";
 export {
   appendLedger,
   readLedger,
@@ -25,6 +34,7 @@ export {
   reserveBudget,
   reserveBudgetAtomic,
   commitBudgetReservation,
+  rollbackBudgetReservation,
   withBudget,
   checkDailyBudget,
   acquireLock,
@@ -58,3 +68,5 @@ export { runSelfAudit, runPreflightSandbox } from "./scripts/jules-self-audit.mj
 export { scanCodebaseForTodos, runScanner } from "./scripts/jules-scan-todos.mjs";
 export { getDynamicGuardrails, dispatchTask } from "./scripts/jules-dispatch.mjs";
 export { classifyQueueFailure } from "./scripts/jules-queue-runner.mjs";
+export { extractPrUrls, auditSessions, buildSyncManifest, pushReservationManifest } from "./scripts/utils.mjs";
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jules-orchestrator-kit",
-  "version": "0.23.0",
+  "version": "0.25.0",
   "description": "Orchestration kit for running Google Jules autonomous agents.",
   "repository": {
     "type": "git",
@@ -23,32 +23,27 @@
     ".": "./index.mjs"
   },
   "files": [
-    "index.mjs",
-    "src/",
     "bin/",
+    "src/",
     "scripts/",
-    ".agent/jules.yml",
+    "index.mjs",
+    "LICENSE",
+    "README.md",
+    "JULES_RULES_TEMPLATE.md",
     ".agent/rules/",
     ".agent/prompts/",
-    ".agent/workflows/",
-    ".agent/jules-queue/README.md",
-    ".github/workflows/jules-audit.yml",
-    ".env.example",
-    "JULES_RULES_TEMPLATE.md",
-    "README.md",
-    "LICENSE"
+    ".agent/workflows/"
   ],
   "scripts": {
     "init": "node bin/init.js",
     "test": "node --test test/*.test.mjs",
     "jules:dispatch": "node scripts/jules-dispatch.mjs",
-    "jules:queue": "node scripts/jules-queue-runner.mjs",
+    "jules:queue": "node bin/agentctl.mjs queue",
     "jules:create": "node scripts/jules-create.mjs",
     "jules:status": "node scripts/jules-status.mjs",
     "jules:audit": "node scripts/jules-self-audit.mjs",
-    "jules:cleanup": "node scripts/jules-cleanup.mjs",
     "jules:scan": "node scripts/jules-scan-todos.mjs",
-    "jules:swarm": "node scripts/jules-swarm.mjs",
+    "jules:swarm": "node bin/agentctl.mjs swarm",
     "jules:merge-swarm": "node scripts/jules-merge-swarm.mjs",
     "jules:patch": "node scripts/jules-patch.mjs",
     "jules:nightly": "node scripts/jules-nightly.mjs",

package/scripts/jules-queue-runner.mjs

@@ -4,10 +4,7 @@
  * Backward compatibility shim for jules-queue-runner.mjs in v0.9.0.
  */
 
-import { getQueueDir, ensureDir } from "../src/state.mjs";
-import { isTaskFile } from "../src/engine.mjs";
-import { readdirSync, renameSync } from "node:fs";
-import { join } from "node:path";
+import { run } from "../src/engine.mjs";
 
 export function classifyQueueFailure(err) {
   const msg = String(err?.message || err || "");
@@ -19,25 +16,9 @@ export function classifyQueueFailure(err) {
 
 if (process.argv[1] && process.argv[1].endsWith("jules-queue-runner.mjs")) {
   const root = process.env.JULES_PROJECT_ROOT || process.cwd();
-  const queueDir = getQueueDir(root);
-  const files = readdirSync(queueDir).filter((f) => isTaskFile(f, queueDir));
-
-  if (files.length === 0) {
-    console.log("Queue processing complete!");
-    process.exit(0);
-  }
-
-  const completedDir = join(queueDir, "completed");
-  ensureDir(completedDir);
-
-  for (const file of files) {
-    const src = join(queueDir, file);
-    const dst = join(completedDir, file);
-    try {
-      renameSync(src, dst);
-    } catch (_) {}
-  }
+  const isDry = process.env.JULES_DRY_RUN === "true" || process.env.JULES_DRY_RUN === "1";
 
+  await run({ root, dryRun: isDry });
   console.log("Queue processing complete!");
   process.exit(0);
 }

package/scripts/utils.mjs

@@ -159,3 +159,68 @@ export function acquireBudgetLock(_root) {
 }
 
 export function releaseBudgetLock(_root) {}
+
+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 };
+}
+
+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 };
+}
+