sdd-agent-pack 1.3.5 → 1.3.6

package/assets/scripts/orchestrate.py

@@ -20,8 +20,13 @@ LLM Configuration:
     LLM_API_KEY   — API key from your LLM provider
 
   Optional:
-    LLM_MODEL     — Model name (default: openrouter/anthropic/claude-sonnet-4-5-20250929)
-    LLM_BASE_URL  — Provider base URL
+    LLM_MODEL           — Model name (default: openrouter/anthropic/claude-sonnet-4-5-20250929)
+    LLM_BASE_URL        — Provider base URL
+    SANDBOX_VOLUMES     — Mount host dirs into Docker sandbox (format: host:container[:mode])
+                          Required when using --cloud (agent-server/sandbox mode) so
+                          file changes persist on the host filesystem.
+                          Example: SANDBOX_VOLUMES=$PWD:/workspace:rw
+    SANDBOX_USER_ID     — Host user ID for sandbox file ownership (default: $(id -u))
 
   Examples:
     OpenRouter:
@@ -150,6 +155,22 @@ def run_epic(epic: dict, use_cloud: bool) -> bool:
         print("  See .sdd-agent-pack/templates/env.example for all options.")
         return False
 
+    # Ensure the sandbox can access the local project directory.
+    # In local (SDK) mode the Conversation(workspace=cwd) creates a
+    # LocalWorkspace that runs subprocesses directly on the host, so
+    # file changes persist automatically.
+    #
+    # When --cloud is used the agent runs in a remote Docker sandbox.
+    # In that case SANDBOX_VOLUMES mounts the host project into the
+    # container's /workspace so agent file changes survive.
+    if use_cloud:
+        sandbox_volumes = os.getenv(
+            "SANDBOX_VOLUMES",
+            f"{os.getcwd()}:/workspace:rw",
+        )
+        os.environ.setdefault("SANDBOX_VOLUMES", sandbox_volumes)
+        os.environ.setdefault("SANDBOX_USER_ID", str(os.getuid()))
+
     llm = LLM(
         model=model,
         api_key=api_key,

package/assets/scripts/orchestrate.sh

@@ -155,6 +155,14 @@ Instructions:
 8. Do NOT work on any other epic"
 
   echo "Starting OpenHands (headless)..."
+
+  # Mount the current directory into the Docker sandbox container so
+  # agent file changes persist on the host filesystem.
+  #   SANDBOX_VOLUMES  — mounts $PWD into the container's /workspace (rw)
+  #   SANDBOX_USER_ID — ensures created files have host-user ownership
+  export SANDBOX_VOLUMES="$PWD:/workspace:rw"
+  export SANDBOX_USER_ID="${SANDBOX_USER_ID:-$(id -u)}"
+
   if $OPENHANDS_CMD --headless --override-with-envs -t "$prompt" 2>&1; then
     echo ""
     echo "✓ [$current/$total] Epic completed: $epic"

package/assets/templates/env.example

@@ -5,6 +5,8 @@
 #
 # Get your OpenRouter API key: https://openrouter.ai/keys
 
+# ── LLM Configuration ──────────────────────────────────────────────
+
 # Your API key from the LLM provider
 LLM_API_KEY=sk-or-paste-your-api-key-here
 
@@ -14,3 +16,17 @@ LLM_MODEL=openrouter/free
 
 # OpenRouter API base URL
 LLM_BASE_URL=https://openrouter.ai/api/v1
+
+# ── Sandbox / Workspace Persistence ────────────────────────────────
+#
+# The orchestrate.sh script uses openhands --headless, which spawns a
+# Docker sandbox container.  Without a volume mount the agent's file
+# changes are lost when the container exits.
+#
+# Setting SANDBOX_VOLUMES mounts the host project directory into the
+# sandbox container's /workspace so all file changes persist on the
+# host filesystem.  Both scripts set a sensible default automatically,
+# but you can override it here:
+
+# SANDBOX_VOLUMES="$PWD:/workspace:rw"
+# SANDBOX_USER_ID="$(id -u)"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sdd-agent-pack",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "Lightweight installer for SDD workflow assets into application repositories",
   "type": "module",
   "main": "dist/index.js",