@pareto4/pp-core 1.7.1 → 1.8.1

package/pareto-skills/_shared/sync-phase-status.sh

@@ -0,0 +1,139 @@
+#!/usr/bin/env bash
+# sync-phase-status.sh
+#
+# Move GitHub issues for a pp-core phase to a target board status.
+# Reads .planning/github-issues.json to find issues mapped to the phase,
+# then updates labels and board column.
+#
+# Used by pp-core workflows (plan-phase, execute-phase) at lifecycle transitions.
+# Non-blocking — failures are logged but never stop the pp-core workflow.
+#
+# Usage:
+#   bash sync-phase-status.sh <phase_number> <target_status> [--label-add X] [--label-remove Y]
+#
+# Examples:
+#   bash sync-phase-status.sh 4 "To Do"
+#   bash sync-phase-status.sh 4 "In Progress"   --label-add in-progress --label-remove verification
+#   bash sync-phase-status.sh 4 "Verification"  --label-add verification --label-remove in-progress
+#
+# Environment:
+#   GITHUB_ISSUES_JSON  — path to mapping file (default: .planning/github-issues.json)
+#
+# Exit code: always 0 (non-blocking). Errors go to stderr.
+
+set -uo pipefail
+
+PHASE="$1"
+TARGET_STATUS="$2"
+shift 2
+
+LABEL_ADD=""
+LABEL_REMOVE=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --label-add)    LABEL_ADD="$2"; shift 2 ;;
+    --label-remove) LABEL_REMOVE="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+
+MAPPING="${GITHUB_ISSUES_JSON:-.planning/github-issues.json}"
+
+if [ ! -f "$MAPPING" ]; then
+  echo "sync-phase-status: no mapping file at $MAPPING — skipping board sync" >&2
+  exit 0
+fi
+
+# Extract repo and board info
+REPO=$(jq -r '.repo // empty' "$MAPPING" 2>/dev/null)
+BOARD_NUM=$(jq -r '.board.number // empty' "$MAPPING" 2>/dev/null)
+BOARD_OWNER=$(jq -r '.board.owner // empty' "$MAPPING" 2>/dev/null)
+
+if [ -z "$REPO" ]; then
+  echo "sync-phase-status: no repo in mapping file — skipping" >&2
+  exit 0
+fi
+
+# Get all issue numbers for this phase (stories only — EPICs are derived)
+ISSUE_NUMBERS=$(jq -r --arg p "$PHASE" '
+  [.issues | to_entries[]
+   | select(.value.phase == ($p | tonumber) and .value.type == "story")
+   | .value.number] | .[]
+' "$MAPPING" 2>/dev/null)
+
+if [ -z "$ISSUE_NUMBERS" ]; then
+  echo "sync-phase-status: no stories mapped to phase $PHASE — skipping" >&2
+  exit 0
+fi
+
+COUNT=$(echo "$ISSUE_NUMBERS" | wc -l | tr -d ' ')
+echo "sync-phase-status: moving $COUNT stories for phase $PHASE → $TARGET_STATUS"
+
+# Update labels on each issue
+for NUM in $ISSUE_NUMBERS; do
+  LABEL_CMD="gh issue edit $NUM -R $REPO"
+  [ -n "$LABEL_ADD" ]    && LABEL_CMD="$LABEL_CMD --add-label $LABEL_ADD"
+  [ -n "$LABEL_REMOVE" ] && LABEL_CMD="$LABEL_CMD --remove-label $LABEL_REMOVE"
+
+  if [ -n "$LABEL_ADD" ] || [ -n "$LABEL_REMOVE" ]; then
+    eval "$LABEL_CMD" 2>/dev/null || echo "  warn: label update failed for #$NUM" >&2
+  fi
+done
+
+# Update board column (if board info available)
+if [ -n "$BOARD_NUM" ] && [ -n "$BOARD_OWNER" ]; then
+  # Resolve board project ID and Status field
+  PROJECT_ID=$(gh project view "$BOARD_NUM" --owner "$BOARD_OWNER" --format json --jq '.id' 2>/dev/null)
+
+  if [ -z "$PROJECT_ID" ]; then
+    echo "sync-phase-status: could not resolve project board — skipping column update" >&2
+    exit 0
+  fi
+
+  STATUS_FIELD_ID=$(gh project field-list "$BOARD_NUM" --owner "$BOARD_OWNER" --format json \
+    --jq '.fields[] | select(.name=="Status") | .id' 2>/dev/null)
+
+  OPTION_ID=$(gh project field-list "$BOARD_NUM" --owner "$BOARD_OWNER" --format json \
+    --jq ".fields[] | select(.name==\"Status\") | .options[] | select(.name==\"$TARGET_STATUS\") | .id" 2>/dev/null)
+
+  if [ -z "$STATUS_FIELD_ID" ] || [ -z "$OPTION_ID" ]; then
+    echo "sync-phase-status: could not resolve Status field or option '$TARGET_STATUS' — skipping column update" >&2
+    exit 0
+  fi
+
+  # Get all board items and match by issue number (--limit 200 to avoid default 30 cap)
+  ITEMS_JSON=$(gh project item-list "$BOARD_NUM" --owner "$BOARD_OWNER" --format json --limit 200 2>/dev/null)
+
+  for NUM in $ISSUE_NUMBERS; do
+    ITEM_ID=$(echo "$ITEMS_JSON" | jq -r --argjson n "$NUM" '
+      .items[] | select(.content.number == $n) | .id
+    ' 2>/dev/null)
+
+    if [ -n "$ITEM_ID" ] && [ "$ITEM_ID" != "null" ]; then
+      gh project item-edit \
+        --project-id "$PROJECT_ID" \
+        --id "$ITEM_ID" \
+        --field-id "$STATUS_FIELD_ID" \
+        --single-select-option-id "$OPTION_ID" 2>/dev/null \
+        && echo "  ✓ #$NUM → $TARGET_STATUS" \
+        || echo "  warn: board update failed for #$NUM" >&2
+    else
+      echo "  warn: #$NUM not found on board — skipping column update" >&2
+    fi
+  done
+fi
+
+# Update status in the mapping file
+jq --arg p "$PHASE" --arg s "$TARGET_STATUS" '
+  .issues |= with_entries(
+    if (.value.phase == ($p | tonumber) and .value.type == "story")
+    then .value.status = $s
+    else .
+    end
+  )
+  | .last_synced = (now | strftime("%Y-%m-%d"))
+' "$MAPPING" > "${MAPPING}.tmp" && mv "${MAPPING}.tmp" "$MAPPING"
+
+echo "sync-phase-status: done — $COUNT stories updated in mapping"
+exit 0