Phase 1: Notch-Shell, Design-System, Menüleisten-Infrastruktur

Zustandsmaschine und Geometrie sind testgetrieben entstanden und tragen 40
Tests — sie sind frei von AppKit, damit jeder Übergang ohne Fenster und ohne
Warten prüfbar ist. Zeit kommt nur als Ereignis herein.

Zwei Entscheidungen, die im Code begründet sind:

Der Zeiger wird über einen globalen Ereignismonitor verfolgt, nicht über ein
unsichtbares Fenster auf der Notch. Ein solches Fenster müsste Mausereignisse
annehmen, um sie zu bemerken, und würde damit Menüleiste und Fensterknöpfe
darunter unbenutzbar machen.

"Nur internes Display" fällt auf ein externes zurück, wenn kein eingebautes da
ist. Am Dock mit geschlossenem Deckel hieße die Einstellung wörtlich genommen,
dass Onyx unerreichbar wird.

Design: NSVisualEffectView mit eigenem Tint statt Liquid Glass — Onyx ist Stein,
kein Glas. Alle Farben und Maße liegen als Tokens in OnyxDesign.

Menüleiste: jedes Modul bekommt ein eigenes NSStatusItem. Elemente, denen macOS
mangels Platz keine Breite gibt, werden erkannt und gemeldet, statt still zu
verschwinden.

App-Target über XcodeGen, damit die Projektdefinition im Diff lesbar bleibt.
Nicht sandboxed, mit App-Group-Entitlement — baut, startet, signiert mit
PP34X97WS3.

Onyx/Info.plist

@@ -0,0 +1,44 @@
+<?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>de</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>Onyx</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleShortVersionString</key>
+    <string>$(MARKETING_VERSION)</string>
+    <key>CFBundleVersion</key>
+    <string>$(CURRENT_PROJECT_VERSION)</string>
+
+    <!-- Keine App im Dock und kein Menü: Onyx lebt in der Notch und in der
+         Menüleiste. -->
+    <key>LSUIElement</key>
+    <true/>
+
+    <key>LSMinimumSystemVersion</key>
+    <string>$(MACOSX_DEPLOYMENT_TARGET)</string>
+
+    <!-- Berechtigungstexte. Sie erscheinen wörtlich im Systemdialog, deshalb
+         steht hier, wofür Onyx den Zugriff braucht — nicht, dass es ihn braucht. -->
+    <key>NSCalendarsFullAccessUsageDescription</key>
+    <string>Onyx zeigt deine Termine im Kalender-Widget an. Es wird ausschließlich gelesen, nie geschrieben.</string>
+    <key>NSLocationWhenInUseUsageDescription</key>
+    <string>Onyx zeigt das Wetter an deinem aktuellen Standort. Du kannst stattdessen auch einen festen Ort wählen.</string>
+    <key>NSAppleEventsUsageDescription</key>
+    <string>Onyx steuert Spotify und Musik, wenn die universelle Medienschnittstelle nicht verfügbar ist.</string>
+    <key>NSAudioCaptureUsageDescription</key>
+    <string>Onyx braucht Zugriff auf die Audioausgabe, um die Lautstärke einzelner Programme zu regeln. Es wird nichts aufgezeichnet.</string>
+
+    <key>NSHumanReadableCopyright</key>
+    <string>© 2026 Scarriffleservices</string>
+</dict>
+</plist>

Onyx/Onyx.entitlements

@@ -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>
+    <!-- Bewusst KEIN com.apple.security.app-sandbox.
+
+         Die Calendarr-Integrationsanleitung fordert die Sandbox, aber sie ist
+         mit Onyx unvereinbar: eine sandboxed App kann keinen privilegierten
+         SMAppService-Daemon registrieren (kein Lüfter, kein Ladelimit), kommt
+         nicht an IOKit/IOReport (kein Hardware-Monitor) und kann /usr/bin/perl
+         nicht so starten, dass dessen MediaRemote-Entitlement noch greift.
+
+         Der App-Group-Container ist auf macOS unabhängig von der Sandbox, solange
+         beide Apps im selben Team signiert sind und die Group-ID mit dem
+         Team-Präfix beginnt. Nachgemessen in docs/spikes/D-appgroup.md. -->
+
+    <key>com.apple.security.application-groups</key>
+    <array>
+        <string>PP34X97WS3.group.com.scarriffleservices.calendarr</string>
+    </array>
+
+    <!-- Das mitgelieferte MediaRemoteAdapter.framework ist ad-hoc signiert,
+         der Host mit Team-Zertifikat. Ohne das wird es nicht geladen. -->
+    <key>com.apple.security.cs.disable-library-validation</key>
+    <true/>
+</dict>
+</plist>

Onyx/OnyxApp.swift

@@ -0,0 +1,110 @@
+import SwiftUI
+import AppKit
+import OnyxDesign
+import OnyxNotch
+import OnyxMenuBar
+
+@main
+struct OnyxApp: App {
+    @NSApplicationDelegateAdaptor(AppDelegate.self) private var delegate
+
+    var body: some Scene {
+        // Onyx hat kein Hauptfenster. Alles lebt im Notch-Panel und in der
+        // Menüleiste; die Einstellungen kommen in Phase 2 als eigenes Fenster.
+        Settings { EmptyView() }
+    }
+}
+
+@MainActor
+final class AppDelegate: NSObject, NSApplicationDelegate {
+
+    private var coordinator: NotchCoordinator?
+    private var menuBar: MenuBarController?
+    private var onyxItem: NSStatusItem?
+
+    func applicationDidFinishLaunching(_ notification: Notification) {
+        NSApp.setActivationPolicy(.accessory)
+
+        let coordinator = NotchCoordinator(policy: .builtInOnly) { displayID in
+            NSHostingView(rootView: NotchPanelContent(displayID: displayID))
+        }
+        coordinator.start()
+        self.coordinator = coordinator
+
+        let menuBar = MenuBarController()
+        menuBar.start()
+        self.menuBar = menuBar
+
+        installOnyxStatusItem()
+    }
+
+    func applicationWillTerminate(_ notification: Notification) {
+        coordinator?.stop()
+        menuBar?.stop()
+    }
+
+    /// Das feste Onyx-Element: Panel öffnen, Einstellungen, Beenden. Es ist auch
+    /// das Sicherheitsnetz, falls die Notch einmal nicht reagiert.
+    private func installOnyxStatusItem() {
+        let item = NSStatusBar.system.statusItem(withLength: NSStatusItem.squareLength)
+        item.autosaveName = "onyx.menubar.main"
+        item.button?.image = NSImage(systemSymbolName: "circle.hexagongrid.fill",
+                                     accessibilityDescription: "Onyx")
+        item.button?.image?.isTemplate = true
+
+        let menu = NSMenu()
+        menu.addItem(withTitle: "Panel öffnen", action: #selector(togglePanel), keyEquivalent: "")
+            .target = self
+        menu.addItem(.separator())
+        menu.addItem(withTitle: "Einstellungen …", action: #selector(openSettings), keyEquivalent: ",")
+            .target = self
+        menu.addItem(.separator())
+        menu.addItem(withTitle: "Onyx beenden", action: #selector(quit), keyEquivalent: "q")
+            .target = self
+        item.menu = menu
+
+        onyxItem = item
+    }
+
+    @objc private func togglePanel() { coordinator?.togglePanelUnderPointer() }
+
+    @objc private func openSettings() {
+        NSApp.activate(ignoringOtherApps: true)
+        NSApp.sendAction(Selector(("showSettingsWindow:")), to: nil, from: nil)
+    }
+
+    @objc private func quit() { NSApp.terminate(nil) }
+}
+
+/// Platzhalterinhalt für Phase 1. Er beweist, dass Fenster, Geometrie und
+/// Zustandsmaschine zusammenspielen; die Widget-Ebene kommt in Phase 2.
+private struct NotchPanelContent: View {
+    let displayID: CGDirectDisplayID
+
+    var body: some View {
+        ZStack {
+            OnyxSurface()
+
+            VStack(alignment: .leading, spacing: Onyx.Metric.tileSpacing) {
+                Text("Onyx")
+                    .font(Onyx.Font.title)
+                    .foregroundStyle(Onyx.Color.textPrimary)
+
+                Text("Phase 1 — Notch-Shell steht.")
+                    .font(Onyx.Font.body)
+                    .foregroundStyle(Onyx.Color.textSecondary)
+
+                HStack(spacing: Onyx.Metric.tileSpacing) {
+                    ForEach(["Kalender", "Wetter", "Medien"], id: \.self) { name in
+                        OnyxTile {
+                            Text(name)
+                                .font(Onyx.Font.caption)
+                                .foregroundStyle(Onyx.Color.textTertiary)
+                        }
+                    }
+                }
+            }
+            .padding(Onyx.Metric.panelPadding)
+        }
+    }
+}