Skip to content
mach

Changelog

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

For upcoming features see the Roadmap.

v1.3.2 — 2026-05-16

Note: v1.3.1 was tagged on 2026-05-15 but its release build failed at codesign and produced no artifact. v1.3.2 supersedes it.

🐛 Bug Fixes

  • Teleprompter UI cleanup (closes #11): Final polish — extracted 5.5 reading-area magic number to readingAreaHeightMultiplier static; moved ActionBarSecondaryStyle from TeleprompterExpandedView.swift to TeleprompterControlPanel.swift. Wraps up the broader cleanup tracked across prior polish sessions.

⚙️ CI & Compatibility

  • Codesign path fixed: Release workflow now points at bazel-bin/Apps/machNotch/machNotch_archive-root/machNotch.app (the actual rules_apple bundle output). Root cause of the v1.2.0, v1.3.0, and v1.3.1 release-build failures.
  • Release dry-run on every main push: Catches packaging/codesign regressions before tag time instead of at release.
  • Release SHA == build SHA: Release job now uses the same commit SHA the build was produced from; eliminates split-state releases.
  • Concurrency hardening: cancel-in-progress: false on release workflows prevents partial/superseded runs from publishing.
  • Tag pattern restricted to semver: Only vX.Y.Z triggers the release pipeline.
  • Arch-check script SRC path corrected: Previously pointed at a non-existent path and silently always passed; now actually validates the source tree.
  • Bazel cache consolidation: Unified Bazel cache keys across CI jobs; added Bazelisk binary cache to cut cold-start time.
  • swift-format strict mode: Baseline cleared and strict mode enforced in CI.
  • CodeQL Swift muted: Moved to manual workflow_dispatch — incompatible with Bazel + rules_swift on macOS. Shared Xcode scheme restored for the manual path.
  • build_reusable.yml permissions tightened: Dropped write permission; reusable build job is read-only.
  • Line-count allowlist: Three files that tipped over the 300-line threshold from the swift-format pass added to the allowlist (tracked for follow-up extraction).

v1.3.0 — 2026-05-10

🏗 Architecture

  • PluginUIContext: New environment type introduced to resolve DIP violations — plugin views no longer import or depend on NotchViewModel directly. All built-in plugin views migrated to PluginUIContext.

✨ New Features

  • mach.brief Phase 1: App Group infrastructure for cross-app settings sync between machNotch and mach.brief.
  • mach.brief Phase 2: Vocabulary level system with in-app onboarding picker; 4-panel hover expanded view with vocab as default tab.
  • mach.brief offline: Word cache, offline fallback, and expanded word lists so the app works without a network connection.
  • Bazel native build: Full migration to native Bazel rules for machNotch and the XPC service bundle. Taskfile.yml replaces the Makefile.

🐛 Bug Fixes

  • Permissions: Bluetooth permission prompt suppressed on launch; persistent TCC/accessibility sentinel prevents repeat prompts across installs.
  • Calendar: Compact access prompt fits within the widget height; grant button always visible regardless of auth state.
  • Stats: Guarded UInt64 underflow in readNetworkRates that caused a crash on rapid interface changes.
  • mach.brief: Prevented notch stuck-state from slow API calls and rapid reloads; fixed word language setting not applying to quote source.

⚙️ CI & Compatibility

  • macOS 26: Switched CI to macos-26 runner; fixed XCTest async teardown crashes across MusicPluginTests, QuickShareService, and BriefPlugin test suites.
  • Bazel CI: Repaired pipeline; split Bazel cache by target; --jobs=HOST_CPUS; actions/checkout@v5.

v1.2.0 — 2026-05-03

First public release.

🧹 Repo Hygiene

  • Root README refresh: Updated root documentation from stale machNotch paths to the current Apps/machNotch/ layout.
  • Build command clarity: Documented the current root-relative build command using Apps/machNotch/machNotch.xcodeproj and noted that plain root xcodebuild is not available until a root workspace/project/package exists.
  • Rename status: Verified the active Xcode scheme/targets are machNotch, MachNotchXPCHelper, and machNotchTests; stale docs now point to the renamed scheme.
  • Build/test repair: Fixed stale Xcode project paths for entitlements, Info.plists, preview assets, and moved source files so root-relative build and test commands pass again.
  • CI path cleanup: Updated build, test, release, and Pages workflows to use the nested Apps/machNotch/ project, configuration, and updater paths.

🎨 UI & Animation Polish

  • Wider, Cleaner Layout: Increased notch width (740pt → 860pt) for better spacing.
  • Unified Animations: Rearchitected open/close animations for a smoother, interruptible, and more cohesive feel. Content and shell now animate together.
  • Refined Header: Redesigned header with better padding, alignment, and a more compact tab selection view.
  • Improved Gestures: Pan gestures for opening/closing the notch are now disabled when interacting with scrollable content, preventing accidental closures.
  • Consistent Padding: Standardized padding and spacing across all notch components for a cleaner look.
  • Aggressive Content Absorption: Content exit animation is now much more aggressive, creating a satisfying “absorbed into the notch” effect.

🐛 Bug Fixes & Refinements

  • UI State & Expansion Bugs: Fixed a horizontal bounce after closing (due to stale phase checks), prevented the Battery expansion from stretching the Music plugin to 640px, and fixed the notch squishing when switching apps via Cmd+Tab.
  • Timeline Sync: Mapped duration and currentTime from the active media controller to fix the timeline UI getting stuck at 0.
  • Shelf Drag and Drop: Fixed an issue where dragging files out of the shelf would fail due to missing selection state context.
  • Accessibility Prompts: Disabled automatic accessibility prompts on launch and settings load to prevent aggressive system popups.
  • Browser Media Controller: Added support for browser extension media controls with SoundCloud metadata extraction.
  • External display fix: Fixed notch not appearing on external (non-notch) displays when “Show on all displays” is enabled. The .transient collection behavior caused macOS to hide windows on non-notch screens.
  • Duplicate init call: Removed duplicate configureWindow() call in NotchSkyLightWindow init.
  • Build regressions: Fixed MusicService, SpotifyController, YouTubeMusicController, NowPlayingController, and PlaybackState regressions after efficiency refactor.
  • UI regressions: Fixed clipping, shape integrity, and header alignment issues in open/closed notch states.
  • Centered layout: Implemented centered ‘hugging’ layout with proper home tab visibility.
  • Project Structure: Massive project file cleanup and reorganization. Moved dozens of files into a more logical structure, improving maintainability.
  • Animation Glitches: Fixed a visual bug where the notch corners would not be rounded correctly during animations.
  • Gesture Conflicts: Resolved gesture conflicts between the notch and scrollable content within plugins.
  • Removed Build Artifacts: Deleted stale build output files from the repository.

🏗 Architecture Overhaul (Plugin System)

Completion of massive architectural refactoring. Monolithic singleton-based design → modular, plugin-first architecture.

  • Plugin Engine: PluginManager + NotchPlugin protocol.
  • Everything is a Plugin: All core features (Music, Battery, Calendar, Shelf, Weather, Webcam) migrated to standalone plugins in Plugins/BuiltIn/.
  • Service Container: Replaced scattered singletons with unified ServiceContainer for DI.
  • Testability: All services use protocols (MusicServiceProtocol, etc.), enabling mock injection.

✨ New Features

  • Teleprompter Pro: Full-featured teleprompter with countdown timer, mic monitoring, hover-to-pause, keyboard shortcuts, AI text assist (refine/summarize/draft via Ollama), control panel with speed/font/color.
  • Browser Extension: Safari web extension for media control from the notch.
  • Habit Tracker Plugin: Daily habit tracking with streaks, progress rings, persistent storage.
  • Pomodoro Plugin: Focus timer with work/break intervals, session history, notch-integrated controls.
  • Display Surface Plugin: Generic display arbitration for surfacing prioritized content.
  • Notifications Plugin: Dedicated system notification handling.
  • Clipboard Plugin: Clipboard history management from the notch.
  • AI Subsystem: AIManager + AIProvider protocol with Ollama backend for text generation.
  • Local API Server: HTTP + WebSocket server for external integrations (notchctl CLI, browser extension). Auth middleware, rate limiting, plugin API routes.
  • App Intents & URL Scheme: Siri Shortcuts integration + machnotch:// URL scheme handler.
  • Protocol-Based Services: Clean APIs enabling easy provider swaps.

🐛 Bug Fixes

  • XPC Helper: Fixed IOServicePort leak in brightness check; broke retain cycle in connection invalidation handler.
  • Animation: Fixed album art ghost on track change, smoother closing animation, shell-first open/close timeline.
  • Settings: Reverted bindableSettings fatalError — SwiftUI resolves default before env modifier applies.
  • DI: Added missing @Environment(\.settings) and Combine imports post-refactor.
  • Home View: Default to home view on notch open instead of shelf.

🧹 Tech Debt & Improvements

  • Singleton Removal: 300+ .shared sites removed. Views use @Environment or init injection.
  • Modern State Management: Migrated to Swift 5.9 @Observable macro across all core models.
  • Decoupled Settings: Split DefaultsNotchSettings into focused extensions (+Display, +HUD, +Music, +Plugins). No direct Defaults[.] outside settings files.
  • File Structure: Core/ for domain + coordination, Plugins/ for features, UI/ for view helpers.
  • Apple-quality animations: Content reveal modifier, shadow easing, spring-tuned choreography.
  • Architecture gate CI: Automated boundary violation checks.

🏛 SOLID & DDD Hardening

Comprehensive review and refactoring across 34+ files.

SRP Extractions

  • TeleprompterTimerManager: Timer + mic monitor lifecycle extracted from TeleprompterState.
  • TeleprompterScrollEngine / ShortcutHandler / CountdownState: Further SRP splits.
  • DisplayPrioritizer: Display arbitration extracted from PluginManager into pure struct.
  • HeaderButton / HeaderActionButton: Reusable components from NotchHeader (197→130 lines).
  • ContentView sub-views: notchBackground, glassOverlay, topEdgeLine extracted.

DDD Improvements

  • PluginID enum: 30+ stringly-typed identifiers → type-safe constants. Typos are compile errors.
  • SneakContentType.isHUD: Moved to computed property on domain enum.
  • NotchServiceProvider: Protocol for clean service resolution across plugin boundaries.

Clean Code

  • DisplaySurfaceState: Private ttlTask, [weak self] capture, explicit clear().
  • Named constants: Magic numbers extracted across teleprompter state.
  • SpotifyController.setFavorite(): LSP contract documented.

⚡ Performance

  • Phase 2 efficiency: Isolated high-frequency progress updates into leaf reader views, event-driven geometry calculations replacing polling, XPC helper backoff strategy for reduced IPC overhead.
  • Background service backoff: BackgroundServiceRestartable protocol pauses BatteryService/BluetoothManager polling when notch is closed.
  • NotchServiceProvider consolidation: Single DI entry point replaces 8 individual service properties in NotchViewModel.
  • TimelineView gating: Music controls switch to static layout when notch is closed (no 60fps background burn).
  • AVAudioRecorder lifecycle: Mic hardware released immediately when teleprompter is paused.
  • AnyView elimination: Plugin views use type-specific wrappers, restoring SwiftUI structural identity.
  • High-frequency reader isolation: elapsedTime decoupled into leaf ScrubberPlayheadView.
  • GPU/CoreAnimation backoff: Heavy blur/blend gated behind !vm.phase.isTransitioning.
  • Teleprompter off-main parsing: Text section parsing offloaded to Task.detached.
  • Teleprompter closed view: Wider layout, prominent X button, live speed slider (🐢↔🐇).
  • Background execution leaks: Fixed rendering leaks in Teleprompter and Music plugins that burned CPU when notch was closed.