@cyperx/clawforge 1.4.0 → 1.5.0

package/VERSION

@@ -1 +1 @@
-1.4.0
+1.5.0

package/bin/clawforge

@@ -83,6 +83,7 @@ Power Features (v1.2):
 
 Web Dashboard (v1.4):
   web         Launch web dashboard (accessible from phone/browser)
+  deps        Show task dependency graph / blocked tasks
 
 Developer Experience (v1.3):
   profile     Manage reusable agent profiles (presets)
@@ -250,6 +251,7 @@ doctor)     exec "${BIN_DIR}/doctor.sh" "$@" ;;
   export)     exec "${BIN_DIR}/export.sh" "$@" ;;
   completions) exec "${BIN_DIR}/completions.sh" "$@" ;;
   web)        exec "${BIN_DIR}/web.sh" "$@" ;;
+  deps)       exec "${BIN_DIR}/deps.sh" "$@" ;;
   logs)       exec "${BIN_DIR}/logs.sh" "$@" ;;
   on-complete) exec "${BIN_DIR}/on-complete.sh" "$@" ;;
 

package/bin/deps.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# deps.sh — Show task dependency graph and blocked tasks
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+source "${SCRIPT_DIR}/../lib/common.sh"
+
+usage(){ cat <<EOF
+Usage: clawforge deps [options]
+
+Show dependency graph for active tasks.
+
+Options:
+  --json           Output JSON graph
+  --blocked        Show only blocked tasks
+  --help           Show help
+EOF
+}
+
+JSON_OUTPUT=false
+BLOCKED_ONLY=false
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --json) JSON_OUTPUT=true; shift ;;
+    --blocked) BLOCKED_ONLY=true; shift ;;
+    --help|-h) usage; exit 0 ;;
+    *) log_error "Unknown option: $1"; usage; exit 1 ;;
+  esac
+done
+
+_ensure_registry
+tasks=$(jq '.tasks' "$REGISTRY_FILE" 2>/dev/null || echo '[]')
+
+if $JSON_OUTPUT; then
+  jq -n --argjson tasks "$tasks" '
+    {
+      nodes: ($tasks | map({id:.id, short_id:.short_id, description:.description, status:.status})),
+      edges: ($tasks | map(select(.depends_on != null) | {from:.depends_on, to:.id}))
+    }'
+  exit 0
+fi
+
+echo "Dependency Graph"
+echo ""
+count=$(echo "$tasks" | jq 'length')
+if [[ "$count" == "0" ]]; then
+  echo "(no active tasks)"
+  exit 0
+fi
+
+echo "$tasks" | jq -r '.[] | [.id, (.short_id//0|tostring), (.description//"—"), (.status//"—"), (.depends_on//"")] | @tsv' | while IFS=$'	' read -r id sid desc status dep; do
+  if $BLOCKED_ONLY; then
+    [[ -z "$dep" ]] && continue
+    dep_status=$(echo "$tasks" | jq -r --arg d "$dep" '.[] | select(.id==$d) | .status' 2>/dev/null || true)
+    [[ "$dep_status" == "done" ]] && continue
+  fi
+
+  if [[ -n "$dep" ]]; then
+    dep_sid=$(echo "$tasks" | jq -r --arg d "$dep" '.[] | select(.id==$d) | (.short_id//0|tostring)' 2>/dev/null || echo "?")
+    dep_status=$(echo "$tasks" | jq -r --arg d "$dep" '.[] | select(.id==$d) | .status' 2>/dev/null || echo "?")
+    blocked=""
+    [[ "$dep_status" != "done" ]] && blocked=" [blocked]"
+    echo "  #$sid ($status)$blocked"
+    echo "    └─ waits for #$dep_sid ($dep_status)"
+    echo "       $desc"
+  else
+    echo "  #$sid ($status)"
+    echo "    $desc"
+  fi
+  echo ""
+done

package/bin/spawn-agent.sh

@@ -24,7 +24,7 @@ EOF
 }
 
 # ── Parse args ─────────────────────────────────────────────────────────
-REPO="" BRANCH="" TASK="" AGENT="" MODEL="" EFFORT="" DRY_RUN=false AFTER=""
+REPO="" BRANCH="" TASK="" AGENT="" MODEL="" EFFORT="" DRY_RUN=false AFTER="" DEP_ID=""
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
@@ -49,26 +49,27 @@ done
 
 # ── Wait for dependency ──────────────────────────────────────────────
 if [[ -n "$AFTER" ]]; then
-  log_info "Waiting for task $AFTER to complete before spawning..."
+  DEP_ID=$(resolve_task_id "$AFTER")
+  [[ -z "$DEP_ID" ]] && { log_error "Dependency '$AFTER' not found"; exit 1; }
+  log_info "Waiting for task $AFTER ($DEP_ID) to complete before spawning..."
   WAIT_TIMEOUT=${CLAWFORGE_DEP_TIMEOUT:-3600}  # 1 hour default
   ELAPSED=0
   INTERVAL=5
   while [[ $ELAPSED -lt $WAIT_TIMEOUT ]]; do
-    DEP_STATUS=""
-    if [[ "$AFTER" =~ ^[0-9]+$ ]]; then
-      DEP_STATUS=$(jq -r --argjson sid "$AFTER" '.tasks[] | select(.short_id == $sid) | .status' "$REGISTRY_FILE" 2>/dev/null || true)
-    else
-      DEP_STATUS=$(jq -r --arg id "$AFTER" '.tasks[] | select(.id == $id) | .status' "$REGISTRY_FILE" 2>/dev/null || true)
-    fi
+    DEP_STATUS=$(jq -r --arg id "$DEP_ID" '.tasks[] | select(.id == $id) | .status' "$REGISTRY_FILE" 2>/dev/null || true)
     case "$DEP_STATUS" in
       done)
         log_info "Dependency $AFTER completed. Spawning..."
         break
         ;;
-      failed|timeout|cancelled)
+      failed|timeout|cancelled|stopped)
         log_error "Dependency $AFTER ended with status: $DEP_STATUS. Aborting spawn."
         exit 1
         ;;
+      "")
+        log_error "Dependency $AFTER not found in registry."
+        exit 1
+        ;;
       *)
         sleep $INTERVAL
         ELAPSED=$((ELAPSED + INTERVAL))
@@ -82,7 +83,15 @@ if [[ -n "$AFTER" ]]; then
 fi
 
 # ── Resolve settings ──────────────────────────────────────────────────
-RESOLVED_AGENT=$(detect_agent "${AGENT:-}")
+if ! RESOLVED_AGENT=$(detect_agent "${AGENT:-}" 2>/dev/null); then
+  if $DRY_RUN; then
+    RESOLVED_AGENT="${AGENT:-claude}"
+    log_warn "No local agent binary found; using '$RESOLVED_AGENT' for dry-run preview"
+  else
+    log_error "No coding agent found (need claude or codex)"
+    exit 1
+  fi
+fi
 EFFORT="${EFFORT:-$(config_get default_effort high)}"
 
 if [[ -z "$MODEL" ]]; then

package/bin/sprint.sh

@@ -21,6 +21,7 @@ Arguments:
 Flags:
   --quick              Patch mode: auto-branch, auto-merge, skip review, targeted tests
   --branch <name>      Override auto-generated branch name
+  --after <id>         Wait for task <id> to complete before starting
   --agent <name>       Agent to use: claude or codex (default: auto-detect)
   --model <model>      Model override
   --routing <strategy>  Model routing: auto, cheap, or quality (--model overrides)
@@ -47,7 +48,7 @@ EOF
 }
 
 # ── Parse args ────────────────────────────────────────────────────────
-REPO="" TASK="" BRANCH="" AGENT="" MODEL="" QUICK=false AUTO_MERGE=false DRY_RUN=false
+REPO="" TASK="" BRANCH="" AGENT="" MODEL="" QUICK=false AUTO_MERGE=false DRY_RUN=false AFTER=""
 TEMPLATE="" CI_LOOP=false MAX_CI_RETRIES=3 BUDGET="" JSON_OUTPUT=false NOTIFY=false WEBHOOK="" ROUTING=""
 AUTO_CLEAN=false
 TIMEOUT_MIN=""
@@ -57,6 +58,7 @@ while [[ $# -gt 0 ]]; do
   case "$1" in
     --quick)          QUICK=true; shift ;;
     --branch)         BRANCH="$2"; shift 2 ;;
+    --after)          AFTER="$2"; shift 2 ;;
     --agent)          AGENT="$2"; shift 2 ;;
     --model)          MODEL="$2"; shift 2 ;;
     --routing)        ROUTING="$2"; shift 2 ;;
@@ -127,7 +129,15 @@ if $QUICK; then
 fi
 
 # ── Resolve agent + model ────────────────────────────────────────────
-RESOLVED_AGENT=$(detect_agent "${AGENT:-}")
+if ! RESOLVED_AGENT=$(detect_agent "${AGENT:-}" 2>/dev/null); then
+  if $DRY_RUN; then
+    RESOLVED_AGENT="${AGENT:-claude}"
+    log_warn "No local agent binary found; using '$RESOLVED_AGENT' for dry-run preview"
+  else
+    log_error "No coding agent found (need claude or codex)"
+    exit 1
+  fi
+fi
 MODEL_OVERRIDE="$MODEL"  # preserve explicit --model
 if [[ -z "$MODEL" ]]; then
   if [[ "$RESOLVED_AGENT" == "claude" ]]; then
@@ -169,6 +179,7 @@ if $DRY_RUN; then
   echo "  Auto-merge: $AUTO_MERGE"
   echo "  Quick:      $QUICK"
   [[ -n "$ROUTING" ]] && echo "  Routing:    $ROUTING"
+  [[ -n "$AFTER" ]] && echo "  After:      $AFTER"
   echo ""
   echo "Would execute:"
   echo "  1. Scope task"
@@ -215,6 +226,7 @@ fi
 SPAWN_ARGS=(--repo "$REPO_ABS" --branch "$BRANCH" --task "$PROMPT")
 [[ -n "${AGENT:-}" ]] && SPAWN_ARGS+=(--agent "$AGENT")
 [[ -n "${SPAWN_MODEL:-}" ]] && SPAWN_ARGS+=(--model "$SPAWN_MODEL")
+[[ -n "${AFTER:-}" ]] && SPAWN_ARGS+=(--after "$AFTER")
 
 TASK_JSON=$("${SCRIPT_DIR}/spawn-agent.sh" "${SPAWN_ARGS[@]}" 2>/dev/null || true)
 

package/bin/swarm.sh

@@ -22,6 +22,7 @@ Flags:
   --repos <paths>      Comma-separated repo paths (one agent per repo, skips decomposition)
   --repos-file <path>  File with repo paths, one per line
   --routing <strategy> Model routing: auto, cheap, or quality
+  --after <id>         Wait for task <id> to complete before starting swarm
   --max-agents <N>     Cap parallel agents (default: 3)
   --agent <name>       Force specific agent for all sub-tasks
   --auto-merge         Merge each PR automatically after CI + review
@@ -48,7 +49,7 @@ EOF
 }
 
 # ── Parse args ────────────────────────────────────────────────────────
-REPO="" TASK="" MAX_AGENTS=3 AGENT="" AUTO_MERGE=false DRY_RUN=false SKIP_CONFIRM=false
+REPO="" TASK="" MAX_AGENTS=3 AGENT="" AUTO_MERGE=false DRY_RUN=false SKIP_CONFIRM=false AFTER=""
 TEMPLATE="" CI_LOOP=false MAX_CI_RETRIES=3 BUDGET="" JSON_OUTPUT=false NOTIFY=false WEBHOOK=""
 REPOS="" REPOS_FILE="" ROUTING="" MULTI_REPO=false AUTO_CLEAN=false TIMEOUT_MIN=""
 POSITIONAL=()
@@ -58,6 +59,7 @@ while [[ $# -gt 0 ]]; do
     --repos)          REPOS="$2"; shift 2 ;;
     --repos-file)     REPOS_FILE="$2"; shift 2 ;;
     --routing)        ROUTING="$2"; shift 2 ;;
+    --after)          AFTER="$2"; shift 2 ;;
     --max-agents)     MAX_AGENTS="$2"; shift 2 ;;
     --agent)          AGENT="$2"; shift 2 ;;
     --auto-merge)     AUTO_MERGE=true; shift ;;
@@ -137,6 +139,36 @@ if $MULTI_REPO; then
   REPO="${REPO_LIST[0]}"
 fi
 
+
+# ── Dependency wait (optional) ──────────────────────────────────────
+if [[ -n "$AFTER" ]]; then
+  DEP_ID=$(resolve_task_id "$AFTER")
+  [[ -z "$DEP_ID" ]] && { log_error "Dependency '$AFTER' not found"; exit 1; }
+  log_info "Waiting for task $AFTER ($DEP_ID) to complete before swarm starts..."
+  WAIT_TIMEOUT=${CLAWFORGE_DEP_TIMEOUT:-3600}
+  ELAPSED=0
+  INTERVAL=5
+  while [[ $ELAPSED -lt $WAIT_TIMEOUT ]]; do
+    DEP_STATUS=$(jq -r --arg id "$DEP_ID" '.tasks[] | select(.id == $id) | .status' "$REGISTRY_FILE" 2>/dev/null || true)
+    case "$DEP_STATUS" in
+      done) break ;;
+      failed|timeout|cancelled|stopped)
+        log_error "Dependency $AFTER ended with status: $DEP_STATUS. Aborting swarm."
+        exit 1
+        ;;
+      "")
+        log_error "Dependency $AFTER not found in registry."
+        exit 1
+        ;;
+      *) sleep $INTERVAL; ELAPSED=$((ELAPSED + INTERVAL)) ;;
+    esac
+  done
+  if [[ $ELAPSED -ge $WAIT_TIMEOUT ]]; then
+    log_error "Dependency wait timed out after ${WAIT_TIMEOUT}s"
+    exit 1
+  fi
+fi
+
 # ── Resolve repo (single-repo mode) ─────────────────────────────────
 if [[ -z "$REPO" ]]; then
   REPO=$(detect_repo) || { log_error "No --repo and no git repo found from cwd"; exit 1; }
@@ -147,7 +179,15 @@ REPO_ABS=$(cd "$REPO" && pwd)
 disk_check "$REPO_ABS" || { log_error "Aborting due to low disk space"; exit 1; }
 
 # ── Resolve agent ─────────────────────────────────────────────────────
-RESOLVED_AGENT=$(detect_agent "${AGENT:-}")
+if ! RESOLVED_AGENT=$(detect_agent "${AGENT:-}" 2>/dev/null); then
+  if $DRY_RUN; then
+    RESOLVED_AGENT="${AGENT:-claude}"
+    log_warn "No local agent binary found; using '$RESOLVED_AGENT' for dry-run preview"
+  else
+    log_error "No coding agent found (need claude or codex)"
+    exit 1
+  fi
+fi
 if [[ "$RESOLVED_AGENT" == "claude" ]]; then
   MODEL=$(config_get default_model_claude "claude-sonnet-4-5")
 else

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyperx/clawforge",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Multi-mode coding workflow CLI for orchestrating AI coding agents",
   "bin": {
     "@cyperx/clawforge": "./bin/clawforge"