forge-workflow 0.0.4 → 0.0.6

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

@@ -0,0 +1,314 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Setup temp dir for test isolation ────────────────────────────────────
+TEST_TMP="$(mktemp -d)"
+trap 'rm -rf "$TEST_TMP"' EXIT
+
+# Override TEAM_MAP_ROOT so tests don't touch real .beads/
+export TEAM_MAP_ROOT="$TEST_TMP"
+
+# ── Create mock directories ────────────────────────────────────────────
+mock_dir="$(mktemp -d)"
+
+# ── Mock gh (authenticated, returns user "testuser") ───────────────────
+cat > "$mock_dir/gh" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  auth)
+    if [[ "${2:-}" == "status" ]]; then
+      echo "github.com"
+      echo "  ✓ Logged in to github.com account harshanandak"
+      exit 0
+    fi
+    ;;
+  api)
+    if [[ "${2:-}" == "user" ]]; then
+      echo "testuser"
+      exit 0
+    fi
+    ;;
+  issue)
+    if [[ "${2:-}" == "list" ]]; then
+      # Return JSON array of open issues
+      if [[ -n "${GH_MOCK_ISSUES:-}" ]]; then
+        echo "$GH_MOCK_ISSUES"
+      else
+        echo "[]"
+      fi
+      exit 0
+    fi
+    ;;
+esac
+echo "unknown gh call: $*" >&2
+exit 1
+MOCK
+chmod +x "$mock_dir/gh"
+
+# ── Mock gh (not authenticated) ────────────────────────────────────────
+cat > "$mock_dir/gh-noauth" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  auth)
+    if [[ "${2:-}" == "status" ]]; then
+      echo "You are not logged into any GitHub hosts." >&2
+      exit 1
+    fi
+    ;;
+  api)
+    echo "not logged in" >&2
+    exit 1
+    ;;
+esac
+exit 1
+MOCK
+chmod +x "$mock_dir/gh-noauth"
+
+# ── Mock bd ────────────────────────────────────────────────────────────
+cat > "$mock_dir/bd" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  list)
+    if [[ -n "${BD_MOCK_OUTPUT:-}" ]]; then
+      echo "$BD_MOCK_OUTPUT"
+    fi
+    exit 0
+    ;;
+  show)
+    case "${2:-}" in
+      forge-aaa)
+        echo "◐ forge-aaa · Feature A [● P2 · IN_PROGRESS]"
+        echo "Owner: devone"
+        if [[ -z "${BD_MOCK_NO_GITHUB_AAA:-}" ]]; then
+          echo "State: github_issue:10"
+        fi
+        ;;
+      forge-bbb)
+        echo "○ forge-bbb · Feature B [● P2 · OPEN]"
+        echo "Owner: devtwo"
+        if [[ -z "${BD_MOCK_NO_GITHUB_BBB:-}" ]]; then
+          echo "State: github_issue:20"
+        fi
+        ;;
+      forge-ccc)
+        echo "◐ forge-ccc · Feature C [● P1 · IN_PROGRESS]"
+        echo "Owner: devone"
+        # forge-ccc never has github_issue (for orphan tests)
+        ;;
+    esac
+    exit 0
+    ;;
+esac
+exit 0
+MOCK
+chmod +x "$mock_dir/bd"
+
+export GH_CMD="$mock_dir/gh"
+export BD_CMD="$mock_dir/bd"
+
+# Source the library under test
+source "$SCRIPT_DIR/lib/agent-prompt.sh"
+source "$SCRIPT_DIR/lib/identity.sh"
+source "$SCRIPT_DIR/lib/verify.sh"
+
+PASS=0
+FAIL=0
+
+assert_eq() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected '$expected', got '$actual')"
+  fi
+}
+
+assert_contains() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == *"$expected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected to contain '$expected', got '$actual')"
+  fi
+}
+
+assert_not_contains() {
+  local label="$1" unexpected="$2" actual="$3"
+  if [[ "$actual" != *"$unexpected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected NOT to contain '$unexpected')"
+  fi
+}
+
+assert_exit() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" -eq "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected exit $expected, got $actual)"
+  fi
+}
+
+# ── Test 1: All clean → exit 0, all checks pass ─────────────────────────
+echo "── Test 1: All clean → exit 0 ──"
+
+# Setup: identity exists in team map
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh"
+export BD_CMD="$mock_dir/bd"
+team_map_add "testuser" "Test User"
+
+# No beads issues, no github issues
+export BD_MOCK_OUTPUT=""
+export GH_MOCK_ISSUES="[]"
+
+# Create empty mapping file
+mkdir -p "$TEST_TMP/.github"
+echo '{}' > "$TEST_TMP/.github/beads-mapping.json"
+
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "all clean exits 0" 0 "$rc"
+assert_contains "shows github cli check" "GitHub CLI" "$output"
+assert_contains "shows identity check" "Identity" "$output"
+
+# ── Test 2: gh not authenticated → exit 1, error message ────────────────
+echo ""
+echo "── Test 2: gh not authenticated → exit 1 ──"
+
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh-noauth"
+
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "no auth exits 1" 1 "$rc"
+assert_contains "error about auth" "not authenticated" "$output"
+assert_contains "error has agent prefix" "FORGE_AGENT_7f3a:ERROR" "$output"
+
+# ── Test 3: Orphan Beads issue (no github_issue state) → detected ───────
+echo ""
+echo "── Test 3: Orphan Beads issue detected ──"
+
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh"
+export BD_MOCK_OUTPUT="◐ forge-ccc · Feature C"
+export GH_MOCK_ISSUES="[]"
+
+# forge-ccc has no github_issue state (see mock bd above)
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "orphan beads exits 1" 1 "$rc"
+assert_contains "orphan beads detected" "forge-ccc" "$output"
+assert_contains "prompt for sync" "forge team sync-issue" "$output"
+
+# ── Test 4: Orphan GitHub issue (not in mapping) → detected ─────────────
+echo ""
+echo "── Test 4: Orphan GitHub issue detected ──"
+
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh"
+export BD_MOCK_OUTPUT=""
+export GH_MOCK_ISSUES='[{"number":42,"title":"Some feature"},{"number":45,"title":"Another feature"}]'
+
+# Mapping file has neither #42 nor #45
+echo '{}' > "$TEST_TMP/.github/beads-mapping.json"
+
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "orphan github exits 1" 1 "$rc"
+assert_contains "orphan github #42 detected" "#42" "$output"
+assert_contains "orphan github #45 detected" "#45" "$output"
+assert_contains "prompt for import" "forge team import" "$output"
+
+# ── Test 5: Assignee mismatch → info message ────────────────────────────
+echo ""
+echo "── Test 5: Assignee mismatch → info message ──"
+
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh"
+
+# Setup: forge-aaa has github_issue:10, forge-bbb has github_issue:20
+export BD_MOCK_OUTPUT="◐ forge-aaa · Feature A
+○ forge-bbb · Feature B"
+
+# Create mapping with both issues
+cat > "$TEST_TMP/.github/beads-mapping.json" << 'EOF'
+{
+  "10": {"beads_id": "forge-aaa", "assignee": "devone"},
+  "20": {"beads_id": "forge-bbb", "assignee": "devtwo"},
+  "42": {"beads_id": "forge-ddd", "assignee": "devone"}
+}
+EOF
+
+# Override gh to return mismatched assignees from github
+cat > "$mock_dir/gh-mismatch" << 'MOCK'
+#!/usr/bin/env bash
+case "$1" in
+  auth)
+    if [[ "${2:-}" == "status" ]]; then
+      echo "  ✓ Logged in to github.com account harshanandak"
+      exit 0
+    fi
+    ;;
+  api)
+    if [[ "${2:-}" == "user" ]]; then
+      echo "testuser"
+      exit 0
+    fi
+    ;;
+  issue)
+    if [[ "${2:-}" == "list" ]]; then
+      echo '[{"number":10,"title":"Feature A"},{"number":20,"title":"Feature B"},{"number":42,"title":"Feature D"}]'
+      exit 0
+    fi
+    # view --json assignees
+    if [[ "${2:-}" == "view" ]]; then
+      case "${3:-}" in
+        10)
+          echo '{"assignees":[{"login":"devone"}]}'
+          ;;
+        20)
+          echo '{"assignees":[{"login":"devthree"}]}'
+          ;;
+        42)
+          echo '{"assignees":[{"login":"devone"}]}'
+          ;;
+      esac
+      exit 0
+    fi
+    ;;
+esac
+echo "unknown gh call: $*" >&2
+exit 1
+MOCK
+chmod +x "$mock_dir/gh-mismatch"
+export GH_CMD="$mock_dir/gh-mismatch"
+
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "assignee mismatch exits 1" 1 "$rc"
+assert_contains "mismatch info message" "mismatch" "$output"
+assert_contains "mismatch shows forge-bbb" "forge-bbb" "$output"
+assert_contains "mismatch shows devtwo vs devthree" "devtwo" "$output"
+
+# ── Test 6: No issues at all (no beads, no github) → exit 0 ─────────────
+echo ""
+echo "── Test 6: No issues at all → exit 0 ──"
+
+unset _GITHUB_USER_CACHE
+export GH_CMD="$mock_dir/gh"
+export BD_MOCK_OUTPUT=""
+export GH_MOCK_ISSUES="[]"
+echo '{}' > "$TEST_TMP/.github/beads-mapping.json"
+
+rc=0
+output="$(cmd_verify 2>&1)" || rc=$?
+assert_exit "no issues exits 0" 0 "$rc"
+
+# ── Results ──────────────────────────────────────────────────────────────
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

package/scripts/forge-team/tests/workflow-integration.test.sh

@@ -0,0 +1,43 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/../../.." && pwd)"
+PASS=0
+FAIL=0
+
+assert_contains_file() {
+  local label="$1" pattern="$2" file="$3"
+  if grep -q "$pattern" "$file" 2>/dev/null; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (pattern '$pattern' not in $file)"
+  fi
+}
+
+echo "── /status integration ──"
+STATUS="$SCRIPT_DIR/.claude/commands/status.md"
+assert_contains_file "status calls workload --me" "forge-team.*workload.*--me" "$STATUS"
+assert_contains_file "status calls dashboard" "forge-team.*dashboard" "$STATUS"
+
+echo ""
+echo "── /plan integration ──"
+PLAN="$SCRIPT_DIR/.claude/commands/plan.md"
+assert_contains_file "plan calls verify" "forge-team.*verify" "$PLAN"
+
+echo ""
+echo "── /ship integration ──"
+SHIP="$SCRIPT_DIR/.claude/commands/ship.md"
+assert_contains_file "ship calls sync" "forge-team.*sync" "$SHIP"
+assert_contains_file "ship calls verify" "forge-team.*verify" "$SHIP"
+
+echo ""
+echo "── Sync check ──"
+if node "$SCRIPT_DIR/scripts/sync-commands.js" --check 2>&1 | grep -qi 'error\|drift\|mismatch'; then
+  FAIL=$((FAIL + 1)); echo "  FAIL: sync drift detected"
+else
+  PASS=$((PASS + 1)); echo "  PASS: all agent dirs in sync"
+fi
+
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

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

@@ -0,0 +1,209 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+# ── Setup temp dir for test isolation ────────────────────────────────────
+TEST_TMP="$(mktemp -d)"
+trap 'rm -rf "$TEST_TMP"' EXIT
+
+# Override TEAM_MAP_ROOT so tests don't touch real .beads/
+export TEAM_MAP_ROOT="$TEST_TMP"
+
+# Fix "now" so stale detection is deterministic
+# forge-bbb updated 2026-03-25T10:00:00Z → 50h ago at this fixed time
+export WORKLOAD_NOW="2026-03-27T12:00:00Z"
+
+# ── Create mock gh ───────────────────────────────────────────────────────
+mock_dir="$(mktemp -d)"
+
+cat > "$mock_dir/gh" << 'MOCK'
+#!/usr/bin/env bash
+case "$1 $2" in
+  "api user")
+    echo "devone"
+    ;;
+esac
+MOCK
+chmod +x "$mock_dir/gh"
+
+# ── Create mock bd ───────────────────────────────────────────────────────
+cat > "$mock_dir/bd" << 'MOCK'
+#!/usr/bin/env bash
+case "$1 $2" in
+  "list --status=open,in_progress")
+    echo "◐ forge-aaa · Feature A"
+    echo "○ forge-bbb · Feature B"
+    echo "◐ forge-ccc · Feature C"
+    ;;
+  "show forge-aaa")
+    echo "◐ forge-aaa · Feature A [● P2 · IN_PROGRESS]"
+    echo "Owner: devone"
+    echo "Updated: 2026-03-27T10:00:00Z"
+    ;;
+  "show forge-bbb")
+    echo "○ forge-bbb · Feature B [● P2 · OPEN]"
+    echo "Owner: devtwo"
+    echo "Updated: 2026-03-25T10:00:00Z"
+    ;;
+  "show 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
+MOCK
+chmod +x "$mock_dir/bd"
+
+# ── Create mock bd with no issues ────────────────────────────────────────
+cat > "$mock_dir/bd-empty" << 'MOCK'
+#!/usr/bin/env bash
+case "$1 $2" in
+  "list --status=open,in_progress")
+    echo ""
+    ;;
+esac
+MOCK
+chmod +x "$mock_dir/bd-empty"
+
+export GH_CMD="$mock_dir/gh"
+export BD_CMD="$mock_dir/bd"
+
+# Source the library under test
+source "$SCRIPT_DIR/lib/workload.sh"
+
+PASS=0
+FAIL=0
+
+assert_eq() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected '$expected', got '$actual')"
+  fi
+}
+
+assert_contains() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" == *"$expected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected to contain '$expected', got '$actual')"
+  fi
+}
+
+assert_not_contains() {
+  local label="$1" unexpected="$2" actual="$3"
+  if [[ "$actual" != *"$unexpected"* ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected NOT to contain '$unexpected', got '$actual')"
+  fi
+}
+
+assert_exit() {
+  local label="$1" expected="$2" actual="$3"
+  if [[ "$actual" -eq "$expected" ]]; then
+    PASS=$((PASS + 1)); echo "  PASS: $label"
+  else
+    FAIL=$((FAIL + 1)); echo "  FAIL: $label (expected exit $expected, got $actual)"
+  fi
+}
+
+# ── Test 1: All developers shown with grouped issues ─────────────────────
+echo "── Test 1: All developers shown with grouped issues ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+assert_contains "shows devone header" "Developer: devone" "$output"
+assert_contains "shows devtwo header" "Developer: devtwo" "$output"
+assert_contains "shows forge-aaa" "forge-aaa" "$output"
+assert_contains "shows forge-bbb" "forge-bbb" "$output"
+assert_contains "shows forge-ccc" "forge-ccc" "$output"
+
+# ── Test 2: --developer=devone filters correctly ─────────────────────────
+echo ""
+echo "── Test 2: --developer=devone filters correctly ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload --developer=devone 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+assert_contains "shows devone" "Developer: devone" "$output"
+assert_not_contains "excludes devtwo" "Developer: devtwo" "$output"
+assert_contains "shows forge-aaa" "forge-aaa" "$output"
+assert_contains "shows forge-ccc" "forge-ccc" "$output"
+assert_not_contains "excludes forge-bbb" "forge-bbb" "$output"
+
+# ── Test 3: --me uses get_github_user() to filter ────────────────────────
+echo ""
+echo "── Test 3: --me uses get_github_user() to filter ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload --me 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+assert_contains "shows devone (current user)" "Developer: devone" "$output"
+assert_not_contains "excludes devtwo" "Developer: devtwo" "$output"
+
+# ── Test 4: No issues → "No active work" ─────────────────────────────────
+echo ""
+echo "── Test 4: No issues → No active work ──"
+unset _GITHUB_USER_CACHE
+export BD_CMD="$mock_dir/bd-empty"
+rc=0
+output="$(cmd_workload 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+assert_contains "shows no active work message" "No active work" "$output"
+export BD_CMD="$mock_dir/bd"
+
+# ── Test 5: Stale assignment flagged (>48h) ──────────────────────────────
+echo ""
+echo "── Test 5: Stale assignment flagged (>48h) ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+# forge-bbb was updated 2026-03-25T10:00:00Z, which is >48h ago from "now"
+assert_contains "stale flag on forge-bbb" "stale:" "$output"
+
+# ── Test 6: --format=json returns valid JSON ─────────────────────────────
+echo ""
+echo "── Test 6: --format=json returns valid JSON ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload --format=json 2>/dev/null)" || rc=$?
+assert_exit "exits 0" 0 "$rc"
+# Validate it's parseable JSON
+if echo "$output" | jq . >/dev/null 2>&1; then
+  PASS=$((PASS + 1)); echo "  PASS: output is valid JSON"
+else
+  FAIL=$((FAIL + 1)); echo "  FAIL: output is not valid JSON: $output"
+fi
+# Check JSON has developer keys
+if echo "$output" | jq -e '.devone' >/dev/null 2>&1; then
+  PASS=$((PASS + 1)); echo "  PASS: JSON contains devone key"
+else
+  FAIL=$((FAIL + 1)); echo "  FAIL: JSON missing devone key"
+fi
+if echo "$output" | jq -e '.devtwo' >/dev/null 2>&1; then
+  PASS=$((PASS + 1)); echo "  PASS: JSON contains devtwo key"
+else
+  FAIL=$((FAIL + 1)); echo "  FAIL: JSON missing devtwo key"
+fi
+
+# ── Test 7: Blocked issue flagged ─────────────────────────────────────────
+echo ""
+echo "── Test 7: Blocked issue flagged ──"
+unset _GITHUB_USER_CACHE
+rc=0
+output="$(cmd_workload 2>/dev/null)" || rc=$?
+assert_contains "blocked flag on forge-ccc" "blocked by forge-aaa" "$output"
+
+# ── Results ──────────────────────────────────────────────────────────────
+echo ""
+echo "Results: $PASS passed, $FAIL failed"
+[[ $FAIL -eq 0 ]] && exit 0 || exit 1

package/scripts/github-beads-sync/comment.mjs

@@ -0,0 +1,64 @@
+/**
+ * Bot comment parser/builder for GitHub-Beads sync.
+ *
+ * Produces and parses Vercel-inspired sync comments that use an
+ * edit-don't-create pattern with a stable HTML comment tag.
+ *
+ * @module comment
+ */
+
+/** HTML comment prefix used to identify sync comments. */
+export const SYNC_TAG_PREFIX = '<!-- beads-sync:';
+
+/**
+ * Build a markdown sync comment for a GitHub issue.
+ *
+ * @param {string} beadsId   - The Beads issue ID (e.g. "forge-abc").
+ * @param {number} issueNumber - The GitHub issue number.
+ * @param {object} [metadata]  - Optional metadata fields.
+ * @param {string} [metadata.type]        - Issue type (feature, bug, etc.).
+ * @param {string} [metadata.priority]    - Priority label (P0-P4).
+ * @param {string} [metadata.externalRef] - External reference string.
+ * @returns {string} Markdown comment body.
+ */
+export function buildComment(beadsId, issueNumber, metadata = {}) {
+  const timestamp = new Date().toISOString();
+
+  const detailLines = [];
+  if (metadata.type) detailLines.push(`- Type: ${metadata.type}`);
+  if (metadata.priority != null) detailLines.push(`- Priority: ${metadata.priority}`);
+  if (metadata.externalRef) detailLines.push(`- External ref: ${metadata.externalRef}`);
+  detailLines.push(`- Synced: ${timestamp}`);
+
+  return [
+    `${SYNC_TAG_PREFIX}${issueNumber} -->`,
+    `**Beads:** \`${beadsId}\``,
+    '<details>',
+    '<summary>Sync details</summary>',
+    '',
+    ...detailLines,
+    '</details>',
+  ].join('\n');
+}
+
+/**
+ * Parse a comment body and extract sync metadata.
+ *
+ * @param {string|null|undefined} commentBody - Raw comment markdown.
+ * @returns {{ beadsId: string, issueNumber: number } | null}
+ *   Extracted IDs, or `null` if the comment is not a sync comment.
+ */
+export function parseComment(commentBody) {
+  if (!commentBody) return null;
+
+  const tagMatch = commentBody.match(/<!--\s*beads-sync:(\d+)\s*-->/);
+  if (!tagMatch) return null;
+
+  const beadsMatch = commentBody.match(/\*\*Beads:\*\*\s*`([a-zA-Z]+-[a-zA-Z0-9]+)`/);
+  if (!beadsMatch) return null;
+
+  return {
+    beadsId: beadsMatch[1],
+    issueNumber: Number(tagMatch[1]),
+  };
+}