dsh-notch 0.3.1

package/macos/Sources/main.swift

@@ -0,0 +1,153 @@
+import AppKit
+import Combine
+import SwiftUI
+
+@main
+enum DshNotchMain {
+  static func main() {
+    if CommandLine.arguments.contains("--verify-idle-resources") {
+      let ids = IdleDirector.basics + ["dance"]
+      let missing = ids.filter { IdleLibrary.shared.clip($0) == nil }
+      print("IDLE_RESOURCES=\(ids.count - missing.count)/\(ids.count)")
+      exit(missing.isEmpty ? 0 : 1)
+    }
+    let app = NSApplication.shared
+    if CommandLine.arguments.contains("--demo") {
+      app.setActivationPolicy(.regular)
+      let delegate = DemoStudioDelegate()
+      DemoStudioDelegate.hold = delegate
+      app.delegate = delegate
+      delegate.show()
+      app.run()
+      return
+    }
+    app.setActivationPolicy(.accessory)
+    let delegate = AppDelegate()
+    app.delegate = delegate
+    app.run()
+  }
+}
+
+@MainActor
+final class AppDelegate: NSObject, NSApplicationDelegate {
+  private let panelW: CGFloat = 480
+  private let restW: CGFloat = 32
+  private let restH: CGFloat = 110
+  private let topOffset: CGFloat = 100
+  private let model = BoardModel()
+  private var panel: NotchPanel?
+  private var hosting: NotchHostingView<RootView>?
+  private var cursorTimer: Timer?
+  private var foldWork: DispatchWorkItem?
+  private var enteredIsland = false
+  private var cancellables = Set<AnyCancellable>()
+
+  func applicationDidFinishLaunching(_ notification: Notification) {
+    ProcessInfo.processInfo.disableAutomaticTermination("dsh-notch")
+    ProcessInfo.processInfo.disableSuddenTermination()
+    let panel = NotchPanel(size: NSSize(width: panelW, height: restH))
+    let root = RootView(
+      model: model,
+      panelSize: CGSize(width: panelW, height: restH),
+      restSize: CGSize(width: restW, height: restH)
+    )
+    let hosting = NotchHostingView(rootView: root)
+    hosting.sizingOptions = []
+    hosting.wantsLayer = true
+    hosting.layer?.isOpaque = false
+    hosting.layer?.backgroundColor = NSColor.clear.cgColor
+    panel.embedHost(hosting)
+    panel.ignoresMouseEvents = false
+    self.panel = panel
+    self.hosting = hosting
+    pinToScreen()
+    updateHits()
+    panel.orderFrontRegardless()
+    model.start()
+    Publishers.CombineLatest3(model.$expanded, model.$currentIslandWidth, model.$currentIslandHeight)
+      .receive(on: DispatchQueue.main)
+      .sink { [weak self] _ in self?.updateHits() }
+      .store(in: &cancellables)
+    cursorTimer = Timer.scheduledTimer(withTimeInterval: 0.05, repeats: true) { [weak self] _ in
+      Task { @MainActor in
+        self?.tickPointer()
+      }
+    }
+    NotificationCenter.default.addObserver(
+      self,
+      selector: #selector(pinToScreen),
+      name: NSApplication.didChangeScreenParametersNotification,
+      object: nil
+    )
+  }
+
+  @objc private func pinToScreen() {
+    guard let panel else { return }
+    panel.cancelResize()
+    let mouse = NSEvent.mouseLocation
+    let screen = NSScreen.screens.first { NSMouseInRect(mouse, $0.frame, false) }
+      ?? NSScreen.main
+      ?? NSScreen.screens.first
+    guard let screen else { return }
+    let visible = screen.visibleFrame
+    let layout = NotchScreenLayout(availableHeight: visible.height, preferredInset: topOffset)
+    model.maximumExpandedHeight = layout.maximumHeight
+    // Anchor capsule to upper-right edge, ~100pt below top of usable screen.
+    // Keep the test helper separate from the real Notch during walkthroughs.
+    let demoInset: CGFloat = ProcessInfo.processInfo.environment["DSH_NOTCH_RUNTIME_FILE"] == nil ? 0 : 360
+    let width = max(1, model.currentIslandWidth)
+    let height = min(max(1, model.currentIslandHeight), model.maximumExpandedHeight)
+    let frame = NSRect(
+      x: visible.maxX - demoInset - width,
+      y: visible.maxY - layout.edgeInset - height,
+      width: width,
+      height: height
+    )
+    panel.setFrame(frame, display: true)
+  }
+
+  private func pointerOverVisual() -> Bool {
+    guard let panel else { return false }
+    return panel.frame.contains(NSEvent.mouseLocation)
+  }
+
+  private func tickPointer() {
+    guard panel != nil else { return }
+    let hit = pointerOverVisual()
+    if hit {
+      enteredIsland = true
+      foldWork?.cancel()
+      foldWork = nil
+      model.foldEnabled = true
+      // Expand when hovering if there are items needing action or if user triggered expansion.
+      if !model.expanded && (model.needsAction || model.allowExpandOnHover) {
+        model.expanded = true
+        updateHits()
+      }
+      return
+    }
+    // A guided local walkthrough stays visible until its test answer is sent.
+    if ProcessInfo.processInfo.environment["DSH_NOTCH_RUNTIME_FILE"] != nil && model.needsAction { return }
+    guard model.expanded, model.foldEnabled, enteredIsland, foldWork == nil else { return }
+    let work = DispatchWorkItem { [weak self] in
+      Task { @MainActor in
+        guard let self else { return }
+        self.foldWork = nil
+        if self.pointerOverVisual() { return }
+        self.enteredIsland = false
+        self.model.expanded = false
+        self.updateHits()
+        self.panel?.orderFrontRegardless()
+      }
+    }
+    foldWork = work
+    DispatchQueue.main.asyncAfter(deadline: .now() + 0.38, execute: work)
+  }
+
+  private func updateHits() {
+    guard let panel else { return }
+    let width = max(1, model.currentIslandWidth)
+    let height = min(max(1, model.currentIslandHeight), model.maximumExpandedHeight)
+    panel.resizeAnchored(to: NSSize(width: width, height: height), animated: true)
+  }
+}

package/macos/Tests/ExpandedHeightProbe.swift

@@ -0,0 +1,108 @@
+import AppKit
+import SwiftUI
+import Combine
+
+@main enum ExpandedHeightProbe {
+  @MainActor static func main() {
+    let app = NSApplication.shared
+    app.setActivationPolicy(.accessory)
+    let model = BoardModel()
+    model.previewMode = true
+    model.maximumExpandedHeight = 800
+    let panel = NotchPanel(size: NSSize(width: 480, height: 110))
+    let host = NotchHostingView(rootView: RootView(model: model, panelSize: CGSize(width: 480, height: 110), restSize: CGSize(width: 32, height: 110)))
+    host.sizingOptions = []
+    panel.embedHost(host)
+    panel.setFrame(NSRect(x: -2000, y: -2000, width: 38, height: 44), display: true)
+    panel.orderFrontRegardless()
+    var subscriptions = Set<AnyCancellable>()
+    Publishers.CombineLatest3(model.$expanded, model.$currentIslandWidth, model.$currentIslandHeight)
+      .receive(on: DispatchQueue.main).sink { _ in
+        panel.resizeAnchored(to: NSSize(width: model.currentIslandWidth, height: min(model.currentIslandHeight, model.maximumExpandedHeight)))
+      }.store(in: &subscriptions)
+    @MainActor func scrollViews(_ view: NSView) -> [NSScrollView] {
+      ((view as? NSScrollView).map { [$0] } ?? []) + view.subviews.flatMap(scrollViews)
+    }
+    Task { @MainActor in
+      var failures = 0
+      @MainActor func check(_ condition: Bool, _ message: String) {
+        if !condition { failures += 1; print("FAIL \(message)") }
+      }
+      @MainActor func question(_ detail: String? = nil, descriptions: Int = 1) -> NotchQuestion {
+        NotchQuestion(id: "question", question: "要在哪个分支继续修改？", detail: detail, options: [
+          NotchOption(label: "在 #17 分支上直接改（推荐）", description: String(repeating: "接着 cursor/reader-transcendent-merge-47c2 提交并重建，热更新到你现在这个页面验证，不用重启。", count: descriptions)),
+          NotchOption(label: "另开分支/PR 改", description: "#17 保持给作者 review，玻璃改动走新分支。"),
+          NotchOption(label: "暂时不改", description: "保留当前版本。")
+        ])
+      }
+      @MainActor func show(_ questions: [NotchQuestion]) {
+        model.wizard = nil
+        model.rows = [NotchRow(id: "offline", title: "Local height fixture", child: false, busy: false, unread: false, ask: NotchAsk(id: "ask", questions: questions))]
+        model.expanded = true
+      }
+      @MainActor func inspect(_ tag: String, overflowing: Bool = false) async {
+        try? await Task.sleep(for: .milliseconds(850))
+        host.layoutSubtreeIfNeeded()
+        let scrolls = scrollViews(host)
+        let overflows = scrolls.map { ($0.documentView?.frame.height ?? 0) - $0.contentView.bounds.height }
+        print("CASE=\(tag) PANEL=\(panel.frame.height) MEASURED=\(model.measuredContentHeight) CAP=\(model.maximumExpandedHeight) OVERFLOWS=\(overflows)")
+        if overflowing {
+          check(abs(panel.frame.height - model.maximumExpandedHeight) < 2, "\(tag): reaches screen cap before scrolling")
+          check(overflows.contains { $0 > 20 }, "\(tag): fixture has real overflow")
+          if let scroll = scrolls.first, let document = scroll.documentView {
+            let bottom = max(0, document.frame.height - scroll.contentView.bounds.height)
+            scroll.contentView.scroll(to: NSPoint(x: 0, y: bottom))
+            scroll.reflectScrolledClipView(scroll.contentView)
+            check(abs(scroll.contentView.bounds.origin.y - bottom) < 2, "\(tag): bottom controls remain reachable")
+          }
+        } else {
+          check(overflows.allSatisfy { $0 < 2 }, "\(tag): content fits without premature scrolling")
+          check(panel.frame.height < model.maximumExpandedHeight - 5, "\(tag): short content doesn't fill screen cap")
+        }
+        if let output = ProcessInfo.processInfo.environment["NOTCH_HEIGHT_PROBE_OUTPUT"],
+           let bitmap = host.bitmapImageRepForCachingDisplay(in: host.bounds) {
+          host.cacheDisplay(in: host.bounds, to: bitmap)
+          if let png = bitmap.representation(using: .png, properties: [:]) {
+            try? png.write(to: URL(fileURLWithPath: output).appendingPathComponent("\(tag).png"))
+          }
+        }
+      }
+      show([question()])
+      await inspect("screenshot-options")
+      model.expanded = false
+      try? await Task.sleep(for: .milliseconds(40))
+      model.rows = [NotchRow(id: "changed", title: "Changed during collapse", child: false, busy: false, unread: false, ask: NotchAsk(id: "changed-ask", questions: [question(descriptions: 15)]))]
+      try? await Task.sleep(for: .milliseconds(80))
+      model.expanded = true
+      await inspect("new-content-during-collapse")
+      show([question(String(repeating: "这是正文，需要完整展示。", count: 25))])
+      await inspect("medium-markdown")
+      show([question("第一行\n\n第二行\n\n第三行")])
+      await inspect("short-markdown")
+      show([question(descriptions: 80)])
+      await inspect("long-options", overflowing: true)
+      model.maximumExpandedHeight = 400
+      await inspect("smaller-screen", overflowing: true)
+      model.maximumExpandedHeight = 800
+      show([question(String(repeating: "### 段落\n\n这是需要完整审核的计划正文。\n\n", count: 30))])
+      await inspect("long-markdown", overflowing: true)
+      show([question()])
+      await inspect("shrink-back")
+      model.rows = (0..<12).map { NotchRow(id: "task-\($0)", title: "任务 \($0)", child: false, busy: true, unread: false) }
+      await inspect("twelve-tasks")
+      show([question(), NotchQuestion(id: "other", question: "Another question", detail: String(repeating: "Long detail. ", count: 100))])
+      await inspect("short-page-before-long-page")
+      let ask = model.rows[0].ask!
+      model.goQuestion(ask: ask, sessionId: "offline", delta: 1)
+      await inspect("next-page")
+      model.goQuestion(ask: ask, sessionId: "offline", delta: -1)
+      await inspect("previous-page")
+      model.toggleCustomField(ask: ask, sessionId: "offline")
+      await inspect("custom-answer")
+      print("FAILURES=\(failures)")
+      exit(failures == 0 ? 0 : 1)
+    }
+    app.run()
+    withExtendedLifetime(subscriptions) {}
+  }
+}

package/macos/Tests/GeometryProbe.swift

@@ -0,0 +1,98 @@
+import AppKit
+import SwiftUI
+import Combine
+@main enum GeometryProbe {
+ @MainActor static func main() {
+  let app = NSApplication.shared
+  app.setActivationPolicy(.accessory)
+  let model = BoardModel()
+  model.maximumExpandedHeight = 460
+  let panel = NotchPanel(size: NSSize(width: 32,height:90))
+  let host = NotchHostingView(rootView: RootView(model:model,panelSize:CGSize(width:320,height:460),restSize:CGSize(width:32,height:110)))
+  host.sizingOptions = []
+  panel.embedHost(host)
+  panel.setFrame(NSRect(x:400,y:400,width:32,height:90),display:true)
+  panel.orderFrontRegardless()
+  var subscriptions = Set<AnyCancellable>()
+  Publishers.CombineLatest(model.$currentIslandWidth,model.$currentIslandHeight).receive(on:DispatchQueue.main).sink { w,h in
+   panel.resizeAnchored(to: NSSize(width:w,height:h))
+  }.store(in:&subscriptions)
+  var failures=0
+  func sample(_ tag:String) {
+   host.layoutSubtreeIfNeeded()
+   guard let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds) else { return }
+   host.cacheDisplay(in:host.bounds,to:rep)
+   let y=rep.pixelsHigh/2
+   var blacks=[Int]()
+   for x in 0..<rep.pixelsWide {
+    if let c=rep.colorAt(x:x,y:y)?.usingColorSpace(.deviceRGB),c.alphaComponent>0.9,c.redComponent<0.05,c.greenComponent<0.05,c.blueComponent<0.05 { blacks.append(x) }
+   }
+   let gap=rep.pixelsWide-1-(blacks.last ?? -1)
+   if abs(panel.frame.maxX - 432) > 0.01 { failures += 1 }
+   if gap>1 { failures += 1 }
+   if let corner=rep.colorAt(x:0,y:2), corner.alphaComponent > 0.1 { failures += 1; print("LEFT_CORNER_CLIPPED") }
+   print("\(tag) width=\(rep.pixelsWide) black=\(blacks.first ?? -1)...\(blacks.last ?? -1) rightGap=\(gap)")
+  }
+  Task { @MainActor in
+   try? await Task.sleep(for:.milliseconds(300));sample("rest")
+   for hover in [true,false,true,false] {
+    model.isPillHovered=hover
+    model.currentIslandWidth=hover ? 42:38
+    model.currentIslandHeight=hover ? 66:68
+    for i in 0..<10 {try? await Task.sleep(for:.milliseconds(20));sample("hover-\(hover)-\(i)")}
+   }
+   for hover in [true,false,true,false,true,false] {
+    model.isPillHovered=hover
+    try? await Task.sleep(for:.milliseconds(35));sample("rapid-hover")
+   }
+   for expanded in [true,false,true,false] {
+    model.expanded=expanded
+    for i in 0..<15 {try? await Task.sleep(for:.milliseconds(20));sample("expanded-\(expanded)-\(i)")}
+   }
+   for available in [100.0, 768.0, 1080.0, 1600.0] {
+    let layout = NotchScreenLayout(availableHeight: available)
+    if abs(layout.maximumHeight + 2 * layout.edgeInset - available) > 0.01 { failures += 1 }
+    if layout.maximumHeight <= 0 { failures += 1 }
+   }
+   @MainActor func setQuestion(description: String) {
+    let row: [String: Any] = ["id":"height-test", "title":"height test", "child":false, "busy":false, "unread":false, "ask":["id":"height-ask", "questions":[["id":"height-q", "question":"Height regression", "options":[["label":"Test option", "description":description]]]]]]
+    model.rows = [try! JSONDecoder().decode(NotchRow.self, from: JSONSerialization.data(withJSONObject:row))]
+   }
+   model.maximumExpandedHeight = 900
+   setQuestion(description: String(repeating: "Long content for measuring the expanded panel. ", count:100))
+   model.expanded = true
+   try? await Task.sleep(for:.milliseconds(500))
+   sample("long-content-900")
+   if abs(panel.frame.height - 900) > 1 { failures += 1; print("LONG_HEIGHT=\(panel.frame.height) EXPECTED=900") }
+   model.maximumExpandedHeight = 560
+   try? await Task.sleep(for:.milliseconds(500))
+   sample("screen-resized-560")
+   if abs(panel.frame.height - 560) > 1 { failures += 1; print("SCREEN_HEIGHT=\(panel.frame.height) EXPECTED=560") }
+   model.maximumExpandedHeight = 900
+   setQuestion(description:"Short content.")
+   try? await Task.sleep(for:.milliseconds(500))
+   sample("short-content")
+   if panel.frame.height >= 460 { failures += 1; print("SHORT_HEIGHT=\(panel.frame.height) EXPECTED<460") }
+   model.expanded=false
+   model.isPillHovered=false
+   for (busy,done,failed,expected) in [(1,0,0,44.0),(1,1,0,72.0),(1,0,1,72.0),(1,1,1,100.0),(0,1,0,44.0)] {
+    var rows: [[String:Any]] = []
+    if busy>0 { rows.append(["id":"busy", "title":"Busy", "child":false,"busy":true,"unread":false]) }
+    if done>0 { rows.append(["id":"done", "title":"Done", "child":false,"busy":false,"unread":true]) }
+    if failed>0 { rows.append(["id":"failed", "title":"Failed", "child":false,"busy":false,"unread":true,"lastTurn":["at":0,"kind":"error","failed":true]]) }
+    // Exercise the production snapshot entry point so lamp layout advances too.
+    model.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"offline",rows:try! JSONDecoder().decode([NotchRow].self,from:JSONSerialization.data(withJSONObject:rows))))
+    try? await Task.sleep(for:.milliseconds(1500))
+    sample("lamps-\(busy)-\(done)-\(failed)")
+    print("LAMP_HEIGHT=\(panel.frame.height) EXPECTED=\(expected)")
+    if abs(panel.frame.height-expected)>1 { failures += 1 }
+   }
+   print("HEIGHT=\(panel.frame.height)")
+   print("FAILURES=\(failures)")
+   exit(failures == 0 ? 0 : 1)
+  }
+  app.run()
+  withExtendedLifetime(subscriptions) {}
+  exit(failures == 0 ? 0 : 1)
+ }
+}

package/macos/Tests/IdleProbe.swift

@@ -0,0 +1,294 @@
+import AppKit
+import SwiftUI
+@main enum IdleProbe {
+ @MainActor static func main() {
+  let app=NSApplication.shared; app.setActivationPolicy(.accessory)
+  let output=URL(fileURLWithPath:ProcessInfo.processInfo.environment["NOTCH_IDLE_OUTPUT"] ?? NSTemporaryDirectory()).appendingPathComponent("notch-idle-proof")
+  try! FileManager.default.createDirectory(at:output,withIntermediateDirectories:true)
+  var failures=0
+  func check(_ ok:Bool,_ label:String){if !ok {failures += 1;print("FAIL \(label)")}}
+  for id in IdleDirector.basics + ["dance"] {
+   guard let clip=IdleLibrary.shared.clip(id) else {check(false,"resource \(id)");continue}
+   check(clip.frames.count > 100,"frames \(id)")
+   for frame in clip.frames {
+    check(frame.points.count == 192,"path topology")
+    check(frame.points.flatMap{$0}.allSatisfy{$0.isFinite},"finite geometry")
+    check(frame.points.allSatisfy{abs($0[0])*40/280 < 15 && abs($0[1])*40/280 < 21},"fits native bounds \(id)")
+   }
+   // Every intermediate outline must preserve area: a shifted SVG start index
+   // used to collapse the robot by joining unrelated boundary vertices.
+   func area(_ p:[[Double]]) -> Double {
+     abs(p.indices.reduce(0.0) { sum,i in
+       let a=p[i], b=p[(i+1)%p.count]
+       return sum + a[0]*b[1]-a[1]*b[0]
+     })/2
+   }
+   for i in 1..<clip.frames.count {
+     let a=clip.frames[i-1], b=clip.frames[i]
+     let mid=IdleInterpolation.mix(a,b,0.5)
+     check(area(mid.points) >= min(area(a.points),area(b.points))*0.98,"contour does not collapse \(id) frame \(i)")
+   }
+   // Interruption visuals from each action's non-neutral middle pose.
+   for step in 0...15 {
+    let visibility=step <= 10 ? 1-Double(step)/10 : 1
+    let suspect=["tilt":33,"scan":37,"balance":129,"sneeze":88,"stretch":72,"nod":64,"dance":612][id] ?? 60
+    let elapsed=step <= 10 ? 2.0 : (Double(suspect)+Double(step-13)*0.25)/clip.fps
+    let rendered=IdleInterpolation.sample(clip,at:elapsed*clip.fps)
+    let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[rendered]),elapsed:0,visibility:visibility,entering:false)
+      .frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
+    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:190)
+    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("\(id)-\(step).png"));panel.close()
+   }
+  }
+  for _ in 0..<100 {
+    check((5...10).contains(IdleDirector.restDuration()), "rest lasts 5–10 seconds")
+    let d=IdleDirector(),start=Date()
+    d.play("dance",at:start)
+    let duration=d.currentDuration
+    check((3...5).contains(duration), "chameleon lasts 3–5 seconds")
+    let end=d.frame(at:start.addingTimeInterval(duration))!
+    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
+    check(end.points == neutral.points && end.body == neutral.body, "chameleon returns continuously to neutral")
+    d.tick(start.addingTimeInterval(duration+0.001))
+    check(d.action == nil, "chameleon completes at sampled duration")
+    d.stop()
+  }
+  let ids = IdleDirector.basics + ["dance"]
+  for from in ids { for to in ids {
+    let director = IdleDirector()
+    let start = Date()
+    director.play(from, at:start)
+    let interrupt = start.addingTimeInterval(2.13)
+    let before = director.frame(at:interrupt)!
+    let previous=director.frame(at:interrupt.addingTimeInterval(-1.0/240))!
+    director.play(to, at:interrupt)
+    let after = director.frame(at:interrupt)!
+    check(before.points == after.points && before.body == after.body, "switch continuity \(from) -> \(to)")
+    check(zip(before.eyes,after.eyes).allSatisfy{$0.x == $1.x && $0.h == $1.h && $0.angle == $1.angle}, "eye continuity")
+    let dt=0.0001
+    let next=director.frame(at:interrupt.addingTimeInterval(dt))!
+    let error=after.points.indices.map { i in
+      hypot((next.points[i][0]-after.points[i][0])/dt-(before.points[i][0]-previous.points[i][0])*240,
+            (next.points[i][1]-after.points[i][1])/dt-(before.points[i][1]-previous.points[i][1])*240)
+    }.max()!
+    check(error < 1,"switch carries velocity \(from) -> \(to)")
+    director.stop()
+  }}
+  for entering in [false,true] {
+    let id=entering ? "cube-in":"satellite-out"
+    let clip=IdleLibrary.shared.clip(id)!
+    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
+    for i in 0...20 {
+      let t=Double(i)/20
+      let target=IdleInterpolation.sample(clip,at:t*clip.duration*clip.fps)
+      let sample=entering ? target:IdleInterpolation.mix(neutral,target,IdleInterpolation.smooth(t*clip.duration/0.22))
+      let visibility=entering ? IdleInterpolation.smooth(t/0.32):1-IdleInterpolation.smooth((t-0.65)/0.35)
+      let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[sample]),elapsed:0,visibility:visibility,entering:entering)
+        .frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
+      let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:190)
+      let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+      hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+      let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("\(id)-\(i).png"));panel.close()
+    }
+  }
+  for i in 0...16 {
+    let t=Double(i)/16,model=BoardModel()
+    model.rows=[NotchRow(id:"done",title:"done",child:false,busy:false,unread:true),NotchRow(id:"failed",title:"failed",child:false,busy:false,unread:true,lastTurn:NotchLastTurn(at:0,kind:"error",failed:true))]
+    let flight=StatusFlight(failed:false,startedAt:Date().addingTimeInterval(-t*StatusFlight.duration),busyBefore:1,destinationBefore:1,returnsToRunning:false)
+    model.statusFlight=flight
+    model.orbitLayout=OrbitLayout.flight(from:OrbitLayout(top:1,middle:1,bottom:1),to:OrbitLayout(top:1,middle:0,bottom:1),progress:t,flight:flight)
+    let view=RootView(model:model,panelSize:CGSize(width:320,height:460),restSize:CGSize(width:38,height:44))
+      .frame(width:38,height:model.orbitLayout.height+24).scaleEffect(3,anchor:.top)
+      .frame(width:160,height:340,alignment:.top).background(Color.gray.opacity(0.3))
+    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:340)
+    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("layout-\(i).png"));panel.close()
+  }
+  for i in 0...100 {
+    let t=Double(i)/100
+    let q=OrbitLayout.mix(OrbitLayout(middle:1),OrbitLayout(decision:1),IdleInterpolation.smooth(t))
+    check(abs(q.height-20)<0.00001,"single doing-to-decision keeps shell height")
+    check(abs(q.middleY-10)<0.00001,"single doing-to-decision stays at same center")
+  }
+  for i in 0...100 {
+    let q=OrbitLayout(top:1,middle:1,bottom:Double(i)/100)
+    check(q.bottomY+10 <= q.height+0.00001,"fading last disk stays within shrinking shell")
+  }
+  for distance in stride(from:0.0,through:20.0,by:0.1) {
+    check(StatusSeparation.opacity(weight:1,distance:distance)==0,"removed disk vanishes before contact")
+  }
+  check(StatusSeparation.opacity(weight:1,distance:28)==1,"separated disk starts fully visible")
+  let sleepClip=IdleLibrary.shared.clip("sleep")!
+  check(sleepClip.duration==9,"sleep includes four-second closed-eye plateau")
+  for t in [2.0,3.0,4.0,5.0] {
+    check(IdleInterpolation.sample(sleepClip,at:t*sleepClip.fps).eyes.allSatisfy{$0.h/$0.w<0.25},"sleep eyes remain closed for the hold")
+  }
+  let cube=IdleLibrary.shared.clip("cube-in")!
+  check(cube.frames.allSatisfy{$0.points.count==192 && $0.eyes.count==2},"cube keeps contour and eye slots across back-facing poses")
+  for i in 0...100 {
+    let departure=RobotDeparture(progress:Double(i)/100)
+    if departure.statusOpacity > 0 { check(departure.scale <= 0.061,"status cannot appear before robot reaches tiny point") }
+    if Double(i)/100*RobotDeparture.duration <= 0.666 { check(departure.statusScale <= 0.0001,"status remains a tiny point until colour handoff finishes") }
+  }
+  for i in 0...20 {
+    let t=Double(i)/20,departure=RobotDeparture(progress:t)
+    let model=BoardModel()
+    model.rows=[NotchRow(id:"ask",title:"local",child:false,busy:false,unread:false,ask:NotchAsk(id:"ask",questions:[]))]
+    model.orbitLayout=OrbitLayout(decision:1)
+    let clip=IdleLibrary.shared.clip("satellite-out")!
+    let target=IdleInterpolation.sample(clip,at:t*RobotDeparture.duration*clip.fps)
+    let neutral=IdleLibrary.shared.clip("blink")!.frames[0]
+    let frame=IdleInterpolation.mix(neutral,target,IdleInterpolation.smooth(t*RobotDeparture.duration/0.22))
+    let view=ZStack {
+      StatusOrbitView(model:model,workReveal:departure.statusScale).opacity(departure.statusOpacity)
+      IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[frame]),elapsed:0)
+        .frame(width:30,height:42).scaleEffect(departure.scale).opacity(departure.opacity)
+    }.frame(width:38,height:44).background(Color.black).scaleEffect(4).frame(width:180,height:200).background(Color.gray.opacity(0.2))
+    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:180,height:200)
+    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("tiny-handoff-\(i).png"));panel.close()
+  }
+  check(DecisionMorph(amount:0).trim==0.7 && DecisionMorph(amount:0).fill==0,"blue starts hollow with gap")
+  check(DecisionMorph(amount:1).trim==0 && DecisionMorph(amount:1).fill==1,"yellow ends closed and solid")
+  for text in ["!","1","3","8","12","99","100"] {
+    let bounds=CenteredStatusGlyph.path(text).boundingRect
+    check(abs(bounds.midX)<0.00001 && (text == "!" || abs(bounds.midY)<0.00001),"visible glyph ink centered: \(text)")
+    check(bounds.width<=12.00001,"multi-digit glyph fits the shared clipping width")
+  }
+  let step=0.000001
+  let penEndSpeed=(DecisionMorph(amount:0).trim-DecisionMorph(amount:step).trim)*2 * Double.pi/(step*DecisionMorph.resumeDuration)
+  check(abs(penEndSpeed-DecisionSpin.runningVelocity)<0.0001,"resume pen ends at running angular velocity")
+  let blueEndSpeed=(StatusBirth(progress:1).blueDraw-StatusBirth(progress:1-step).blueDraw)*2 * Double.pi*0.7/(step*(RobotDeparture.duration-0.666))
+  check(abs(blueEndSpeed-StatusBirth.bluePenVelocity)<0.0001,"birth pen hands its exact velocity to rotation")
+  for i in 25...99 {
+    let a=StatusBirth(progress:Double(i)/100).blueDraw,b=StatusBirth(progress:Double(i+1)/100).blueDraw
+    check(abs((b-a)-0.01/0.76)<0.00001,"blue appearance draws at constant speed")
+  }
+  check(DecisionClosing(amount:0.5).trim >= DecisionClosing(amount:0).trim,"09 must close the blue ring instead of erasing it")
+  for i in 0...100 {
+    let q=Double(i)/100,c=DecisionClosing(amount:q)
+    check(c.fill == 0 || c.trim > 0.99999,"09 fill waits for a closed ring")
+    if i>0 {check(c.trim>=DecisionClosing(amount:q-0.01).trim,"09 arc advances monotonically")}
+  }
+  let phaseModel=BoardModel()
+  var phaseRows=[NotchRow(id:"phase-a",title:"a",child:false,busy:true,unread:false),NotchRow(id:"phase-b",title:"b",child:false,busy:true,unread:false)]
+  phaseModel.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"test",rows:phaseRows))
+  check(abs(phaseModel.decisionVelocity(at:Date())-DecisionSpin.runningVelocity)<0.0001,"cold snapshot starts at normal speed")
+  phaseRows[0].busy=false;phaseRows[0].unread=true
+  phaseModel.applySnapshot(NotchSnapshot(ok:true,generatedAt:0,origin:"test",rows:phaseRows))
+  if let f=phaseModel.statusFlight {
+    let end=f.startedAt.addingTimeInterval(StatusFlight.duration)
+    let error=phaseModel.decisionAngle(at:end)-(f.angle+StatusFlight.duration*DecisionSpin.runningVelocity)
+    check(abs(sin(error/2))<0.001,"02 flight return and running ring must share phase")
+  } else { check(false,"completion repro starts flight") }
+  let epoch=Date()
+  let stop=DecisionSpin(began:epoch,angle:1.2,initialVelocity:DecisionSpin.runningVelocity,finalVelocity:0)
+  let reversal=epoch.addingTimeInterval(0.24)
+  let resume=DecisionSpin(began:reversal,angle:stop.position(at:reversal),initialVelocity:stop.velocity(at:reversal),finalVelocity:DecisionSpin.runningVelocity)
+  check(abs(stop.position(at:reversal)-resume.position(at:reversal))<0.00001,"reverse preserves ring position")
+  check(abs(stop.velocity(at:reversal)-resume.velocity(at:reversal))<0.00001,"reverse preserves ring velocity")
+  for i in 1...100 {
+    let a=epoch.addingTimeInterval(Double(i-1)/100),b=epoch.addingTimeInterval(Double(i)/100)
+    check(stop.position(at:b)>=stop.position(at:a),"ring never reverses while stopping")
+    check(resume.velocity(at:b)>=0,"ring resumes forward")
+  }
+  check(DecisionMorph(amount:0.64).flip < 0.00001,"number resolves before most of the brush is drawn")
+  check(DecisionMorph(amount:0.99).fill == 1,"disk supports the early symbol flip")
+  for i in 0...100 {
+    let m=DecisionMorph(amount:Double(i)/100)
+    check(m.draw == 0 || m.fill < 0.00001,"blue pen starts only after yellow fill clears")
+    let birth=StatusBirth(progress:Double(i)/100)
+    check(birth.draw == 0 || birth.travel > 0.99999,"pen reaches rim before drawing")
+    check(birth.fill == 0 || birth.draw > 0.99999,"yellow ring closes before filling")
+    check(birth.text == 0 || birth.draw > 0.99999,"text follows completed stroke")
+  }
+  for i in 0...12 {
+    let t=Double(i)/12
+    let view=WorkingDecisionGlyph(amount:t,number:3,angle:-Double.pi/2).scaleEffect(6).frame(width:160,height:160).background(Color.black)
+    let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:160)
+    let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+    hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+    let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("decision-flip-\(i).png"));panel.close()
+  }
+  for decision in [false,true] {
+    for i in 0...12 {
+      let view=StatusBirthGlyph(progress:Double(i)/12,decision:decision,number:3,angle:-Double.pi/2).scaleEffect(6).frame(width:160,height:160).background(Color.black)
+      let hosting=NSHostingView(rootView:view);hosting.frame=NSRect(x:0,y:0,width:160,height:160)
+      let panel=NSPanel(contentRect:hosting.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=hosting
+      hosting.layoutSubtreeIfNeeded();hosting.displayIfNeeded()
+      let rep=hosting.bitmapImageRepForCachingDisplay(in:hosting.bounds)!;hosting.cacheDisplay(in:hosting.bounds,to:rep)
+      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("birth-\(decision ? "yellow":"blue")-\(i).png"));panel.close()
+    }
+  }
+  for scale in [1.0,2.0,3.0] {
+    for kind in ["blue","green","red","yellow"] {
+      let model=BoardModel()
+      let ask=kind == "yellow" ? NotchAsk(id:"q",questions:[]):nil
+      let failed=kind == "red" ? NotchLastTurn(at:0,kind:"error",failed:true):nil
+      model.rows=[NotchRow(id:"a",title:"local",child:false,busy:kind == "blue",unread:kind == "green" || kind == "red",lastTurn:failed,ask:ask)]
+      model.orbitLayout=OrbitLayout(top:kind == "green" ? 1:0,middle:kind == "blue" ? 1:0,bottom:kind == "red" ? 1:0,decision:kind == "yellow" ? 1:0)
+      let view=StatusOrbitView(model:model,reduceMotionOverride:true).frame(width:60,height:120).scaleEffect(scale).frame(width:60*scale,height:120*scale).background(Color.black)
+      let host=NSHostingView(rootView:view);host.frame=NSRect(x:0,y:0,width:60*scale,height:120*scale)
+      let panel=NSPanel(contentRect:host.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=host
+      host.layoutSubtreeIfNeeded();host.displayIfNeeded()
+      let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds)!;host.cacheDisplay(in:host.bounds,to:rep)
+      try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("alignment-\(kind)-\(Int(scale)).png"));panel.close()
+    }
+  }
+  let tourDirector=IdleDirector(),tourStart=Date()
+  tourDirector.play("dance",at:tourStart)
+  let end=tourDirector.currentDuration
+  for (i,t) in [0.0,0.10,0.25,0.45,2.0,end-0.45,end-0.20,end,end+0.15,end+0.37].enumerated() {
+    let now=tourStart.addingTimeInterval(t)
+    if t >= end {tourDirector.tick(now)}
+    let frame=tourDirector.displayFrame(at:now)!
+    let view=IdleRobotCanvas(clip:IdleClip(fps:1,duration:7,frames:[frame]),elapsed:0).frame(width:30,height:42).scaleEffect(4).frame(width:180,height:190).background(Color.black)
+    let host=NSHostingView(rootView:view);host.frame=NSRect(x:0,y:0,width:180,height:190)
+    let panel=NSPanel(contentRect:host.frame,styleMask:[.borderless],backing:.buffered,defer:false);panel.contentView=host
+    host.layoutSubtreeIfNeeded();host.displayIfNeeded()
+    let rep=host.bitmapImageRepForCachingDisplay(in:host.bounds)!;host.cacheDisplay(in:host.bounds,to:rep)
+    try! rep.representation(using:.png,properties:[:])!.write(to:output.appendingPathComponent("tour-dance-\(i).png"));panel.close()
+  }
+  tourDirector.stop()
+  var closures=0
+  for i in 1..<3000 {
+    if IdleDirector.blinkClosure(at:Double(i)/100)>0.9 && IdleDirector.blinkClosure(at:Double(i-1)/100)<=0.9 { closures+=1 }
+  }
+  check(closures >= 5 && closures <= 9,"natural blinks recur independently of gestures")
+  for failed in [false,true] {
+    let flight=StatusFlight(failed:failed,startedAt:Date(),busyBefore:1,destinationBefore:1,returnsToRunning:false)
+    let initial=OrbitLayout(top:1,middle:1,bottom:1),final=OrbitLayout(top:1,middle:0,bottom:1)
+    var previous=initial
+    for i in 0...160 {
+      let layout=OrbitLayout.flight(from:initial,to:final,progress:Double(i)/160,flight:flight)
+      check(abs((layout.bottomY-previous.bottomY)-(layout.height-previous.height)) < 0.00001,"red disk and shell share displacement")
+      check(abs(layout.bottomY-previous.bottomY)<2,"no last-task layout snap")
+      previous=layout
+    }
+    check(previous==final,"last task settles into exact two-light layout")
+  }
+  let director=IdleDirector(),presence=IdlePresence()
+  presence.set(true,director:director,animated:false)
+  director.play("hop")
+  presence.set(false,director:director)
+  check(director.action == nil,"work cancels idle immediately")
+  let frozen=presence.frozenID
+  RunLoop.current.run(until:Date().addingTimeInterval(0.1))
+  let before=presence.visibility
+  presence.set(true,director:director)
+  check(presence.visibility==before && presence.frozenID==frozen,"reverse retains geometry")
+  RunLoop.current.run(until:Date().addingTimeInterval(1.2))
+  check(presence.visibility == 1,"reverse finishes idle")
+  presence.stop();director.stop()
+  print("FAILURES=\(failures)");exit(failures==0 ? 0:1)
+ }
+}