@ai-hero/sandcastle 0.1.4 → 0.1.6

package/README.md

@@ -117,14 +117,14 @@ console.log(result.branch); // target branch name
 
 ## How it works
 
-Sandcastle uses a worktree-based architecture for direct, zero-sync agent execution:
+Sandcastle uses a worktree-based architecture for agent execution:
 
-- **Worktree**: Sandcastle creates a git worktree on the host at `.sandcastle/worktrees/`. The worktree is a real checkout of your repo — no copying or bundling required.
+- **Worktree**: Sandcastle creates a git worktree on the host at `.sandcastle/worktrees/`. The worktree is a just a normal `git worktree`.
 - **Bind-mount**: The worktree directory is bind-mounted into the sandbox container as the agent's working directory. The agent writes directly to the host filesystem through the mount.
 - **No sync needed**: Because the agent writes directly to the host filesystem, there are no sync-in or sync-out operations. Commits made by the agent are immediately visible on the host.
 - **Merge back**: After the run completes, the temp worktree branch is fast-forward merged back to the target branch, and the worktree is cleaned up.
 
-This approach eliminates the complexity of patch-based sync and ensures the agent always works with the exact repo state on the host.
+From your point of view, you just run `sandcastle.run({ branch: 'foo' })`, and get a commit on branch `foo` once it's complete. All 100% local.
 
 ## Prompts
 

package/dist/templates/parallel-planner/main.ts

@@ -167,43 +167,34 @@ for (let iteration = 1; iteration <= MAX_ITERATIONS; iteration++) {
     continue;
   }
 
-  if (completedBranches.length === 1) {
-    // Single branch — merge directly without spinning up a merge agent.
-    const { execSync } = await import("node:child_process");
-    const branch = completedBranches[0]!;
-    console.log(`\nSingle branch — merging ${branch} directly.`);
-    execSync(`git merge ${branch}`, { stdio: "inherit" });
-    console.log("\nBranch merged.");
-  } else {
-    // -------------------------------------------------------------------------
-    // Phase 3: Merge
-    //
-    // One sonnet agent merges all completed branches into the current branch,
-    // resolving any conflicts and running tests to confirm everything still works.
-    //
-    // The {{BRANCHES}} and {{ISSUES}} prompt arguments are lists that the agent
-    // uses to know which branches to merge and which issues to close.
-    // -------------------------------------------------------------------------
-    await sandcastle.run({
-      hooks,
-      copyToSandbox,
-      name: "merger",
-      maxIterations: 10,
-      // Sonnet is sufficient for merge conflict resolution.
-      model: "claude-sonnet-4-6",
-      promptFile: "./.sandcastle/merge-prompt.md",
-      promptArgs: {
-        // A markdown list of branch names, one per line.
-        BRANCHES: completedBranches.map((b) => `- ${b}`).join("\n"),
-        // A markdown list of issue numbers and titles, one per line.
-        ISSUES: completedIssues
-          .map((i) => `- #${i.number}: ${i.title}`)
-          .join("\n"),
-      },
-    });
-
-    console.log("\nBranches merged.");
-  }
+  // -------------------------------------------------------------------------
+  // Phase 3: Merge
+  //
+  // One sonnet agent merges all completed branches into the current branch,
+  // resolving any conflicts and running tests to confirm everything still works.
+  //
+  // The {{BRANCHES}} and {{ISSUES}} prompt arguments are lists that the agent
+  // uses to know which branches to merge and which issues to close.
+  // -------------------------------------------------------------------------
+  await sandcastle.run({
+    hooks,
+    copyToSandbox,
+    name: "merger",
+    maxIterations: 10,
+    // Sonnet is sufficient for merge conflict resolution.
+    model: "claude-sonnet-4-6",
+    promptFile: "./.sandcastle/merge-prompt.md",
+    promptArgs: {
+      // A markdown list of branch names, one per line.
+      BRANCHES: completedBranches.map((b) => `- ${b}`).join("\n"),
+      // A markdown list of issue numbers and titles, one per line.
+      ISSUES: completedIssues
+        .map((i) => `- #${i.number}: ${i.title}`)
+        .join("\n"),
+    },
+  });
+
+  console.log("\nBranches merged.");
 }
 
 console.log("\nAll done.");

package/package.json

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