chanora/CHANGELOG.md

Changelog

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

This project follows a Conventional Commits style workflow.

[v0.3.0] — Cross-platform voice client baseline

The v0.3.0 milestone transitions Chanora from an internal-beta voice prototype to a cross-platform baseline client with event-driven UI, per-user audio controls, non-self client info parity, and CI-hardened Android / iOS / macOS / Linux builds.

Added

• Event-driven UI replaces timer-based snapshot polling. Protocol deltas (client join/leave/move/update, channel add/remove/update) flow through a typed ProtocolDelta enum and update the Flutter UI in real time. Channel switching is instant.
• Per-user volume controls. Each client in the snapshot gets an independent volume slider persisted in the bridge layer. Avatar badges show muted/deafened state. Volume adjustments take effect immediately on the audio mix.
• Non-self client info parity with Qint. The Info tab now populates connection metadata (name, description, created, last connected, connections, transfer, ping deviation) for other clients via an explicit ClientProfileRefreshPlan that fetches connectioninfo and recent text messages with a bounded timeout.
• Ping deviation in client profiles. ping_deviation_milliseconds propagated from protocol DTO through bridge API to Dart, with a conditional l10n row in the client info sheet (en + zh).
• Apple CoreML Silero VAD as the preferred voice activity detector on iOS / macOS when the private silero-coreml SwiftPM submodule is available. WebRTC VAD remains the runtime fallback.
• TeamSpeak address resolver (chanora_resolver) for DNS SRV lookups and ts3server:// URI handling.
• Per-ABI Android APK splitting. flutter build apk --split-per-abi produces separate arm64-v8a / armeabi-v7a / x86_64 APKs instead of a single fat APK.
• Cross-platform CI (GitHub Actions): cargo check + test, cargo deny, cargo about license inventory, flutter analyze, flutter test, flutter iOS unsigned release build. All gates must pass before merge.
• Diagnostic recording. Bridge events, audio interruptions, and Rust-level log entries are captured into an in-memory ring buffer accessible from the diagnostics page.
• Shared app snackbar styling for consistent error/info feedback.

Changed

• iOS / macOS audio lifecycle hardened. Voice unit restart-in-place, serialized lifecycle events, WebRTC VAD on iOS, unblocked connect-time audio startup.
• Linux native audio path promoted with ONNX Runtime bundled for VAD. Desktop voice I/O works on PipeWire / PulseAudio.
• Android audio routing uses MODE_IN_COMMUNICATION, proper startup permission flow, and system back-button integration.
• SnapshotChanged event removed. Replaced by the typed delta stream. The dead variant was removed end-to-end (protocol, bridge, Flutter).
• Prefetch crate renamed from the PoC-era name to chanora_prefetch. All docs, specs, and code updated.
• Build number bumped to 76.
• Flutter bridge regenerated for flutter_rust_bridge 2.12.0.

Fixed

• clamp panic on Info tab open. adapter.rs cast i64::MIN to u128 before clamping, producing min > max. Replaced with .min(i64::MAX as u128) as i64.
• Non-self client profiles empty. Added request_client_db_info() with graceful fallback for missing fields.
• Server query clients visible in UI. Delta joins now filter is_server_query clients from the channel tree.
• Speaking indicators lost after reconnect. Event forwarders are reattached after the connection task restarts.
• Channel double-tap join. 1-second cooldown prevents rapid re-join attempts.
• getconnectioninfo errors silently discarded. Now logged at warning level instead.
• iOS keyboard lag. Multiple focus/tap handling fixes for iOS 26 TextField stale-focus regression.
• Storage test isolation. Temp directories no longer collide across parallel test runs.
• CI submodule fetch. iOS build job uses best-effort git submodule update with || true fallback for the private silero-coreml package.
• Stale license inventory. Regenerated docs/security/license- inventory.md to match current Cargo.lock.

Notes

• The silero-coreml submodule references a private repository (chanoraapp/silero-coreml). CI builds skip the iOS unsigned build when the submodule is unavailable.
• Default base branch is main (previously product/scaffold-v0).
• DSP chain (AEC / AGC / NS / HPF) is not yet production-tuned. AudioEffects struct exists but filters are placeholder-grade.
• Desktop push-to-talk is capability-based; global PTT requires OS-specific permissions and is not yet wired end-to-end in the UI.

[v0.2.0-beta.1] — Internal Beta first build

• Voice in/out wired end-to-end through the Flutter UI. Per DEC-001 this reaches the Internal Beta milestone.
• crates/chanora_audio/ promoted from scaffold to working engine: cpal capture (mic gain, linear resampling to 48 kHz, mono down-mix) and playback (48 kHz stereo). Opus VoIP encoding (20 ms frames). Push-to-talk gate. Live counters.
• crates/chanora_protocol/ extended with voice channels.
• core/chanora_core::ChanoraSession audio API.
• crates/chanora_bridge/ audio surface for Dart.
• Beta UI rewrite with connect, PTT, and audio stats.

Notes

• DSP chain not yet implemented (AEC / AGC / NS / HPF deferred).
• Capture resampler is linear interpolation (production resampler deferred).
• Identity is ephemeral per connect; persistence deferred.
• No live event stream — UI polls on timer.
• chanora_diagnostics still scaffold.
• Audio engine is desktop-only in this build.

[v0.1.0-alpha.1] — Internal Alpha

• First Alpha build wires connect → snapshot → disconnect end-to-end from the Flutter UI to a live TeamSpeak-compatible server via the typed Flutter/Rust bridge.
• crates/chanora_protocol/ promoted from scaffold to working adapter.
• crates/chanora_bridge/ wired against flutter_rust_bridge 2.12.0.
• Alpha UI: server address form, connect button, snapshot view.

Versioning note

The project implementation has not reached a public release version yet.