centralize guides and rails under mosaic with runtime compatibility links

rails/git/issue-list.sh

@@ -0,0 +1,96 @@
+#!/bin/bash
+# issue-list.sh - List issues on Gitea or GitHub
+# Usage: issue-list.sh [-s state] [-l label] [-m milestone] [-a assignee]
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/detect-platform.sh"
+
+# Default values
+STATE="open"
+LABEL=""
+MILESTONE=""
+ASSIGNEE=""
+LIMIT=100
+
+usage() {
+    cat <<EOF
+Usage: $(basename "$0") [OPTIONS]
+
+List issues from the current repository (Gitea or GitHub).
+
+Options:
+    -s, --state STATE       Filter by state: open, closed, all (default: open)
+    -l, --label LABEL       Filter by label
+    -m, --milestone NAME    Filter by milestone name
+    -a, --assignee USER     Filter by assignee
+    -n, --limit N           Maximum issues to show (default: 100)
+    -h, --help              Show this help message
+
+Examples:
+    $(basename "$0")                          # List open issues
+    $(basename "$0") -s all -l bug            # All issues with 'bug' label
+    $(basename "$0") -m "0.2.0"               # Issues in milestone 0.2.0
+EOF
+    exit 1
+}
+
+# Parse arguments
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -s|--state)
+            STATE="$2"
+            shift 2
+            ;;
+        -l|--label)
+            LABEL="$2"
+            shift 2
+            ;;
+        -m|--milestone)
+            MILESTONE="$2"
+            shift 2
+            ;;
+        -a|--assignee)
+            ASSIGNEE="$2"
+            shift 2
+            ;;
+        -n|--limit)
+            LIMIT="$2"
+            shift 2
+            ;;
+        -h|--help)
+            usage
+            ;;
+        *)
+            echo "Unknown option: $1" >&2
+            usage
+            ;;
+    esac
+done
+
+PLATFORM=$(detect_platform)
+
+case "$PLATFORM" in
+    github)
+        CMD="gh issue list --state $STATE --limit $LIMIT"
+        [[ -n "$LABEL" ]] && CMD="$CMD --label \"$LABEL\""
+        [[ -n "$MILESTONE" ]] && CMD="$CMD --milestone \"$MILESTONE\""
+        [[ -n "$ASSIGNEE" ]] && CMD="$CMD --assignee \"$ASSIGNEE\""
+        eval "$CMD"
+        ;;
+    gitea)
+        CMD="tea issues list --state $STATE --limit $LIMIT"
+        [[ -n "$LABEL" ]] && CMD="$CMD --labels \"$LABEL\""
+        [[ -n "$MILESTONE" ]] && CMD="$CMD --milestones \"$MILESTONE\""
+        # Note: tea may not support assignee filter directly
+        eval "$CMD"
+        if [[ -n "$ASSIGNEE" ]]; then
+            echo "Note: Assignee filtering may require manual review for Gitea" >&2
+        fi
+        ;;
+    *)
+        echo "Error: Could not detect git platform" >&2
+        exit 1
+        ;;
+esac