feat: GitHub Command Center MVP (v0.1.0.0)

.env.example

@@ -0,0 +1,5 @@
+# EnvironmentTokenBootstrapper reads either GITHUB_TOKEN or GH_TOKEN.
+# They are equivalent for local token bootstrapping, so set only one.
+GITHUB_TOKEN=ghp_your_token_here
+# Optional alias if you prefer GH_TOKEN instead of GITHUB_TOKEN:
+# GH_TOKEN=ghp_your_token_here

.github/workflows/ci.yml

@@ -0,0 +1,69 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, ready_for_review]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  check:
+    name: fix-and-check
+    runs-on: macos-15
+    if: github.event_name != 'pull_request' || github.event.pull_request.draft == false
+    env:
+      XCODE_VERSION: "26.3"
+    steps:
+      - uses: actions/checkout@v4
+
+      # Keep CI on the Xcode 26.3 toolchain expected by the project.
+      - name: Select Xcode
+        uses: maxim-lobanov/setup-xcode@v1.7.0
+        with:
+          xcode-version: ${{ env.XCODE_VERSION }}
+
+      - name: Setup mise
+        uses: jdx/mise-action@v4.0.1
+        with:
+          install: true
+
+      - name: Cache SwiftPM and DerivedData
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cache/org.swift.swiftpm
+            ~/Library/Caches/org.swift.swiftpm
+            ~/Library/Developer/Xcode/DerivedData
+            build/DerivedData
+            .build
+          key: ${{ runner.os }}-xcode-${{ env.XCODE_VERSION }}-${{ hashFiles('project.yml', 'Package.resolved') }}
+          restore-keys: |
+            ${{ runner.os }}-xcode-${{ env.XCODE_VERSION }}-
+            ${{ runner.os }}-xcode-
+
+      - name: Run auto-fixes
+        run: mise run fix
+
+      - name: Verify auto-fixes produced no changes
+        run: |
+          if [[ -n "$(git status --short --untracked-files=all)" ]]; then
+            git status --short --untracked-files=all
+            exit 1
+          fi
+
+      - name: Run repo checks
+        run: mise run check
+
+      - name: Verify checks produced no changes
+        run: |
+          if [[ -n "$(git status --short --untracked-files=all)" ]]; then
+            git status --short --untracked-files=all
+            exit 1
+          fi

.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    runs-on: macos-15
+    env:
+      APP_NAME: GitHubCommandCenter.app
+      DERIVED_DATA_ROOT: build/DerivedData
+      XCODE_VERSION: "26.3"
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: jdx/mise-action@v4.0.1
+        with:
+          install: true
+
+      # Release builds are produced with the Xcode 26.3 toolchain used in CI.
+      - name: Select Xcode
+        uses: maxim-lobanov/setup-xcode@v1.7.0
+        with:
+          xcode-version: ${{ env.XCODE_VERSION }}
+
+      - name: Build (unsigned)
+        run: mise run build-release
+
+      - name: Create .zip for distribution
+        run: |
+          MATCHES="$(find "$DERIVED_DATA_ROOT" -type d -path "*/Build/Products/Release/$APP_NAME" -print)"
+          MATCH_COUNT="$(printf '%s\n' "$MATCHES" | sed '/^$/d' | wc -l | tr -d ' ')"
+
+          if [ "$MATCH_COUNT" -eq 0 ]; then
+            echo "App bundle not found under $DERIVED_DATA_ROOT"
+            exit 1
+          fi
+
+          if [ "$MATCH_COUNT" -gt 1 ]; then
+            echo "Multiple app bundles found under $DERIVED_DATA_ROOT:"
+            printf '%s\n' "$MATCHES"
+            exit 1
+          fi
+
+          APP_PATH="$(printf '%s\n' "$MATCHES" | head -n 1)"
+          APP_BUNDLE_NAME="$(basename "$APP_PATH")"
+          echo "Found app at: $APP_PATH"
+          cp -R "$APP_PATH" .
+          zip -r "GitHubCommandCenter-${{ github.ref_name }}.zip" "$APP_BUNDLE_NAME"
+          # Print macOS installation/quarantine note to the job log.
+          echo "To install: unzip, move to /Applications, then right-click > Open on first launch (unsigned build)."
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          files: "GitHubCommandCenter-${{ github.ref_name }}.zip"
+          body: |
+            ## GitHub Command Center ${{ github.ref_name }}
+
+            **Install:**
+            1. Download the `.zip` below and unzip it
+            2. Move `GitHubCommandCenter.app` to `/Applications`
+            3. First launch: right-click the app → **Open** (bypasses Gatekeeper for unsigned builds)
+
+            **Requirements:** macOS 14 (Sonoma) or later
+
+            **Setup:** Click the menu bar icon → enter your GitHub Personal Access Token (needs `repo` read scope)
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,26 @@
+# Xcode
+build/
+DerivedData/
+xcuserdata/
+*.xcuserstate
+
+# Swift Package Manager
+.build/
+
+# macOS
+.DS_Store
+*.swp
+*~
+
+# XcodeGen (project is regenerated from project.yml)
+*.xcodeproj/project.pbxproj
+
+# Claude Code
+.claude/settings.local.json
+.mise.local.toml
+.env
+.env.local
+
+# gstack
+.gstack/
+.conductor/

.swift-format

@@ -0,0 +1,75 @@
+{
+  "fileScopedDeclarationPrivacy" : {
+    "accessLevel" : "private"
+  },
+  "indentConditionalCompilationBlocks" : true,
+  "indentSwitchCaseLabels" : false,
+  "indentation" : {
+    "spaces" : 4
+  },
+  "lineBreakAroundMultilineExpressionChainComponents" : false,
+  "lineBreakBeforeControlFlowKeywords" : false,
+  "lineBreakBeforeEachArgument" : true,
+  "lineBreakBeforeEachGenericRequirement" : false,
+  "lineBreakBetweenDeclarationAttributes" : false,
+  "lineLength" : 120,
+  "maximumBlankLines" : 1,
+  "multiElementCollectionTrailingCommas" : true,
+  "noAssignmentInExpressions" : {
+    "allowedFunctions" : [
+      "XCTAssertNoThrow"
+    ]
+  },
+  "prioritizeKeepingFunctionOutputTogether" : false,
+  "reflowMultilineStringLiterals" : "never",
+  "respectsExistingLineBreaks" : true,
+  "rules" : {
+    "AllPublicDeclarationsHaveDocumentation" : false,
+    "AlwaysUseLiteralForEmptyCollectionInit" : false,
+    "AlwaysUseLowerCamelCase" : true,
+    "AmbiguousTrailingClosureOverload" : true,
+    "AvoidRetroactiveConformances" : true,
+    "BeginDocumentationCommentWithOneLineSummary" : false,
+    "DoNotUseSemicolons" : true,
+    "DontRepeatTypeInStaticProperties" : true,
+    "FileScopedDeclarationPrivacy" : true,
+    "FullyIndirectEnum" : true,
+    "GroupNumericLiterals" : true,
+    "IdentifiersMustBeASCII" : true,
+    "NeverForceUnwrap" : false,
+    "NeverUseForceTry" : false,
+    "NeverUseImplicitlyUnwrappedOptionals" : false,
+    "NoAccessLevelOnExtensionDeclaration" : true,
+    "NoAssignmentInExpressions" : true,
+    "NoBlockComments" : true,
+    "NoCasesWithOnlyFallthrough" : true,
+    "NoEmptyLinesOpeningClosingBraces" : false,
+    "NoEmptyTrailingClosureParentheses" : true,
+    "NoLabelsInCasePatterns" : true,
+    "NoLeadingUnderscores" : false,
+    "NoParensAroundConditions" : true,
+    "NoPlaygroundLiterals" : true,
+    "NoVoidReturnOnFunctionSignature" : true,
+    "OmitExplicitReturns" : false,
+    "OneCasePerLine" : true,
+    "OneVariableDeclarationPerLine" : true,
+    "OnlyOneTrailingClosureArgument" : true,
+    "OrderedImports" : true,
+    "ReplaceForEachWithForLoop" : true,
+    "ReturnVoidInsteadOfEmptyTuple" : true,
+    "TypeNamesShouldBeCapitalized" : true,
+    "UseEarlyExits" : false,
+    "UseExplicitNilCheckInConditions" : true,
+    "UseLetInEveryBoundCaseVariable" : true,
+    "UseShorthandTypeNames" : true,
+    "UseSingleLinePropertyGetter" : true,
+    "UseSynthesizedInitializer" : true,
+    "UseTripleSlashForDocumentationComments" : true,
+    "UseWhereClausesInForLoops" : false,
+    "ValidateDocumentationComments" : false
+  },
+  "spacesAroundRangeFormationOperators" : false,
+  "spacesBeforeEndOfLineComments" : 2,
+  "tabWidth" : 8,
+  "version" : 1
+}

.swiftlint.yml

@@ -0,0 +1,69 @@
+included:
+  - GitHubCommandCenter
+  - GitHubCommandCenterTests
+
+excluded:
+  - GitHubCommandCenter.xcodeproj
+  - build
+  - DerivedData
+
+disabled_rules:
+  - closing_brace
+  - colon
+  - comma
+  - control_statement
+  - empty_parentheses_with_trailing_closure
+  - indentation_width
+  - opening_brace
+  - operator_usage_whitespace
+  - return_arrow_whitespace
+  - static_over_final_class
+  - statement_position
+  - trailing_comma
+  - trailing_newline
+  - trailing_semicolon
+  - trailing_whitespace
+  - vertical_parameter_alignment
+  - vertical_parameter_alignment_on_call
+  - vertical_whitespace
+  - vertical_whitespace_between_cases
+
+opt_in_rules:
+  - empty_count
+  - first_where
+  - force_unwrapping
+  - implicitly_unwrapped_optional
+  - modifier_order
+  - toggle_bool
+
+line_length:
+  warning: 120
+  error: 200
+
+file_length:
+  warning: 700
+  error: 1000
+
+function_body_length:
+  warning: 110
+  error: 140
+
+type_body_length:
+  warning: 600
+  error: 700
+
+cyclomatic_complexity:
+  warning: 20
+  error: 30
+
+identifier_name:
+  min_length:
+    warning: 2
+    error: 1
+  # Keep global exclusions empty. For legitimate API-shaped short names such as `id`,
+  # use scoped inline disables instead; do not add generic shortcuts like id/x/y/i/j/k here.
+  excluded: []
+
+nesting:
+  type_level:
+    warning: 2

CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to GitHub Command Center will be documented in this file.
+
+## [0.1.0] - 2026-03-31
+
+Initial MVP release. A macOS menu bar app that monitors your GitHub PRs and tells you what needs attention.
+
+### Added
+
+- **PR triage dashboard** in the menu bar — PRs are split into "Needs Your Action", "Waiting on Others", and "Your Drafts" so you always know what to look at first
+- **Smart attention badge** — the menu bar icon shows how many PRs need your action, not the total count
+- **Status dots** with click popovers showing CI, review, and merge status for each PR at a glance
+- **Real-time notifications** for CI failures on your PRs, review requests, changes requested, approval, and merge conflicts
+- **Adaptive polling** — polls every 60s for small workloads, backs off to 5min for large ones, with ETag caching to minimize API usage
+- **Rate limit awareness** — detects GitHub API rate limits and pauses polling with a recovery timer
+- **Token validation** — checks that your PAT has the right scopes and warns about missing permissions
+- **Environment token bootstrapper** — automatically loads tokens from `GITHUB_TOKEN`, `GH_TOKEN`, or `.env.local` files during development
+- **Inline settings panel** — configure your token and manage repos without leaving the menu bar popover
+- **Draft PR section** — your drafts are tracked separately so they don't clutter the action list
+- **Pagination safety** — caps API pagination to prevent runaway requests on very active accounts
+- **Keychain storage** with `kSecAttrAccessibleAfterFirstUnlockThisDeviceOnly` for secure token persistence
+- **Notification threading** — PR notifications are grouped under a shared thread identifier
+
+### Changed
+
+- Menu bar icon animates during initial load to show the app is working
+
+### Fixed
+
+- CI notification fires correctly on pending-to-failing transitions (not just passing-to-failing)
+- Check-run API 403/404 falls back gracefully instead of failing the entire PR fetch
+- Thread-safe access to notification handlers, date formatters, and mock test infrastructure
+- Unterminated quoted tokens in `.env` files are rejected instead of silently truncated

CLAUDE.md

@@ -1,3 +1,17 @@
+## Project
+
+Swift/SwiftUI macOS 14+ menu bar app monitoring GitHub PR status. No external Swift dependencies.
+
+## Build & Test (CLI)
+
+- First-time setup: `mise install`
+- Sync tools and regenerate the Xcode project: `mise run sync`
+- Build: `mise run build`
+- Test: `mise run test`
+- Style checks: `mise run check`
+- Fix, then re-run style checks and tests: `mise run verify`
+- After editing `project.yml`: run `mise run sync`
+
 ## Skill routing
 
 When the user's request matches an available skill, ALWAYS invoke it using the Skill

GitHubCommandCenter/Assets.xcassets/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}