shipwright-cli 1.10.0 → 2.1.0

package/scripts/sw-tracker-github.sh

@@ -0,0 +1,188 @@
+#!/usr/bin/env bash
+# ╔═══════════════════════════════════════════════════════════════════════════╗
+# ║  shipwright tracker: GitHub Provider                                     ║
+# ║  Sourced by sw-tracker.sh — do not call directly                       ║
+# ╚═══════════════════════════════════════════════════════════════════════════╝
+# This file is sourced by sw-tracker.sh.
+# It defines provider_* functions used by the tracker router.
+# Do NOT add set -euo pipefail or a main() function here.
+
+# ─── Discovery & CRUD Interface ────────────────────────────────────────────
+# All functions output normalized JSON (or plain text where specified).
+# Input: normalized arguments (label, state, issue_id, etc.)
+# Output: JSON matching common schema across all providers
+
+# Discover issues from GitHub using gh CLI
+# Input: label, state, limit
+# Output: JSON array of {id, title, labels[], state, body}
+provider_discover_issues() {
+    local label="$1"
+    local state="${2:-open}"
+    local limit="${3:-50}"
+
+    # Check $NO_GITHUB env var
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    local gh_args=()
+    gh_args+=(issue list)
+    gh_args+=(--state "$state")
+    gh_args+=(--limit "$limit")
+
+    if [[ -n "$label" ]]; then
+        gh_args+=(--label "$label")
+    fi
+
+    # Fetch as JSON: number, title, labels, state
+    gh_args+=(--json number,title,labels,state)
+
+    local response
+    response=$(gh "${gh_args[@]}" 2>/dev/null) || {
+        echo "[]"
+        return 0
+    }
+
+    # Normalize to {id, title, labels[], state}
+    echo "$response" | jq '[.[] | {id: .number, title: .title, labels: [.labels[].name], state: .state}]' 2>/dev/null || echo "[]"
+}
+
+# Fetch single issue details
+# Input: issue_id (number or identifier like "123" or "OWNER/REPO#123")
+# Output: JSON {id, title, body, labels[], state}
+provider_get_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    local response
+    response=$(gh issue view "$issue_id" --json number,title,body,labels,state 2>/dev/null) || {
+        return 1
+    }
+
+    # Normalize output
+    echo "$response" | jq '{id: .number, title: .title, body: .body, labels: [.labels[].name], state: .state}' 2>/dev/null || return 1
+}
+
+# Fetch issue body text only
+# Input: issue_id
+# Output: plain text body
+provider_get_issue_body() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    gh issue view "$issue_id" --json body --jq '.body' 2>/dev/null || return 1
+}
+
+# Add label to issue
+# Input: issue_id, label
+# Output: none (stdout on success, nothing on failure)
+provider_add_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    gh issue edit "$issue_id" --add-label "$label" 2>/dev/null || return 1
+}
+
+# Remove label from issue
+# Input: issue_id, label
+# Output: none
+provider_remove_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    gh issue edit "$issue_id" --remove-label "$label" 2>/dev/null || return 1
+}
+
+# Add comment to issue
+# Input: issue_id, body
+# Output: none
+provider_comment() {
+    local issue_id="$1"
+    local body="$2"
+
+    [[ -z "$issue_id" || -z "$body" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    gh issue comment "$issue_id" --body "$body" 2>/dev/null || return 1
+}
+
+# Close/resolve issue
+# Input: issue_id
+# Output: none
+provider_close_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    gh issue close "$issue_id" 2>/dev/null || return 1
+}
+
+# Create new issue
+# Input: title, body, labels (comma-separated or space-separated)
+# Output: JSON {id, title}
+provider_create_issue() {
+    local title="$1"
+    local body="$2"
+    local labels="${3:-}"
+
+    [[ -z "$title" ]] && return 1
+    [[ "${NO_GITHUB:-}" == "1" ]] && return 0
+
+    local gh_args=(issue create)
+    gh_args+=(--title "$title")
+
+    if [[ -n "$body" ]]; then
+        gh_args+=(--body "$body")
+    fi
+
+    if [[ -n "$labels" ]]; then
+        # Convert space-separated to gh format (--label multiple times)
+        # Handle both "label1,label2" and "label1 label2"
+        local label_list
+        label_list=$(echo "$labels" | tr ',' '\n' | tr ' ' '\n' | grep -v '^$' || true)
+        while IFS= read -r label; do
+            [[ -n "$label" ]] && gh_args+=(--label "$label")
+        done <<< "$label_list"
+    fi
+
+    local response
+    response=$(gh "${gh_args[@]}" 2>/dev/null) || {
+        return 1
+    }
+
+    # Extract issue number from response or return error
+    # GitHub response is typically: "Created issue <repo>#<number>"
+    local issue_num
+    issue_num=$(echo "$response" | grep -oE '#[0-9]+' | head -1 | tr -d '#' || true)
+
+    if [[ -z "$issue_num" ]]; then
+        return 1
+    fi
+
+    echo "{\"id\": $issue_num, \"title\": \"$title\"}"
+}
+
+# ─── Main Provider Entry Point (Notification) ──────────────────────────────
+# Called by tracker_notify() in sw-tracker.sh
+
+provider_notify() {
+    local event="$1"
+    local gh_issue="${2:-}"
+    local detail="${3:-}"
+
+    # GitHub is the native provider — no external sync needed
+    # This function exists for consistency with Linear/Jira but is minimal
+    # Real integration happens through pipeline stages calling provider_* functions
+
+    # For now, just log the event
+    emit_event "tracker.notify" "provider=github" "event=$event" "issue=$gh_issue"
+}

package/scripts/sw-tracker-jira.sh

@@ -137,6 +137,178 @@ jira_api() {
     curl "${args[@]}" "${JIRA_BASE_URL}/rest/api/3/${endpoint}" 2>&1
 }
 
+# ─── Discovery & CRUD Interface ───────────────────────────────────────────
+# Implements provider interface for daemon discovery and pipeline CRUD
+
+provider_discover_issues() {
+    local label="$1"
+    local state="${2:-open}"
+    local limit="${3:-50}"
+
+    provider_load_config
+
+    # Build JQL query
+    local jql="project = \"${JIRA_PROJECT_KEY}\""
+
+    if [[ -n "$label" ]]; then
+        jql="${jql} AND labels = \"${label}\""
+    fi
+
+    # Map state parameter to Jira status
+    case "$state" in
+        open)
+            jql="${jql} AND status IN (${JIRA_TRANSITION_IN_PROGRESS:-\"In Progress\"},${JIRA_TRANSITION_IN_REVIEW:-\"In Review\"})"
+            ;;
+        closed)
+            jql="${jql} AND status = ${JIRA_TRANSITION_DONE:-\"Done\"}"
+            ;;
+        *)
+            # Custom status provided
+            jql="${jql} AND status = \"${state}\""
+            ;;
+    esac
+
+    jql="${jql} ORDER BY created DESC"
+
+    # Fetch issues
+    local response
+    response=$(jira_api "GET" "search?jql=$(printf '%s' "$jql" | jq -sRr @uri)&maxResults=${limit}&fields=key,summary,labels,status" 2>/dev/null) || {
+        echo "[]"
+        return 0
+    }
+
+    # Normalize to {id, title, labels[], state}
+    echo "$response" | jq '[.issues[]? | {id: .key, title: .fields.summary, labels: [.fields.labels[]?.name // empty], state: .fields.status.name}]' 2>/dev/null || echo "[]"
+}
+
+provider_get_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+
+    local response
+    response=$(jira_api "GET" "issue/${issue_id}?fields=key,summary,description,labels,status" 2>/dev/null) || {
+        return 1
+    }
+
+    # Normalize output
+    echo "$response" | jq '{id: .key, title: .fields.summary, body: .fields.description, labels: [.fields.labels[]?.name // empty], state: .fields.status.name}' 2>/dev/null || return 1
+}
+
+provider_get_issue_body() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+
+    local response
+    response=$(jira_api "GET" "issue/${issue_id}?fields=description" 2>/dev/null) || {
+        return 1
+    }
+
+    echo "$response" | jq -r '.fields.description // ""' 2>/dev/null || return 1
+}
+
+provider_add_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+
+    provider_load_config
+
+    # Get current labels
+    local current_labels
+    current_labels=$(jira_api "GET" "issue/${issue_id}?fields=labels" 2>/dev/null | jq '.fields.labels[]?.name' 2>/dev/null || echo "[]")
+
+    # Add new label
+    local payload
+    payload=$(jq -n --arg label "$label" --argjson labels "$current_labels" '{fields: {labels: ($labels | map(select(. != $label)) + [$label])}}' 2>/dev/null)
+
+    jira_api "PUT" "issue/${issue_id}" "$payload" 2>/dev/null || return 1
+}
+
+provider_remove_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+
+    provider_load_config
+
+    # Get current labels and remove the specified one
+    local payload
+    payload=$(jq -n --arg label "$label" '{fields: {labels: [{name: ""}]}}')
+
+    jira_api "PUT" "issue/${issue_id}" "$payload" 2>/dev/null || return 1
+}
+
+provider_comment() {
+    local issue_id="$1"
+    local body="$2"
+
+    [[ -z "$issue_id" || -z "$body" ]] && return 1
+
+    provider_load_config
+    jira_add_comment "$issue_id" "$body"
+}
+
+provider_close_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+    jira_transition "$issue_id" "$JIRA_TRANSITION_DONE"
+}
+
+provider_create_issue() {
+    local title="$1"
+    local body="$2"
+    local labels="${3:-}"
+
+    [[ -z "$title" ]] && return 1
+
+    provider_load_config
+
+    # Build payload
+    local payload
+    payload=$(jq -n --arg summary "$title" --arg description "$body" --arg project "$JIRA_PROJECT_KEY" \
+        '{
+            fields: {
+                project: {key: $project},
+                summary: $summary,
+                description: $description,
+                issuetype: {name: "Task"}
+            }
+        }')
+
+    # Add labels if provided
+    if [[ -n "$labels" ]]; then
+        local label_array
+        label_array=$(echo "$labels" | jq -R 'split("[, ]"; "x") | map(select(length > 0))' 2>/dev/null || echo '[]')
+        payload=$(echo "$payload" | jq --argjson labels "$label_array" '.fields.labels = $labels' 2>/dev/null)
+    fi
+
+    local response
+    response=$(jira_api "POST" "issue" "$payload" 2>/dev/null) || {
+        return 1
+    }
+
+    # Extract issue key from response
+    local issue_key
+    issue_key=$(echo "$response" | jq -r '.key // empty' 2>/dev/null)
+
+    if [[ -z "$issue_key" ]]; then
+        return 1
+    fi
+
+    echo "{\"id\": \"$issue_key\", \"title\": \"$title\"}"
+}
+
 # ─── Find Jira Issue Key from GitHub Issue Body ───────────────────────────
 
 find_jira_key() {

package/scripts/sw-tracker-linear.sh

@@ -216,6 +216,257 @@ linear_attach_pr() {
     linear_add_comment "$issue_id" "$body"
 }
 
+# ─── Discovery & CRUD Interface ───────────────────────────────────────────
+# Implements provider interface for daemon discovery and pipeline CRUD
+
+provider_discover_issues() {
+    local label="$1"
+    local state="${2:-open}"
+    local limit="${3:-50}"
+
+    provider_load_config
+
+    # Build Linear query for issues
+    local query='query($teamId: String!, $first: Int, $filter: IssueFilter) {
+        team(id: $teamId) {
+            issues(first: $first, filter: $filter) {
+                nodes {
+                    id identifier title labels {nodes {name}}
+                    state {id name type}
+                }
+            }
+        }
+    }'
+
+    # Build filter for state
+    local state_filter=""
+    case "$state" in
+        open)
+            # Open = unstarted or started
+            state_filter='and: [or: [{state: {type: {eq: "unstarted"}}}, {state: {type: {eq: "started"}}}]]'
+            ;;
+        closed)
+            state_filter='and: [{state: {type: {eq: "completed"}}}]'
+            ;;
+        *)
+            # Custom state provided
+            state_filter="and: [{state: {type: {eq: \"${state}\"}}}]"
+            ;;
+    esac
+
+    # Add label filter if provided
+    if [[ -n "$label" ]]; then
+        state_filter="${state_filter}, {labels: {some: {name: {eq: \"${label}\"}}}}"
+    fi
+
+    local filter
+    filter="{${state_filter}}"
+
+    local vars
+    vars=$(jq -n --arg teamId "$LINEAR_TEAM_ID" --arg filter "$filter" --arg limit "$limit" \
+        "{teamId: \$teamId, first: (\$limit | tonumber), filter: $filter}" 2>/dev/null || \
+        jq -n --arg teamId "$LINEAR_TEAM_ID" --arg limit "$limit" \
+        '{teamId: $teamId, first: ($limit | tonumber)}')
+
+    local response
+    response=$(linear_graphql "$query" "$vars" 2>/dev/null) || {
+        echo "[]"
+        return 0
+    }
+
+    # Normalize to {id, title, labels[], state}
+    echo "$response" | jq '[.data.team.issues.nodes[]? | {id: .id, title: .title, labels: [.labels.nodes[]?.name // empty], state: .state.name}]' 2>/dev/null || echo "[]"
+}
+
+provider_get_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+
+    local query='query($id: String!) {
+        issue(id: $id) {
+            id title description labels {nodes {name}}
+            state {id name}
+        }
+    }'
+
+    local vars
+    vars=$(jq -n --arg id "$issue_id" '{id: $id}')
+
+    local response
+    response=$(linear_graphql "$query" "$vars" 2>/dev/null) || {
+        return 1
+    }
+
+    # Normalize output
+    echo "$response" | jq '{id: .data.issue.id, title: .data.issue.title, body: .data.issue.description, labels: [.data.issue.labels.nodes[]?.name // empty], state: .data.issue.state.name}' 2>/dev/null || return 1
+}
+
+provider_get_issue_body() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+
+    local query='query($id: String!) {
+        issue(id: $id) {
+            description
+        }
+    }'
+
+    local vars
+    vars=$(jq -n --arg id "$issue_id" '{id: $id}')
+
+    local response
+    response=$(linear_graphql "$query" "$vars" 2>/dev/null) || {
+        return 1
+    }
+
+    echo "$response" | jq -r '.data.issue.description // ""' 2>/dev/null || return 1
+}
+
+provider_add_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+
+    provider_load_config
+
+    # Linear label IDs are required — fetch them
+    local query='query {
+        labels(first: 100) {
+            nodes {id name}
+        }
+    }'
+
+    local labels_response
+    labels_response=$(linear_graphql "$query" "{}" 2>/dev/null) || return 1
+
+    local label_id
+    label_id=$(echo "$labels_response" | jq -r --arg name "$label" '.data.labels.nodes[] | select(.name == $name) | .id' 2>/dev/null || true)
+
+    if [[ -z "$label_id" ]]; then
+        # Label not found — skip
+        return 0
+    fi
+
+    local update_query='mutation($issueId: String!, $labelIds: [String!]) {
+        issueLabelCreate(issueId: $issueId, labelIds: $labelIds) {
+            success
+        }
+    }'
+
+    local vars
+    vars=$(jq -n --arg issueId "$issue_id" --arg labelId "$label_id" \
+        '{issueId: $issueId, labelIds: [$labelId]}')
+
+    linear_graphql "$update_query" "$vars" >/dev/null 2>&1 || return 1
+}
+
+provider_remove_label() {
+    local issue_id="$1"
+    local label="$2"
+
+    [[ -z "$issue_id" || -z "$label" ]] && return 1
+
+    provider_load_config
+
+    # Linear requires label IDs
+    local query='query {
+        labels(first: 100) {
+            nodes {id name}
+        }
+    }'
+
+    local labels_response
+    labels_response=$(linear_graphql "$query" "{}" 2>/dev/null) || return 1
+
+    local label_id
+    label_id=$(echo "$labels_response" | jq -r --arg name "$label" '.data.labels.nodes[] | select(.name == $name) | .id' 2>/dev/null || true)
+
+    if [[ -z "$label_id" ]]; then
+        return 0
+    fi
+
+    local update_query='mutation($issueId: String!, $labelIds: [String!]) {
+        issueLabelDelete(issueId: $issueId, labelIds: $labelIds) {
+            success
+        }
+    }'
+
+    local vars
+    vars=$(jq -n --arg issueId "$issue_id" --arg labelId "$label_id" \
+        '{issueId: $issueId, labelIds: [$labelId]}')
+
+    linear_graphql "$update_query" "$vars" >/dev/null 2>&1 || return 1
+}
+
+provider_comment() {
+    local issue_id="$1"
+    local body="$2"
+
+    [[ -z "$issue_id" || -z "$body" ]] && return 1
+
+    provider_load_config
+    linear_add_comment "$issue_id" "$body"
+}
+
+provider_close_issue() {
+    local issue_id="$1"
+
+    [[ -z "$issue_id" ]] && return 1
+
+    provider_load_config
+    linear_update_status "$issue_id" "$STATUS_DONE"
+}
+
+provider_create_issue() {
+    local title="$1"
+    local body="$2"
+    local labels="${3:-}"
+
+    [[ -z "$title" ]] && return 1
+
+    provider_load_config
+
+    local query='mutation($title: String!, $description: String, $teamId: String!) {
+        issueCreate(input: {title: $title, description: $description, teamId: $teamId}) {
+            issue {id}
+        }
+    }'
+
+    local vars
+    vars=$(jq -n --arg title "$title" --arg description "$body" --arg teamId "$LINEAR_TEAM_ID" \
+        '{title: $title, description: $description, teamId: $teamId}')
+
+    local response
+    response=$(linear_graphql "$query" "$vars" 2>/dev/null) || {
+        return 1
+    }
+
+    local issue_id
+    issue_id=$(echo "$response" | jq -r '.data.issueCreate.issue.id // empty' 2>/dev/null)
+
+    if [[ -z "$issue_id" ]]; then
+        return 1
+    fi
+
+    # Add labels if provided
+    if [[ -n "$labels" ]]; then
+        local label_list
+        label_list=$(echo "$labels" | tr ',' '\n' | tr ' ' '\n' | grep -v '^$' || true)
+        while IFS= read -r lbl; do
+            [[ -n "$lbl" ]] && provider_add_label "$issue_id" "$lbl" || true
+        done <<< "$label_list"
+    fi
+
+    echo "{\"id\": \"$issue_id\", \"title\": \"$title\"}"
+}
+
 # ─── Find Linear Issue ID from GitHub Issue Body ──────────────────────────
 
 find_linear_id() {