forge-workflow 0.0.10 → 0.1.0-beta.3

package/scripts/forge-team/tests/dashboard.test.sh

@@ -7,53 +7,38 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 TEST_TMP="$(mktemp -d)"
 trap 'rm -rf "$TEST_TMP"' EXIT
 
-# ── Create mock bd ───────────────────────────────────────────────────────
+# ── Create mock forge ─────────────────────────────────────────────────────
+# Emits Kernel-shaped JSON ({"data":{"issues":[...]}}) for `issue list`.
 mock_dir="$(mktemp -d)"
 
-cat > "$mock_dir/bd" << 'MOCK'
+cat > "$mock_dir/forge" << 'MOCK'
 #!/usr/bin/env bash
-case "$1" in
-  list)
-    if echo "$*" | grep -q -- "--status=open,in_progress"; then
-      if [[ -n "${BD_MOCK_EMPTY:-}" ]]; then
-        # No output for empty test
-        :
-      elif [[ -n "${BD_MOCK_SINGLE:-}" ]]; then
-        echo "◐ forge-aaa · Feature A"
-      else
-        echo "◐ forge-aaa · Feature A"
-        echo "○ forge-bbb · Feature B"
-        echo "◐ forge-ccc · Feature C"
-      fi
-    fi
-    ;;
-  show)
-    case "$2" in
-      forge-aaa)
-        echo "◐ forge-aaa · Feature A [● P2 · IN_PROGRESS]"
-        echo "Owner: devone"
-        echo "Updated: 2026-03-27T10:00:00Z"
-        ;;
-      forge-bbb)
-        echo "○ forge-bbb · Feature B [● P2 · OPEN]"
-        echo "Owner: devtwo"
-        echo "Updated: 2026-03-24T10:00:00Z"
-        ;;
-      forge-ccc)
-        echo "◐ forge-ccc · Feature C [● P1 · IN_PROGRESS]"
-        echo "Owner: devone"
-        echo "Updated: 2026-03-27T09:00:00Z"
-        echo ""
-        echo "DEPENDS ON"
-        echo "  → ◐ forge-aaa: Feature A"
-        ;;
-    esac
-    ;;
-esac
+args="$*"
+emit() { printf '{"data":{"issues":%s}}\n' "$1"; }
+
+# forge-aaa BLOCKS forge-ccc (kernel: blocker carries the dependency edge), so
+# forge-ccc is the blocked one — its blocked_by resolves to forge-aaa via reverse scan.
+aaa='{"id":"forge-aaa","title":"Feature A","status":"in_progress","assignee":"devone","updated_at":"2026-03-27T10:00:00Z","dependencies":["forge-ccc"]}'
+bbb='{"id":"forge-bbb","title":"Feature B","status":"open","assignee":"devtwo","updated_at":"2026-03-24T10:00:00Z","dependencies":[]}'
+ccc='{"id":"forge-ccc","title":"Feature C","status":"in_progress","assignee":"devone","updated_at":"2026-03-27T09:00:00Z","dependencies":[]}'
+
+if [[ "$args" == *"issue list"* ]]; then
+  if [[ -n "${FORGE_MOCK_EMPTY:-}" ]]; then
+    emit "[]"
+  elif [[ -n "${FORGE_MOCK_SINGLE:-}" ]]; then
+    if [[ "$args" == *"--status=in_progress"* ]]; then emit "[$aaa]"; else emit "[]"; fi
+  else
+    if [[ "$args" == *"--status=open"* ]]; then emit "[$bbb]"
+    elif [[ "$args" == *"--status=in_progress"* ]]; then emit "[$aaa,$ccc]"
+    else emit "[]"; fi
+  fi
+  exit 0
+fi
+exit 0
 MOCK
-chmod +x "$mock_dir/bd"
+chmod +x "$mock_dir/forge"
 
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 
 # Source the library under test
 source "$SCRIPT_DIR/lib/dashboard.sh"
@@ -132,24 +117,24 @@ assert_contains "blocked shows dependency" "forge-aaa" "$output"
 echo ""
 echo "── Test 4: No issues → clear message ──"
 
-export BD_MOCK_EMPTY=1
+export FORGE_MOCK_EMPTY=1
 rc=0
 output_empty="$(cmd_dashboard 2>&1)" || rc=$?
 assert_exit "empty dashboard exits 0" 0 "$rc"
 assert_contains "shows no active issues" "No active issues" "$output_empty"
-unset BD_MOCK_EMPTY
+unset FORGE_MOCK_EMPTY
 
 # ── Test 5: Single developer → works correctly ──────────────────────────
 echo ""
 echo "── Test 5: Single developer ──"
 
-export BD_MOCK_SINGLE=1
+export FORGE_MOCK_SINGLE=1
 rc=0
 output_single="$(cmd_dashboard 2>&1)" || rc=$?
 assert_exit "single dev dashboard exits 0" 0 "$rc"
 assert_contains "shows devone" "devone" "$output_single"
 assert_not_contains "no devtwo in single mode" "devtwo" "$output_single"
-unset BD_MOCK_SINGLE
+unset FORGE_MOCK_SINGLE
 
 # ── Test 6: --format=json → valid JSON ──────────────────────────────────
 echo ""

package/scripts/forge-team/tests/epic.test.sh

@@ -7,74 +7,45 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 TEST_TMP="$(mktemp -d)"
 trap 'rm -rf "$TEST_TMP"' EXIT
 
-# ── Create mock bd ───────────────────────────────────────────────────────
+# ── Create mock forge ────────────────────────────────────────────────────
+# Only handles `forge issue children <id> --json`, emitting the kernel
+# issue-command-contract envelope ({schema_version,command,data:{epic,children,
+# rollup,count},next_commands}). An unknown id mirrors the kernel not-found path:
+# error on stderr, empty stdout, non-zero exit.
 mock_dir="$(mktemp -d)"
 
-cat > "$mock_dir/bd" << 'MOCK'
+cat > "$mock_dir/forge" << 'MOCK'
 #!/usr/bin/env bash
-case "$1 $2" in
-  "show forge-epic1")
-    cat << 'SHOW'
-◐ forge-epic1 · Test Epic [● P2 · IN_PROGRESS]
-Owner: devone
-
-BLOCKS
-  ← ✓ forge-child1: Child 1 (closed)
-  ← ◐ forge-child2: Child 2 (in_progress)
-  ← ○ forge-child3: Child 3 (open)
-SHOW
-    ;;
-  "show forge-child1")
-    echo "✓ forge-child1 · Child 1 [● P2 · CLOSED]"
-    echo "Owner: devone"
-    ;;
-  "show forge-child2")
-    echo "◐ forge-child2 · Child 2 [● P2 · IN_PROGRESS]"
-    echo "Owner: devtwo"
-    ;;
-  "show forge-child3")
-    echo "○ forge-child3 · Child 3 [● P3 · OPEN]"
-    echo "Owner: devone"
-    ;;
-  "show forge-empty")
-    cat << 'SHOW'
-○ forge-empty · Empty Epic [● P2 · OPEN]
-Owner: devone
-SHOW
-    ;;
-  "show forge-blocked")
-    cat << 'SHOW'
-◐ forge-blocked · Blocked Epic [● P2 · IN_PROGRESS]
-Owner: devone
-
-BLOCKS
-  ← ✓ forge-bchild1: Bchild 1 (closed)
-  ← ◐ forge-bchild2: Bchild 2 (in_progress)
-  ← ○ forge-bchild3: Bchild 3 (open)
-SHOW
-    ;;
-  "show forge-bchild1")
-    echo "✓ forge-bchild1 · Bchild 1 [● P2 · CLOSED]"
-    echo "Owner: devone"
-    ;;
-  "show forge-bchild2")
-    cat << 'SHOW'
-◐ forge-bchild2 · Bchild 2 [● P2 · IN_PROGRESS]
-Owner: devtwo
-
-BLOCKED_BY
-  → forge-bchild1: Bchild 1
-SHOW
-    ;;
-  "show forge-bchild3")
-    echo "○ forge-bchild3 · Bchild 3 [● P3 · OPEN]"
-    echo "Owner: devone"
-    ;;
-esac
+if [[ "$1" == "issue" && "$2" == "children" ]]; then
+  id="$3"
+  case "$id" in
+    forge-epic1)
+      cat << 'JSON'
+{"schema_version":"forge.issue.v1","command":"issue.children","data":{"epic":{"id":"forge-epic1","title":"Test Epic","type":"epic","status":"in_progress"},"children":[{"id":"forge-child1","title":"Child 1","status":"done","assignee":"devone","blocked":false,"blocked_by":[],"dependencies":[],"dependents":[]},{"id":"forge-child2","title":"Child 2","status":"in_progress","assignee":"devtwo","blocked":false,"blocked_by":[],"dependencies":[],"dependents":[]},{"id":"forge-child3","title":"Child 3","status":"open","assignee":"devone","blocked":false,"blocked_by":[],"dependencies":[],"dependents":[]}],"rollup":{"total":3,"done":1,"in_progress":1,"open":1,"review":0,"cancelled":0,"blocked":0,"percentage":33,"by_status":{"open":1,"in_progress":1,"review":0,"done":1,"cancelled":0}},"count":3},"next_commands":[]}
+JSON
+      ;;
+    forge-empty)
+      cat << 'JSON'
+{"schema_version":"forge.issue.v1","command":"issue.children","data":{"epic":{"id":"forge-empty","title":"Empty Epic","type":"epic","status":"open"},"children":[],"rollup":{"total":0,"done":0,"in_progress":0,"open":0,"review":0,"cancelled":0,"blocked":0,"percentage":0,"by_status":{"open":0,"in_progress":0,"review":0,"done":0,"cancelled":0}},"count":0},"next_commands":[]}
+JSON
+      ;;
+    forge-blocked)
+      cat << 'JSON'
+{"schema_version":"forge.issue.v1","command":"issue.children","data":{"epic":{"id":"forge-blocked","title":"Blocked Epic","type":"epic","status":"in_progress"},"children":[{"id":"forge-bchild1","title":"Bchild 1","status":"done","assignee":"devone","blocked":false,"blocked_by":[],"dependencies":[],"dependents":["forge-bchild2"]},{"id":"forge-bchild2","title":"Bchild 2","status":"in_progress","assignee":"devtwo","blocked":true,"blocked_by":["forge-bchild1"],"dependencies":["forge-bchild1"],"dependents":[]},{"id":"forge-bchild3","title":"Bchild 3","status":"open","assignee":"devone","blocked":false,"blocked_by":[],"dependencies":[],"dependents":[]}],"rollup":{"total":3,"done":1,"in_progress":1,"open":1,"review":0,"cancelled":0,"blocked":1,"percentage":33,"by_status":{"open":1,"in_progress":1,"review":0,"done":1,"cancelled":0}},"count":3},"next_commands":[]}
+JSON
+      ;;
+    *)
+      echo "Issue $id not found" >&2
+      exit 1
+      ;;
+  esac
+  exit 0
+fi
+exit 1
 MOCK
-chmod +x "$mock_dir/bd"
+chmod +x "$mock_dir/forge"
 
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 
 # Source the library under test
 source "$SCRIPT_DIR/lib/epic.sh"
@@ -116,7 +87,7 @@ output="$(cmd_epic "forge-epic1" 2>&1)" || rc=$?
 assert_exit "exits 0" 0 "$rc"
 assert_contains "shows epic id" "forge-epic1" "$output"
 assert_contains "progress shows 1/3" "1/3" "$output"
-assert_contains "shows closed child marker" "forge-child1" "$output"
+assert_contains "shows done child marker" "✓ forge-child1" "$output"
 assert_contains "shows in_progress child" "forge-child2" "$output"
 assert_contains "shows open child" "forge-child3" "$output"
 
@@ -145,13 +116,14 @@ echo "── Test 5: --format=json ──"
 rc=0
 output_json="$(cmd_epic "forge-epic1" "--format=json" 2>&1)" || rc=$?
 assert_exit "json exits 0" 0 "$rc"
-# Validate it's actual JSON (check for opening brace and key fields)
-assert_contains "json has epic_id" "epic_id" "$output_json"
-assert_contains "json has total" "total" "$output_json"
-assert_contains "json has done" "done" "$output_json"
-assert_contains "json has percentage" "percentage" "$output_json"
-assert_contains "json has children" "children" "$output_json"
-assert_contains "json has by_developer" "by_developer" "$output_json"
+# Validate it parses as JSON and carries the expected fields/values.
+assert_eq "json total is 3" "3" "$(printf '%s' "$output_json" | jq -r '.total')"
+assert_eq "json done is 1" "1" "$(printf '%s' "$output_json" | jq -r '.done')"
+assert_eq "json percentage is 33" "33" "$(printf '%s' "$output_json" | jq -r '.percentage')"
+assert_eq "json has 3 children" "3" "$(printf '%s' "$output_json" | jq -r '.children | length')"
+assert_eq "json by_developer devone total 2" "2" "$(printf '%s' "$output_json" | jq -r '.by_developer.devone.total')"
+assert_eq "json by_developer devone done 1" "1" "$(printf '%s' "$output_json" | jq -r '.by_developer.devone.done')"
+assert_eq "json epic_id" "forge-epic1" "$(printf '%s' "$output_json" | jq -r '.epic_id')"
 
 # ── Test 6: Missing issue-id → error ────────────────────────────────────
 echo ""
@@ -169,6 +141,15 @@ output_blocked="$(cmd_epic "forge-blocked" 2>&1)" || rc=$?
 assert_exit "blocked epic exits 0" 0 "$rc"
 assert_contains "blocked section present" "Blocked" "$output_blocked"
 assert_contains "blocked child mentioned" "forge-bchild2" "$output_blocked"
+assert_contains "blocked-by id mentioned" "forge-bchild1" "$output_blocked"
+
+# ── Test 8: Unknown epic id → not-found error ────────────────────────────
+echo ""
+echo "── Test 8: Unknown epic id ──"
+rc=0
+output_unknown="$(cmd_epic "forge-nope" 2>&1)" || rc=$?
+assert_exit "unknown id returns 1" 1 "$rc"
+assert_contains "error about fetch" "Could not fetch" "$output_unknown"
 
 # ── Results ──────────────────────────────────────────────────────────────
 echo ""

package/scripts/forge-team/tests/hooks.test.sh

@@ -37,71 +37,59 @@ esac
 MOCK
 chmod +x "$mock_dir/gh-noauth"
 
-# ── Create mock bd (with in_progress issues having github_issue state) ──
-cat > "$mock_dir/bd" << 'MOCK'
+# ── Create mock forge (in_progress issues carry github_issue:<n> labels) ──
+# `issue list --json` exposes labels; sync_issue_status re-reads `issue show`.
+cat > "$mock_dir/forge" << 'MOCK'
 #!/usr/bin/env bash
 case "$1 $2" in
-  "list --status=in_progress")
-    echo "◐ forge-aaa · Feature A"
-    echo "◐ forge-bbb · Feature B"
+  "issue list")
+    printf '{"data":{"issues":[{"id":"forge-aaa","status":"in_progress","labels":["github_issue:42"]},{"id":"forge-bbb","status":"in_progress","labels":["github_issue:55"]}]}}\n'
     ;;
-  "show forge-aaa")
-    echo "◐ forge-aaa · Feature A [● P2 · IN_PROGRESS]"
-    echo "Owner: devone"
-    echo "Updated: 2026-03-27T10:00:00Z"
-    echo ""
-    echo "STATE"
-    echo "  github_issue:42"
-    ;;
-  "show forge-bbb")
-    echo "◐ forge-bbb · Feature B [● P2 · IN_PROGRESS]"
-    echo "Owner: devtwo"
-    echo "Updated: 2026-03-27T09:00:00Z"
-    echo ""
-    echo "STATE"
-    echo "  github_issue:55"
+  "issue show")
+    case "$3" in
+      forge-aaa) printf '{"data":{"issue":{"id":"forge-aaa","title":"Feature A","labels":["github_issue:42"]}}}\n' ;;
+      forge-bbb) printf '{"data":{"issue":{"id":"forge-bbb","title":"Feature B","labels":["github_issue:55"]}}}\n' ;;
+      *)         printf '{"data":{"issue":{"id":"%s","title":"","labels":[]}}}\n' "$3" ;;
+    esac
     ;;
+  "issue update") echo "Updated" ;;
 esac
 MOCK
-chmod +x "$mock_dir/bd"
+chmod +x "$mock_dir/forge"
 
-# ── Create mock bd (no in_progress issues) ──────────────────────────────
-cat > "$mock_dir/bd-empty" << 'MOCK'
+# ── Create mock forge (no in_progress issues) ───────────────────────────
+cat > "$mock_dir/forge-empty" << 'MOCK'
 #!/usr/bin/env bash
 case "$1 $2" in
-  "list --status=in_progress")
-    echo ""
-    ;;
+  "issue list") printf '{"data":{"issues":[]}}\n' ;;
 esac
 MOCK
-chmod +x "$mock_dir/bd-empty"
+chmod +x "$mock_dir/forge-empty"
 
-# ── Create mock bd (issue without github_issue state) ───────────────────
-cat > "$mock_dir/bd-no-gh" << 'MOCK'
+# ── Create mock forge (issue without a github_issue label) ──────────────
+cat > "$mock_dir/forge-no-gh" << 'MOCK'
 #!/usr/bin/env bash
 case "$1 $2" in
-  "list --status=in_progress")
-    echo "◐ forge-xxx · Feature X"
+  "issue list")
+    printf '{"data":{"issues":[{"id":"forge-xxx","status":"in_progress","labels":[]}]}}\n'
     ;;
-  "show forge-xxx")
-    echo "◐ forge-xxx · Feature X [● P2 · IN_PROGRESS]"
-    echo "Owner: devone"
-    echo "Updated: 2026-03-27T10:00:00Z"
+  "issue show")
+    printf '{"data":{"issue":{"id":"forge-xxx","title":"Feature X","labels":[]}}}\n'
     ;;
 esac
 MOCK
-chmod +x "$mock_dir/bd-no-gh"
+chmod +x "$mock_dir/forge-no-gh"
 
-# ── Create .beads/config.yaml for auto-sync tests ──────────────────────
-mkdir -p "$TEST_TMP/.beads"
-cat > "$TEST_TMP/.beads/config.yaml" << 'YAML'
+# ── Create .forge/config.yaml for auto-sync tests ──────────────────────
+mkdir -p "$TEST_TMP/.forge"
+cat > "$TEST_TMP/.forge/config.yaml" << 'YAML'
 team:
   auto-sync: true
 YAML
 
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd"
-export BEADS_ROOT="$TEST_TMP"
+export FORGE_CMD="$mock_dir/forge"
+export FORGE_ROOT="$TEST_TMP"
 
 # Source the library under test
 source "$SCRIPT_DIR/lib/hooks.sh"
@@ -148,7 +136,7 @@ assert_exit() {
 # ── Test 1: forge_team_sync with mock gh + bd → syncs in_progress issues ──
 echo "── Test 1: forge_team_sync syncs in_progress issues ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 rc=0
 output="$(forge_team_sync 2>&1)" || rc=$?
 assert_exit "exits 0" 0 "$rc"
@@ -158,7 +146,7 @@ assert_contains "reports synced issues" "Synced 2 issues" "$output"
 echo ""
 echo "── Test 2: forge_team_sync with gh not authenticated → error, exit 1 ──"
 export GH_CMD="$mock_dir/gh-noauth"
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 rc=0
 output="$(forge_team_sync 2>&1)" || rc=$?
 assert_exit "exits 1" 1 "$rc"
@@ -168,8 +156,8 @@ assert_contains "error message" "FORGE_AGENT_7f3a:ERROR:" "$output"
 echo ""
 echo "── Test 3: forge_team_sync with auto-sync: false → skip, exit 0 ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd"
-cat > "$TEST_TMP/.beads/config.yaml" << 'YAML'
+export FORGE_CMD="$mock_dir/forge"
+cat > "$TEST_TMP/.forge/config.yaml" << 'YAML'
 team:
   auto-sync: false
 YAML
@@ -178,7 +166,7 @@ output="$(forge_team_sync 2>&1)" || rc=$?
 assert_exit "exits 0" 0 "$rc"
 assert_not_contains "does not sync" "Synced" "$output"
 # Restore config
-cat > "$TEST_TMP/.beads/config.yaml" << 'YAML'
+cat > "$TEST_TMP/.forge/config.yaml" << 'YAML'
 team:
   auto-sync: true
 YAML
@@ -187,7 +175,7 @@ YAML
 echo ""
 echo "── Test 4: forge_team_sync with no in_progress issues → nothing to sync ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd-empty"
+export FORGE_CMD="$mock_dir/forge-empty"
 rc=0
 output="$(forge_team_sync 2>&1)" || rc=$?
 assert_exit "exits 0" 0 "$rc"
@@ -197,7 +185,7 @@ assert_contains "nothing to sync message" "Nothing to sync" "$output"
 echo ""
 echo "── Test 5: forge_team_sync --quiet → no output on success ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 rc=0
 output="$(forge_team_sync --quiet 2>&1)" || rc=$?
 assert_exit "exits 0" 0 "$rc"
@@ -207,7 +195,7 @@ assert_eq "no output" "" "$output"
 echo ""
 echo "── Test 6: forge_team_sync_on_stage triggers correct status sync per stage ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd"
+export FORGE_CMD="$mock_dir/forge"
 # dev transition → in_progress
 rc=0
 output="$(forge_team_sync_on_stage forge-aaa plan dev 2>&1)" || rc=$?
@@ -226,7 +214,7 @@ assert_contains "verify skips sync" "skipped" "$output"
 echo ""
 echo "── Test 7: Sync failure doesn't block (non-fatal warning) ──"
 export GH_CMD="$mock_dir/gh"
-export BD_CMD="$mock_dir/bd-no-gh"
+export FORGE_CMD="$mock_dir/forge-no-gh"
 rc=0
 output="$(forge_team_sync 2>&1)" || rc=$?
 # Should still exit 0 even with sync failures (non-blocking)

package/scripts/forge-team/tests/identity.test.sh

@@ -7,7 +7,7 @@ SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
 TEST_TMP="$(mktemp -d)"
 trap 'rm -rf "$TEST_TMP"' EXIT
 
-# Override TEAM_MAP_ROOT so tests don't touch real .beads/
+# Override TEAM_MAP_ROOT so tests don't touch real .forge/
 export TEAM_MAP_ROOT="$TEST_TMP"
 
 # ── Create mock gh ───────────────────────────────────────────────────────
@@ -88,7 +88,7 @@ echo "── Test 3: team_map_add creates parseable JSONL ──"
 export GH_CMD="$mock_dir/gh"
 unset _GITHUB_USER_CACHE
 team_map_add "testuser" "Test User"
-mapfile="$TEAM_MAP_ROOT/.beads/team-map.jsonl"
+mapfile="$TEAM_MAP_ROOT/.forge/team-map.jsonl"
 # Entry should be parseable JSON
 last_line="$(tail -1 "$mapfile")"
 parsed="$(echo "$last_line" | jq -r '.github')"
@@ -146,7 +146,7 @@ assert_exit "not a bot" 1 "$rc"
 echo ""
 echo "── Test 9: auto_detect_identity ──"
 # Clean state
-rm -rf "$TEAM_MAP_ROOT/.beads"
+rm -rf "$TEAM_MAP_ROOT/.forge"
 unset _GITHUB_USER_CACHE
 export GH_CMD="$mock_dir/gh"
 auto_detect_identity