Bootstrap Context Panel repo

.github/dependabot.yml

@@ -0,0 +1,37 @@
+---
+version: 2
+
+updates:
+  - package-ecosystem: swift
+    directory: "/"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+      - swift
+    groups:
+      all-version-updates:
+        patterns:
+          - "*"
+      all-security-updates:
+        applies-to: security-updates
+        patterns:
+          - "*"
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    open-pull-requests-limit: 2
+    schedule:
+      interval: weekly
+    labels:
+      - dependencies
+      - github-actions
+    groups:
+      all-version-updates:
+        patterns:
+          - "*"
+      all-security-updates:
+        applies-to: security-updates
+        patterns:
+          - "*"

.github/github-repo-workflow.json

@@ -0,0 +1,68 @@
+{
+  "defaultBranch": "main",
+  "projectType": "native-macos-app",
+  "docs": {
+    "agentNotes": "AGENTS.md",
+    "index": "docs/README.md",
+    "productGoals": "docs/product-goals.md",
+    "architecture": "docs/architecture.md",
+    "designDirection": "docs/design-direction.md",
+    "localLimitProbe": "docs/local-limit-probe.md",
+    "providerUsageAccess": "docs/provider-usage-access.md",
+    "repoSettings": "docs/repo-settings.md"
+  },
+  "qualityGate": {
+    "build": {
+      "default": "swift build"
+    },
+    "test": {
+      "default": "swift test"
+    },
+    "validate": {
+      "default": "scripts/commit-gate.sh"
+    },
+    "docsRequiredWhen": [
+      "provider behavior changes",
+      "provider account model changes",
+      "credential storage changes",
+      "user-visible UI changes",
+      "widget layout changes",
+      "release or signing changes"
+    ]
+  },
+  "importantWorkflows": ["CI", "CodeQL"],
+  "qaLabels": [],
+  "deployLabels": [],
+  "healthUrls": [],
+  "validatedThrough": [],
+  "githubSignals": {
+    "postMerge": {
+      "waitForActions": true,
+      "checkSecurityAndQuality": true
+    },
+    "capabilities": {
+      "codeScanning": "available",
+      "secretScanning": "available",
+      "dependabotAlerts": "available",
+      "securityAdvisories": "available"
+    },
+    "refreshWhen": [
+      "repo visibility changes",
+      "GitHub plan changes",
+      "security settings change",
+      "token permissions change"
+    ]
+  },
+  "cleanup": {
+    "deleteMergedLocalBranches": true,
+    "removeMergedCleanWorktrees": true
+  },
+  "metadataFreshness": {
+    "updateWhen": [
+      "validation gates change",
+      "important workflows change",
+      "repo relationship changes",
+      "ownership boundaries change"
+    ]
+  }
+}

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+---
+name: CI
+
+"on":
+  pull_request:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  swift:
+    runs-on: macos-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Select Xcode
+        run: sudo xcode-select -s /Applications/Xcode.app
+
+      - name: Build
+        run: swift build
+
+      - name: Test
+        run: swift test

.github/workflows/codeql.yml

@@ -0,0 +1,37 @@
+---
+name: CodeQL
+
+"on":
+  pull_request:
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: "31 9 * * 1"
+  workflow_dispatch:
+
+permissions:
+  actions: read
+  contents: read
+  security-events: write
+
+jobs:
+  analyze:
+    name: Analyze Swift
+    runs-on: macos-latest
+    timeout-minutes: 360
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v4
+        with:
+          languages: swift
+
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v4
+
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v4

.gitignore

@@ -0,0 +1,11 @@
+.DS_Store
+.build/
+DerivedData/
+*.xcuserdata/
+*.xcuserstate
+*.xcodeproj/project.xcworkspace/xcuserdata/
+*.xcodeproj/xcuserdata/
+*.xcworkspace/xcuserdata/
+.swiftpm/
+.idea/
+dist/

AGENTS.md

@@ -0,0 +1,59 @@
+# Context Panel Agent Notes
+
+## Product Shape
+
+Context Panel is a native macOS app plus WidgetKit extension for tracking AI
+usage limits across providers. Treat multi-account support as a core product
+requirement, not a later enhancement. The initial provider set is OpenAI,
+Anthropic, and Google.
+
+The widget is for glanceable state: remaining capacity, limit pressure, reset
+time, and whether refreshes are healthy. The app is for setup and detail:
+multiple logins, credential management, provider diagnostics, detailed charts,
+history, and settings.
+
+## Engineering Defaults
+
+- Keep the repo native-first. Do not add web or Docker surfaces unless Chris
+  explicitly asks for them.
+- Prefer Swift, SwiftUI, WidgetKit, and Swift Package Manager.
+- Keep provider-specific behavior behind adapters. Shared UI and storage should
+  consume normalized provider/account/limit snapshots.
+- Keep credentials local. Favor Keychain-backed storage for secrets and avoid
+  logging tokens, account identifiers, or raw provider responses that may expose
+  sensitive data.
+- Model unknown and degraded states explicitly. Provider APIs and unofficial
+  usage surfaces can change; the UI should make stale or partial data obvious.
+- Design for multiple accounts per provider from the data model up through the
+  widget layout.
+
+## UX Direction
+
+- The widget should be beautiful, dense, and calm: compact charts, rings, bars,
+  sparklines, reset countdowns, and provider/account grouping where useful.
+- For weekly or rolling account limits, include forecast language that helps the
+  user decide whether higher-burn modes are safe before reset.
+- Avoid making the widget a dashboard crammed into a rectangle. Put setup,
+  troubleshooting, raw details, and long histories in the app.
+- Clicking the widget should open the app to the most relevant provider/account
+  detail.
+- Prefer plain status language: available, close to limit, limited, unknown,
+  stale, refreshing.
+
+## Validation
+
+Run the commit gate before publishing changes:
+
+```sh
+scripts/commit-gate.sh
+```
+
+For UI work, also run the native app/widget locally and inspect the actual macOS
+presentation before calling the work ready.
+
+## Repo Workflow
+
+- Default branch: `main`.
+- Work on focused branches and open pull requests.
+- Keep `.github/github-repo-workflow.json` current when docs, validation gates,
+  important workflows, or repo ownership assumptions change.

Config/ContextPanel.entitlements

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.app-sandbox</key>
+  <false/>
+  <key>com.apple.security.application-groups</key>
+  <array>
+    <string>group.com.shinycomputers.contextpanel</string>
+  </array>
+</dict>
+</plist>

Config/ContextPanelWidget-Info.plist

@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>XPC!</string>
+	<key>CFBundleShortVersionString</key>
+	<string>1.0</string>
+	<key>CFBundleVersion</key>
+	<string>1</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.widgetkit-extension</string>
+	</dict>
+</dict>
+</plist>

Config/ContextPanelWidget.entitlements

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.app-sandbox</key>
+  <true/>
+  <key>com.apple.security.application-groups</key>
+  <array>
+    <string>group.com.shinycomputers.contextpanel</string>
+  </array>
+</dict>
+</plist>