specweave 1.0.235 → 1.0.239

package/plugins/specweave-github/hooks/github-auto-create-handler.sh

@@ -0,0 +1,455 @@
+#!/bin/bash
+# github-auto-create-handler.sh — Auto-creates GitHub issues from spec.md user stories
+#
+# Triggered by post-tool-use.sh when spec.md is created/updated.
+# Pure bash using gh CLI — no TypeScript compilation required.
+#
+# Features:
+# - Idempotent: checks existing issues before creating
+# - Updates metadata.json with external links
+# - Debounce (10s window to batch rapid spec edits)
+# - Circuit breaker (3 consecutive failures → auto-disable)
+# - Non-blocking (all errors → exit 0)
+#
+# Usage: github-auto-create-handler.sh <INCREMENT_ID>
+# Called by: safe_run_background in post-tool-use.sh
+
+set +e  # Never crash Claude Code
+
+[[ "${SPECWEAVE_DISABLE_HOOKS:-0}" == "1" ]] && exit 0
+
+# ============================================================================
+# ARGS & PROJECT ROOT
+# ============================================================================
+
+INC_ID="$1"
+[[ -z "$INC_ID" ]] && exit 0
+
+PROJECT_ROOT="$PWD"
+while [[ "$PROJECT_ROOT" != "/" ]] && [[ ! -d "$PROJECT_ROOT/.specweave" ]]; do
+  PROJECT_ROOT=$(dirname "$PROJECT_ROOT")
+done
+[[ ! -d "$PROJECT_ROOT/.specweave" ]] && exit 0
+
+SPEC_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/spec.md"
+META_PATH="$PROJECT_ROOT/.specweave/increments/$INC_ID/metadata.json"
+CONFIG_PATH="$PROJECT_ROOT/.specweave/config.json"
+STATE_DIR="$PROJECT_ROOT/.specweave/state"
+LOGS_DIR="$PROJECT_ROOT/.specweave/logs"
+LOG_FILE="$LOGS_DIR/github-auto-create.log"
+
+mkdir -p "$STATE_DIR" "$LOGS_DIR" 2>/dev/null || true
+
+log() {
+  echo "[$(date '+%Y-%m-%d %H:%M:%S')] [github-auto-create] $1" >> "$LOG_FILE" 2>/dev/null || true
+}
+
+# ============================================================================
+# PRECONDITIONS
+# ============================================================================
+
+[[ ! -f "$SPEC_PATH" ]] && exit 0
+[[ ! -f "$CONFIG_PATH" ]] && exit 0
+
+command -v gh &>/dev/null || { log "gh CLI not found"; exit 0; }
+command -v jq &>/dev/null || { log "jq not found"; exit 0; }
+
+# Check GitHub sync enabled
+GH_ENABLED=$(jq -r '.sync.github.enabled // false' "$CONFIG_PATH" 2>/dev/null)
+[[ "$GH_ENABLED" != "true" ]] && { log "GitHub sync not enabled"; exit 0; }
+
+# Check auto-create enabled (either autoSync OR auto_create_github_issue)
+AUTO_SYNC=$(jq -r '.sync.autoSync // false' "$CONFIG_PATH" 2>/dev/null)
+AUTO_CREATE=$(jq -r '.hooks.post_increment_planning.auto_create_github_issue // false' "$CONFIG_PATH" 2>/dev/null)
+if [[ "$AUTO_SYNC" != "true" ]] && [[ "$AUTO_CREATE" != "true" ]]; then
+  log "Auto-sync disabled (autoSync=$AUTO_SYNC, auto_create=$AUTO_CREATE)"
+  exit 0
+fi
+
+# Get owner/repo
+OWNER=$(jq -r '.sync.github.owner // ""' "$CONFIG_PATH" 2>/dev/null)
+REPO=$(jq -r '.sync.github.repo // ""' "$CONFIG_PATH" 2>/dev/null)
+if [[ -z "$OWNER" ]] || [[ -z "$REPO" ]]; then
+  log "GitHub owner/repo not configured"
+  exit 0
+fi
+REPO_SLUG="$OWNER/$REPO"
+
+# Get project name from config for labels
+PROJECT_NAME=$(jq -r '.project.name // "specweave"' "$CONFIG_PATH" 2>/dev/null)
+PROJECT_LABEL="project:${PROJECT_NAME}"
+
+# ============================================================================
+# CIRCUIT BREAKER
+# ============================================================================
+
+CB_FILE="$STATE_DIR/.hook-circuit-breaker-github-auto-create"
+if [[ -f "$CB_FILE" ]]; then
+  CB_COUNT=$(cat "$CB_FILE" 2>/dev/null || echo 0)
+  if (( CB_COUNT >= 3 )); then
+    log "Circuit breaker OPEN ($CB_COUNT failures). Skipping. Delete $CB_FILE to reset."
+    exit 0
+  fi
+fi
+
+# ============================================================================
+# DEBOUNCE (10s window — spec.md may be written multiple times during planning)
+# ============================================================================
+
+if [[ "${SPECWEAVE_SKIP_DEBOUNCE:-0}" != "1" ]]; then
+  DEBOUNCE_FILE="$STATE_DIR/.github-auto-create-pending-$INC_ID"
+  if [[ -f "$DEBOUNCE_FILE" ]]; then
+    SIGNAL_AGE=$(($(date +%s) - $(stat -f "%m" "$DEBOUNCE_FILE" 2>/dev/null || echo 0)))
+    if (( SIGNAL_AGE < 10 )); then
+      log "Debounce: signal age ${SIGNAL_AGE}s < 10s. Deferring."
+      exit 0
+    fi
+  fi
+  echo "$(date +%s)" > "$DEBOUNCE_FILE" 2>/dev/null || true
+  sleep 10
+  # Check if a newer invocation took over
+  if [[ -f "$DEBOUNCE_FILE" ]]; then
+    CURRENT_SIGNAL=$(cat "$DEBOUNCE_FILE" 2>/dev/null || echo 0)
+    NOW=$(date +%s)
+    SIGNAL_AGE=$((NOW - CURRENT_SIGNAL))
+    if (( SIGNAL_AGE > 12 )); then
+      log "Debounce: newer invocation detected. Exiting."
+      exit 0
+    fi
+  fi
+  rm -f "$DEBOUNCE_FILE" 2>/dev/null || true
+fi
+
+# ============================================================================
+# CHECK IF ISSUES ALREADY EXIST
+# ============================================================================
+
+if [[ -f "$META_PATH" ]]; then
+  # Check if there are actual issues with issueNumber values (not just empty {})
+  ISSUE_COUNT=$(jq '[.externalLinks.github.issues // {} | to_entries[] | select(.value.issueNumber != null)] | length' "$META_PATH" 2>/dev/null || echo 0)
+  if (( ISSUE_COUNT > 0 )); then
+    log "Issues already exist for $INC_ID ($ISSUE_COUNT). Skipping."
+    exit 0
+  fi
+fi
+
+# ============================================================================
+# PARSE USER STORIES FROM SPEC.MD
+# ============================================================================
+
+# Get default priority from metadata.json
+DEFAULT_PRIORITY="P2"
+if [[ -f "$META_PATH" ]]; then
+  META_PRIORITY=$(jq -r '.priority // "P2"' "$META_PATH" 2>/dev/null)
+  [[ -n "$META_PRIORITY" ]] && DEFAULT_PRIORITY="$META_PRIORITY"
+fi
+
+log "Parsing user stories from $SPEC_PATH..."
+
+# Arrays to hold parsed user stories
+declare -a US_IDS US_TITLES US_PRIORITIES
+US_COUNT=0
+
+while IFS= read -r line; do
+  # Match: ### US-001: Title Here (P1)  — with priority
+  if [[ "$line" =~ ^###[[:space:]]+(US-[0-9]+):[[:space:]]+(.+)[[:space:]]+\((P[0-9])\)[[:space:]]*$ ]]; then
+    US_IDS+=("${BASH_REMATCH[1]}")
+    US_TITLES+=("${BASH_REMATCH[2]}")
+    US_PRIORITIES+=("${BASH_REMATCH[3]}")
+    ((US_COUNT++))
+  # Match: ### US-001: Title Here  — without priority
+  elif [[ "$line" =~ ^###[[:space:]]+(US-[0-9]+):[[:space:]]+(.+)[[:space:]]*$ ]]; then
+    US_IDS+=("${BASH_REMATCH[1]}")
+    US_TITLES+=("${BASH_REMATCH[2]}")
+    # Try to extract priority from metadata.json or default to P2
+    US_PRIORITIES+=("${DEFAULT_PRIORITY:-P2}")
+    ((US_COUNT++))
+  fi
+done < "$SPEC_PATH"
+
+if (( US_COUNT == 0 )); then
+  log "No user stories found in spec.md. Skipping."
+  exit 0
+fi
+
+log "Found $US_COUNT user stories. Creating GitHub issues..."
+
+# Get increment title from frontmatter
+INC_TITLE=$(grep -m1 '^title:' "$SPEC_PATH" | sed 's/^title:[[:space:]]*//' | sed 's/^"//' | sed 's/"$//')
+
+# ============================================================================
+# DERIVE FEATURE ID (ADR-0187: FS-{number} from increment number)
+# ============================================================================
+# Extract numeric prefix from increment ID: "0192-github-sync-v2-multi-repo" → "0192"
+INC_NUM=$(echo "$INC_ID" | grep -oE '^[0-9]+')
+# Strip leading zeros: "0192" → "192", "0001" → "1"
+FEATURE_NUM=$(echo "$INC_NUM" | sed 's/^0*//')
+[[ -z "$FEATURE_NUM" ]] && FEATURE_NUM="0"
+FEATURE_ID="FS-${FEATURE_NUM}"
+log "Derived Feature ID: $FEATURE_ID (from increment $INC_ID)"
+
+# ============================================================================
+# CREATE MILESTONE (one per increment, idempotent)
+# ============================================================================
+
+# Milestone uses Feature ID format: "FS-192: Short Title"
+MILESTONE_TITLE="${FEATURE_ID}"
+MILESTONE_NUM=""
+
+# Check existing milestones (list all, including closed)
+EXISTING_MS=$(gh api "repos/$REPO_SLUG/milestones?state=all&per_page=100" --jq ".[] | select(.title == \"$MILESTONE_TITLE\") | .number" 2>/dev/null || echo "")
+if [[ -n "$EXISTING_MS" ]]; then
+  MILESTONE_NUM="$EXISTING_MS"
+  log "Using existing milestone #$MILESTONE_NUM"
+else
+  MS_RESULT=$(gh api "repos/$REPO_SLUG/milestones" \
+    -f "title=$MILESTONE_TITLE" \
+    -f "description=$INC_TITLE" \
+    --method POST --jq '.number' 2>/dev/null || echo "")
+  if [[ -n "$MS_RESULT" ]] && [[ "$MS_RESULT" =~ ^[0-9]+$ ]]; then
+    MILESTONE_NUM="$MS_RESULT"
+    log "Created milestone #$MILESTONE_NUM: $MILESTONE_TITLE"
+  else
+    log "Warning: Failed to create milestone (continuing without it)"
+  fi
+fi
+
+# ============================================================================
+# ENSURE REQUIRED LABELS EXIST (idempotent)
+# ============================================================================
+
+ensure_label() {
+  local label_name="$1"
+  local label_color="${2:-ededed}"
+  local label_desc="${3:-}"
+  gh label create "$label_name" --repo "$REPO_SLUG" --color "$label_color" \
+    --description "$label_desc" --force 2>/dev/null || true
+}
+
+# Core labels
+ensure_label "user-story" "0075ca" "User story from SpecWeave spec"
+ensure_label "specweave" "6f42c1" "Managed by SpecWeave"
+ensure_label "$PROJECT_LABEL" "c5def5" "$PROJECT_NAME project"
+ensure_label "status:active" "0e8a16" "Active work item"
+
+# Priority labels (collect unique priorities from parsed user stories)
+for i in $(seq 0 $((US_COUNT - 1))); do
+  PRIO_LABEL="priority:$(echo "${US_PRIORITIES[$i]}" | tr '[:upper:]' '[:lower:]')"
+  case "${US_PRIORITIES[$i]}" in
+    P1) ensure_label "$PRIO_LABEL" "b60205" "Critical priority" ;;
+    P2) ensure_label "$PRIO_LABEL" "fbca04" "Medium priority" ;;
+    P3) ensure_label "$PRIO_LABEL" "0e8a16" "Low priority" ;;
+    *)  ensure_label "$PRIO_LABEL" "ededed" "Priority label" ;;
+  esac
+done
+
+log "Labels ensured"
+
+# ============================================================================
+# EXTRACT ACCEPTANCE CRITERIA FOR EACH USER STORY
+# ============================================================================
+
+# Function to extract ACs for a given US from spec.md
+extract_acs_for_us() {
+  local us_id="$1"
+  local in_section=false
+  local in_ac=false
+  local acs=""
+
+  while IFS= read -r line; do
+    # Start of our US section
+    if [[ "$line" =~ ^###[[:space:]]+"$us_id": ]]; then
+      in_section=true
+      continue
+    fi
+    # Start of next US section — stop
+    if $in_section && [[ "$line" =~ ^###[[:space:]]+US- ]]; then
+      break
+    fi
+    # Inside our section, look for AC lines
+    if $in_section; then
+      if [[ "$line" =~ ^\*\*Acceptance[[:space:]]Criteria ]]; then
+        in_ac=true
+        continue
+      fi
+      if $in_ac && [[ "$line" =~ ^-[[:space:]]+\[(.)\][[:space:]]+\*\*([^*]+)\*\*:[[:space:]]*(.*) ]]; then
+        local checked="${BASH_REMATCH[1]}"
+        local ac_id="${BASH_REMATCH[2]}"
+        local ac_desc="${BASH_REMATCH[3]}"
+        if [[ "$checked" == "x" ]]; then
+          acs+="- [x] **${ac_id}**: ${ac_desc}"$'\n'
+        else
+          acs+="- [ ] **${ac_id}**: ${ac_desc}"$'\n'
+        fi
+      fi
+      # Stop ACs at next section or empty line after ACs
+      if $in_ac && [[ "$line" =~ ^---$ ]]; then
+        break
+      fi
+    fi
+  done < "$SPEC_PATH"
+
+  echo "$acs"
+}
+
+# Function to extract description for a given US
+extract_desc_for_us() {
+  local us_id="$1"
+  local in_section=false
+  local desc=""
+  local collecting=false
+
+  while IFS= read -r line; do
+    if [[ "$line" =~ ^###[[:space:]]+"$us_id": ]]; then
+      in_section=true
+      continue
+    fi
+    if $in_section && [[ "$line" =~ ^###[[:space:]]+US- ]]; then
+      break
+    fi
+    if $in_section; then
+      # Collect the As a/I want/So that lines
+      if [[ "$line" =~ ^\*\*As\ a\*\* ]] || [[ "$line" =~ ^\*\*I\ want\*\* ]] || [[ "$line" =~ ^\*\*So\ that\*\* ]]; then
+        desc+="$line"$'\n'
+      fi
+    fi
+  done < "$SPEC_PATH"
+
+  echo "$desc"
+}
+
+# ============================================================================
+# CREATE ISSUES
+# ============================================================================
+
+CREATED_JSON="{}"
+ERRORS=0
+
+for i in $(seq 0 $((US_COUNT - 1))); do
+  US_ID="${US_IDS[$i]}"
+  US_TITLE="${US_TITLES[$i]}"
+  US_PRIORITY="${US_PRIORITIES[$i]}"
+
+  ISSUE_TITLE="[${FEATURE_ID}][${US_ID}] ${US_TITLE}"
+
+  # Check if issue already exists (by title prefix search — match both old and new format)
+  EXISTING=$(gh issue list --repo "$REPO_SLUG" --search "[${FEATURE_ID}][${US_ID}] in:title" --json number,url --limit 1 2>/dev/null || echo "[]")
+  EXISTING_NUM=$(echo "$EXISTING" | jq -r '.[0].number // empty' 2>/dev/null)
+
+  if [[ -n "$EXISTING_NUM" ]]; then
+    EXISTING_URL=$(echo "$EXISTING" | jq -r '.[0].url // empty' 2>/dev/null)
+    log "Issue already exists for $US_ID: #$EXISTING_NUM"
+    CREATED_JSON=$(echo "$CREATED_JSON" | jq --arg us "$US_ID" --arg num "$EXISTING_NUM" --arg url "$EXISTING_URL" \
+      '. + {($us): {"issueNumber": ($num | tonumber), "issueUrl": $url, "status": "existing"}}' 2>/dev/null)
+    continue
+  fi
+
+  # Build issue body
+  US_DESC=$(extract_desc_for_us "$US_ID")
+  US_ACS=$(extract_acs_for_us "$US_ID")
+
+  ISSUE_BODY="## Description
+
+${US_DESC}
+**Priority**: ${US_PRIORITY}
+
+## Acceptance Criteria
+
+<!-- specweave:ac-start -->
+${US_ACS}<!-- specweave:ac-end -->
+
+---
+**Feature**: ${FEATURE_ID} | **Increment**: \`${INC_ID}\`
+<!-- specweave:sync feature=${FEATURE_ID} increment=${INC_ID} us=${US_ID} -->"
+
+  # Create the issue
+  CREATE_ARGS=(
+    "issue" "create"
+    "--repo" "$REPO_SLUG"
+    "--title" "$ISSUE_TITLE"
+    "--body" "$ISSUE_BODY"
+    "--label" "user-story"
+    "--label" "specweave"
+    "--label" "$PROJECT_LABEL"
+    "--label" "status:active"
+    "--label" "priority:$(echo "$US_PRIORITY" | tr '[:upper:]' '[:lower:]')"
+  )
+
+  # Add milestone if available
+  if [[ -n "$MILESTONE_NUM" ]]; then
+    CREATE_ARGS+=("--milestone" "$MILESTONE_TITLE")
+  fi
+
+  RESULT=$(gh "${CREATE_ARGS[@]}" 2>&1)
+  CREATE_EXIT=$?
+
+  if [[ $CREATE_EXIT -ne 0 ]]; then
+    log "ERROR creating issue for $US_ID: $RESULT"
+    ((ERRORS++))
+
+    # Update circuit breaker
+    CB_VAL=$(cat "$CB_FILE" 2>/dev/null || echo 0)
+    echo "$((CB_VAL + 1))" > "$CB_FILE" 2>/dev/null || true
+    continue
+  fi
+
+  # Parse issue URL from result (gh outputs the URL on success)
+  ISSUE_URL=$(echo "$RESULT" | grep -oE 'https://github.com/[^ ]+' | head -1)
+  ISSUE_NUM=$(echo "$ISSUE_URL" | grep -oE '[0-9]+$')
+
+  if [[ -n "$ISSUE_NUM" ]]; then
+    log "Created issue #$ISSUE_NUM for $US_ID: $ISSUE_URL"
+    CREATED_JSON=$(echo "$CREATED_JSON" | jq --arg us "$US_ID" --arg num "$ISSUE_NUM" --arg url "$ISSUE_URL" \
+      '. + {($us): {"issueNumber": ($num | tonumber), "issueUrl": $url, "status": "created"}}' 2>/dev/null)
+  fi
+done
+
+# ============================================================================
+# UPDATE METADATA.JSON WITH EXTERNAL LINKS
+# ============================================================================
+
+if [[ -f "$META_PATH" ]]; then
+  UPDATED_META=$(jq --argjson issues "$CREATED_JSON" --arg ms "${MILESTONE_NUM:-}" \
+    '.externalLinks.github = {
+      "issues": $issues,
+      "milestone": (if $ms != "" then ($ms | tonumber) else null end),
+      "syncedAt": (now | strftime("%Y-%m-%dT%H:%M:%SZ"))
+    }' "$META_PATH" 2>/dev/null)
+
+  if [[ -n "$UPDATED_META" ]]; then
+    echo "$UPDATED_META" > "$META_PATH" 2>/dev/null
+    log "Updated metadata.json with GitHub issue links"
+  fi
+fi
+
+# ============================================================================
+# UPDATE SYNC METADATA
+# ============================================================================
+
+SYNC_META="$PROJECT_ROOT/.specweave/sync-metadata.json"
+if [[ -f "$SYNC_META" ]]; then
+  jq --arg ts "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+    '.github.lastSync = $ts | .github.lastSyncResult = "success"' \
+    "$SYNC_META" > "${SYNC_META}.tmp" 2>/dev/null && \
+    mv "${SYNC_META}.tmp" "$SYNC_META" 2>/dev/null
+fi
+
+# Reset circuit breaker on success
+if (( ERRORS == 0 )); then
+  echo "0" > "$CB_FILE" 2>/dev/null || true
+fi
+
+CREATED_COUNT=$(echo "$CREATED_JSON" | jq 'to_entries | map(select(.value.status == "created")) | length' 2>/dev/null || echo 0)
+EXISTING_COUNT=$(echo "$CREATED_JSON" | jq 'to_entries | map(select(.value.status == "existing")) | length' 2>/dev/null || echo 0)
+
+log "Done: $CREATED_COUNT created, $EXISTING_COUNT existing, $ERRORS errors"
+
+# Output summary for user visibility (will appear as hook output)
+if (( CREATED_COUNT > 0 )); then
+  echo ""
+  echo "  [GitHub Sync] Auto-created $CREATED_COUNT issue(s) for increment $INC_ID"
+  echo "  Milestone: $MILESTONE_TITLE"
+  echo ""
+fi
+
+exit 0

package/plugins/specweave-github/lib/github-ac-comment-poster.js

@@ -0,0 +1,150 @@
+import { readFile } from "fs/promises";
+import { execFileNoThrow } from "../../../src/utils/execFileNoThrow.js";
+import { pushSyncUserStories } from "./github-push-sync.js";
+async function postACProgressComments(incrementId, affectedUSIds, specPath, options) {
+  const result = { posted: [], errors: [] };
+  if (affectedUSIds.length === 0) {
+    return result;
+  }
+  let content;
+  try {
+    content = await readFile(specPath, "utf-8");
+  } catch (err) {
+    result.errors.push({
+      usId: affectedUSIds[0],
+      error: err instanceof Error ? err.message : String(err)
+    });
+    return result;
+  }
+  const issueLinks = parseIssueLinks(content);
+  const repoSlug = `${options.owner}/${options.repo}`;
+  const env = options.token ? { GH_TOKEN: options.token } : void 0;
+  for (const usId of affectedUSIds) {
+    const link = issueLinks[usId];
+    if (!link) {
+      continue;
+    }
+    const acStates = parseACStatesForUS(content, usId);
+    const commentBody = buildProgressCommentForUS(incrementId, usId, acStates);
+    const execResult = await execFileNoThrow(
+      "gh",
+      ["issue", "comment", String(link.issueNumber), "--body", commentBody, "-R", repoSlug],
+      env ? { env } : {}
+    );
+    if (execResult.success) {
+      result.posted.push({ usId, issueNumber: link.issueNumber });
+    } else {
+      result.errors.push({
+        usId,
+        error: execResult.stderr || "Unknown error posting comment"
+      });
+    }
+    const usForSync = buildUserStoryForSync(content, usId, acStates, incrementId);
+    if (usForSync) {
+      try {
+        await pushSyncUserStories([usForSync], {
+          owner: options.owner,
+          repo: options.repo,
+          token: options.token
+        });
+      } catch {
+      }
+    }
+  }
+  return result;
+}
+function parseIssueLinks(content) {
+  const links = {};
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!fmMatch) return links;
+  const frontmatter = fmMatch[1];
+  const usBlockMatch = frontmatter.match(/userStories:\s*\n((?:\s{6,}[\s\S]*?)(?=\n\s{0,3}\S|$))/);
+  if (!usBlockMatch) return links;
+  const usBlock = usBlockMatch[1];
+  const usEntries = usBlock.match(/^\s+(US-\d+):\s*\n((?:\s+\w[\s\S]*?)(?=\n\s+US-|\s*$))/gm);
+  if (!usEntries) return links;
+  for (const entry of usEntries) {
+    const idMatch = entry.match(/(US-\d+):/);
+    const numMatch = entry.match(/issueNumber:\s*(\d+)/);
+    const urlMatch = entry.match(/issueUrl:\s*"([^"]+)"/);
+    if (idMatch && numMatch) {
+      links[idMatch[1]] = {
+        issueNumber: parseInt(numMatch[1], 10),
+        issueUrl: urlMatch ? urlMatch[1] : ""
+      };
+    }
+  }
+  return links;
+}
+function parseACStatesForUS(content, usId) {
+  const states = [];
+  const usNum = String(parseInt(usId.replace("US-", ""), 10));
+  const acPattern = new RegExp(
+    `- \\[([ x])\\] \\*\\*AC-US${usNum}-(\\d+)\\*\\*:\\s*(.+)`,
+    "g"
+  );
+  let match;
+  while ((match = acPattern.exec(content)) !== null) {
+    states.push({
+      id: `AC-US${usNum}-${match[2]}`,
+      description: match[3].trim(),
+      completed: match[1] === "x"
+    });
+  }
+  return states;
+}
+function buildUserStoryForSync(content, usId, acStates, incrementId) {
+  const usNum = String(parseInt(usId.replace("US-", ""), 10)).padStart(3, "0");
+  const titleMatch = content.match(new RegExp(`### US-${usNum}:\\s*(.+)`));
+  const title = titleMatch ? titleMatch[1].trim() : usId;
+  return {
+    id: usId,
+    title,
+    description: "",
+    priority: "P1",
+    status: "in-progress",
+    acceptanceCriteria: acStates.map((ac) => ({
+      id: ac.id,
+      description: ac.description,
+      completed: ac.completed
+    })),
+    specId: incrementId
+  };
+}
+function buildProgressCommentForUS(incrementId, usId, acStates) {
+  const total = acStates.length;
+  const completed = acStates.filter((ac) => ac.completed).length;
+  const percentage = total > 0 ? Math.round(completed / total * 100) : 0;
+  let comment = `**Progress Update** \u2014 ${usId} (Increment ${incrementId})
+
+`;
+  comment += `**Status**: ${completed}/${total} ACs complete (${percentage}%)
+
+`;
+  if (completed > 0) {
+    comment += `**Completed**:
+`;
+    for (const ac of acStates.filter((a) => a.completed)) {
+      comment += `- [x] **${ac.id}**: ${ac.description}
+`;
+    }
+    comment += "\n";
+  }
+  if (completed < total) {
+    comment += `**Remaining**:
+`;
+    for (const ac of acStates.filter((a) => !a.completed)) {
+      comment += `- [ ] **${ac.id}**: ${ac.description}
+`;
+    }
+    comment += "\n";
+  }
+  comment += `---
+`;
+  comment += `Auto-synced by SpecWeave | ${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}
+`;
+  return comment;
+}
+export {
+  postACProgressComments
+};