Halo heisst ab hier Flaro — die Marke stand im Weg

Der Upload zu App Store Connect scheiterte am Namen. „Halo" ist eine
eingetragene Marke von Microsoft; im App Store heisst zwar keine App exakt
so, aber reservierte und markenrechtlich belegte Namen tauchen in keiner
Suche auf. Der einzige verlässliche Test war die Eingabe dort, und die ging
daneben.

**Der Name wurde diesmal vorher geprüft.** Zwanzig Kandidaten gegen den
deutschen und amerikanischen App Store, auf exakte Treffer und auf ähnliche
Namen. „Kavo" wäre dieselbe Wand gewesen — exakt belegt in beiden Stores, in
Deutschland von KaVo Dental GmbH. „Flare" ist mit 42 ähnlichen Apps je Store
der am dichtesten besetzte Name der ganzen Runde. **Flaro** ist in beiden
frei und liest sich als eigenes Wort, nicht als Flare mit Tippfehler.

Das bleibt eine Store-Suche und keine Markenrecherche — reservierte Namen
ohne veröffentlichte App sieht sie nicht. Aber es ist mehr Prüfung, als beim
letzten Mal stattfand.

---

2160 Textvorkommen in 273 Dateien, 49 Pfade. Betroffen ist diesmal auch der
Server: `Flaro.Api`, `Flaro.Core`, `Flaro.Data`, `Flaro.Media`,
`Flaro.Metadata`, `FlaroContext`, `FlaroPaths`, `flaro.db`, die Variablen
`FLARO_DATA`, `FLARO_CACHE`, `FLARO_TRANSCODE`, `FLARO_WRITE_SIDECARS`, und
das Image.

**Vor dem Ersetzen geprüft**, ob „halo" irgendwo als Teil eines anderen
Wortes steckt — und ob es im TMDB-Token vorkommt. Tat es nicht; ein blindes
Ersetzen hätte den sonst zerlegt.

`docs/superpowers/specs/` bleibt wie beim letzten Mal unangetastet: datierte
Entwurfsdokumente sind ein Protokoll getroffener Entscheidungen. Das
Server-Dokument hat stattdessen einen Nachtrag bekommen, damit es niemanden
in die Irre führt.

**Die Bundle-ID wandert mit**, zum zweiten Mal an einem Tag:
`com.scarriffleservices.flaro`. Wer die vorige Fassung installiert hat, hat
jetzt zwei Karteileichen auf dem Gerät — beide löschen, dann ist Ruhe.

308 Server-Tests grün, 368 im Swift-Paket, null Warnungen. iOS und tvOS
bauen, das Image baut, und ein frischer Container läuft durch Einrichtung
und Anmeldung.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Packages/FlaroKit/Tests/FlaroPlaybackTests/UpgradeRuleTests.swift

@@ -0,0 +1,143 @@
+import Foundation
+import Testing
+@testable import FlaroPlayback
+
+@Suite("Wann hinaufgeschaltet wird")
+struct UpgradeRuleTests {
+
+    /// Die Lage, in der es erlaubt ist — alle übrigen Tests weichen davon in
+    /// genau einem Punkt ab. So steht in jedem Test nur der Unterschied.
+    private func ruhig(
+        isAutomatic: Bool = true,
+        condition: StreamCondition = .healthy,
+        hasHigherRung: Bool = false,
+        ceilingAllowsMore: Bool = true,
+        bufferedAhead: Duration? = .seconds(30),
+        playedFor: Duration = .seconds(120),
+        sinceLastStall: Duration? = nil,
+        sinceLastSeek: Duration? = nil,
+        sinceLastUpgrade: Duration? = nil,
+        used: Int = 0,
+        budget: Int = 2
+    ) -> UpgradeRule.Facts {
+        .init(
+            isAutomatic: isAutomatic,
+            condition: condition,
+            hasHigherRung: hasHigherRung,
+            ceilingAllowsMore: ceilingAllowsMore,
+            bufferedAhead: bufferedAhead,
+            playedFor: playedFor,
+            sinceLastStall: sinceLastStall,
+            sinceLastSeek: sinceLastSeek,
+            sinceLastUpgrade: sinceLastUpgrade,
+            used: used,
+            budget: budget
+        )
+    }
+
+    @Test("Läuft es ruhig und ist die Leiter ausgereizt, wird neu aufgebaut")
+    func calmAndCappedRebuilds() {
+        #expect(UpgradeRule.verdict(ruhig()) == .rebuildHigher)
+    }
+
+    // MARK: - Was es verbietet
+
+    /// Wer „720p · 3 Mbps" antippt, meint das — auch wenn die Leitung mehr
+    /// trüge.
+    @Test("Eine gewählte Stufe wird nicht überstimmt")
+    func neverOverridesAChoice() {
+        #expect(UpgradeRule.verdict(ruhig(isAutomatic: false)) == .notAutomatic)
+    }
+
+    /// **Der wichtigste Fall.** Solange die Leiter noch eine Sprosse hat,
+    /// kostet das Hinaufgehen kein schwarzes Bild — ein Neuaufbau dafür wäre
+    /// Verschwendung.
+    @Test("Solange die Leiter trägt, kein Neuaufbau")
+    func prefersTheCheapPath() {
+        #expect(UpgradeRule.verdict(ruhig(hasHigherRung: true)) == .cheaperPathRemains)
+    }
+
+    @Test("Über die eingestellte Grenze geht es nicht")
+    func respectsTheSetting() {
+        #expect(UpgradeRule.verdict(ruhig(ceilingAllowsMore: false)) == .atCeiling)
+    }
+
+    @Test("Bei angespannter Lage wird nicht hinaufgegangen")
+    func notWhenStrained() {
+        #expect(UpgradeRule.verdict(ruhig(condition: .strained)) == .notCalmEnough)
+        #expect(UpgradeRule.verdict(ruhig(condition: .failing)) == .notCalmEnough)
+    }
+
+    /// „Es läuft gerade" genügt nicht — es muss etwas auf der hohen Kante
+    /// liegen, sonst trägt es den Neuaufbau nicht.
+    @Test("Ohne Vorrat kein Neuaufbau")
+    func needsABuffer() {
+        #expect(UpgradeRule.verdict(ruhig(bufferedAhead: .seconds(5))) == .notCalmEnough)
+        #expect(UpgradeRule.verdict(ruhig(bufferedAhead: nil)) == .notCalmEnough)
+    }
+
+    /// Der Puffer füllt sich nach dem Start immer, und das sieht eine halbe
+    /// Minute lang nach einer hervorragenden Leitung aus.
+    @Test("Am Anfang nicht, auch wenn alles gut aussieht")
+    func notRightAfterStart() {
+        #expect(UpgradeRule.verdict(ruhig(playedFor: .seconds(20))) == .tooEarly)
+    }
+
+    @Test("Nach einem Sprung nicht")
+    func notRightAfterSeek() {
+        #expect(UpgradeRule.verdict(ruhig(sinceLastSeek: .seconds(3))) == .tooEarly)
+    }
+
+    /// Wer gerade gestockt hat, hat keine Reserve — und ein Neuaufbau wäre
+    /// die zweite Unterbrechung binnen einer Minute.
+    @Test("Nach einem Rückler lange nicht")
+    func waitsAfterAStall() {
+        #expect(UpgradeRule.verdict(ruhig(sinceLastStall: .seconds(30))) == .tooEarly)
+        #expect(UpgradeRule.verdict(ruhig(sinceLastStall: .seconds(120))) == .rebuildHigher)
+    }
+
+    @Test("Die Sperrfrist gilt")
+    func respectsTheCooldown() {
+        #expect(UpgradeRule.verdict(ruhig(sinceLastUpgrade: .seconds(60))) == .cooling)
+        #expect(UpgradeRule.verdict(ruhig(sinceLastUpgrade: .seconds(200))) == .rebuildHigher)
+    }
+
+    @Test("Das Budget ist endlich")
+    func budgetIsFinite() {
+        #expect(UpgradeRule.verdict(ruhig(used: 2, budget: 2)) == .budgetSpent)
+        #expect(UpgradeRule.verdict(ruhig(used: 1, budget: 2)) == .rebuildHigher)
+    }
+
+    // MARK: - Die Reihenfolge der Gründe
+
+    /// Bei mehreren Gründen soll der **grundsätzlichste** gemeldet werden —
+    /// sonst steht im Protokoll „Sperrfrist", wo in Wahrheit die Einstellung
+    /// das Ende ist, und jemand wartet auf etwas, das nie kommt.
+    @Test("Der grundsätzlichste Grund gewinnt")
+    func reportsTheMostFundamentalReason() {
+        #expect(
+            UpgradeRule.verdict(ruhig(
+                isAutomatic: false, hasHigherRung: true, ceilingAllowsMore: false
+            )) == .notAutomatic
+        )
+        #expect(
+            UpgradeRule.verdict(ruhig(
+                hasHigherRung: true, ceilingAllowsMore: false
+            )) == .atCeiling
+        )
+        #expect(
+            UpgradeRule.verdict(ruhig(
+                condition: .failing, hasHigherRung: true
+            )) == .cheaperPathRemains
+        )
+    }
+
+    /// Das Hinaufschalten muss zurückhaltender sein als das Absenken: ein zu
+    /// spätes Absenken bedeutet Ruckeln, ein zu spätes Hinaufschalten ein
+    /// etwas weicheres Bild.
+    @Test("Zurückhaltender als das Absenken")
+    func moreCautiousThanDowngrading() {
+        #expect(UpgradeRule.settleIn > DowngradeRule.settleIn)
+        #expect(UpgradeRule.cooldown < DowngradeRule.cooldown)
+    }
+}