/github-status

description: Check GitHub sync status for SpecWeave increment. Shows issue number, sync state, progress, last update, and any sync issues. Useful for troubleshooting and monitoring.

Check GitHub Sync Status

Display the current GitHub sync status for a SpecWeave increment.

Usage

sw:github:status [increment-id] [options]

Arguments

• `increment-id`: Increment ID (optional, defaults to current increment)

Options

• `--all`: Show status for all increments
• `--verbose`: Show detailed sync information
• `--json`: Output in JSON format
• `--check-health`: Run health check on sync connection

Examples

# Check current increment
sw:github:status

# Check specific increment
sw:github:status 0004

# Check all increments
sw:github:status --all

# Verbose output with full details
sw:github:status 0004 --verbose

# JSON output for scripting
sw:github:status 0004 --json

# Health check
sw:github:status --check-health

Output Format

Basic Status

📊 GitHub Sync Status: Increment 0004

Increment: 0004-plugin-architecture
Status: In Progress
Priority: P1

GitHub Issue: #130
URL: https://github.com/owner/repo/issues/130
State: Open
Labels: specweave, increment, P1, in-progress

Sync Status: ✅ Up-to-date
Last Synced: 5 minutes ago (2025-10-30 16:55:00)
Sync Count: 7
Auto-Sync: Enabled (every-task)

Progress:
- Tasks: 7/48 completed (15%)
- Week: 1 of 4 (Foundation)
- Current Task: T-008 - Implement Cursor compiler

GitHub vs Local:
✅ Progress matches
✅ Labels match
✅ Status matches
✅ No conflicts detected

Verbose Status

📊 GitHub Sync Status: Increment 0004 (Detailed)

═══════════════════════════════════════════
BASIC INFO
═══════════════════════════════════════════

Increment ID: 0004
Full Name: 0004-plugin-architecture
Title: Plugin Architecture
Status: in_progress
Priority: P1
Created: 2025-10-01 10:00:00
Duration: 29 days

═══════════════════════════════════════════
GITHUB ISSUE
═══════════════════════════════════════════

Issue Number: #130
Issue URL: https://github.com/owner/repo/issues/130
Issue State: open
Issue Created: 2025-10-01 10:15:00
Issue Updated: 2025-10-30 16:55:00

Labels:
- specweave
- increment
- P1
- in-progress

Milestone: v0.4.0 (due: 2025-11-30)
Assignees: @developer1, @developer2

Comments: 12
- 7 auto-sync comments
- 5 manual comments

Last Comment:
  By: @developer2
  At: 2025-10-30 16:00:00
  Text: "Cursor adapter completed, moving to testing..."

═══════════════════════════════════════════
SYNC STATUS
═══════════════════════════════════════════

Sync State: ✅ Up-to-date
Last Synced: 5 minutes ago (2025-10-30 16:55:00)
Sync Method: Auto (post-task hook)
Sync Count: 7
Failed Syncs: 0

Auto-Sync Settings:
- Enabled: Yes
- Frequency: every-task
- Post Comments: Yes
- Update Checklist: Yes
- Update Labels: Yes
- Include Files: Yes
- Include Time: Yes

═══════════════════════════════════════════
PROGRESS
═══════════════════════════════════════════

Tasks: 7/48 completed (15%)

Week 1: Foundation (7/12 tasks, 58%)
  ✅ T-001: Plugin types
  ✅ T-002: Manifest schema
  ✅ T-003: PluginLoader
  ✅ T-004: PluginManager
  ✅ T-005: PluginDetector
  ✅ T-006: Adapter interface
  ✅ T-007: Claude installer
  ⏳ T-008: Cursor compiler (in progress)
  ⏸️ T-009: Copilot compiler
  ⏸️ T-010: Generic compiler
  ⏸️ T-011: Config schema
  ⏸️ T-012: Update .gitignore

Week 2: GitHub Plugin (0/10 tasks, 0%)
Week 3: Additional Plugins (0/15 tasks, 0%)
Week 4: Documentation (0/11 tasks, 0%)

Current Task: T-008
Estimated: 6 hours
Started: 2025-10-30 15:00:00
Duration: 2 hours (33% of estimate)

═══════════════════════════════════════════
COMPARISON (GitHub vs Local)
═══════════════════════════════════════════

✅ Progress: 7/48 (both sides match)
✅ Labels: All 4 labels match
✅ Status: in_progress (both sides)
✅ Comments: All synced (no missing)

No conflicts detected.
Last comparison: Just now

═══════════════════════════════════════════
METADATA
═══════════════════════════════════════════

Metadata File: .specweave/increments/0004/.metadata.yaml
GitHub Section:
  issue_number: 130
  issue_url: https://github.com/owner/repo/issues/130
  created_at: 2025-10-01T10:15:00Z
  last_synced_at: 2025-10-30T16:55:00Z
  sync_count: 7
  closing_comment_ids: []

Repository: owner/repo
Remote URL: https://github.com/owner/repo.git
Branch: features/0004-plugin-architecture

═══════════════════════════════════════════
HEALTH
═══════════════════════════════════════════

✅ GitHub CLI: Authenticated
✅ Repository Access: Write
✅ Issue Exists: Yes
✅ Network: Connected
✅ Rate Limit: 4,823 / 5,000 remaining
✅ Sync Hook: Installed and working

All systems operational.

Status for All Increments

📊 GitHub Sync Status: All Increments

┌──────┬────────────────┬────────┬────────┬──────────┬─────────────┐
│ ID   │ Title          │ Issue  │ State  │ Progress │ Last Synced │
├──────┼────────────────┼────────┼────────┼──────────┼─────────────┤
│ 0001 │ Core Framework │ #100   │ Closed │ 100%     │ 30 days ago │
│ 0002 │ Enhancements   │ #110   │ Closed │ 100%     │ 15 days ago │
│ 0003 │ Model Select   │ #120   │ Closed │ 100%     │ 5 days ago  │
│ 0004 │ Plugins        │ #130   │ Open   │ 15%      │ 5 mins ago  │
│ 0005 │ Auth           │ #135   │ Open   │ 0%       │ Never       │
└──────┴────────────────┴────────┴────────┴──────────┴─────────────┘

Summary:
- Total Increments: 5
- Synced: 4
- Not Synced: 1 (0005)
- Open Issues: 2
- Closed Issues: 2

Issues:
⚠️  Increment 0005: Not synced to GitHub (run sw:github:create-issue 0005)

JSON Output

{
  "increment": {
    "id": "0004",
    "name": "0004-plugin-architecture",
    "title": "Plugin Architecture",
    "status": "in_progress",
    "priority": "P1",
    "created_at": "2025-10-01T10:00:00Z",
    "duration_days": 29
  },
  "github": {
    "issue_number": 130,
    "issue_url": "https://github.com/owner/repo/issues/130",
    "state": "open",
    "labels": ["specweave", "increment",