@ai-hero/sandcastle 0.5.8 → 0.5.10

package/dist/templates/sequential-reviewer/main.mts

@@ -1,12 +1,15 @@
 // Sequential Reviewer — implement-then-review loop
 //
 // This template drives a two-phase workflow per issue:
-//   Phase 1 (Implement): A sonnet agent picks an open GitHub issue, works on it
+//   Phase 1 (Implement): A sonnet agent picks an open issue, works on it
 //                        on a dedicated branch, commits the changes, and signals
 //                        completion.
 //   Phase 2 (Review):    A second sonnet agent reviews the branch diff and either
 //                        approves it or makes corrections directly on the branch.
 //
+// Both phases share a single sandbox created via createSandbox(), so the
+// implementer and reviewer work on the same explicit branch.
+//
 // The outer loop repeats up to MAX_ITERATIONS times, processing one issue per
 // iteration. This is a middle-complexity option between the simple-loop (no review
 // gate) and the parallel-planner (concurrent execution with a planning phase).
@@ -45,62 +48,64 @@ const copyToWorktree = ["node_modules"];
 for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
   console.log(`\n=== Iteration ${iteration}/${MAX_ITERATIONS} ===\n`);
 
-  // -------------------------------------------------------------------------
-  // Phase 1: Implement
-  //
-  // A sonnet agent picks the next open GitHub issue, creates a branch, writes
-  // the implementation (using RGR: Red → Green → Repeat → Refactor), and
-  // commits the result.
-  //
-  // The agent signals completion via <promise>COMPLETE</promise> when done.
-  // The result contains the branch name the agent worked on.
-  // -------------------------------------------------------------------------
-  const implement = await sandcastle.run({
+  // Generate a unique branch name for this iteration.
+  const branch = `sandcastle/sequential-reviewer/${Date.now()}`;
+
+  // Create a single sandbox that both the implementer and reviewer share.
+  // This gives both agents a real, named branch that persists across phases.
+  const sandbox = await sandcastle.createSandbox({
+    branch,
+    sandbox: docker(),
     hooks,
     copyToWorktree,
-    sandbox: docker(),
-    branchStrategy: { type: "merge-to-head" },
-    name: "implementer",
-    maxIterations: 100,
-    agent: sandcastle.claudeCode("claude-sonnet-4-6"),
-    promptFile: "./.sandcastle/implement-prompt.md",
   });
 
-  // Extract the branch the agent worked on so the reviewer can target it.
-  const branch = implement.branch;
+  try {
+    // -----------------------------------------------------------------------
+    // Phase 1: Implement
+    //
+    // A sonnet agent picks the next open issue, writes the
+    // implementation (using RGR: Red → Green → Repeat → Refactor), and
+    // commits the result.
+    //
+    // The agent signals completion via <promise>COMPLETE</promise> when done.
+    // -----------------------------------------------------------------------
+    const implement = await sandbox.run({
+      name: "implementer",
+      maxIterations: 100,
+      agent: sandcastle.claudeCode("claude-sonnet-4-6"),
+      promptFile: "./.sandcastle/implement-prompt.md",
+    });
 
-  if (!implement.commits.length) {
-    console.log("Implementation agent made no commits. Skipping review.");
-    continue;
-  }
+    if (!implement.commits.length) {
+      console.log("Implementation agent made no commits. Skipping review.");
+      continue;
+    }
 
-  console.log(`\nImplementation complete on branch: ${branch}`);
-  console.log(`Commits: ${implement.commits.length}`);
+    console.log(`\nImplementation complete on branch: ${branch}`);
+    console.log(`Commits: ${implement.commits.length}`);
 
-  // -------------------------------------------------------------------------
-  // Phase 2: Review
-  //
-  // A second sonnet agent reviews the diff of the branch produced by Phase 1.
-  // It uses the {{BRANCH}} prompt argument to inspect the right branch, and
-  // either approves or makes corrections directly on the branch.
-  // -------------------------------------------------------------------------
-  await sandcastle.run({
-    hooks,
-    copyToWorktree,
-    sandbox: docker(),
-    branchStrategy: { type: "branch", branch },
-    name: "reviewer",
-    maxIterations: 1,
-    agent: sandcastle.claudeCode("claude-sonnet-4-6"),
-    promptFile: "./.sandcastle/review-prompt.md",
-    // Prompt arguments substitute {{BRANCH}} in review-prompt.md before the
-    // agent sees the prompt.
-    promptArgs: {
-      BRANCH: branch,
-    },
-  });
+    // -----------------------------------------------------------------------
+    // Phase 2: Review
+    //
+    // A second sonnet agent reviews the diff of the branch produced by
+    // Phase 1. It uses the {{BRANCH}} prompt argument to inspect the right
+    // branch, and either approves or makes corrections directly on the branch.
+    // -----------------------------------------------------------------------
+    await sandbox.run({
+      name: "reviewer",
+      maxIterations: 1,
+      agent: sandcastle.claudeCode("claude-sonnet-4-6"),
+      promptFile: "./.sandcastle/review-prompt.md",
+      promptArgs: {
+        BRANCH: branch,
+      },
+    });
 
-  console.log("\nReview complete.");
+    console.log("\nReview complete.");
+  } finally {
+    await sandbox.close();
+  }
 }
 
 console.log("\nAll done.");

package/dist/templates/simple-loop/main.mts

@@ -1,7 +1,7 @@
 import { run, claudeCode } from "@ai-hero/sandcastle";
 import { docker } from "@ai-hero/sandcastle/sandboxes/docker";
 
-// Simple loop: an agent that picks open GitHub issues one by one and closes them.
+// Simple loop: an agent that picks open issues one by one and closes them.
 // Run this with: npx tsx .sandcastle/main.mts
 // Or add to package.json scripts: "sandcastle": "npx tsx .sandcastle/main.mts"
 

package/dist/templates/simple-loop/prompt.md

@@ -10,7 +10,7 @@
 
 # Task
 
-You are RALPH — an autonomous coding agent working through GitHub issues one at a time.
+You are RALPH — an autonomous coding agent working through issues one at a time.
 
 ## Priority order
 

package/dist/templates/simple-loop/template.json

@@ -1,4 +1,4 @@
 {
   "name": "simple-loop",
-  "description": "Picks GitHub issues one by one and closes them"
+  "description": "Picks issues one by one and closes them"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-hero/sandcastle",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "CLI for orchestrating AI agents in isolated sandbox environments",
   "type": "module",
   "main": "./dist/index.js",