github_issues_script.sh

#!/bin/bash

# Script to create GitHub issues for Synapse project
# Requires: GitHub CLI (gh) to be installed and authenticated
# Usage: ./create-github-issues.sh [owner/repo]

set -e

# Check if gh CLI is installed
if ! command -v gh &> /dev/null; then
    echo "Error: GitHub CLI (gh) is not installed."
    echo "Install it from: https://cli.github.com/"
    exit 1
fi

# Check if user is authenticated
if ! gh auth status &> /dev/null; then
    echo "Error: Not authenticated with GitHub CLI."
    echo "Run: gh auth login"
    exit 1
fi

# Get repository (use current directory's repo or from argument)
if [ -n "$1" ]; then
    REPO="$1"
else
    REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null || echo "")
    if [ -z "$REPO" ]; then
        echo "Error: Not in a git repository or repository not specified."
        echo "Usage: ./create-github-issues.sh [owner/repo]"
        exit 1
    fi
fi

echo "Creating issues for repository: $REPO"
echo "----------------------------------------"

# Function to create issue and add labels separately
create_issue_with_labels() {
    local title="$1"
    local milestone="$2"
    local body="$3"
    local labels="$4"
    
    # Create issue without labels first
    issue_url=$(gh issue create --repo "$REPO" \
        --title "$title" \
        --milestone "$milestone" \
        --body "$body" 2>&1)
    
    if [ $? -eq 0 ]; then
        # Extract issue number from URL
        issue_number=$(echo "$issue_url" | grep -oE '[0-9]+$')
        
        # Add labels separately
        if [ -n "$labels" ]; then
            IFS=',' read -ra label_array <<< "$labels"
            for label in "${label_array[@]}"; do
                gh issue edit "$issue_number" --add-label "$label" --repo "$REPO" 2>/dev/null || echo "  ⚠ Could not add label: $label"
            done
        fi
        
        echo "✓ Issue #$issue_number created: $title"
        return 0
    else
        echo "✗ Failed to create issue: $title"
        echo "  Error: $issue_url"
        return 1
    fi
}

# Create labels first
echo "Creating labels..."

declare -A LABELS=(
    ["setup"]="0052CC"
    ["feature"]="1D76DB"
    ["enhancement"]="84B6EB"
    ["documentation"]="0075CA"
    ["testing"]="FBCA04"
    ["ui"]="D4C5F9"
    ["security"]="EE0701"
    ["accessibility"]="5319E7"
    ["a11y"]="5319E7"
    ["performance"]="BFDADC"
    ["chrome-ai"]="006B75"
    ["ux"]="C5DEF5"
    ["design"]="FEF2C0"
    ["privacy"]="B60205"
    ["compatibility"]="C2E0C6"
    ["release"]="0E8A16"
    ["priority: critical"]="D93F0B"
    ["priority: high"]="E99695"
    ["priority: medium"]="FBCA04"
    ["priority: low"]="0E8A16"
    ["complexity: low"]="BFD4F2"
    ["complexity: medium"]="5319E7"
    ["complexity: high"]="D93F0B"
    ["req-001"]="FEF2C0"
    ["req-002"]="FEF2C0"
    ["req-003"]="FEF2C0"
    ["req-004"]="FEF2C0"
    ["req-005"]="FEF2C0"
    ["req-006"]="FEF2C0"
    ["req-007"]="FEF2C0"
    ["deadline: oct-31"]="D93F0B"
)

for label in "${!LABELS[@]}"; do
    color="${LABELS[$label]}"
    gh label create "$label" --color "$color" --repo "$REPO" 2>/dev/null || true
done

echo "Labels created/verified!"
echo ""

# Create milestones
echo "Creating milestones..."

gh api repos/$REPO/milestones -f title="Milestone 1: Foundation (Week 1)" -f description="Setup and infrastructure" -f state="open" 2>/dev/null || true
gh api repos/$REPO/milestones -f title="Milestone 2: Core Features (Week 2)" -f description="Essential content processing features" -f state="open" 2>/dev/null || true
gh api repos/$REPO/milestones -f title="Milestone 3: Advanced Features (Week 3)" -f description="Image processing and writing tools" -f state="open" 2>/dev/null || true
gh api repos/$REPO/milestones -f title="Milestone 4: Polish & Testing (Week 3-4)" -f description="Optimization, testing, and refinement" -f state="open" 2>/dev/null || true
gh api repos/$REPO/milestones -f title="Milestone 5: Launch (Week 4)" -f description="Documentation and hackathon submission" -f state="open" 2>/dev/null || true

echo "Milestones created/verified!"
echo ""
echo "Creating issues..."
echo "----------------------------------------"

# Issue #1
create_issue_with_labels \
  "Project Setup and Foundation" \
  "Milestone 1: Foundation (Week 1)" \
  "Initialize the project with core dependencies and structure.

## Tasks
- [ ] Set up React/Vite project structure
- [ ] Configure Tailwind CSS
- [ ] Set up Chrome AI APIs origin trial token
- [ ] Create component folder structure
- [ ] Initialize local storage utilities
- [ ] Set up error handling framework

## Acceptance Criteria
- Development environment runs locally
- Chrome AI APIs are accessible in dev mode
- Basic routing and layout structure in place" \
  "setup,priority: critical"

# Issue #2
create_issue_with_labels \
  "Chrome AI APIs Integration Setup" \
  "Milestone 1: Foundation (Week 1)" \
  "Implement core utilities for Chrome's Built-in AI APIs with proper error handling.

## Tasks
- [ ] Create Chrome Rewriter API wrapper
- [ ] Create Chrome Prompt API wrapper
- [ ] Create Chrome Translation API wrapper
- [ ] Implement API availability detection
- [ ] Add graceful fallback messaging for unsupported browsers
- [ ] Add loading states and progress indicators

## Acceptance Criteria
- All three APIs have utility wrappers
- Browser compatibility is checked on load
- Clear error messages for unavailable APIs" \
  "setup,priority: high,chrome-ai"

# Issue #3
create_issue_with_labels \
  "Text Input Component" \
  "Milestone 2: Core Features (Week 2)" \
  "Create the main text input interface with paste and direct text entry support.

## Tasks
- [ ] Build textarea component with character count
- [ ] Add clear/reset functionality
- [ ] Implement basic validation
- [ ] Add example content button
- [ ] Show processing status indicators

## Acceptance Criteria
- Users can paste or type text
- Character count displayed (max 10,000 words)
- Processing starts within 2 seconds of submission" \
  "feature,priority: high,req-001"

# Issue #4
create_issue_with_labels \
  "URL Content Extraction" \
  "Milestone 2: Core Features (Week 2)" \
  "Implement URL fetching and content extraction using Readability.

## Tasks
- [ ] Add URL input field with validation
- [ ] Integrate Readability.js or similar library
- [ ] Extract main content from web pages
- [ ] Handle CORS and fetch errors
- [ ] Strip ads and navigation elements
- [ ] Preserve important images for processing

## Acceptance Criteria
- Valid URLs fetch page content
- Main article text is cleanly extracted
- Images are captured for optional processing
- Error handling for failed fetches" \
  "feature,priority: high,req-001,complexity: medium"

# Issue #5
create_issue_with_labels \
  "File Upload and Parsing" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Support file uploads for TXT, PDF, and DOCX formats with text extraction.

## Tasks
- [ ] Create file upload dropzone component
- [ ] Integrate PDF.js for PDF parsing
- [ ] Integrate Mammoth.js for DOCX parsing
- [ ] Handle TXT file reading
- [ ] Add file size validation (reasonable limits)
- [ ] Show extraction progress
- [ ] Handle parsing errors gracefully

## Acceptance Criteria
- All three file types parse correctly
- Text extraction completes within 5 seconds
- Large files show progress indicators
- Clear error messages for corrupt files" \
  "feature,priority: high,req-001,complexity: high"

# Issue #6
create_issue_with_labels \
  "Reading Level Selector Component" \
  "Milestone 2: Core Features (Week 2)" \
  "Create UI for selecting target reading levels.

## Tasks
- [ ] Build reading level selector (4 levels)
- [ ] Add descriptions for each level
- [ ] Implement level presets
- [ ] Add side-by-side comparison toggle
- [ ] Show current vs target level indicators

## Acceptance Criteria
- All 4 reading levels available (Elementary, Middle School, High School, Adult)
- Clear descriptions help users choose
- Visual indicators show selected level" \
  "feature,priority: high,req-002"

# Issue #7
create_issue_with_labels \
  "Chrome Rewriter API Integration" \
  "Milestone 2: Core Features (Week 2)" \
  "Implement text simplification using Chrome's Rewriter API.

## Tasks
- [ ] Create simplification prompts for each reading level
- [ ] Implement context-aware rewriting
- [ ] Preserve technical terminology with explanations
- [ ] Handle long-form content (chunking if needed)
- [ ] Add retry logic for API failures
- [ ] Implement progressive simplification options

## Acceptance Criteria
- Content is simplified to target reading level
- Meaning and accuracy preserved
- Technical terms explained in context
- Processing completes within 5 seconds" \
  "feature,priority: critical,req-002,complexity: high,chrome-ai"

# Issue #8
create_issue_with_labels \
  "Side-by-Side Comparison View" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Show original and simplified content in comparison view.

## Tasks
- [ ] Create split-pane layout
- [ ] Add scroll synchronization
- [ ] Highlight changed sections
- [ ] Add toggle between split and single view
- [ ] Make responsive for mobile

## Acceptance Criteria
- Original and simplified text viewable side-by-side
- Scrolling syncs between panes
- Works on mobile (stacked view)" \
  "feature,priority: medium,req-002"

# Issue #9
create_issue_with_labels \
  "Language Selector Component" \
  "Milestone 2: Core Features (Week 2)" \
  "Create language selection interface with 20+ supported languages.

## Tasks
- [ ] Build language dropdown with search
- [ ] Add auto-detect option for source language
- [ ] Implement bidirectional translation toggle
- [ ] Add favorite languages feature
- [ ] Show translation status indicators

## Acceptance Criteria
- 20+ languages supported
- Auto-detect works reliably
- UI clearly shows source → target direction" \
  "feature,priority: high,req-003"

# Issue #10
create_issue_with_labels \
  "Chrome Translation API Integration" \
  "Milestone 2: Core Features (Week 2)" \
  "Implement translation using Chrome's Translation API while preserving reading level.

## Tasks
- [ ] Integrate Chrome Translation API
- [ ] Maintain reading level post-translation
- [ ] Handle idioms and cultural context
- [ ] Add language detection
- [ ] Implement chunked translation for long content
- [ ] Handle unsupported language pairs gracefully

## Acceptance Criteria
- Accurate translation to target language
- Reading level maintained after translation
- Idioms handled with context notes
- Processing completes within 10 seconds" \
  "feature,priority: high,req-003,complexity: medium,chrome-ai"

# Issue #11
create_issue_with_labels \
  "Format Options Component" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Create UI for selecting content restructuring formats.

## Tasks
- [ ] Build format selector (bullet points, paragraphs, steps, Q&A, summary)
- [ ] Add format preview examples
- [ ] Implement format combinations
- [ ] Create format presets for common use cases

## Acceptance Criteria
- All 5 format options available
- Multiple formats can be combined
- Clear previews help users choose" \
  "feature,priority: high,req-004"

# Issue #12
create_issue_with_labels \
  "Content Restructuring Engine" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Implement content restructuring using Chrome Rewriter/Prompt API.

## Tasks
- [ ] Break long paragraphs into sections
- [ ] Generate headings and structure
- [ ] Extract and highlight key points
- [ ] Create bullet point summaries
- [ ] Generate Q&A format
- [ ] Add numbered step formatting
- [ ] Improve scannability with formatting

## Acceptance Criteria
- Long content broken into digestible chunks
- Structure improves readability
- Key points are highlighted
- Format matches user selection" \
  "feature,priority: high,req-004,complexity: medium,chrome-ai"

# Issue #13
create_issue_with_labels \
  "Image Upload and Preview" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Create image upload interface with preview.

## Tasks
- [ ] Build image upload component
- [ ] Support PNG, JPG, GIF, WEBP
- [ ] Add drag-and-drop support
- [ ] Show image preview
- [ ] Add image from URL option
- [ ] Validate file size and format

## Acceptance Criteria
- Common image formats supported
- Preview shows before processing
- File size limits enforced" \
  "feature,priority: medium,req-005"

# Issue #14
create_issue_with_labels \
  "Chrome Prompt API (Multimodal) Integration" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Implement image analysis using Chrome's multimodal Prompt API.

## Tasks
- [ ] Integrate Chrome Prompt API for images
- [ ] Generate alt-text descriptions
- [ ] Extract text from screenshots
- [ ] Explain charts and diagrams
- [ ] Match description to user's reading level
- [ ] Handle multiple images in sequence

## Acceptance Criteria
- Alt-text generated for all images
- Text extracted from screenshots
- Charts/diagrams explained clearly
- Processing completes within 10 seconds
- Descriptions match selected reading level" \
  "feature,priority: medium,req-005,complexity: high,chrome-ai"

# Issue #15
create_issue_with_labels \
  "Writing Tools Component" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Create interface for writing assistance tools.

## Tasks
- [ ] Build proofreading tool UI
- [ ] Add tone adjustment selector (4 tones)
- [ ] Create summarization interface
- [ ] Add expand/elaborate option
- [ ] Show before/after preview

## Acceptance Criteria
- All writing tools accessible
- Clear descriptions of each tool
- Preview shows expected results" \
  "feature,priority: medium,req-006"

# Issue #16
create_issue_with_labels \
  "Writing Enhancement Engine" \
  "Milestone 3: Advanced Features (Week 3)" \
  "Implement writing assistance using Chrome AI APIs.

## Tasks
- [ ] Grammar and spelling correction
- [ ] Tone adjustment (professional, casual, academic, simple)
- [ ] Key point extraction for summaries
- [ ] Text expansion/elaboration
- [ ] Provide actionable suggestions

## Acceptance Criteria
- Errors corrected accurately
- Tone adjustments preserve meaning
- Summaries capture key points
- Suggestions are actionable" \
  "feature,priority: medium,req-006,complexity: low,chrome-ai"

# Issue #17
create_issue_with_labels \
  "User Preferences System" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Implement local storage for user preferences and settings.

## Tasks
- [ ] Create settings modal/page
- [ ] Save reading level defaults
- [ ] Save language preferences
- [ ] Save format preferences
- [ ] Persist theme preferences
- [ ] Add reset to defaults option

## Acceptance Criteria
- Preferences persist across sessions
- Saved preferences auto-apply
- Settings easily accessible
- Reset option available" \
  "feature,priority: medium,req-007,complexity: low"

# Issue #18
create_issue_with_labels \
  "Processing History Feature" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Track and display recent transformations (local only).

## Tasks
- [ ] Create history storage in localStorage
- [ ] Build history view component
- [ ] Add search/filter in history
- [ ] Implement favorites/bookmarks
- [ ] Add export history option
- [ ] Clear history functionality
- [ ] Limit history size (e.g., last 50)

## Acceptance Criteria
- Recent transformations viewable
- Favorites quickly accessible
- History is searchable
- Storage limits enforced" \
  "feature,priority: low,req-007"

# Issue #19
create_issue_with_labels \
  "Performance Optimization" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Ensure app meets performance requirements.

## Tasks
- [ ] Implement text chunking for large content
- [ ] Add request debouncing
- [ ] Optimize component re-renders
- [ ] Lazy load heavy components
- [ ] Add service worker for caching
- [ ] Monitor and optimize bundle size
- [ ] Test with 10,000-word articles

## Acceptance Criteria
- Text processing < 5 seconds
- Image analysis < 10 seconds
- UI remains responsive during processing
- Supports 10,000-word articles" \
  "enhancement,priority: high,performance"

# Issue #20
create_issue_with_labels \
  "Privacy Implementation" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Ensure complete client-side processing and privacy compliance.

## Tasks
- [ ] Verify no external API calls
- [ ] Implement clear data policy
- [ ] Add privacy notice to UI
- [ ] Ensure localStorage is only storage
- [ ] Remove any tracking/analytics
- [ ] Add data export/clear functionality

## Acceptance Criteria
- All processing happens client-side
- No data sent to servers
- Privacy policy clearly stated
- Users can clear all data" \
  "security,priority: high,privacy"

# Issue #21
create_issue_with_labels \
  "Accessibility Compliance" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Ensure WCAG 2.1 AA compliance.

## Tasks
- [ ] Implement keyboard navigation
- [ ] Add ARIA labels and roles
- [ ] Test with screen readers
- [ ] Add high contrast mode
- [ ] Ensure color contrast ratios
- [ ] Add focus indicators
- [ ] Test with accessibility tools (axe, Lighthouse)

## Acceptance Criteria
- WCAG 2.1 AA compliant
- Keyboard navigation works throughout
- Screen reader compatible
- High contrast mode available" \
  "accessibility,priority: high,a11y"

# Issue #22
create_issue_with_labels \
  "Browser Detection and Messaging" \
  "Milestone 1: Foundation (Week 1)" \
  "Implement browser compatibility checks and messaging.

## Tasks
- [ ] Detect Chrome version on load
- [ ] Check Chrome AI API availability
- [ ] Show clear requirements message
- [ ] Provide setup instructions for origin trial
- [ ] Add progressive enhancement fallbacks
- [ ] Create 'unsupported browser' page

## Acceptance Criteria
- Chrome 119+ detected correctly
- Clear messaging for unsupported browsers
- Setup instructions provided
- Graceful degradation implemented" \
  "feature,priority: high,compatibility"

# Issue #23
create_issue_with_labels \
  "Main UI Layout and Navigation" \
  "Milestone 2: Core Features (Week 2)" \
  "Create intuitive main interface with clear navigation.

## Tasks
- [ ] Design and implement main layout
- [ ] Create responsive navigation
- [ ] Build workflow wizard/steps
- [ ] Add tooltips and help text
- [ ] Implement mobile-responsive design
- [ ] Add dark/light theme toggle
- [ ] Create loading and empty states

## Acceptance Criteria
- 3-click maximum to transform content
- Intuitive without training
- Mobile responsive
- Clear visual hierarchy" \
  "ui,priority: high,design"

# Issue #24
create_issue_with_labels \
  "Error Handling and User Feedback" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Implement comprehensive error handling and user feedback.

## Tasks
- [ ] Create error boundary components
- [ ] Add toast notifications
- [ ] Implement clear error messages
- [ ] Add retry mechanisms
- [ ] Show processing progress
- [ ] Add success confirmations
- [ ] Create help documentation

## Acceptance Criteria
- Clear error messages
- Easy error recovery
- Progress indicators for all operations
- Help available when needed" \
  "feature,priority: medium,ux"

# Issue #25
create_issue_with_labels \
  "User Documentation" \
  "Milestone 5: Launch (Week 4)" \
  "Create comprehensive user documentation.

## Tasks
- [ ] Write user guide
- [ ] Create feature tutorials
- [ ] Add inline help/tooltips
- [ ] Create video demo
- [ ] Write FAQ section
- [ ] Document Chrome AI setup process

## Acceptance Criteria
- Complete user guide available
- Video demo created for hackathon
- FAQ covers common questions" \
  "documentation,priority: medium"

# Issue #26
create_issue_with_labels \
  "Developer Documentation" \
  "Milestone 5: Launch (Week 4)" \
  "Create technical documentation for developers.

## Tasks
- [ ] Write comprehensive README
- [ ] Document API usage
- [ ] Create architecture diagram
- [ ] Add code comments
- [ ] Write contributing guide
- [ ] Document Chrome AI API integration
- [ ] Add setup instructions

## Acceptance Criteria
- README complete with setup instructions
- Code is well-commented
- Architecture documented
- Contributing guide available" \
  "documentation,priority: medium"

# Issue #27
create_issue_with_labels \
  "Testing Infrastructure" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Set up testing framework and write tests.

## Tasks
- [ ] Set up Vitest/Jest
- [ ] Write unit tests for utilities
- [ ] Write component tests
- [ ] Test Chrome AI API integration
- [ ] Add E2E tests for critical flows
- [ ] Test with various content types
- [ ] Test error scenarios

## Acceptance Criteria
- >70% code coverage
- Critical flows tested
- All API integrations tested" \
  "testing,priority: medium"

# Issue #28
create_issue_with_labels \
  "User Acceptance Testing" \
  "Milestone 4: Polish & Testing (Week 3-4)" \
  "Conduct user testing and gather feedback.

## Tasks
- [ ] Test with target user groups (ESL, neurodivergent)
- [ ] Measure success metrics
- [ ] Gather usability feedback
- [ ] Test reading comprehension improvement
- [ ] Validate transformation quality
- [ ] Test on different devices

## Acceptance Criteria
- 95% successful transformation rate
- 90% user satisfaction score
- Feedback incorporated" \
  "testing,priority: high"

# Issue #29
create_issue_with_labels \
  "Hackathon Submission Package" \
  "Milestone 5: Launch (Week 4)" \
  "Prepare complete hackathon submission.

## Tasks
- [ ] Create demo video
- [ ] Write project description
- [ ] Document Chrome AI APIs used (target: 6+)
- [ ] Showcase multimodal features
- [ ] Prepare presentation slides
- [ ] Test complete user flow
- [ ] Gather screenshots

## Acceptance Criteria
- Demo video complete
- All required documentation ready
- 6+ Chrome AI APIs demonstrated
- Multimodal features showcased" \
  "documentation,priority: critical,deadline: oct-31"

# Issue #30
create_issue_with_labels \
  "Open Source Release" \
  "Milestone 5: Launch (Week 4)" \
  "Prepare project for open source release.

## Tasks
- [ ] Add MIT license
- [ ] Clean up code
- [ ] Remove sensitive data
- [ ] Create CHANGELOG
- [ ] Set up GitHub Pages deployment
- [ ] Add badges to README
- [ ] Create GitHub release

## Acceptance Criteria
- MIT license added
- Code is clean and documented
- Deployed and accessible
- Release published on GitHub" \
  "release,priority: high"

echo ""
echo "=========================================="
echo "✅ Successfully created all 30 issues!"
echo "=========================================="
echo ""
echo "View your issues at: https://github.com/$REPO/issues"
echo ""
echo "Next steps:"
echo "1. Review issues and verify labels applied correctly"
echo "2. Set milestone due dates in GitHub UI"
echo "3. Assign issues to team members"
echo "4. Start working on Milestone 1 issues"
echo ""