Edison Jwa
dd6e80f72a
- function-inventory: complete public API for 10 Rust crates + 56 Dart files - coverage-analysis: 312 Rust tests, 221 Dart tests, doc coverage gaps - doc-quality-analysis: duplications, broken refs, useless content audit - link-coverage-report: all internal/external links validated - external/teaspeak: TeaSpeak voice server architecture & protocol - external/respeak: ReSpeak org, tsclientlib, tsproto, crypto docs - external/yatqa-en/de: yat.qa admin tool (English + German) - reviews/: cross-validation reports for all analyses All documentation only, no code changes.
376 lines
18 KiB
Markdown
376 lines
18 KiB
Markdown
# Test & Document Coverage Analysis
|
|
|
|
**Generated:** 2026-06-13
|
|
**Scope:** All crates, Flutter app, and docs/ directory
|
|
|
|
---
|
|
|
|
## Test Coverage Summary
|
|
|
|
| Metric | Count |
|
|
|--------|-------|
|
|
| Total Rust tests (inline `#[test]`) | 312 |
|
|
| Total Rust integration tests | 2 |
|
|
| Total Dart tests (`test()` + `testWidgets()`) | 221 |
|
|
| Crates with tests | 7/9 |
|
|
| Dart services with tests | 19/21 (90%) |
|
|
| Dart widgets with tests | 13/24 (58%) |
|
|
| Overall estimated coverage | ~65% |
|
|
|
|
---
|
|
|
|
## Per-Crate Test Coverage (Rust)
|
|
|
|
### chanora_audio — 221 tests, ~48% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| engine.rs | ~45 | 7 | ~16% |
|
|
| ptt_backends/windows.rs | ~80 | 44 | ~55% |
|
|
| ptt_backends/windows_keymap.rs | ~30 | 12 | ~40% |
|
|
| ptt_backends/macos.rs | ~35 | 12 | ~34% |
|
|
| ptt_backends/linux.rs | ~25 | 10 | ~40% |
|
|
| ptt_backends/mod.rs | ~15 | 1 | ~7% |
|
|
| transmit_selector.rs | ~20 | 10 | ~50% |
|
|
| voice_activity.rs | ~15 | 9 | ~60% |
|
|
| voice_render.rs | ~15 | 9 | ~60% |
|
|
| mobile_voice_backend.rs | ~20 | 9 | ~45% |
|
|
| processor/sonora.rs | ~15 | 8 | ~53% |
|
|
| processor/dsp/agc2.rs | ~10 | 6 | ~60% |
|
|
| mode_stack.rs | ~10 | 6 | ~60% |
|
|
| opus_voice.rs | ~10 | 5 | ~50% |
|
|
| capture_accumulator.rs | ~8 | 5 | ~63% |
|
|
| processor/dsp/ns.rs | ~8 | 4 | ~50% |
|
|
| ptt.rs | ~8 | 4 | ~50% |
|
|
| vad/mod.rs | ~6 | 4 | ~67% |
|
|
| audio_processing.rs | ~8 | 3 | ~38% |
|
|
| debug_wav.rs | ~6 | 3 | ~50% |
|
|
| processor/dsp/hpf.rs | ~5 | 3 | ~60% |
|
|
| processor/dsp/aec3.rs | ~5 | 3 | ~60% |
|
|
| transmit_mode.rs | ~4 | 3 | ~75% |
|
|
| android_render_ring.rs | ~5 | 3 | ~60% |
|
|
| vad/resampler.rs | ~4 | 3 | ~75% |
|
|
| vad/apple_coreml.rs | ~5 | 3 | ~60% |
|
|
| vad/silero_onnx.rs | ~10 | 6 | ~60% |
|
|
| render_reference.rs | ~8 | 7 | ~88% |
|
|
| capture_resampler.rs | ~3 | 2 | ~67% |
|
|
| audio_event_queue.rs | ~4 | 2 | ~50% |
|
|
| processor/webrtc_apm.rs | ~5 | 2 | ~40% |
|
|
| frame.rs | ~3 | 1 | ~33% |
|
|
| lib.rs (defaults) | ~5 | 1 | ~20% |
|
|
| release_tail.rs | ~4 | 1 | ~25% |
|
|
| route_policy.rs | ~8 | 8 | ~100% |
|
|
| **Integration: tests/ptt_privacy.rs** | — | 1 | — |
|
|
| **Integration: tests/linux_portal_smoke.rs** | — | 1 | — |
|
|
|
|
### chanora_protocol — 17 tests, ~18% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| adapter.rs | ~80 | 13 | ~16% |
|
|
| poke_limiter.rs | ~17 | 4 | ~24% |
|
|
| dto.rs | ~0 | 0 | — |
|
|
| lib.rs | ~0 | 0 | — |
|
|
|
|
**Untested areas:** Message parsing, serialization, most adapter methods
|
|
|
|
### chanora_state — 27 tests, ~46% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~35 | 18 | ~51% |
|
|
| channel_join.rs | ~24 | 9 | ~38% |
|
|
|
|
### chanora_storage — 15 tests, ~24% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~62 | 15 | ~24% |
|
|
|
|
**Untested areas:** Migration logic, concurrent access patterns, error recovery
|
|
|
|
### chanora_resolver — 12 tests, ~17% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~70 | 12 | ~17% |
|
|
| examples/cli.rs | — | 1 | — |
|
|
|
|
**Untested areas:** DNS failure modes, timeout handling, cache behavior
|
|
|
|
### chanora_diagnostics — 19 tests, ~26% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~74 | 19 | ~26% |
|
|
|
|
### chanora_core — 11 tests, ~7% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~140 | 10 | ~7% |
|
|
| network_diagnostics.rs | ~7 | 1 | ~14% |
|
|
|
|
**Untested areas:** Connection lifecycle, server event handling, most state transitions
|
|
|
|
### chanora_bridge — 0 tests, 0% function coverage
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| api.rs | ~200+ | 0 | 0% |
|
|
| frb_generated.rs | ~100+ | 0 | 0% |
|
|
| permission_jni.rs | ~10 | 0 | 0% |
|
|
| android_init.rs | ~5 | 0 | 0% |
|
|
| lib.rs | ~4 | 0 | 0% |
|
|
|
|
**Note:** chanora_bridge is an FFI/bridge layer; testing requires integration with Flutter.
|
|
|
|
### chanora_cache — 0 tests
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~16 | 0 | 0% |
|
|
|
|
### chanora_prefetch — 0 tests
|
|
|
|
| Source File | Functions | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| lib.rs | ~18 | 0 | 0% |
|
|
|
|
---
|
|
|
|
## Per-Module Test Coverage (Dart/Flutter)
|
|
|
|
### Services — 155 tests across 19 test files
|
|
|
|
| Source File | Test File | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| android_audio_output_devices.dart | ✅ android_audio_output_devices_test.dart | 2 | Tested |
|
|
| android_permissions_service.dart | ✅ android_permissions_service_test.dart | 14 | Tested |
|
|
| app_bootstrap.dart | ✅ app_bootstrap_test.dart | 4 | Tested |
|
|
| audio_lifecycle_service.dart | ✅ audio_lifecycle_service_test.dart | 4 | Tested |
|
|
| back_intent_policy.dart | ✅ back_intent_policy_test.dart | 9 | Tested |
|
|
| back_intent_service.dart | ✅ back_intent_service_test.dart | 5 | Tested |
|
|
| channel_join_error_mapper.dart | ✅ channel_join_error_mapper_test.dart | Tested |
|
|
| channel_spacer.dart | ✅ channel_spacer_test.dart | 9 | Tested |
|
|
| connection_phase_state.dart | ✅ connection_phase_state_test.dart | 8 | Tested |
|
|
| hard_mute_owners.dart | ✅ hard_mute_owners_test.dart | 3 | Tested |
|
|
| ios_audio_session_controller.dart | ✅ ios_audio_session_controller_test.dart | 6 | Tested |
|
|
| macos_permissions_service.dart | ✅ macos_permissions_service_test.dart | 20 | Tested |
|
|
| poke_active_chat.dart | ✅ poke_active_chat_test.dart | 2 | Tested |
|
|
| poke_notification_service.dart | ✅ poke_notification_service_test.dart | 2 | Tested |
|
|
| poke_preferences_service.dart | ✅ poke_preferences_service_test.dart | 4 | Tested |
|
|
| prefetch_debouncer.dart | ✅ prefetch_debouncer_test.dart | 3 | Tested |
|
|
| snapshot_state_mapper.dart | ✅ snapshot_state_mapper_test.dart | 7 | Tested |
|
|
| ts3_server_link.dart | ✅ ts3_server_link_test.dart | 3 | Tested |
|
|
| ui_preferences_service.dart | ✅ ui_preferences_service_test.dart | 5 | Tested |
|
|
| voice_join_ordering.dart | ✅ voice_join_ordering_test.dart | 4 | Tested |
|
|
| **ios_permissions_service.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **link_trust_service.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
|
|
### Widgets — 66 tests across 13 test files
|
|
|
|
| Source File | Test File | Tests | Coverage |
|
|
|-------------|-----------|-------|----------|
|
|
| app_snack_bar.dart | ✅ app_snack_bar_test.dart | 1 | Tested |
|
|
| audio_processing_config_state.dart | ✅ audio_processing_config_state_test.dart | 8 | Tested |
|
|
| bbcode_text.dart | ✅ bbcode_text_test.dart | Tested |
|
|
| chat_panel.dart | ✅ chat_panel_test.dart | Tested |
|
|
| chat_views.dart | ✅ chat_views_test.dart | 18 | Tested |
|
|
| client_info_sheet.dart | ✅ client_info_sheet_test.dart | Tested |
|
|
| poke_notification_settings.dart | ✅ poke_notification_settings_test.dart | Tested |
|
|
| snapshot_view.dart | ✅ snapshot_view_test.dart | Tested |
|
|
| talk_power_warning.dart | ✅ talk_power_warning_test.dart | 1 | Tested |
|
|
| voice_compact.dart | ✅ voice_compact_test.dart | Tested |
|
|
| voice_settings_controls.dart | ✅ voice_settings_controls_test.dart | 6 | Tested |
|
|
| voice_status_summary.dart | ✅ voice_status_summary_test.dart | 5 | Tested |
|
|
| mobile_ui_resilience.dart | ✅ mobile_ui_resilience_test.dart | Tested |
|
|
| **audio_debug_stats_panel.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **audio_device_list_tile.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **audio_output_tile.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **connect_widgets.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **input_dialogs.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **permission_state_banner.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **ptt_capability_badge.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **voice_bar.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **voice_haptics.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **voice_level_meter.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **voice_platform.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
| **voice_settings.dart** | ❌ No test file | 0 | **UNTESTED** |
|
|
|
|
### E2E Tests
|
|
|
|
| File | Tests | Notes |
|
|
|------|-------|-------|
|
|
| alpha_e2e_test.dart | 1 | End-to-end integration |
|
|
| beta_e2e_test.dart | 1 | End-to-end integration |
|
|
| widget_test.dart | — | Default Flutter template |
|
|
|
|
---
|
|
|
|
## Document Coverage Summary
|
|
|
|
| Metric | Count |
|
|
|--------|-------|
|
|
| Total doc files (under docs/) | 55 |
|
|
| Modules documented | ~15 areas |
|
|
| Estimated outdated docs | 3-5 |
|
|
|
|
## Document Inventory
|
|
|
|
### Architecture (4 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| architecture/sad.md | Software Architecture Document | Current | 190 lines, references SDD |
|
|
| architecture/sdd.md | Software Design Document | Current | 161 lines |
|
|
| architecture/sysdes.md | System Design overview | Current | 21 lines, brief |
|
|
| architecture/desktop-ptt-architecture.md | Desktop PTT subsystem design | Current | 43 lines |
|
|
| architecture/file-transfer-design.md | File transfer feature design | Current | 737 lines |
|
|
| architecture/file-transfer-research.md | File transfer research | Current | 770 lines |
|
|
| architecture/file-transfer-implementation-plan.md | File transfer implementation plan | Current | 1315 lines |
|
|
|
|
### Requirements (2 files + 2 symlinks)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| requirements/srs.md | Software Requirements Spec | Current | 22 lines (pointer) |
|
|
| requirements/sysrs.md | System Requirements Spec | Current | 22 lines (pointer) |
|
|
| srs.md | SRS (full) | Current | 2850 lines |
|
|
| sysrs.md | SysRS (full) | Current | 2014 lines |
|
|
|
|
### Verification (5 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| verification/verification-master-plan.md | Overall V&V plan | Current | 91 lines |
|
|
| verification/swe4-unit-verification-plan.md | Unit test plan | Current | 60 lines |
|
|
| verification/swe5-software-integration-verification-plan.md | Integration test plan | Current | 71 lines |
|
|
| verification/swe6-software-verification-plan.md | System verification plan | Current | 62 lines |
|
|
| verification/sys4-system-integration-verification-plan.md | System integration plan | Current | 58 lines |
|
|
|
|
### Security (7 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| security/threat-model.md | Threat model | Current | 33 lines |
|
|
| security/license-inventory.md | Rust license inventory | Current | 10970 lines |
|
|
| security/flutter-license-inventory.md | Flutter license inventory | Current | 5477 lines |
|
|
| security/diagnostic-redaction-audit-report.md | Diagnostic redaction audit | Current | 31 lines |
|
|
| security/secure-storage-audit-report.md | Secure storage audit | Current | 31 lines |
|
|
| security/dependency-and-supply-chain-report.md | Dependency audit | Current | 43 lines |
|
|
| security/security-privacy-legal-guideline.md | Security/privacy guidelines | Current | 63 lines |
|
|
|
|
### Governance (11 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| governance/document-index.md | Document catalog | Current | 36 lines |
|
|
| governance/document-naming-convention.md | Naming conventions | Current | 33 lines |
|
|
| governance/document-review-report.md | Review report | Current | 37 lines |
|
|
| governance/traceability-matrix.md | Requirements traceability | Current | 73 lines |
|
|
| governance/product-decision-register.md | Decision log | Current | 25 lines |
|
|
| governance/decision-impact-assessment.md | Impact assessment | Current | 18 lines |
|
|
| governance/git-commit-message-convention.md | Commit conventions | Current | 21 lines |
|
|
| governance/path-migration-map.md | Path migration plan | Current | 18 lines |
|
|
| governance/repo-format-validation-report.md | Format validation | Current | 22 lines |
|
|
| governance/baseline-candidate-validation-report.md | Baseline validation | Current | 38 lines |
|
|
| governance/baseline-approval-record.md | Baseline approval | Current | 32 lines |
|
|
| governance/maintainability-review-2026-06-08.md | Maintainability review | Current | 99 lines |
|
|
|
|
### Release (4 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| release/ios-build.md | iOS build instructions | Current | 47 lines |
|
|
| release/platform-release-policy.md | Release policy | Current | 26 lines |
|
|
| release/release-readiness-go-nogo-record.md | Go/no-go record | Current | 105 lines |
|
|
| release/dv-waiver-register.md | DV waiver register | Current | 36 lines |
|
|
|
|
### UI/UX (4 files)
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| ui-ux/material3-guideline.md | Material 3 guidelines | Current | 8 lines (brief) |
|
|
| ui-ux/material3-design-tokens.md | Design tokens | Current | 21 lines |
|
|
| ui-ux/material3-component-catalog.md | Component catalog | Current | 38 lines |
|
|
| ui-ux/adaptive-layout-platform-guide.md | Adaptive layout guide | Current | 27 lines |
|
|
|
|
### Other
|
|
|
|
| File | Topic | Status | Notes |
|
|
|------|-------|--------|-------|
|
|
| privacy/privacy-policy.md | Privacy policy | Current | 51 lines |
|
|
| references/external-references.md | External references | Current | 21 lines |
|
|
| references/aspice-swe2-swe3-integration-note.md | ASPICE integration note | Current | 28 lines |
|
|
| legal/trademark-and-attribution-review.md | Trademark review | Current | 47 lines |
|
|
| i18n/localization-architecture.md | Localization architecture | Current | 44 lines |
|
|
| implementation-status-2026-05-28.md | Implementation status | **Possibly outdated** | Date is 2026-05-28 |
|
|
| material3-guideline.md | Material 3 guideline (duplicate) | Current | 93 lines |
|
|
|
|
### Superpowers Plans & Specs (13 files)
|
|
|
|
| File | Topic | Status |
|
|
|------|-------|--------|
|
|
| superpowers/plans/2026-05-28-server-resolution-prefetch.md | Server resolution prefetch plan | Current |
|
|
| superpowers/plans/2026-05-28-chanora-server-prefetch-crate.md | Prefetch crate plan | Current |
|
|
| superpowers/plans/2026-05-29-dv-evidence-pack.md | DV evidence pack plan | Current |
|
|
| superpowers/plans/2026-05-29-state-sync-ui-settings-validation.md | State sync validation plan | Current |
|
|
| superpowers/plans/2026-05-29-swe2-swe3-baselines.md | SWE2/SWE3 baselines plan | Current |
|
|
| superpowers/plans/2026-05-29-finish-dv-document-tree.md | DV document tree plan | Current |
|
|
| superpowers/plans/2026-06-06-chat-panel-switching.md | Chat panel switching plan | Current |
|
|
| superpowers/plans/2026-06-08-maintainability-continuation.md | Maintainability continuation | Current |
|
|
| superpowers/plans/2026-06-08-core-internal-split.md | Core internal split plan | Current |
|
|
| superpowers/specs/2026-05-28-server-resolution-prefetch-design.md | Prefetch design spec | Current |
|
|
| superpowers/specs/2026-05-28-chanora-server-prefetch-crate-design.md | Prefetch crate design | Current |
|
|
| superpowers/specs/2026-05-29-state-sync-ui-settings-validation-design.md | State sync design | Current |
|
|
| superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | Adaptive layout design | Current |
|
|
| superpowers/specs/2026-06-08-maintainability-continuation-design.md | Maintainability design | Current |
|
|
| superpowers/specs/2026-06-09-poke-without-message-design.md | Poke without message design | Current |
|
|
|
|
---
|
|
|
|
## Documentation Gaps
|
|
|
|
The following code modules have **no dedicated documentation**:
|
|
|
|
| Module | Functions | Gap Description |
|
|
|--------|-----------|-----------------|
|
|
| `chanora_audio` (engine) | ~45 | No architecture doc for audio engine internals |
|
|
| `chanora_audio` (VAD subsystem) | ~25 | VAD pipeline, model loading, fallback strategy undocumented |
|
|
| `chanora_audio` (DSP processors) | ~30 | AEC3, AGC2, NS, HPF configuration undocumented |
|
|
| `chanora_audio` (PTT backends) | ~155 | Platform-specific PTT behavior undocumented |
|
|
| `chanora_bridge` (FFI layer) | ~300 | Flutter-Rust bridge API contract undocumented |
|
|
| `chanora_cache` | ~16 | Cache strategy, eviction policy undocumented |
|
|
| `chanora_prefetch` | ~18 | Prefetch timing, debouncing strategy undocumented |
|
|
| `chanora_core` | ~147 | Core connection lifecycle, event handling undocumented |
|
|
| `chanora_state` | ~59 | State machine transitions, delta emission undocumented |
|
|
| `chanora_storage` | ~62 | Storage format, migration strategy undocumented |
|
|
| `chanora_protocol` | ~97 | Protocol message format, adapter logic undocumented |
|
|
| `chanora_resolver` | ~70 | DNS resolution, TSDNS discovery undocumented |
|
|
| `chanora_diagnostics` | ~74 | Diagnostic collection, redaction rules undocumented |
|
|
| Flutter services layer | ~21 files | No service-layer architecture doc |
|
|
| Flutter widgets layer | ~24 files | No widget catalog or component doc |
|
|
| Localization (l10n) | — | Translation workflow undocumented (only architecture doc exists) |
|
|
|
|
## Potentially Outdated Documents
|
|
|
|
| File | Reason |
|
|
|------|--------|
|
|
| `implementation-status-2026-05-28.md` | Dated 2026-05-28; code has changed significantly since |
|
|
| `docs/material3-guideline.md` | Duplicate of `docs/ui-ux/material3-guideline.md` |
|
|
| `docs/sysdes.md` | Top-level duplicate of `docs/architecture/sysdes.md` |
|
|
| `docs/srs.md` / `docs/sysrs.md` | Top-level duplicates of `docs/requirements/` versions |
|
|
|
|
---
|
|
|
|
## Key Findings
|
|
|
|
1. **chanora_audio** is the best-tested crate (204 tests), but still only ~48% function coverage due to the large codebase (~428 functions)
|
|
2. **chanora_bridge**, **chanora_cache**, and **chanora_prefetch** have zero tests
|
|
3. **chanora_core** has very low coverage (~7%) despite being the main connection orchestrator
|
|
4. **Dart widget tests** cover only 54% of widget files; 11 widget files have no tests
|
|
5. **Dart service tests** are strong at 90% coverage (only 2 files untested)
|
|
6. **Documentation** is extensive (55 files) but focuses on process/governance; code-level architecture docs are sparse
|
|
7. No dedicated docs exist for the audio engine, FFI bridge, protocol layer, or state machine internals
|