shipwright-cli 1.9.0 → 2.0.0

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() {

package/scripts/sw-tracker.sh

@@ -6,7 +6,7 @@
 set -euo pipefail
 trap 'echo "ERROR: $BASH_SOURCE:$LINENO exited with status $?" >&2' ERR
 
-VERSION="1.9.0"
+VERSION="2.0.0"
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 REPO_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
 
@@ -101,6 +101,14 @@ load_tracker_config() {
                 warn "Jira provider script not found: $SCRIPT_DIR/sw-tracker-jira.sh"
             fi
             ;;
+        github)
+            if [[ -f "$SCRIPT_DIR/sw-tracker-github.sh" ]]; then
+                source "$SCRIPT_DIR/sw-tracker-github.sh"
+                return 0
+            else
+                warn "GitHub provider script not found: $SCRIPT_DIR/sw-tracker-github.sh"
+            fi
+            ;;
         none|"") return 0 ;;
         *)
             warn "Unknown tracker provider: $TRACKER_PROVIDER"
@@ -116,6 +124,98 @@ tracker_available() {
     [[ "$TRACKER_PROVIDER" != "none" && -n "$TRACKER_PROVIDER" ]]
 }
 
+# ─── Internal Dispatcher ──────────────────────────────────────────────────
+# Routes a provider function call to the loaded provider, with fallback to GitHub
+
+_dispatch_provider() {
+    local func="$1"
+    shift
+
+    load_tracker_config
+
+    # Build the function name
+    local provider_func="provider_${func}"
+
+    # Provider scripts define provider_* functions
+    if type "$provider_func" &>/dev/null; then
+        "$provider_func" "$@"
+        return $?
+    else
+        # Fall back to GitHub if provider doesn't define the function
+        # (for backward compatibility with minimal providers like Jira/Linear notify-only)
+        if [[ "$TRACKER_PROVIDER" != "github" && "$TRACKER_PROVIDER" != "none" ]]; then
+            # Try GitHub provider
+            if [[ -f "$SCRIPT_DIR/sw-tracker-github.sh" ]]; then
+                source "$SCRIPT_DIR/sw-tracker-github.sh"
+                if type "$provider_func" &>/dev/null; then
+                    "$provider_func" "$@"
+                    return $?
+                fi
+            fi
+        fi
+        return 1
+    fi
+}
+
+# ─── Discovery Interface ────────────────────────────────────────────────────
+# Used by daemon to discover issues from the configured tracker
+
+# Discover issues matching criteria
+# Usage: tracker_discover_issues <label> [state] [limit]
+# Output: JSON array of {id, title, labels[], state}
+tracker_discover_issues() {
+    _dispatch_provider "discover_issues" "$@"
+}
+
+# Fetch single issue details
+# Usage: tracker_get_issue <issue_id>
+# Output: JSON {id, title, body, labels[], state}
+tracker_get_issue() {
+    _dispatch_provider "get_issue" "$@"
+}
+
+# Fetch issue body text only
+# Usage: tracker_get_issue_body <issue_id>
+# Output: plain text body
+tracker_get_issue_body() {
+    _dispatch_provider "get_issue_body" "$@"
+}
+
+# ─── CRUD Interface ───────────────────────────────────────────────────────
+# Used by pipeline to modify issues
+
+# Add label to issue
+# Usage: tracker_add_label <issue_id> <label>
+tracker_add_label() {
+    _dispatch_provider "add_label" "$@"
+}
+
+# Remove label from issue
+# Usage: tracker_remove_label <issue_id> <label>
+tracker_remove_label() {
+    _dispatch_provider "remove_label" "$@"
+}
+
+# Add comment to issue
+# Usage: tracker_comment <issue_id> <body>
+tracker_comment() {
+    _dispatch_provider "comment" "$@"
+}
+
+# Close/resolve issue
+# Usage: tracker_close_issue <issue_id>
+tracker_close_issue() {
+    _dispatch_provider "close_issue" "$@"
+}
+
+# Create new issue
+# Usage: tracker_create_issue <title> <body> [labels]
+# Output: JSON {id, title}
+tracker_create_issue() {
+    _dispatch_provider "create_issue" "$@"
+}
+
+# ─── Notification Interface (Legacy) ───────────────────────────────────────
 # Route notification to the active provider
 # Usage: tracker_notify <event> <gh_issue> [detail]
 # Events: spawn, started, stage_complete, stage_failed, review, pr-created, completed, done, failed
@@ -361,9 +461,24 @@ show_help() {
     echo -e "  ${CYAN}help${RESET}                          Show this help"
     echo ""
     echo -e "${BOLD}PROVIDERS${RESET}"
+    echo -e "  ${CYAN}github${RESET}     GitHub (native, gh CLI)"
     echo -e "  ${CYAN}linear${RESET}     Linear.app (GraphQL API)"
     echo -e "  ${CYAN}jira${RESET}       Atlassian Jira (REST API v3)"
     echo ""
+    echo -e "${BOLD}DISCOVERY INTERFACE${RESET} (for daemon)"
+    echo -e "  Provider-agnostic issue discovery and metadata:"
+    echo -e "  ${CYAN}tracker_discover_issues${RESET} <label> [state] [limit]"
+    echo -e "  ${CYAN}tracker_get_issue${RESET} <issue_id>"
+    echo -e "  ${CYAN}tracker_get_issue_body${RESET} <issue_id>"
+    echo ""
+    echo -e "${BOLD}CRUD INTERFACE${RESET} (for pipeline)"
+    echo -e "  Provider-agnostic issue modification:"
+    echo -e "  ${CYAN}tracker_add_label${RESET} <issue_id> <label>"
+    echo -e "  ${CYAN}tracker_remove_label${RESET} <issue_id> <label>"
+    echo -e "  ${CYAN}tracker_comment${RESET} <issue_id> <body>"
+    echo -e "  ${CYAN}tracker_close_issue${RESET} <issue_id>"
+    echo -e "  ${CYAN}tracker_create_issue${RESET} <title> <body> [labels]"
+    echo ""
     echo -e "${BOLD}NOTIFICATION EVENTS${RESET}"
     echo -e "  ${CYAN}spawn${RESET}           Pipeline started"
     echo -e "  ${CYAN}stage_complete${RESET}  Stage finished (detail: stage_id|duration|description)"
@@ -374,7 +489,7 @@ show_help() {
     echo ""
     echo -e "${BOLD}CONFIGURATION${RESET}"
     echo -e "  Config file:  ${DIM}~/.shipwright/tracker-config.json${RESET}"
-    echo -e "  Env override: ${DIM}TRACKER_PROVIDER_OVERRIDE=linear|jira|none${RESET}"
+    echo -e "  Env override: ${DIM}TRACKER_PROVIDER_OVERRIDE=github|linear|jira|none${RESET}"
     echo -e "  Daemon block: ${DIM}.claude/daemon-config.json → .tracker.provider${RESET}"
     echo ""
     echo -e "${BOLD}EXAMPLES${RESET}"