feat(release): complete v0.1.1 attention controls [release:v0.1.1]

[tcballard]

Summary

Implements the complete v0.1.1 attention-controls contract.

Adds:

• Self-explanatory menu-bar state language in Settings
• Settings-first onboarding with visible agent, event, and GitHub health
• Native global-shortcut recording with live registration
• Clear temporary snooze versus Hide Until It Changes behavior
• A bounded local recent-signals history for lightweight diagnosis
• Persistent native disclosure controls for information-heavy Settings groups
• Bundle and release metadata updated to 0.1.1

Scope

Included

• Teaches Needs you, review numbers, CI!, and quiet icon-only states in Settings.
• Opens Settings on first launch instead of showing an integration alert.
• Detects complete, partial, and missing Claude/Codex hook installation.
• Shows the most recent durable agent event and GitHub CLI authentication state.
• Replaces the key picker/modifier buttons with a focused AppKit shortcut recorder.
• Supports capture, Escape cancel, Delete clear, live registration, and registration errors.
• Renames Dismiss This Item to Hide Until It Changes.
• Persists the eight newest signals and displays the five newest in Settings.
• Splits the Settings surface into focused SwiftUI section types.
• Makes status, health, repository, and recent-signal groups collapsible while keeping Controls visible.
• Makes the development run script terminate the stale app before relaunching.
• Bumps CFBundleShortVersionString to 0.1.1 and CFBundleVersion to 2.

Excluded

• No change to the native NSStatusItem architecture.
• No default global shortcut; shortcut use remains opt-in.
• No change to GitHub review/CI ordering, wait-gating, or polling cadence.
• No full dashboard, analytics, or remote telemetry.
• No automatic modification of an existing Claude status line.
• No Liquid Glass or macOS 15+ visual dependency.
• No broader v0.2 product redesign.

Product / Architecture Decisions

• Kept the menu-bar chip as the signature interaction and made trust the Settings signature: state language, health, and recent evidence form one compact trail.
• Kept SwiftUI as the source of truth and crossed into AppKit only for the shortcut recorder; Carbon remains isolated to global shortcut registration.
• Stores recent signals locally in a bounded UserDefaults payload and coalesces immediate duplicates.
• Writes a hidden durable latest-event snapshot alongside active session files so health survives stale-session cleanup.
• Treats partial hook installation or malformed hook settings as Needs review, not as healthy.
• Uses semantic system colours and macOS 14 controls/materials; red and orange remain attention states rather than decoration.
• Persists disclosure choices with app preferences so Settings restores the user’s preferred density.

User-Facing Contract

Menu Bar

• Needs you: an agent is blocked on the user.
• #78: a review is ready while an agent works.
• CI!: failing CI is ready while an agent works.
• Icon only: nothing needs attention.
• Snooze for 15 Minutes: temporarily hides the current item.
• Hide Until It Changes: suppresses that source item until it leaves the active set.

Settings

• First launch opens Settings with setup status and one Install or Update… action.
• Connection health reports agent hooks, the latest agent event, and GitHub authentication.
• Shortcut recording accepts a modified letter, digit, Space, Tab, Return, or Escape.
• Escape alone cancels recording; Delete clears the shortcut.
• Recent signals show agent, review, CI, snooze, hide, and installation activity.
• Repository scope remains configurable in the same window.
• Status, health, repository, and recent-signal groups can be expanded or collapsed and remember their state.

Privacy

• Hook events, the latest-event snapshot, preferences, and recent signals stay local.
• No GitHub token is read or stored by Meanwhile.
• No telemetry was added.

Verification

Ran

swift test
./Scripts/run-meanwhile.sh
plutil -extract CFBundleShortVersionString raw dist/Meanwhile.app/Contents/Info.plist
codesign --verify --deep --strict --verbose=2 dist/Meanwhile.app
git diff --check

Covered

• 40 Swift tests passed.
• Complete, partial, and missing hook-health states.
• Durable latest-event storage after active-session cleanup.
• GitHub CLI authentication success and failure.
• Bounded and duplicate-coalesced recent-signal persistence.
• Debug packaging, ad-hoc signing, bundle verification, and launch.
• Live shortcut capture (⌃⌥Space), Escape cancel, Delete clear, and restoration to ⌘M.
• Running Settings window reviewed in light appearance with repository, populated recent-signal, and authenticated health data.
• All four disclosure groups exercised expanded and collapsed, including persistence across app relaunch.

Review Path

Suggested review order:

1. docs/v0.1.1-authored-settings.md and the Settings section composition.
2. First-run, menu semantics, and recent-signal wiring in MeanwhileApp.swift.
3. Integration/event/GitHub health models in MeanwhileCore.
4. ShortcutRecorder.swift and GlobalHotKey.swift.
5. Persistence tests, README, version metadata, and run-script relaunch behavior.

Notes For Reviewer

The shortcut is opt-in. Existing config-file hotkeys remain a fallback until the user records or clears a shortcut in Settings. The local audit-screenshots/ directory is intentionally excluded from the PR.