sdd-agent-pack 1.3.4 → 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:
@@ -61,7 +66,16 @@ TASKS_FILE = "specs/tasks.md"
 
 
 def parse_epics(file_path: str) -> list[dict]:
-    """Parse incomplete epics from tasks.md frontmatter."""
+    """Parse incomplete epics from tasks.md.
+
+    Detects epic headings like:
+      ## Epic EPIC-001 — Title
+      ## Epic TDS.1: Title
+      ### Epic Something
+
+    An epic is "incomplete" if any checkbox (- [ ]) is unchecked under it.
+    An epic is "complete" if all its checkboxes are checked or there are none.
+    """
     if not os.path.exists(file_path):
         print(f"✗ tasks.md not found at {file_path}")
         print("  Run this from your repository root.")
@@ -71,43 +85,35 @@ def parse_epics(file_path: str) -> list[dict]:
         content = f.read()
 
     epics = []
-
-    # Try YAML frontmatter format first
-    # Look for: status: pending or status: in-progress under an epic entry
-    frontmatter_match = re.search(
-        r"autopilot:\s*\n\s+epics:\s*\n(.+?)(?=\n\S|\Z)",
-        content,
-        re.DOTALL,
-    )
-
-    if frontmatter_match:
-        # Parse structured frontmatter
-        epic_pattern = re.compile(
-            r"- id:\s*(\S+)\s*\n\s+title:\s*(.+?)\s*\n\s+status:\s*(.+?)(?:\n|$)"
-        )
-        for match in epic_pattern.finditer(frontmatter_match.group(1)):
-            epic_id = match.group(1)
-            title = match.group(2).strip()
-            status = match.group(3).strip()
-            if status in ("pending", "in-progress"):
-                epics.append({"id": epic_id, "title": title, "status": status})
-    else:
-        # Fallback: parse markdown headings and status lines
-        lines = content.split("\n")
-        current_epic = None
-        for i, line in enumerate(lines):
-            heading_match = re.match(r"^#{2,4}\s+(.+)$", line)
-            if heading_match:
-                current_epic = heading_match.group(1).strip()
-            elif current_epic and re.search(
-                r"status:\s*(pending|in-progress)", line
-            ):
-                epics.append(
-                    {"id": current_epic, "title": current_epic, "status": "pending"}
-                )
-                current_epic = None
-            elif current_epic and re.search(r"status:\s*complete", line):
-                current_epic = None
+    lines = content.split("\n")
+
+    epic_heading_re = re.compile(r"^#{2,4}\s+Epic\s+(.+)$", re.IGNORECASE)
+
+    current_epic = None
+    has_unchecked = False
+
+    for line in lines:
+        heading_match = epic_heading_re.match(line)
+        if heading_match:
+            # Save previous epic if it has unchecked tasks
+            if current_epic and has_unchecked:
+                epics.append({
+                    "id": current_epic,
+                    "title": current_epic,
+                    "status": "incomplete",
+                })
+            current_epic = heading_match.group(1).strip()
+            has_unchecked = False
+        elif current_epic and re.match(r"^\s*-\s+\[\s*\]", line):
+            has_unchecked = True
+
+    # Don't forget the last epic
+    if current_epic and has_unchecked:
+        epics.append({
+            "id": current_epic,
+            "title": current_epic,
+            "status": "incomplete",
+        })
 
     return epics
 
@@ -149,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

@@ -68,24 +68,36 @@ echo "━━━ SDD Agent Pack — Epic Orchestrator ━━━"
 echo ""
 
 # Parse incomplete epics from tasks.md
-# Looks for lines like: "### EPIC-001: Title" followed by "- [ ] ..."
+# Looks for epic headings (## Epic XXX — Title) and checks if any
+# of their tasks or requirements have unchecked boxes (- [ ]).
+# An epic is "incomplete" if any checkbox under it is unchecked.
 echo "Scanning $TASKS_FILE for incomplete epics..."
 
 epics=()
 current_epic=""
+has_unchecked=false
 
 while IFS= read -r line; do
-  if [[ "$line" =~ ^###[[:space:]]+(EPIC-[^:]+):(.+)$ ]] || [[ "$line" =~ ^###[[:space:]]+(T[^:]+):(.+)$ ]] || [[ "$line" =~ ^###[[:space:]]+([^:]+):(.+)$ ]]; then
-    current_epic="${BASH_REMATCH[1]}:${BASH_REMATCH[2]}"
-    current_epic="$(echo "$current_epic" | xargs)"
-  elif [[ "$line" =~ status:[[:space:]]*(pending|in-progress) ]] && [ -n "$current_epic" ]; then
-    epics+=("$current_epic")
-    current_epic=""
-  elif [[ "$line" =~ status:[[:space:]]*complete ]] || [[ "$line" =~ status:[[:space:]]*completed ]]; then
-    current_epic=""
+  # Detect epic heading: ## Epic XXX — Title or ## Epic XXX: Title
+  if [[ "$line" =~ ^[#]+\ +Epic\ +(.+)$ ]]; then
+    # Save previous epic if it has unchecked tasks
+    if [ -n "$current_epic" ] && [ "$has_unchecked" = true ]; then
+      epics+=("$current_epic")
+    fi
+    current_epic="${BASH_REMATCH[1]}"
+    current_epic="$(echo "$current_epic" | sed 's/^[#[:space:]]*//' | xargs)"
+    has_unchecked=false
+  # Detect unchecked checkbox
+  elif [[ "$line" =~ ^[[:space:]]*-\ +\[\ \] ]] && [ -n "$current_epic" ]; then
+    has_unchecked=true
   fi
 done < "$TASKS_FILE"
 
+# Don't forget the last epic
+if [ -n "$current_epic" ] && [ "$has_unchecked" = true ]; then
+  epics+=("$current_epic")
+fi
+
 if [ ${#epics[@]} -eq 0 ]; then
   echo "✓ All epics are complete! Nothing to do."
   exit 0
@@ -143,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.4",
+  "version": "1.3.6",
   "description": "Lightweight installer for SDD workflow assets into application repositories",
   "type": "module",
   "main": "dist/index.js",