0 Fork 0

Files

T

james.maes a6f91e6b73 fix(bus,hud): v0.1 S1 cluster — webview didFail + menu-bar icon transition (#40 , #41 , #151 )

#40: BridgeNavigationDelegate gains onDidFail closure (covers didFailProvisionalNavigation + didFail). WebviewBridge.failHandshake(reason:) transitions to new terminal .loadFailed state, cancels pending 2s timeout, fires existing alertPresenter, idempotent. AppDelegate.handleWebviewLoadFailure dual-surfaces: failHandshake + critical non-dismissible banner (defense-in-depth across test seams). WebviewBootHealthProbe gets .loadFailed case.

#41: HudStateCoordinator emit closure now ALSO calls menuBarController.transition(to:) in addition to bridge.send(.hudState(...)). Doc-comment correctly notes this is not a HUD-08 single-writer violation — transition writes currentState, not BusOutbound.hudState. scripts/check-single-writer-hudstate.sh still green.

Tests: 4 new Handshake cases (load-failure-from-sentHello with alert-not-duplicated, from-idle, idempotency, post-armed no-op), BridgeNavigationFailureTests end-to-end + per-arm, MenuBarIconStateTransitionTests drives dormantAgentContinuation and asserts .thinking → .speaking → .idle. 62/62 Bus pass; all 18 boundary gates green.

2026-05-13 06:29:34 -05:00

Sources/Bus

fix(bus,hud): v0.1 S1 cluster — webview didFail + menu-bar icon transition (#40 , #41 , #151 )

2026-05-13 06:29:34 -05:00

Tests/BusTests

fix(bus,hud): v0.1 S1 cluster — webview didFail + menu-bar icon transition (#40 , #41 , #151 )

2026-05-13 06:29:34 -05:00

Package.swift

feat(05-05): App-level MCPRuntimeWiring + ME-04 channel + SEC-07 observer

2026-04-25 14:57:01 -05:00

README.md

docs(packages): per-package README files

2026-05-04 17:13:33 -05:00

README.md

Bus

Typed Swift↔JS message protocol over WKScriptMessageHandler. The webview is a pure rendering layer; this package is the only legitimate way Swift talks to the HUD and back.

Key public types

Type	Purpose
`BusOutbound` (enum)	Messages Swift→JS — `hello`, `hudState`, `tokenDelta`, `audioLevel`, `toolCallStart/End`, `turnStarted/Ended`, `sessionHistory`
`BusInbound` (enum)	Messages JS→Swift — `helloAck`, `uiReady`, `frameAttachRequested`, `chatSubmit`, `chatCancelAndSubmit`
`OutboundBatcher` (actor)	Coalesces `tokenDelta` on a 32 ms tick; forwards everything else immediately
`WebviewBridge`	The `WKScriptMessageHandler` boundary (the only place that calls `evaluateJavaScript`)
`Handshake`	Version-negotiation flow on first `uiReady`
`BusReply` / `BusError`	Reply + error types for request/response patterns

Depends on

Logging. External: swift-log.

Used by

App/AppDelegate, every subsystem that emits to the HUD, the webview-side TS package webview/packages/bus.

Key invariants / contracts

Hand-written Codable. Both BusOutbound and BusInbound declare Codable in extensions with explicit init(from:) / encode(to:). Swift's synthesized Codable would produce {"hudState": {"_0": "idle"}} instead of {"type":"hudState","state":"idle"}. Adding a case without updating both methods is a compile error — schema-drift preventer at the language level.
Schema version sync. Protocol.swift carries the version; webview/packages/bus/src/version.ts carries the TS mirror. scripts/check-bus-protocol-version.sh requires both to match.
Harness parity. scripts/check-bus-harness-parity.sh requires the TS bus fixtures to round-trip through the Swift decoder.
No evaluateJavaScript outside WebviewBridge. Grep-gated by scripts/check-no-evaluate-javascript.sh.
Single writer to HudState. scripts/check-single-writer-hudstate.sh enforces.

Tests

58 XCTest. Round-trip encoding tests, version-negotiation tests, batcher coalescing tests, content-world isolation tests (WebviewBridgeOutboundTests asserts WKContentWorld.page).

Notable files

Sources/Bus/BusOutbound.swift — Swift→JS event union + hand-written Codable
Sources/Bus/BusInbound.swift — JS→Swift event union + hand-written Codable
Sources/Bus/OutboundBatcher.swift — token-coalescing actor
Sources/Bus/WebviewBridge.swift — WKScriptMessageHandler boundary
Sources/Bus/Protocol.swift — version constant