docs: add offline knowledge library with project analysis and external references

- 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.
2026-06-13 02:00:26 +09:00
parent 89bbfa1e18
commit dd6e80f72a
13 changed files with 3358 additions and 0 deletions
@@ -0,0 +1,64 @@
+# Chanora Offline Knowledge Library
+
+**Generated:** 2026-06-13  
+**Branch:** `docs/offline-knowledge-library-2026-06-13`  
+**Purpose:** Comprehensive offline reference for the Chanora project, its dependencies, and related ecosystem.
+
+---
+
+## Contents
+
+### Project Analysis
+
+| Document | Description | Status |
+|----------|-------------|--------|
+| [function-inventory.md](function-inventory.md) | Complete public API inventory for all 10 Rust crates + 56 Dart files. Includes dead code analysis. | Reviewed |
+| [coverage-analysis.md](coverage-analysis.md) | Test coverage (312 Rust tests, 221 Dart tests) and documentation coverage gaps. | Reviewed, corrected |
+| [doc-quality-analysis.md](doc-quality-analysis.md) | Duplicated content, useless content, and broken references in docs/. | Reviewed, corrected |
+| [link-coverage-report.md](link-coverage-report.md) | All internal/external links validated. 2 broken LICENSE links, 5 broken doc-path refs. | Reviewed, corrected |
+
+### External Projects
+
+| Document | Description | Status |
+|----------|-------------|--------|
+| [external/teaspeak-overview.md](external/teaspeak-overview.md) | TeaSpeak voice server - architecture, protocol, build system. | Reviewed |
+| [external/respeak-overview.md](external/respeak-overview.md) | ReSpeak org - tsclientlib, tsproto, crypto, Chanora integration. | Reviewed |
+| [external/yatqa-en.md](external/yatqa-en.md) | yat.qa TeamSpeak admin tool (English). | Reviewed |
+| [external/yatqa-de.md](external/yatqa-de.md) | yat.qa TeamSpeak admin tool (German/Deutsch). | Reviewed |
+
+### Review Reports
+
+| Document | Description |
+|----------|-------------|
+| [reviews/coverage-analysis-review.md](reviews/coverage-analysis-review.md) | Cross-validation of coverage analysis |
+| [reviews/doc-quality-review.md](reviews/doc-quality-review.md) | Cross-validation of doc quality analysis |
+| [reviews/link-coverage-review.md](reviews/link-coverage-review.md) | Cross-validation of link coverage |
+| [reviews/external-docs-review.md](reviews/external-docs-review.md) | Cross-validation of external project docs |
+
+---
+
+## Key Findings Summary
+
+### Test Coverage
+- **Rust**: 312 inline tests + 2 integration tests across 7/9 crates
+- **Dart**: 221 tests (widgets: 58%, services: 90%)
+- **Untested crates**: chanora_bridge, chanora_cache, chanora_prefetch
+
+### Documentation Gaps
+- No architecture docs for: audio engine, FFI bridge, protocol layer, state machine, cache, prefetch, diagnostics
+- 15 TODO/FIXME items catalogued across codebase
+
+### Dead/Useless Code
+- No true dead code found (platform-gated items are intentional)
+- 1 malformed markdown in docs/sysdes.md
+- 2 missing LICENSE files (LICENSE-APACHE, LICENSE-MIT)
+
+### Duplicated Content
+- Lifecycle chain repeated in 6+ files
+- Git commit examples in 3 files
+- Security doc list in 2 files
+
+### External Dependencies
+- **ReSpeak/tsclientlib**: Chanora patches tsproto-types for P-256 coordinate padding
+- **TeaSpeak**: Compatible voice server, C++20 + Electron architecture
+- **yat.qa**: TeamSpeak admin tool, v3.9.9b, English + German docs
@@ -0,0 +1,375 @@
+# 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
@@ -0,0 +1,115 @@
+# Documentation Quality Analysis
+
+## Summary
+- Total docs analyzed: 64
+- Duplicated content instances: 8
+- Useless content items: 1 (malformed markdown only)
+- Broken references: 1 (suggested file names only; SDD-109/SAD-043 are valid historical refs)
+
+## Duplicated Content
+
+### Instance 1: Lifecycle Documentation Chain
+- **Files**: `README.md:280`, `CONTRIBUTING.md:10`, `docs/sysdes.md:90`, `docs/sysrs.md:108`, `docs/governance/traceability-matrix.md:16`, `docs/references/aspice-swe2-swe3-integration-note.md:12`
+- **Content**: `SysRS -> SysDes -> SRS -> SAD -> SDD` lifecycle chain repeated across 6+ files
+- **Recommendation**: Define once in `README.md` and reference from other docs
+
+### Instance 2: Git Commit Convention Examples
+- **Files**: `README.md:380`, `CONTRIBUTING.md:38`, `docs/governance/git-commit-message-convention.md:15`
+- **Content**: Same commit examples (`feat(voice): add push-to-talk state handling`, `fix(protocol): recover channel tree after reconnect snapshot`, etc.) duplicated across 3 files
+- **Recommendation**: Keep examples only in `docs/governance/git-commit-message-convention.md` and reference from README/CONTRIBUTING
+
+### Instance 3: Security/Privacy/Legal Document List
+- **Files**: `README.md:349-355`, `SECURITY.md:33-38`
+- **Content**: Same list of 6 security documents (threat-model, secure-storage, diagnostic-redaction, dependency, privacy-policy, trademark) repeated verbatim
+- **Recommendation**: Keep list in `SECURITY.md` and reference from README
+
+### Instance 4: Architecture Component Table
+- **Files**: `README.md:73-92`, `docs/architecture/sad.md:56-67`
+- **Content**: Similar architecture overview showing Flutter UI, Rust Core, Protocol Layer structure
+- **Recommendation**: Keep detailed version in SAD; use abbreviated version in README
+
+### Instance 5: Platform Policy Table
+- **Files**: `README.md:47-54`, `docs/release/platform-release-policy.md:12-19`
+- **Content**: Platform requirements table with overlapping information
+- **Recommendation**: Consolidate in `platform-release-policy.md` and reference from README
+
+### Instance 6: Security Gate Requirements
+- **Files**: `docs/security/security-privacy-legal-guideline.md:13-21`, `docs/security/threat-model.md:22-30`
+- **Content**: Similar threat/mitigation tables with overlapping secure-storage and diagnostics concerns
+- **Recommendation**: Threat model should reference the guideline for gate requirements
+
+### Instance 7: DV Conclusion Pattern
+- **Files**: Nearly every `docs/` file ends with a "## DV Conclusion" section
+- **Content**: Repetitive pattern: "[Area] is documented for DV. [Limitation] remains."
+- **Recommendation**: This is intentional for ASPICE compliance. No change needed, but consider a template.
+
+### Instance 8: Android Runtime Gate Documentation
+- **Files**: `docs/verification/swe5-software-integration-verification-plan.md:57-68`, `docs/governance/maintainability-review-2026-06-08.md:61-88`
+- **Content**: Same Android ADB/emulator verification steps and `adb devices -l` requirements
+- **Recommendation**: Define once in a shared reference and import
+
+## Useless Content
+
+### Empty Sections
+
+| File | Line | Header | Issue |
+|------|------|--------|-------|
+| `docs/architecture/sysdes.md` | 1-21 | Entire file | Path record file — 21 lines pointing to `docs/sysdes.md` with no unique content |
+| `docs/requirements/sysrs.md` | 1-22 | Entire file | Path record file — 22 lines pointing to `docs/sysrs.md` with no unique content |
+| `docs/requirements/srs.md` | 1-22 | Entire file | Path record file — 22 lines pointing to `docs/srs.md` with no unique content |
+| `docs/ui-ux/material3-guideline.md` | 1-8 | Entire file | Path record file — 8 lines pointing to `docs/material3-guideline.md` |
+| `docs/sysdes.md` | 13 | `**Repo path:** ...  ---` | Malformed markdown (missing blank line before `---`) |
+
+### TODO/Placeholder Markers
+
+No actual TODO/TBD/placeholder markers found in the documentation files. The codebase is clean of such markers.
+
+### Broken References
+
+| File | Line | Reference | Issue |
+|------|------|-----------|-------|
+| `docs/sysrs.md` | 126-130 | `docs/chanora_SysDes.md`, `docs/chanora_SRS.md`, etc. | These suggested file names do not exist. Actual files use different names (`docs/sysdes.md`, `docs/srs.md`, etc.) |
+| `docs/implementation-status-2026-05-28.md` | 103 | `SDD-109` | References a specific SDD item ID that is not itemized in the current SDD baseline |
+| `docs/implementation-status-2026-05-28.md` | 105 | `SAD-043` | References a specific SAD item ID that is not itemized in the current SAD baseline |
+
+### Outdated Content
+
+| File | Line | Content | Issue |
+|------|------|---------|-------|
+| `docs/sysdes.md` | 6 | Version `0.9.8` | Superseded by later governance docs dated 2026-05-29 |
+| `docs/sysrs.md` | 5 | Version `0.9.11` | May need alignment with SysDes version |
+| `docs/material3-guideline.md` | 4-5 | Version `0.9.2` | Change history stops at 2026-05-14; no updates for 2026-05-29 baseline |
+| `tools/windows-smoke.md` | 6 | `product/scaffold-v0` branch | Default base branch changed to `main` per CHANGELOG |
+| `docs/implementation-status-2026-05-28.md` | 140 | Agent spec docs reference | States docs are "deleted from the working tree but still in git HEAD" — stale cleanup note |
+
+### Stale Content
+
+| File | Line | Content | Issue |
+|------|------|---------|-------|
+| `docs/implementation-status-2026-05-28.md` | 1 | Date: 2026-05-28 | Pre-dates DV baseline (2026-05-29); may not reflect final baseline state |
+| `docs/governance/git-commit-message-convention.md` | 18 | `release(android): prepare internal alpha build metadata` | Example uses `release` type which is not in the Conventional Commits standard types |
+
+## Duplicated Code Blocks
+
+| Code Hash | Files | Description |
+|-----------|-------|-------------|
+| Lifecycle chain | `README.md:280`, `CONTRIBUTING.md:10`, `docs/sysdes.md:90`, `docs/sysrs.md:108`, `docs/governance/traceability-matrix.md:16`, `docs/references/aspice-swe2-swe3-integration-note.md:12` | `SysRS -> SysDes -> SRS -> SAD -> SDD -> Verification` |
+| Commit examples | `README.md:379-386`, `CONTRIBUTING.md:37-42`, `docs/governance/git-commit-message-convention.md:14-19` | 4-6 identical commit message examples |
+| Security doc list | `README.md:349-355`, `SECURITY.md:33-38` | 6 identical file paths |
+| Architecture ASCII art | `README.md:73-92`, `docs/architecture/sad.md:56-67` | Similar but not identical architecture diagrams |
+| Platform table | `README.md:47-54`, `docs/release/platform-release-policy.md:12-19` | Overlapping platform requirement tables |
+
+## Recommendations
+
+### High Priority
+1. **Consolidate lifecycle chain**: Define once in README, reference elsewhere
+2. **Fix suggested file names**: `docs/sysrs.md` lines 126-130 reference non-existent file names
+
+### Medium Priority
+4. **Consolidate commit examples**: Keep in `git-commit-message-convention.md` only
+5. **Consolidate security doc list**: Keep in `SECURITY.md` only
+6. **Update outdated branch reference**: `tools/windows-smoke.md` references `product/scaffold-v0` but default is now `main`
+
+### Low Priority
+7. **Align document versions**: SysDes (0.9.8), SysRS (0.9.11), Material3 (0.9.2) have different versions
+8. **Clean up implementation status**: Remove stale agent-spec references and update date
@@ -0,0 +1,280 @@
+# ReSpeak Project Knowledge Base
+
+> **Source**: https://github.com/ReSpeak/tsclientlib
+> **Last synced**: 2026-06-13
+> **License**: MIT OR Apache-2.0
+
+## Overview
+
+ReSpeak is an open-source project that provides a Rust implementation of the **TeamSpeak 3 protocol**. The primary goal is to enable building TeamSpeak clients and bots in Rust. The project is **not** an official TeamSpeak product — it was created for fun and to gain features/bugfixes not available in the official client.
+
+The organization maintains a single monorepo (`ReSpeak/tsclientlib`) containing multiple crates that layer from low-level protocol handling up to a high-level client library.
+
+**Key principle**: ReSpeak does **not** publish server-side code. They earn revenue by selling servers and ReSpeak respects that business model.
+
+## Repository Map
+
+| Crate | Path | Purpose | Version |
+|-------|------|---------|---------|
+| `tsclientlib` | `tsclientlib/` | High-level client/bot library | 0.2.0 |
+| `tsproto` | `tsproto/` | Low-level TeamSpeak 3 protocol implementation | 0.2.0 |
+| `ts-bookkeeping` | `utils/ts-bookkeeping/` | Server state tracking (clients, channels) | 0.1.x |
+| `tsproto-packets` | `utils/tsproto-packets/` | Packet and command parsing/serialization | 0.1.x |
+| `tsproto-types` | `utils/tsproto-types/` | Core types, enums, crypto primitives | 0.1.x |
+| `tsproto-structs` | `utils/tsproto-structs/` | Generated structs from tsdeclarations | 0.1.x |
+
+**External dependency**: [tsdeclarations](https://github.com/ReSpeak/tsdeclarations) — machine-readable TeamSpeak protocol declarations (embedded as git submodule).
+
+## tsclientlib
+
+### Architecture
+
+`tsclientlib` is the **top-level crate** — the one consumers use. It provides:
+
+- `Connection` struct: manages a single connection to a TeamSpeak server
+- Async API built on `tokio` + `futures`
+- DNS SRV resolution for server discovery (`resolver.rs`)
+- Audio handling via `audiopus` (Opus codec) behind the `audio` feature flag
+- Sync wrapper (`sync.rs`) for non-async contexts
+- Prelude module for convenient imports
+
+### Features
+
+| Feature | Default | Description |
+|---------|---------|-------------|
+| `audio` | yes | Opus encode/decode, `AudioHandler` for jitter buffer + mixing |
+| `unstable` | no | Expose internal protocol API (may break on minor releases) |
+| `default-tls` | yes | reqwest with default TLS for HTTP/HTTPS |
+| `bundled` | no | Bundle SDL2 |
+| `static-link` | no | Statically link SDL2 |
+| `audiopus-unstable` | no | Extended audiopus API from Flakebi's fork |
+
+### Key Dependencies
+
+- `tsproto` — protocol layer
+- `ts-bookkeeping` — state management
+- `tsproto-packets` — packet parsing
+- `tsproto-types` — types + crypto
+- `tokio` — async runtime
+- `hickory-proto` / `hickory-resolver` — DNS resolution
+- `reqwest` — HTTP client
+- `audiopus` — Opus codec (optional)
+
+### Source Files
+
+| File | Purpose |
+|------|---------|
+| `lib.rs` | Core types, re-exports, `Connection` entry point |
+| `audio.rs` | Audio subsystem — Opus encode/decode, `AudioHandler` |
+| `resolver.rs` | DNS SRV resolution for TeamSpeak servers |
+| `sync.rs` | Synchronous wrapper API |
+| `prelude.rs` | Convenience re-exports |
+| `tests.rs` | Integration tests |
+
+### Examples
+
+- `simple.rs` — minimal async client
+- `simple-sync.rs` — minimal sync client
+- `audio.rs` — audio streaming client
+- `audio-latency.rs` — latency measurement
+- `channeltree.rs` — channel navigation
+- `many.rs` / `sync.rs` — stress tests
+
+## tsproto
+
+### Architecture
+
+`tsproto` implements the **low-level TeamSpeak 3 protocol**:
+
+- Connection establishment and handshake
+- UDP packet delivery with reliability (resend logic)
+- Packet encryption and compression
+- Command parsing
+
+### Source Files
+
+| File | Purpose |
+|------|---------|
+| `algorithms.rs` | Packet splitting, encryption/decryption, compression, hash cash |
+| `client.rs` | Client-side connection logic |
+| `connection.rs` | Connection state machine, packet queuing |
+| `packet_codec.rs` | Packet encoding/decoding codec |
+| `resend.rs` | Reliable packet delivery with retransmission |
+| `license.rs` | License system implementation |
+| `log.rs` | Logging utilities |
+| `utils.rs` | Helper functions |
+
+### Protocol Details
+
+#### Packet Types
+
+| Type | Description |
+|------|-------------|
+| `Command` | High-priority commands |
+| `CommandLow` | Low-priority commands |
+| `Voice` | Voice data |
+| `VoiceWhisper` | Whisper voice data |
+| `Ack` / `AckLow` | Acknowledgments |
+| `Ping` / `Pong` | Keepalive |
+| `Init` | Connection initialization |
+
+#### Packet Limits
+
+- **Max UDP packet size**: 1500 bytes (ethernet MTU)
+- **Max command packet size**: 500 bytes (including header)
+- **Max fragments length**: 40960 bytes
+- **Max decompressed size**: 2 MiB (for large servers with 2000+ channels)
+- **Max out-of-order queue**: 200 packets
+
+#### Compression
+
+- Uses **QuickLZ** level 1 for command packets
+- Compression only applied if result is smaller than original
+- Fragmentation occurs when compressed data exceeds 500 bytes
+
+### Cryptography
+
+#### Key Types
+
+| Type | Curve | Usage |
+|------|-------|-------|
+| `EccKeyPubP256` | P-256 (secp256r1) | Public identity key |
+| `EccKeyPrivP256` | P-256 | Private identity key |
+| `EccKeyPubEd25519` | Ed25519 | Public ephemeral key (handshake) |
+| `EccKeyPrivEd25519` | Ed25519 | Private ephemeral key (handshake) |
+
+#### Encryption Algorithm
+
+1. **Key derivation**: `SHA-256(packet_type || generation_id || shared_iv)` → 16-byte key + 16-byte nonce
+2. **Cipher**: AES-128 in EAX mode with 8-byte MAC
+3. **Key caching**: Derived keys are cached per generation to avoid recomputation
+4. **Packet ID mixing**: `key[0] ^= (packet_id >> 8)`, `key[1] ^= (packet_id & 0xff)`
+
+#### Shared IV Computation (`compute_iv_mac`)
+
+1. ECDH shared secret via Ed25519
+2. `shared_iv = SHA-512(shared_secret)`
+3. XOR with `alpha` (10 bytes) and `beta` (54 bytes) from handshake
+4. `shared_mac = SHA-1(shared_iv)[..8]`
+
+#### Hash Cash (Identity Proof-of-Work)
+
+- Identity level = number of leading zero bits in `SHA-1(public_key_string || counter)`
+- `upgrade_level(target)` iterates counter until desired level is reached
+- Default target level: 8
+
+#### Identity Format
+
+```
+Format: counter || 'V' || base64(private_key)
+Example: "2792354VMG8DAgeAAgEgAiEA..."
+```
+
+#### Fake Encryption
+
+- Used for unencrypted packet types (voice, ack, ping, etc.)
+- Fixed key: `c:\windows\syste` (16 bytes)
+- Fixed nonce: `m\firewall32.cpl` (16 bytes)
+
+## ts-bookkeeping
+
+Tracks the **server state** by processing incoming commands:
+
+- Maintains client list, channel tree, server info
+- Generates events from state changes
+- Provides methods to create outgoing command packets
+- Main struct: `data::Connection`
+
+## tsproto-packets
+
+Handles **packet serialization/deserialization**:
+
+- `packets.rs` — packet structures (`InPacket`, `OutPacket`, `OutAck`, etc.)
+- `commands.rs` — TeamSpeak command parsing
+- Header constants: `C2S_HEADER_LEN`, `S2C_HEADER_LEN`
+
+## tsproto-types
+
+Core **types and primitives**:
+
+- `crypto.rs` — ECC key types (P-256, Ed25519), ECDH, signatures, identity obfuscation
+- `versions.rs` — TeamSpeak version strings
+- `errors.rs` — Protocol error codes
+
+### Key Crypto Functions
+
+| Function | Description |
+|----------|-------------|
+| `EccKeyPrivP256::create()` | Generate new P-256 keypair |
+| `EccKeyPrivP256::import_str()` | Import from base64/tomcrypt/obfuscated formats |
+| `EccKeyPrivP256::create_shared_secret()` | ECDH with P-256 |
+| `EccKeyPrivP256::sign()` | ECDSA signature |
+| `EccKeyPubP256::verify()` | ECDSA verification |
+| `EccKeyPubP256::get_uid()` | `base64(SHA-1(ts_encoded_key))` |
+| `encode_password()` | `base64(SHA-1(password))` |
+| `EccKeyPrivEd25519::create_shared_secret()` | ECDH with Ed25519 |
+
+### Identity Obfuscation
+
+TeamSpeak stores identities XOR'd with a static 128-byte pattern + SHA-1 hash of trailing data. ReSpeak implements both obfuscation and deobfuscation.
+
+## How Chanora Uses ReSpeak
+
+Chanora depends on **four crates** from the ReSpeak monorepo, all pinned to revision `04aa2491`:
+
+### Dependency Chain
+
+```
+chanora_protocol/
+  ├── tsclientlib (rev 04aa2491, features=["audio"])
+  ├── tsproto-packets (rev 04aa2491)
+  ├── tsproto-types (rev 04aa2491)
+  └── ts-bookkeeping (rev 04aa2491)
+
+chanora_audio/
+  └── tsclientlib (rev 04aa2491, features=["audio"])
+```
+
+### Architectural Constraint (SAD-067 / SysDes-011 / SysDes-029)
+
+Chanora's `chanora_protocol` crate acts as an **isolation boundary**:
+
+> No tsclientlib types may cross out of this crate.
+
+This prevents ReSpeak API changes from cascading through Chanora's codebase.
+
+### Patched Fork
+
+Chanora patches `tsproto-types` to fix **P-256 short coordinate padding**:
+
+```toml
+[patch."https://github.com/ReSpeak/tsclientlib.git"]
+tsproto-types = { git = "https://github.com/EdisonJwa/tsclientlib.git", branch = "fix/p256-short-coordinate-pad" }
+```
+
+This handles cases where P-256 coordinates are shorter than 32 bytes and need left-padding.
+
+### Key Usage Points
+
+1. **Protocol connection**: `tsclientlib::Connection` for TeamSpeak server connections
+2. **Audio handling**: `AudioHandler` from tsclientlib for decode, jitter buffer, mixing
+3. **Packet types**: `tsproto-packets` for `OutAudio`, `InAudioBuf`, `AudioData`, `CodecType`, `Direction`
+4. **State tracking**: `ts-bookkeeping` for server state management
+
+## External References
+
+- **Qint** (https://github.com/ReSpeak/Qint) — Cross-platform TeamSpeak client built on tsclientlib (not yet ready)
+- **SimpleBot** (https://github.com/ReSpeak/SimpleBot) — Example chat bot
+- **tsdeclarations** (https://github.com/ReSpeak/tsdeclarations) — Machine-readable protocol declarations
+- **TSIdentityTool** (https://github.com/landave/TSIdentityTool) — Identity deobfuscation reference (MIT)
+
+## Performance Benchmarks
+
+From i7-5280K @ 3.6 GHz (single-threaded):
+
+| Operation | Time | Throughput |
+|-----------|------|------------|
+| Connection creation | 199 ms | 6.5 conn/sec |
+| Message send | 189 µs | 5300 msg/sec |
+
+Bottleneck: RSA puzzle solving at connection time. Use `--features rug` for efficient big integer implementation.
@@ -0,0 +1,392 @@
+# TeaSpeak Project Knowledge Base
+
+## Overview
+
+TeaSpeak is an open-source, TeamSpeak-compatible voice communication platform hosted at `https://git.did.science/TeaSpeak`. It consists of two main repositories:
+
+- **TeaSpeak-Client** — An Electron-based desktop client (329 commits, created May 2020)
+- **TeaSpeakLibrary** — A C++ shared library providing core protocol, channel, and database functionality (208 commits, created May 2020)
+
+The project is developed by WolverinDEV / TeaSpeak and targets users who need a self-hosted, TeamSpeak-compatible voice chat solution.
+
+## Architecture
+
+### Two-Repository Design
+
+```
+TeaSpeak/
+├── TeaSpeak-Client/        # Electron desktop application
+│   ├── main.ts             # Entry point (Electron main process)
+│   ├── modules/            # TypeScript modules (core, renderer, shared, crash_handler)
+│   ├── native/             # C++ native addons (Node.js N-API)
+│   │   ├── serverconnection/   # Server connection & audio engine
+│   │   ├── codec/              # Opus codec bindings
+│   │   ├── crash_handler/      # Native crash handling
+│   │   ├── dns/                # DNS resolution
+│   │   ├── ppt/                # Protocol handling
+│   │   └── updater/            # Auto-updater
+│   ├── imports/            # Shared TypeScript definitions & vendor libs
+│   └── resources/          # Static assets
+│
+└── TeaSpeakLibrary/        # C++ static library
+    ├── CMakeLists.txt      # CMake build system
+    ├── src/
+    │   ├── protocol/       # TeamSpeak protocol implementation
+    │   ├── channel/        # Channel tree management
+    │   ├── query/          # Server query protocol
+    │   ├── sql/            # SQLite & MySQL database layer
+    │   ├── ssl/            # SSL/TLS support
+    │   ├── bbcode/         # BBCode parsing
+    │   └── misc/           # Utilities (crypto, networking, etc.)
+    └── test/               # Unit tests
+```
+
+### Client Architecture (Electron)
+
+The client uses a multi-process Electron architecture:
+
+- **Main Process** (`modules/core/main.ts`) — App lifecycle, window management, crash handling
+- **Renderer Process** (`modules/renderer/`) — UI rendering, audio controls, connection management
+- **Shared Module** (`modules/shared/`) — IPC definitions, version info, proxy utilities
+- **Native Addons** (`native/`) — C++ bindings for performance-critical operations
+
+Key TypeScript path aliases:
+- `tc-shared/*` → `imports/shared-app/*`
+- `tc-native/connection` → `native/serverconnection/exports/exports.d.ts`
+
+## Features
+
+### Voice Communication
+- Opus audio codec support (encoder/decoder)
+- Audio input/output with gain control and level metering
+- Audio mixing and interleaving
+- Voice activity detection (VAD) via libfvad
+- Audio filtering and processing pipeline
+- Sound file playback capabilities
+
+### Server Protocol
+- TeamSpeak protocol compatibility
+- Custom protocol handler with crypto support (ProtocolHandlerCrypto)
+- Packet acknowledgement and loss calculation
+- Ring buffer for reliable packet delivery
+- QuickLZ compression
+- Hardware ID (HWID) generation for client identification
+
+### Channel System
+- Tree-based channel hierarchy (TreeView)
+- Channel properties and permissions
+- BBCode formatting support
+
+### Data & Storage
+- SQLite database support
+- MySQL database support
+- Client storage and profiles
+- File transfer capabilities
+- Connection logging
+
+### Client Features
+- Auto-updater
+- Crash handler with Sentry integration
+- Window management and system tray
+- Keyboard shortcuts
+- Context menus
+- i18n (internationalization)
+- Music playback
+- URL preview
+
+## Technology Stack
+
+### Client (TeaSpeak-Client)
+| Component | Technology |
+|-----------|-----------|
+| Runtime | Electron 8.5.5 |
+| Language | TypeScript 3.9, C++ |
+| UI | HTML/CSS, jQuery, EJS templates |
+| Styling | SASS |
+| Native addons | cmake-js, Node.js N-API |
+| Build | electron-packager |
+| Error tracking | Sentry |
+
+### Library (TeaSpeakLibrary)
+| Component | Technology |
+|-----------|-----------|
+| Language | C++20 |
+| Build system | CMake 3.6+ |
+| Crypto | TomCrypt, TomMath, OpenSSL, Ed25519 |
+| Compression | QuickLZ |
+| Database | SQLite3, MySQL Connector/C++ |
+| Logging | spdlog |
+| Events | libevent |
+| Audio | Opus |
+| JSON | jsoncpp |
+| Serialization | Protocol Buffers |
+| Memory | jemalloc |
+| Crash reporting | Breakpad |
+| Terminal | CXXTerminal (server mode) |
+| Threading | Custom ThreadPool |
+| String templating | StringVariable |
+| Networking | DataPipes (includes libnice for ICE) |
+
+### External Dependencies (from libraries.txt)
+- PortAudio — Cross-platform audio I/O
+- libfvad — Voice activity detection
+- SoXR — High-quality sample rate conversion
+
+## Protocol / API
+
+### TeamSpeak Protocol Implementation
+
+The protocol layer (`TeaSpeakLibrary/src/protocol/`) implements:
+
+- **Packet** — Core packet structure and serialization
+- **CryptHandler** — Encryption/decryption for secure communication
+- **CompressionHandler** — QuickLZ-based packet compression
+- **AcknowledgeManager** — Reliable delivery with ACK tracking
+- **PacketLossCalculator** — Network quality monitoring
+- **RingBuffer** — Circular buffer for packet ordering
+- **Generation** — Protocol version/generation handling
+
+### Server Connection (Client Side)
+
+The native server connection module (`native/serverconnection/`) handles:
+
+- **ServerConnection** — Main connection state machine
+- **ProtocolHandler** — Full protocol implementation split across:
+  - `ProtocolHandlerCommands.cpp` — Command processing
+  - `ProtocolHandlerCrypto.cpp` — Crypto handshake
+  - `ProtocolHandlerPOW.cpp` — Proof of work (anti-spam)
+  - `ProtocolHandlerPackets.cpp` — Packet serialization
+- **Socket** — TCP/UDP socket management
+- **Audio subsystem** — Codec, drivers, filters, processing
+
+### Query Protocol
+
+Server query support (`src/query/`) with:
+- Command parsing (v2 and v3 formats)
+- Escape sequence handling
+
+## Build & Configuration
+
+### Building TeaSpeakLibrary
+
+```bash
+# Prerequisites: CMake 3.6+, C++20 compiler, OpenSSL, MySQL, etc.
+mkdir build && cd build
+cmake .. -DTEASPEAK_SERVER=ON
+make -j$(nproc)
+
+# Build tests (optional)
+cmake .. -DBUILD_TESTS=ON
+make -j$(nproc)
+```
+
+### Building TeaSpeak-Client
+
+```bash
+# Install dependencies
+npm install
+
+# Compile TypeScript
+npm run compile-tsc
+
+# Compile SASS
+npm run compile-sass
+
+# Generate JSON validators
+npm run compile-json-validator
+
+# Build for Linux
+npm run build-linux-64
+npm run package-linux-64
+
+# Build for Windows
+npm run build-windows-64
+npm run package-windows-64
+
+# Development mode
+npm run start-s  # Connects to localhost:8080
+```
+
+### Environment Variables
+
+- `teaclient_deploy_secret` — Deployment signing key (in `env.sh`)
+
+### Platform-Specific Dependencies
+
+- **Linux**: electron-installer-debian
+- **Windows**: electron-installer-windows, electron-winstaller, electron-wix-msi, rcedit
+
+## Key Concepts
+
+### Protocol Concepts
+- **HWID** (Hardware ID) — Unique machine identifier for client authentication
+- **POW** (Proof of Work) — Anti-spam mechanism in connection handshake
+- **Ring Buffer** — Circular buffer for managing packet ordering and retransmission
+- **Acknowledge Manager** — Tracks packet delivery confirmation
+- **Packet Loss Calculator** — Monitors network quality metrics
+
+### Audio Concepts
+- **Opus Converter** — Handles Opus encoding/decoding
+- **Audio Gain** — Volume amplification/attenuation
+- **Audio Level Meter** — Real-time audio level monitoring
+- **Audio Merger** — Combines multiple audio streams
+- **Audio Interleaved** — Audio frame interleaving for transmission
+- **Audio Event Loop** — Async audio processing pipeline
+- **VAD** (Voice Activity Detection) — Detects speech vs silence
+
+### Channel Concepts
+- **TreeView** — Hierarchical channel structure (parent/child relationships)
+- **BBCode** — Text formatting markup (TeamSpeak standard)
+- **Permission Manager** — Role-based access control
+
+### Connection Concepts
+- **ServerConnection** — Full connection lifecycle management
+- **Command Handler** — Processes server commands/responses
+- **Handshake Handler** — Initial connection negotiation
+- **Voice Connection** — Audio stream management
+- **Video Connection** — Video stream support
+- **Dummy Voice Connection** — Placeholder/mock for testing
+
+## Source Repository Structure
+
+### TeaSpeak-Client Root
+```
+.
+├── .gitignore
+├── .gitmodules
+├── bugs                        # Bug tracking
+├── build_declarations.sh       # Build script for type declarations
+├── env.sh                      # Environment variables
+├── generate-json-validators.sh # JSON schema validation generator
+├── libraries.txt               # External library references
+├── main.ts                     # Electron entry point
+├── package.json                # Node.js dependencies & scripts
+├── package-lock.json
+├── restore.sh                  # Restore script
+├── tsconfig.json               # TypeScript configuration
+├── tsconfig_render_api.json    # Renderer API TypeScript config
+├── imports/                    # Shared TypeScript types & vendor code
+│   ├── shared-app/             # Application-level shared types
+│   │   ├── audio/              # Audio type definitions
+│   │   ├── backend/            # Backend interfaces
+│   │   ├── clientservice/      # Client service definitions
+│   │   ├── connection/         # Connection type definitions
+│   │   │   └── rtc/            # WebRTC-related types
+│   │   ├── connectionlog/      # Connection logging
+│   │   ├── conversations/      # Chat/conversation types
+│   │   ├── crypto/             # Crypto interfaces
+│   │   ├── entry-points/       # Module entry points
+│   │   ├── events/             # Event definitions
+│   │   ├── file/               # File handling types
+│   │   ├── i18n/               # Internationalization
+│   │   ├── ipc/                # IPC message definitions
+│   │   ├── media/              # Media handling
+│   │   ├── music/              # Music playback
+│   │   ├── permission/         # Permission types
+│   │   ├── profiles/           # User profiles
+│   │   ├── text/               # Text processing
+│   │   ├── tree/               # Tree data structures
+│   │   ├── ui/                 # UI component types
+│   │   └── update/             # Update mechanism
+│   ├── svg-sprites/            # SVG icon sprites
+│   └── vendor/                 # Third-party libraries
+│       ├── TeaEventBus/        # Event bus implementation
+│       └── TeaClientServices/  # Client services
+├── installer/                  # Build & packaging scripts
+├── jenkins/                    # CI/CD pipeline
+├── modules/                    # TypeScript source modules
+│   ├── core/                   # Main process
+│   │   ├── app-updater/        # Auto-update logic
+│   │   ├── main-window/        # Main window management
+│   │   ├── render-backend/     # Renderer backend
+│   │   ├── ui-loader/          # UI loading
+│   │   ├── url-preview/        # URL preview
+│   │   └── windows/            # Window definitions
+│   ├── crash_handler/          # Crash handling
+│   ├── renderer/               # Renderer process
+│   │   ├── audio/              # Audio controls UI
+│   │   ├── connection/         # Connection UI
+│   │   ├── dns/                # DNS resolution
+│   │   └── hooks/              # React-like hooks
+│   ├── renderer-manifest/      # Renderer configuration
+│   └── shared/                 # Shared utilities
+│       ├── ipc/                # IPC implementation
+│       ├── process-arguments/  # CLI argument parsing
+│       ├── proxy/              # Proxy utilities
+│       └── version/            # Version management
+├── native/                     # C++ native addons
+│   ├── cmake/                  # CMake modules
+│   ├── codec/                  # Audio codec (Opus)
+│   │   └── codec/              # Codec implementation
+│   ├── crash_handler/          # Native crash handler
+│   ├── dist/                   # Distribution files
+│   ├── dns/                    # DNS resolver
+│   ├── ppt/                    # Protocol tools
+│   ├── serverconnection/       # Server connection module
+│   │   ├── exports/            # TypeScript declarations
+│   │   ├── src/
+│   │   │   ├── audio/          # Audio engine
+│   │   │   │   ├── codec/      # Opus encoder/decoder
+│   │   │   │   ├── driver/     # Audio drivers
+│   │   │   │   ├── file/       # Audio file I/O
+│   │   │   │   ├── filter/     # Audio filters
+│   │   │   │   ├── js/         # JS audio bindings
+│   │   │   │   ├── processing/ # Audio processing
+│   │   │   │   └── sounds/     # Sound effects
+│   │   │   └── connection/     # Protocol implementation
+│   │   │       ├── audio/      # Audio connection
+│   │   │       └── ft/         # File transfer
+│   │   └── test/               # Connection tests
+│   └── updater/                # Auto-updater native code
+├── resources/                  # Static resources
+└── scripts/                    # Build/utility scripts
+```
+
+### TeaSpeakLibrary Root
+```
+.
+├── CMakeLists.txt          # Build configuration
+├── main.cpp                # Test entry point
+├── src/
+│   ├── bbcode/             # BBCode parser
+│   ├── channel/            # Channel tree (TreeView)
+│   ├── converters/         # Data converters
+│   ├── lock/               # Read-write mutex
+│   ├── log/                # Logging utilities
+│   ├── misc/               # Utilities
+│   │   ├── base64.*        # Base64 encoding
+│   │   ├── digest.*        # Hash digests
+│   │   ├── hex.*           # Hex encoding
+│   │   ├── memtracker.*    # Memory tracking
+│   │   ├── net.*           # Network utilities
+│   │   └── rnd.*           # Random number generation
+│   ├── protocol/           # TeamSpeak protocol
+│   │   ├── AcknowledgeManager.*    # ACK tracking
+│   │   ├── CompressionHandler.*    # QuickLZ compression
+│   │   ├── CryptHandler.*          # Encryption
+│   │   ├── Packet.*                # Packet structure
+│   │   ├── PacketLossCalculator.*  # Loss monitoring
+│   │   ├── buffers.*               # Buffer management
+│   │   ├── generation.*            # Protocol generation
+│   │   └── ringbuffer.*            # Circular buffer
+│   ├── qlz/                # QuickLZ compression library
+│   ├── query/              # Server query protocol
+│   ├── sql/                # Database layer
+│   │   ├── sqlite/         # SQLite implementation
+│   │   └── mysql/          # MySQL implementation
+│   ├── ssl/                # SSL/TLS management
+│   ├── BasicChannel.*      # Base channel class
+│   ├── Definitions.h       # Global definitions
+│   ├── Error.*             # Error handling
+│   ├── EventLoop.*         # Event loop
+│   ├── License.*           # License management
+│   ├── PermissionManager.* # Permission system
+│   ├── Properties.*        # Property system
+│   └── Variable.*          # Variable system
+└── test/                   # Unit tests
+    ├── RingTest.cpp
+    ├── CommandTest.cpp
+    ├── ChannelTest.cpp
+    ├── PermissionTest.cpp
+    └── ...
+```
@@ -0,0 +1,348 @@
+# YaTQA Wissensdatenbank (Deutsch)
+
+> Quelle: https://yat.qa/ — Abgerufen: 13.06.2026
+> Version: v3.9.9b (01. Mrz 2023)
+
+## Überblick
+
+**YaTQA** (Yet Another TeamSpeak³ Query Admin Tool) ist eine Windows-Anwendung zur Verwaltung von **TeamSpeak-3-Servern und -Instanzen** über das ServerQuery-Interface. Es bietet eine grafische Oberfläche für alle Query-Befehle und macht das Erlernen der rohen Query-Syntax überflüssig.
+
+- **Autor:** Janni „Яedeemer" K. (Norddeutschland)
+- **Sprache:** Geschrieben in Delphi 2009 (über 50.000 Zeilen Quelltext)
+- **Entwicklungsbeginn:** 10. April 2011
+- **Erstveröffentlichung:** 29. Juni 2011
+- **Lizenz:** Kostenlos und voll funktionsfähig (keine Adware/Spyware)
+- **Plattformen:** Windows XP und neuer, Linux mittels Wine
+- **Größe:** ~1,3 MiB Installer
+- **Enthaltene Sprachen:** Deutsch und Englisch (Auswahl während der Installation)
+- **Unterstützte Server:** TeamSpeak 3.9.0 bis 3.13.7, TeaSpeak 1.4.10-beta
+- **Download:** https://dl.yat.qa/stable/
+- **Website:** https://yat.qa/
+
+### Motto
+*„Dinosaurier haben kein TeamSpeak benutzt und sind vor 66 Millionen Jahren ausgestorben. Zufall? Vermutlich nicht."*
+
+---
+
+## Funktionen
+
+**YaTQA unterstützt alle ServerQuery-Funktionen ohne Ausnahme.** Die folgende Liste beschränkt sich auf Funktionen, die der normale TS-Client nicht bietet.
+
+### Allgemeine Funktionen (Kein Admin erforderlich)
+
+- **DNS-Auflösung:** Detaillierte Visualisierung der DNS-Auflösung (simuliert 10 verschiedene Client-Versionen)
+- **Blacklist-Prüfung:** TeamSpeaks Blacklist auf eine IP überprüfen
+- **Blacklist2:** TeamSpeaks Blacklist2 für virtuelle Server prüfen
+- **Benutzerdiagramm:** Serverstatistiken von Planet TeamSpeak als Diagramm anzeigen und als PNG speichern
+- **Client-Cache:** Avatare, Icons und Chatlogs im Client-Cache finden
+
+### Konsole (Query-Interface)
+
+- **Autovervollständigung:** Befehlsvervollständigung einschließlich undokumentierter Befehle
+- **Parameterhilfe:** Zeigt alle Parameter eines Befehls basierend auf eigener Forschung
+- **Werteauswahl:** Strg+Leertaste für Werteliste
+- **Ergebnisanalyse:** Gruppierte Datensätze mit Erklärungen
+- **Skripting:** Befehlslisten aus Dateien laden und ausführen
+- **Events:** Server-Events abonnieren und in der Konsole protokollieren
+
+### SSH-Tunnel
+
+- **Verschlüsselung:** Vollständig verschlüsselte Verbindung (außer Dateiübertragungen)
+- **Geschwindigkeit:** Auf vielen Servern merkbar schneller (ähnlich wie `tcp_nodelay`)
+- **Privatsphäre:** IP wird immer verborgen (man erscheint als 127.0.0.1)
+- **Flood-Umgehung:** Umgeht alle Flood-Beschränkungen (127.0.0.1 steht üblicherweise auf der Whitelist)
+
+### Instanz-Funktionen (Erfordert serveradmin)
+
+- Instanzstatistiken anzeigen/bearbeiten
+- Lizenzdetails und IP-Bindings anzeigen
+- Alle virtuellen Server anzeigen
+- Lokale Notizen zu Servern erstellen (lokal gespeichert)
+- Virtuelle Server starten/stoppen/erstellen/löschen/umbenennen
+- Unsichtbar werden (Server-Fehler, könnte behoben werden)
+- Nachricht an alle Server senden
+- Snapshots erstellen/massenweise erstellen/wiederherstellen (inkl. Dateien)
+- Manipulierte Snapshots einspielen
+- Server mittels Snapshots kopieren
+- Rechte auf Vorlagengruppen zurücksetzen
+- Channel-Datei-Backups speichern/wiederherstellen (inkrementelles Backup unterstützt)
+
+### Funktionen für virtuelle Server
+
+- Host-Message-Modal-Quit und hohe Sicherheitsstufe ignorieren
+- Sehr detaillierte Serverstatistiken
+- Mehrere Server gleichzeitig bearbeiten
+- Ausklappbarer Serverbaum (optional immer im Vordergrund)
+- Mehrere Nutzer gleichzeitig verschieben/kicken/bannen/beschreiben
+- Mehrere Channel gleichzeitig erstellen
+- Channel als Vorlage für weitere verwenden
+- Mehrere Channel gleichzeitig bearbeiten
+- Nachrichten an mehrere Nutzer/Channel gleichzeitig senden
+- Rechte mehrerer Nutzer/Channel gleichzeitig bearbeiten
+- Dateien zwischen Channeln verschieben
+- Bildvorschau ohne Download (bmp, gif, jpg, png, pbm, pgm, ppm, xbm, xpm)
+- Upload/Download ganzer Ordnerstrukturen
+- Nutzer zu Gruppen hinzufügen durch Namenseingabe
+- Funktionierende Rechteübersicht mit Echtzeitbearbeitung
+- Rechte zwischen Servern/Instanzen kopieren
+- Rechtewerte und -powers vergleichen
+- Alle Clients/Gruppen mit einem bestimmten Recht finden
+- Mehrere Gruppen gleichzeitig bearbeiten
+- Verbesserte Clientdatenbank mit mehr Details und Suchfunktionen
+- Gesamte Clientdatenbank mit einem Klick herunterladen
+- Clientdatenbank als HTML oder CSV exportieren
+- Gebannte Nutzer und IP-teilende Profile hervorheben
+- Log an beliebiger Stelle lesen
+- User CustomInfo verwalten (suchen, anzeigen, bearbeiten, hinzufügen)
+- Log als HTML oder TXT exportieren
+- Avatare und Icons herunterladen
+- Avatar-Besitzer auf dem Server identifizieren
+- Servervorlage verwalten
+- Uploads/Downloads überwachen
+
+### Unterstützte Bildformate
+
+| Format | Beschreibung |
+|--------|-------------|
+| bmp | Windows Bitmap |
+| gif | Graphics Interchange Format |
+| jpg/jpeg | Joint Photographic Experts Group |
+| png | Portable Network Graphics |
+| pbm | Portable Bitmap (ASCII und binär) |
+| pgm | Portable Graymap (ASCII und binär) |
+| ppm | Portable Pixmap (ASCII und binär) |
+| xbm | X BitMap |
+| xpm | X PixMap |
+
+---
+
+## Architektur / Funktionsweise
+
+### Verbindungsmethoden
+- **Raw TCP/Telnet:** Standard-Query-Verbindung (Standardport 10011)
+- **YaTQA-SSH-Tunnel:** Über Plink (PuTTY-Suite) — verschlüsselt, schneller, IP verborgen
+- **TeamSpeak SSH:** Natives TS3.3+-SSH (auch unterstützt, aber weniger Vorteile)
+
+### Datenspeicherung
+- **Portable Modus:** Alle Daten im Installationsverzeichnis (`yatqa.ini` vorhanden)
+- **Standardmodus:** Einige Dateien in `%APPDATA%\YaTQA`
+- **Icon-Cache:** 16-Bit-RES-Format (`icons.res`)
+- **Befehlsverlauf:** `commandhistory.txt`
+- **Debug-Log:** `RedeemerTS3.log` (erstellt mit `-debug`-Schalter)
+
+### DNS-Auflösung
+YaTQA simuliert die Auflösungsschritte des TeamSpeak-Clients und zeigt sie visuell an. Verwendet Googles DNS-Server für Zuverlässigkeit. Unterstützt:
+- A- und CNAME-Einträge
+- SRV-Einträge
+- TSDNS-Auflösung
+- Alle 10 verschiedenen Client-Version-DNS-Verhaltensweisen
+
+### Snapshot-System
+- Snapshots enthalten alle Servereinstellungen (außer Port und Server-ID)
+- Snapshots enthalten KEINE Dateien, Icons oder Avatare
+- Datei-Backups enthalten Dateien und Icons (keine Avatare wegen Serverbeschränkungen)
+- Pseudo-Snapshots ermöglichen Serverkopien ohne Keypair
+- Unterstützt Zstd-komprimierte Snapshots (3.10.0+-Format)
+
+### Anti-Flood-Schutz
+- Konfigurierbare „Befehle bis Flood"-Einstellung (empfohlen: ~20)
+- Konfigurierbare Verzögerung zwischen Befehlen (empfohlen: 340ms für fremde Server)
+- SSH-Verbindungen umgehen Flood-Beschränkungen (127.0.0.1 auf Whitelist)
+
+---
+
+## Konfiguration
+
+### Anwendungseinstellungen
+
+| Einstellung | Beschreibung |
+|------------|-------------|
+| Verbesserte XP-Unicode-Anzeige | Verwendet Arial Unicode MS für bessere CJK-Unterstützung |
+| Daten bei Tabwechsel aktualisieren | Automatisch Daten aktualisieren |
+| Lokale Zeit verwenden | Lokale Zeit statt UTC |
+| Verbesserte Channel-Dropdowns | Baumansicht für Unterchannel |
+| In den Tray minimieren | Minimieren in den Systemtray |
+| Tray-Icon immer anzeigen | Permanent anzeigen |
+| Icon-Caching aktivieren | Icons in `icons.res` cachen (empfohlen) |
+| Keine Icons verwenden | Icon-Anzeige deaktivieren |
+| Windows Aero verwenden | Aero-Design nutzen (Vista+) |
+| Aero-Glow deaktivieren | Weißen Schatten hinter Menütext entfernen |
+| Beim Start nach Updates suchen | Automatisch nach Updates suchen |
+| Sortiereinstellungen speichern | Sortierpräferenzen merken |
+| Sprunglisten aktivieren | Windows 7+-Sprunglisten-Integration |
+
+### Kompatibilitätseinstellungen
+
+| Einstellung | Beschreibung |
+|------------|-------------|
+| Befehle bis Flood | Verzögerung zwischen Befehlen (340 empfohlen für fremde Server) |
+| Nicht-Standard-Query-Port erlauben | Verbindung zu anderen Ports als 10011 |
+| Löschen wichtiger Gruppen erlauben | Löschen der ersten 5 Server-/4 Channelgruppen erlauben |
+| Verlassen wichtiger Gruppen erlauben | serveradmin darf Admin Server Query verlassen |
+| Machine-ID ändern erlauben | Änderung der Machine-ID ermöglichen |
+
+### SSH-Tunnel-Profile
+SSH-Profile für Server konfigurieren. Bei Verbindung zu einem Server mit passendem SSH-Profil verwendet YaTQA automatisch den Tunnel.
+
+### Kreisdiagramm-Styles
+Auswahl aus 4 verschiedenen Kreisdiagramm-Styles (durch Benutzerabstimmung ausgewählt).
+
+---
+
+## Startparameter
+
+| Parameter | Beschreibung |
+|-----------|-------------|
+| `-a` | Verbindung zum Standardserver |
+| `-b [IP]` | Blacklist-Prüfung |
+| `-c IP Query_Port [User Pass [Voice_Port]]` | Verbindung zum angegebenen Server |
+| `-d` | DNS-Auflösung |
+| `-i` | Iconsammlung |
+| `-p` | Rechtedateien-Editor |
+| `-s [IP]` | Benutzerstatistik |
+| `-debug` | Debug-Logging aktivieren |
+
+---
+
+## Systemanforderungen
+
+### Mindestanforderungen
+- **Betriebssystem:** Windows XP+ (Desktop), Windows 2012+ (Server)
+- **Speicher:** 3 MB für YaTQA (mehr für Konfiguration/Snapshots)
+- **Auflösung:** 960×720 (allgemein), 1024×720 (Serverbaum), 1024×768 (Konsole)
+
+### Fehlende Funktionen unter Windows XP
+- Geist-Modus
+- Nameserver für DNS-Auflösung ändern
+- Einklappbare DNS-Ergebnisse
+- Einklappbare Gruppen im Servergruppenmodus der Benutzer-DB
+
+### Fehlende Funktionen unter Windows Vista/XP
+- Sprunglisten
+
+### Wine/Linux-Einschränkungen
+- Speicherlecks (Wine unterstützt kein Entfernen von Link-Labels)
+- Auch unter XP fehlende Funktionen fehlen unter Wine
+- Zusätzliche Einschränkungen: Keine Array-Gruppierung, keine DNS-Gruppierung, kein Servergruppenmodus in der Benutzer-DB
+- Plink muss manuell installiert werden (Version 0.61+)
+
+---
+
+## Schlüsselkonzepte
+
+### ServerQuery-Interface
+Das TeamSpeak-3-ServerQuery-Interface ist ein textbasiertes Protokoll zur Serververwaltung. YaTQA kapselt diese Schnittstelle in einer GUI mit:
+- Befehlsautovervollständigung
+- Parameterhilfe
+- Werteauswahl
+- Ergebnisanalyse
+
+### Virtueller Server
+Ein virtueller Server ist eine unabhängige TeamSpeak-Serverinstanz, die auf einem einzelnen physischen Serverprozess läuft. Mehrere virtuelle Server können auf einer Instanz laufen.
+
+### Instanz
+Der Serverprozess, der einen oder mehrere virtuelle Server hostet. Verwaltet über den „serveradmin"-Account.
+
+### Snapshot
+Ein vollständiges Backup der Einstellungen eines virtuellen Servers (ohne Port und ID). Enthält keine Dateien, Icons oder Avatare.
+
+### Pseudo-Snapshot
+Ein vom Benutzer manipulierter Snapshot, der zum Kopieren von Servern ohne Beibehaltung des originalen Keypairs verwendet werden kann.
+
+### Rechtesystem
+TeamSpeak verwendet ein hierarchisches Rechtesystem mit:
+- Servergruppen
+- Channelgruppen
+- Client-Rechte
+- Rechte-Powers (Werte, die steuern, was gesetzt werden kann)
+
+### Anti-Flood
+TeamSpeak-Server begrenzen die Häufigkeit von Query-Befehlen. YaTQA bietet konfigurierbare Verzögerungen und „Befehle bis Flood"-Einstellungen, um Bans zu vermeiden.
+
+### Blacklist / Blacklist2
+TeamSpeak führt Blacklists gebannter IPs (Blacklist1) und Server-UIDs (Blacklist2).
+
+### Abzeichen
+Visuelle Indikatoren im TeamSpeak, die Benutzerstatus, Addon-Creator-Status usw. anzeigen. YaTQA kann Abzeichen konfigurieren.
+
+### DNS-Auflösung
+TeamSpeak-Clients lösen Serveradressen über mehrere Methoden auf: A-Einträge, CNAME, SRV-Einträge und TSDNS. YaTQA visualisiert diesen Prozess.
+
+---
+
+## Bekannte Einschränkungen
+
+- **Channel-Passwörter:** YaTQA sendet grundsätzlich keine Channel-Passwörter. Erfordert `b_channel_join_ignore_password` und `b_ft_ignore_password`-Rechte.
+- **Unicode:** Nur Basic Multilingual Plane (BMP) unterstützt (TeamSpeak-Einschränkung).
+- **Integrierte DNS-Auflösung:** Nur A- und CNAME-Einträge (TSDNS und SRV im integrierten Resolver nicht unterstützt).
+- **Geist-Modus:** Viele Funktionen funktionieren nicht; Geist hat nur Query-Gast-Rechte.
+- **Konsole:** Nur die üblichen Einschränkungen des TS3-Servers.
+
+---
+
+## IPv6-Unterstützung
+
+Eckige Klammern `[]` um die Serveradresse schreiben. Unterstützt seit v1.4/2.0-pre für Query-Verbindungen. IPv4-Tunnel (z.B. `[::ffff:7f00:1]`) werden nicht unterstützt.
+
+---
+
+## Projekthistorie
+
+- **10.04.2011:** Entwicklungsbeginn (ursprünglich „TS3Telnet" genannt)
+- **29.06.2011:** Erste Alpha-Version veröffentlicht
+- **18.04.2014:** v2.0 führte Registrierungserfordernis für einige Funktionen ein
+- **22.08.2019:** YaTQA wieder uneingeschränkt Freeware
+- **01.03.2023:** v3.9.9b veröffentlicht (Zeitlimit dauerhaft entfernt)
+
+### Namensherkunft
+„Yet Another TeamSpeak³ Query App" — benannt, weil es beim Entwicklungsbeginn bereits viele Query-Tools gab, aber keines auf dem Rechner des Autors funktionierte.
+
+### Aussprache
+[jatka] in IPA-Lautschrift — auch als deutsches Wort aussprechbar.
+
+---
+
+## Globale Tastenkürzel
+
+| Kürzel | Aktion |
+|--------|--------|
+| Strg+F | Filtern (Rechte, Log) oder Suchen |
+| Strg+Alt+F | In Listen suchen |
+| F3 | Weiter suchen |
+| Strg+A | Alles auswählen |
+| Strg+C | Kopieren oder ausgewählte Daten speichern |
+| Strg+Alt+A | Spalten automatisch anpassen |
+| F2 | Umbenennen |
+| F5 | Tab aktualisieren |
+| NUM + | Ausgewählte Checkbox-Elemente aktivieren |
+| NUM - | Ausgewählte Checkbox-Elemente deaktivieren |
+| Strg+Leertaste | Parameterwert auswählen (Konsole) |
+| Strg+E | Ausgewählten Text escapen (Konsole) |
+| Strg+S | Diagramm als Bild speichern |
+
+---
+
+## Ressourcen
+
+- **Website:** https://yat.qa/
+- **Download:** https://dl.yat.qa/stable/
+- **Funktionen:** https://yat.qa/funktionen/
+- **Anleitung:** https://yat.qa/manual/ (nur Englisch)
+- **Changelog:** https://yat.qa/changelog/ (nur Englisch)
+- **FAQ:** https://yat.qa/haeufige-fragen/
+- **Support:** https://yat.qa/unterstuetzung/
+- **Ressourcen:** https://yat.qa/ressourcen/
+- **Über:** https://yat.qa/ueber/
+
+---
+
+## Übersetzung
+
+YaTQAs Originalsprache ist Deutsch. Die Übersetzung erfolgt mit OmegaT und XLIFF-Dateien. Den Autor vorher kontaktieren. Das Übersetzungssystem verwendet:
+- `%s` — Zeichenketten-Platzhalter
+- `%d` — Dezimalzahl-Platzhalter
+- `&` — Tastenkürzel
+- `&&` — Tatsächliches Kaufmanns-Und
+- `|` — Senkrechter Strich (Hinweistext-Trennzeichen)
+- `\r\n` — Neue Zeile
+- `\t` — Tabulator
@@ -0,0 +1,348 @@
+# YaTQA Knowledge Base (English)
+
+> Source: https://yat.qa/ — Last fetched: 2026-06-13
+> Version: v3.9.9b (01 Mar 2023)
+
+## Overview
+
+**YaTQA** (Yet Another TeamSpeak³ Query Admin Tool) is a Windows application for managing **TeamSpeak 3 servers and instances** using the ServerQuery interface. It provides a graphical interface to all query commands, eliminating the need to learn raw query syntax.
+
+- **Author:** Janni "Яedeemer" K. (northern Germany)
+- **Language:** Written in Delphi 2009 (50,000+ lines of code)
+- **Development started:** April 10, 2011
+- **First release:** June 29, 2011
+- **License:** Free and fully functional freeware (no adware/spyware)
+- **Platforms:** Windows XP and up, Linux via Wine
+- **Size:** ~1.3 MiB installer
+- **Languages included:** English and German (selectable during installation)
+- **Supported servers:** TeamSpeak 3.9.0 through 3.13.7, TeaSpeak 1.4.10-beta
+- **Download:** https://dl.yat.qa/stable/
+- **Website:** https://yat.qa/
+
+### Key Tagline
+*"Dinosaurs weren't using TeamSpeak and wiped about 66 million years ago. Coincidence? I think not."*
+
+---
+
+## Features
+
+**YaTQA supports ALL ServerQuery features with no exceptions.** The feature list below focuses on capabilities beyond what the standard TS3 client offers.
+
+### General Features (No Admin Required)
+
+- **DNS Resolver:** Detailed DNS lookup visualization simulating TeamSpeak client behavior (10 different client version lookups)
+- **Blacklist Check:** Check TeamSpeak's blacklist for any IP
+- **Blacklist2:** Check TeamSpeak's blacklist2 for virtual servers from an instance's server list
+- **User Graph:** View server statistics from Planet TeamSpeak as a chart, save as PNG image
+- **Client Cache:** Find avatars, icons, and chat logs in your client cache
+
+### Console (Query Interface)
+
+- **Autocomplete:** Command completion including undocumented commands
+- **Parameter Help:** Displays every command's parameters based on extensive research
+- **Parameter Value Selection:** Press Ctrl+Space to select values from a list
+- **Result Analysis:** Groups datasets and explains most values
+- **Scripting:** Load and execute command lists from files
+- **Events:** Subscribe to server events and log them in the console
+
+### SSH Tunnel
+
+- **Encryption:** Fully encrypted connection (except file transfers)
+- **Speed:** Notably faster on most servers (similar to `tcp_nodelay`)
+- **Privacy:** Always hides your IP (you appear as 127.0.0.1)
+- **Flood Bypass:** Circumvents all flood restrictions (127.0.0.1 is usually whitelisted)
+
+### Instance Features (Requires serveradmin)
+
+- View/edit instance settings and stats
+- View license details and IP bindings
+- See all virtual servers
+- Add local notes to servers (stored locally)
+- Start/stop/create/delete/rename virtual servers
+- Become invisible (server bug, may be fixed)
+- Send message to all servers
+- Create/mass-create/deploy snapshots (including file-inclusive snapshots)
+- Deploy manipulated snapshots
+- Copy servers using snapshots
+- Reset permissions to template groups
+- Save/restore channel file backups (incremental backup supported)
+
+### Virtual Server Features
+
+- Ignore host message modal quit and high security level
+- Very detailed virtual server statistics
+- Edit multiple servers at once
+- Collapsible server tree (optionally topmost)
+- Move/kick/ban/describe multiple users at once
+- Create multiple channels at once
+- Use channel as template for other channels
+- Edit multiple channels at once
+- Send messages to multiple users/channels at once
+- Edit permissions of multiple users/channels at once
+- Move files between channels
+- Image preview without download (bmp, gif, jpg, png, pbm, pgm, ppm, xbm, xpm)
+- Upload/download entire folder structures
+- Add users to groups by entering names
+- Working permission overview with realtime editing
+- Copy permissions between servers/instances
+- Compare permission values and powers
+- Find all clients/groups with a certain permission
+- Edit multiple groups at once
+- Enhanced client database with more details and search features
+- Download full client database with one click
+- Export client database to HTML or CSV
+- Highlight banned users and IP-sharing profiles
+- Browse log from any position
+- Manage user custominfo (search, view, edit, add)
+- Export log to HTML or TXT
+- Download icons and avatars
+- Identify avatar owners on your server
+- Manage server template
+- Monitor uploads/downloads
+
+### Supported Image Formats
+
+| Format | Description |
+|--------|-------------|
+| bmp | Windows Bitmap |
+| gif | Graphics Interchange Format |
+| jpg/jpeg | Joint Photographic Experts Group |
+| png | Portable Network Graphics |
+| pbm | Portable Bitmap (ASCII and binary) |
+| pgm | Portable Graymap (ASCII and binary) |
+| ppm | Portable Pixmap (ASCII and binary) |
+| xbm | X BitMap |
+| xpm | X PixMap |
+
+---
+
+## Architecture / How It Works
+
+### Connection Methods
+- **Raw TCP/Telnet:** Standard query connection (default port 10011)
+- **YaTQA SSH Tunnel:** Via Plink (PuTTY suite) — encrypted, faster, hides IP
+- **TeamSpeak SSH:** Native TS3.3+ SSH support (also supported but fewer advantages)
+
+### Data Storage
+- **Portable Mode:** All data in installation directory (`yatqa.ini` present)
+- **Standard Mode:** Some files stored in `%APPDATA%\YaTQA`
+- **Icon Cache:** 16-bit RES format (`icons.res`)
+- **Command History:** `commandhistory.txt`
+- **Debug Log:** `RedeemerTS3.log` (created with `-debug` switch)
+
+### DNS Resolution
+YaTQA simulates lookup steps done by TeamSpeak and displays them visually. Uses Google's DNS servers for reliability. Supports:
+- A and CNAME records
+- SRV records
+- TSDNS lookups
+- All 10 different client version DNS behaviors
+
+### Snapshot System
+- Snapshots contain all server settings (except port and virtual server ID)
+- Snapshots do NOT include files, icons, or avatars
+- File backups include files and icons (not avatars due to server limitations)
+- Pseudo snapshots allow server copying without keypair
+- Supports Zstd-compressed snapshots (3.10.0+ format)
+
+### Anti-Flood Protection
+- Configurable "Commands to Flood" setting (recommended: ~20)
+- Configurable delay between commands (recommended: 340ms for non-own servers)
+- SSH connections bypass flood restrictions (127.0.0.1 whitelisted)
+
+---
+
+## Configuration
+
+### Application Settings
+
+| Setting | Description |
+|---------|-------------|
+| Improved XP Unicode display | Uses Arial Unicode MS for better CJK support |
+| Refresh on tab change | Auto-refresh data when switching tabs |
+| Use local time | Local time instead of UTC |
+| Improved channel dropdowns | Tree view lines for sub-channels |
+| Minimize to tray | Minimize to system tray |
+| Always show tray icon | Persistent tray icon |
+| Enable icon caching | Cache icons in `icons.res` (recommended) |
+| Don't use icons globally | Disable icon display |
+| Try Windows Aero | Use Aero theme (Vista+) |
+| Disable Aero glow | Remove white shadow behind menu text |
+| Search for updates on start | Auto-check for updates |
+| Save sort settings | Remember sort preferences |
+| Enable jump lists | Windows 7+ jump list integration |
+
+### Compatibility Settings
+
+| Setting | Description |
+|---------|-------------|
+| Commands to flood | Delay between commands (340 recommended for remote servers) |
+| Allow non-default query port | Connect to ports other than 10011 |
+| Allow deleting important groups | Enable deletion of first 5 server/4 channel groups |
+| Allow leaving important groups | Allow serveradmin to leave Admin Server Query |
+| Allow changing machine ID | Enable machine ID modification |
+
+### SSH Tunnel Profiles
+Configure SSH profiles for servers. When connecting to a server with a matching SSH profile, YaTQA automatically uses the tunnel.
+
+### Pie Chart Styles
+Choose from 4 different pie chart styles (selected by user voting).
+
+---
+
+## Startup Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `-a` | Connect to default server |
+| `-b [IP]` | Blacklist check |
+| `-c IP Query_Port [User Pass [Voice_Port]]` | Connect to specified server |
+| `-d` | DNS lookup |
+| `-i` | Icon collection |
+| `-p` | Permission editor |
+| `-s [IP]` | User statistics |
+| `-debug` | Enable debug logging |
+
+---
+
+## System Requirements
+
+### Minimum Requirements
+- **OS:** Windows XP+ (desktop), Windows 2012+ (server)
+- **Disk:** 3 MB for YaTQA (more for configuration/snapshots)
+- **Resolution:** 960×720 (general), 1024×720 (server tree), 1024×768 (console)
+
+### Features Missing on Windows XP
+- Ghost Mode
+- Nameserver for DNS lookups
+- DNS lookup group folding
+- Folding server groups in user DB server group mode
+
+### Features Missing on Windows Vista/XP
+- Jump lists
+
+### Wine/Linux Limitations
+- Memory leaks (Wine doesn't support removing link labels)
+- Features missing on XP also missing on Wine
+- Additional limitations: no array property grouping, no DNS grouping, no server group mode in user DB
+- Plink must be installed manually (version 0.61+)
+
+---
+
+## Key Concepts
+
+### ServerQuery Interface
+The TeamSpeak 3 ServerQuery interface is a text-based protocol for managing TeamSpeak servers. YaTQA wraps this interface in a GUI, providing:
+- Command autocompletion
+- Parameter help
+- Value selection
+- Result analysis
+
+### Virtual Server
+A virtual server is an independent TeamSpeak server instance running on a single physical server process. Multiple virtual servers can run on one instance.
+
+### Instance
+The server process that hosts one or more virtual servers. Managed via the "serveradmin" account.
+
+### Snapshot
+A complete backup of a virtual server's settings (excluding port and ID). Does not include files, icons, or avatars.
+
+### Pseudo Snapshot
+A user-manipulated snapshot that can be used to copy servers without preserving the original keypair.
+
+### Permissions System
+TeamSpeak uses a hierarchical permission system with:
+- Server groups
+- Channel groups
+- Client permissions
+- Permission powers (values that control what can be set)
+
+### Anti-Flood
+TeamSpeak servers limit query command frequency. YaTQA provides configurable delays and "Commands to Flood" settings to avoid bans.
+
+### Blacklist / Blacklist2
+TeamSpeak maintains blacklists of banned IPs (Blacklist1) and server UIDs (Blacklist2).
+
+### Badges
+Visual indicators in TeamSpeak showing user status, addon creator status, etc. YaTQA can configure badges.
+
+### DNS Resolution
+TeamSpeak clients resolve server addresses through multiple methods: A records, CNAME, SRV records, and TSDNS. YaTQA visualizes this process.
+
+---
+
+## Known Limitations
+
+- **Channel passwords:** YaTQA never sends channel passwords. Requires `b_channel_join_ignore_password` and `b_ft_ignore_password` permissions.
+- **Unicode:** Only Basic Multilingual Plane (BMP) supported (TeamSpeak limitation).
+- **Integrated DNS lookups:** Only A and CNAME records (TSDNS and SRV unsupported in built-in resolver).
+- **Ghost mode:** Many features don't work; ghost has Query Guest permissions.
+- **Console:** Only limitations from TS3 server apply.
+
+---
+
+## IPv6 Support
+
+Use square brackets `[]` around the server address. Supported since v1.4/2.0-pre for query connections. IPv4 tunnels (e.g., `[::ffff:7f00:1]`) are not supported.
+
+---
+
+## Project History
+
+- **2011-04-10:** Development started (originally named "TS3Telnet")
+- **2011-06-29:** First alpha version released
+- **2014-04-18:** v2.0 introduced registration requirement for some features
+- **2019-08-22:** YaTQA became unlimited freeware again
+- **2023-03-01:** v3.9.9b released (removed time limit permanently)
+
+### Naming
+"Yet Another TeamSpeak³ Query App" — named because there were already many query tools when development started, but none worked for the author.
+
+### Pronunciation
+[jatka] in IPA notation — also suitable for German speakers.
+
+---
+
+## Global Hotkeys
+
+| Shortcut | Action |
+|----------|--------|
+| Ctrl+F | Filter (permissions, log) or find |
+| Ctrl+Alt+F | Find in lists |
+| F3 | Find next |
+| Ctrl+A | Select all |
+| Ctrl+C | Copy or save selected data |
+| Ctrl+Alt+A | Auto-adjust columns |
+| F2 | Rename |
+| F5 | Refresh tab |
+| NUM + | Check selected checkbox items |
+| NUM - | Uncheck selected checkbox items |
+| Ctrl+Space | Select parameter value (console) |
+| Ctrl+E | Escape selected text (console) |
+| Ctrl+S | Save chart as image |
+
+---
+
+## Resources
+
+- **Website:** https://yat.qa/
+- **Download:** https://dl.yat.qa/stable/
+- **Features:** https://yat.qa/features/
+- **Manual:** https://yat.qa/manual/
+- **Changelog:** https://yat.qa/changelog/
+- **FAQ:** https://yat.qa/faq/
+- **Support:** https://yat.qa/support/
+- **Resources:** https://yat.qa/resources/
+- **About:** https://yat.qa/about/
+
+---
+
+## Translation
+
+YaTQA's original language is German. Translation is done using OmegaT with XLIFF files. Contact the author before translating. The translation system uses:
+- `%s` — String placeholder
+- `%d` — Decimal number placeholder
+- `&` — Shortcut key
+- `&&` — Actual ampersand
+- `|` — Vertical line (hint text separator)
+- `\r\n` — New line
+- `\t` — Tab
@@ -0,0 +1,608 @@
+# Chanora Function Inventory
+
+> Auto-generated comprehensive inventory of all public APIs across 10 Rust crates and 50+ Dart files.
+
+## Summary Statistics
+
+| Category | Count |
+|----------|-------|
+| **Rust Crates** | 10 |
+| **Rust pub fn** | ~180 |
+| **Rust pub struct** | ~90 |
+| **Rust pub enum** | ~50 |
+| **Rust pub trait** | 6 |
+| **Rust pub const** | ~30 |
+| **Dart files** | 56 |
+| **Dart public classes** | ~80 |
+| **TODO/FIXME comments** | 15 |
+| **Empty/commented stubs** | 0 |
+
+---
+
+## Rust Crates
+
+### 1. `chanora_cache` — Content-Addressed Blob Cache
+
+Disposable blob cache for avatar/icon files. Wraps `cacache` for crash safety.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `BlobCache` | lib.rs:30 | Content-addressed blob cache backed by cacache |
+| enum | `BlobCacheError` | lib.rs:20 | Errors raised by blob cache (Io, InvalidKey) |
+| const | `PREFIX_AVATAR` | lib.rs:37 | Avatar blob prefix `"av_"` |
+| const | `PREFIX_ICON` | lib.rs:39 | Icon blob prefix `"ic_"` |
+| fn | `BlobCache::new` | lib.rs:46 | Create/open cache rooted at `cache_dir/chanora/` |
+| fn | `BlobCache::put` | lib.rs:63 | Store a blob with prefix+key |
+| fn | `BlobCache::get` | lib.rs:80 | Read a blob (returns None if missing) |
+| fn | `BlobCache::remove` | lib.rs:101 | Delete a specific blob |
+| fn | `BlobCache::clear` | lib.rs:111 | Delete all blobs |
+| fn | `BlobCache::total_size` | lib.rs:129 | Return total bytes used |
+| fn | `BlobCache::evict` | lib.rs:154 | Evict oldest entries until under max_bytes |
+
+**Dead code:** None found. All public items consumed by `chanora_core`.
+
+---
+
+### 2. `chanora_protocol` — TeamSpeak Protocol Adapter
+
+Isolates `tsclientlib` behind a typed boundary. No upstream types leak.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `ConnectConfig` | adapter.rs:146 | Typed connection parameters |
+| struct | `ProtocolClient` | adapter.rs:236 | Async handle owning live protocol connection |
+| struct | `InboundVoice` | adapter.rs:260 | One inbound voice packet from remote client |
+| struct | `SnapshotProbe` | adapter.rs:270 | Clone-free probe handle for watchdog |
+| struct | `ChannelInfo` | dto.rs:19 | One channel in server tree |
+| struct | `ClientInfo` | dto.rs:72 | One connected client |
+| struct | `ClientProfile` | dto.rs:96 | Rich profile + live connection details |
+| struct | `ServerSnapshot` | dto.rs:153 | Full server state snapshot |
+| struct | `ChatMessage` | dto.rs:50 | In-channel text message |
+| struct | `ServerActivity` | dto.rs:65 | Server-activity notification |
+| struct | `ChannelId` | dto.rs:11 | Opaque channel identifier (u64 newtype) |
+| struct | `ClientId` | dto.rs:15 | Opaque client identifier (u64 newtype) |
+| struct | `PokeLimiter` | poke_limiter.rs:19 | Per-connection poke rate limiter |
+| enum | `ProtocolError` | lib.rs:62 | Typed error catalogue (9 variants) |
+| enum | `ProtocolDelta` | dto.rs:183 | Incremental state changes (7 variants) |
+| enum | `DisconnectReason` | adapter.rs:225 | Why protocol task ended |
+| enum | `MessageTarget` | dto.rs:37 | Text message target scope |
+| enum | `PokeStrength` | poke_limiter.rs:8 | Poke notification strength |
+| trait | *(re-exports)* | lib.rs:52 | `AudioData`, `CodecType`, `Direction`, `InAudioBuf`, `OutAudio`, `OutPacket` |
+| fn | `ProtocolClient::generate_identity` | adapter.rs:296 | Generate fresh TS3 identity string |
+| fn | `ProtocolClient::connect` | adapter.rs:304 | Dial server, wait for initial snapshot |
+| fn | `ProtocolClient::snapshot` | adapter.rs:354 | Read typed server state snapshot |
+| fn | `ProtocolClient::client_profile` | adapter.rs:365 | Fetch rich client profile |
+| fn | `ProtocolClient::download_avatar` | adapter.rs:389 | Download avatar bytes by UID |
+| fn | `ProtocolClient::download_icon` | adapter.rs:394 | Download icon bytes by ID |
+| fn | `ProtocolClient::disconnect` | adapter.rs:399 | Clean disconnect |
+| fn | `ProtocolClient::move_to_channel` | adapter.rs:421 | Move self to channel |
+| fn | `ProtocolClient::queue_move_to_channel` | adapter.rs:442 | Fire-and-forget move |
+| fn | `ProtocolClient::set_muted` | adapter.rs:458 | Update own mute state |
+| fn | `ProtocolClient::voice_out` | adapter.rs:477 | Get outbound voice sender |
+| fn | `ProtocolClient::snapshot_probe` | adapter.rs:485 | Get watchdog probe handle |
+| fn | `ProtocolClient::take_voice_in` | adapter.rs:493 | Take inbound voice receiver |
+| fn | `ProtocolClient::put_voice_in` | adapter.rs:503 | Put voice receiver back |
+| fn | `ProtocolClient::take_loss_notifier` | adapter.rs:519 | Take disconnect notifier |
+| fn | `ProtocolClient::take_chat_rx` | adapter.rs:525 | Take chat receiver |
+| fn | `ProtocolClient::put_chat_rx` | adapter.rs:530 | Put chat receiver back |
+| fn | `ProtocolClient::take_activity_rx` | adapter.rs:540 | Take activity receiver |
+| fn | `ProtocolClient::put_activity_rx` | adapter.rs:545 | Put activity receiver back |
+| fn | `ProtocolClient::take_delta_rx` | adapter.rs:556 | Take delta receiver |
+| fn | `ProtocolClient::send_text_message` | adapter.rs:561 | Send text message |
+| fn | `SnapshotProbe::probe` | adapter.rs:278 | Issue single snapshot RPC |
+| fn | `PokeLimiter::new` | poke_limiter.rs:36 | Create limiter with 5-min window |
+| fn | `PokeLimiter::record` | poke_limiter.rs:44 | Record poke, return strength |
+| fn | `ChannelId::ROOT` | dto.rs:176 | Root channel constant |
+
+**Dead code:** None found. All items consumed by `chanora_core`.
+
+---
+
+### 3. `chanora_bridge` — Flutter/Rust Bridge
+
+Typed DTOs and commands for `flutter_rust_bridge` 2.x.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `BridgeChannel` | api.rs:404 | Channel DTO for Dart |
+| struct | `BridgeClient` | api.rs:422 | Client DTO for Dart |
+| struct | `BridgeClientProfile` | api.rs:445 | Rich profile DTO for Dart |
+| struct | `BridgeSnapshot` | api.rs:502 | Server snapshot DTO for Dart |
+| struct | `BridgeAudioStats` | api.rs:1034 | Audio engine statistics |
+| struct | `BridgeAudioProcessingConfig` | api.rs:1112 | Audio processing config DTO |
+| struct | `BridgeAudioProcessingStats` | api.rs:1143 | Audio processing stats DTO |
+| struct | `BridgePttDescriptor` | api.rs:854 | PTT capability descriptor |
+| struct | `BridgePttBinding` | api.rs:875 | PTT binding display state |
+| enum | `BridgeError` | lib.rs:55 | Bridge-layer errors (8 variants) |
+| enum | `BridgeTransmitMode` | api.rs:731 | Transmit mode mirror |
+| enum | `BridgePttInputClass` | api.rs:843 | PTT input class |
+| enum | `BridgeAudioRoute` | api.rs:1047 | Audio route class |
+| enum | `BridgeIosVoiceProcessingMode` | api.rs:1064 | iOS voice processing mode |
+| enum | `BridgeAudioBackend` | api.rs:1071 | Processing backend |
+| enum | `BridgeVadBackend` | api.rs:1084 | VAD backend |
+| enum | `BridgeEffectOwner` | api.rs:1097 | AEC/NS/AGC owner |
+| fn | `bridge_init` | api.rs:220 | One-time process init (FRB init) |
+| fn | `log_file_path_str` | api.rs:294 | Platform log file path |
+| fn | `connect` | api.rs:601 | Connect to TS3 server |
+| fn | `prefetch_server` | api.rs:636 | Warm DNS resolution |
+| fn | `snapshot` | api.rs:645 | Re-fetch server snapshot |
+| fn | `client_profile` | api.rs:654 | Fetch client profile |
+| fn | `disconnect` | api.rs:663 | Disconnect from server |
+| fn | `is_connected` | api.rs:672 | Check connection status |
+| fn | `handle_route_change` | api.rs:687 | iOS route change handler |
+| fn | `handle_media_services_reset_with_route` | api.rs:696 | iOS media reset handler |
+| fn | `handle_interruption_began` | api.rs:703 | iOS interruption begin |
+| fn | `handle_interruption_ended` | api.rs:709 | iOS interruption end |
+| fn | `set_ptt` | api.rs:718 | Set PTT active state |
+| fn | `voice_join` | api.rs:770 | Join voice channel |
+| fn | `voice_leave` | api.rs:785 | Leave voice channel |
+| fn | `set_transmit_mode` | api.rs:794 | Set transmit mode |
+| fn | `get_transmit_mode` | api.rs:803 | Get transmit mode |
+| fn | `set_release_tail_ms` | api.rs:814 | Set release tail |
+| fn | `get_release_tail_ms` | api.rs:823 | Get release tail |
+| fn | `set_hard_mute` | api.rs:832 | Engage/release hard mute |
+| fn | `set_ptt_binding` | api.rs:907 | Update PTT binding |
+| fn | `ptt_descriptor` | api.rs:925 | Get PTT descriptor |
+| fn | `get_ptt_binding` | api.rs:941 | Get persisted PTT binding |
+| fn | `move_to_channel` | api.rs:955 | Move self to channel |
+| fn | `set_input_muted` | api.rs:971 | Toggle input mute |
+| fn | `set_output_muted` | api.rs:983 | Toggle output mute |
+| fn | `set_output_gain` | api.rs:994 | Set master output gain |
+| fn | `set_client_volume` | api.rs:1006 | Set per-client volume |
+| fn | `send_chat_message` | api.rs:1015 | Send text message |
+| fn | `export_diagnostics` | api.rs:1392 | User-initiated diagnostic export |
+
+**Dead code:** `publish_permission_state` is `#[cfg_attr(not(target_os = "android"), allow(dead_code))]` — intentional, only used on Android via JNI.
+
+---
+
+### 4. `chanora_storage` — Identity & Bookmark Storage
+
+SQLite bookmarks + ChaCha20-Poly1305 encrypted identity file.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `IdentityFileStore` | lib.rs:176 | Encrypted identity file store |
+| struct | `BookmarkRepository` | lib.rs:792 | SQLite-backed bookmark store |
+| struct | `Bookmark` | lib.rs:767 | A persisted bookmark |
+| struct | `PttBindingMeta` | lib.rs:117 | PTT binding metadata |
+| enum | `StorageError` | lib.rs:59 | Storage errors (6 variants) |
+| trait | `Crypto` | lib.rs:673 | Envelope encryption abstraction |
+| const | `KEYRING_SERVICE` | lib.rs:190 | Keyring service name `"chanora"` |
+| fn | `IdentityFileStore::new` | lib.rs:194 | Construct store at directory |
+| fn | `IdentityFileStore::path` | lib.rs:211 | Get identity file path |
+| fn | `IdentityFileStore::crypto` | lib.rs:384 | Get DekCrypto helper |
+| fn | `IdentityFileStore::load` | lib.rs:390 | Read persisted identity |
+| fn | `IdentityFileStore::save` | lib.rs:449 | Persist identity (encrypted) |
+| fn | `IdentityFileStore::set_transmit_mode` | lib.rs:520 | Persist transmit mode |
+| fn | `IdentityFileStore::get_transmit_mode` | lib.rs:528 | Read transmit mode |
+| fn | `IdentityFileStore::set_release_tail_ms` | lib.rs:534 | Persist release tail |
+| fn | `IdentityFileStore::get_release_tail_ms` | lib.rs:542 | Read release tail |
+| fn | `IdentityFileStore::set_ptt_binding` | lib.rs:554 | Persist PTT binding |
+| fn | `IdentityFileStore::get_ptt_binding` | lib.rs:568 | Read PTT binding |
+| fn | `IdentityFileStore::clear` | lib.rs:579 | Remove persisted identity |
+| fn | `BookmarkRepository::new` | lib.rs:801 | Open DB without encryption |
+| fn | `BookmarkRepository::with_crypto` | lib.rs:807 | Open DB with password encryption |
+| fn | `BookmarkRepository::encrypts_passwords` | lib.rs:858 | Check if encryption wired |
+| fn | `BookmarkRepository::add` | lib.rs:865 | Insert bookmark |
+| fn | `BookmarkRepository::upsert_or_add` | lib.rs:891 | Insert or update by host |
+| fn | `BookmarkRepository::update` | lib.rs:935 | Replace existing bookmark |
+| fn | `BookmarkRepository::delete` | lib.rs:963 | Delete bookmark by id |
+| fn | `BookmarkRepository::list` | lib.rs:976 | List all bookmarks |
+
+**Dead code:** None found.
+
+---
+
+### 5. `chanora_state` — Server State Mirror
+
+Authoritative client-side mirror of server state with deterministic reducers.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `ServerState` | lib.rs:62 | Authoritative server state mirror |
+| struct | `Reduction` | lib.rs:266 | Result of applying one event |
+| struct | `ChannelJoinState` | channel_join.rs:53 | Channel-join reducer state |
+| struct | `AuthoritativeMembership` | channel_join.rs:27 | Server-confirmed membership |
+| struct | `JoinPending` | channel_join.rs:36 | Active pending join intent |
+| struct | `ChannelJoinProjection` | channel_join.rs:135 | Reducer projection for UI |
+| struct | `JoinOutcomeKey` | channel_join.rs:124 | Correlation key for outcomes |
+| struct | `ConnectionEpoch` | channel_join.rs:15 | Per-connection epoch |
+| struct | `JoinGeneration` | channel_join.rs:19 | Monotonic join generation |
+| struct | `JoinRequestId` | channel_join.rs:23 | Protocol request identifier |
+| struct | `ChannelId` (join) | channel_join.rs:11 | Channel identifier at reducer seam |
+| enum | `ConnectionState` | lib.rs:43 | Connection lifecycle (5 variants) |
+| enum | `Delta` | lib.rs:209 | State changes for bridge (8 variants) |
+| enum | `StateEvent` | lib.rs:237 | Events flowing into reducer (9 variants) |
+| enum | `StateError` | lib.rs:32 | State errors (2 variants) |
+| enum | `ChannelJoinEvent` | channel_join.rs:165 | Channel-join events (10 variants) |
+| enum | `ChannelJoinAction` | channel_join.rs:240 | Side-effect actions (7 variants) |
+| enum | `ChannelJoinSyncState` | channel_join.rs:101 | Sync readiness (2 variants) |
+| enum | `SyncReason` | channel_join.rs:115 | Sync reason (2 variants) |
+| enum | `JoinReduceStatus` | channel_join.rs:309 | Transition status (9 variants) |
+| enum | `JoinIntentRejected` | channel_join.rs:332 | Rejection reasons (2 variants) |
+| enum | `JoinFailureKind` | channel_join.rs:341 | Failure kinds (5 variants) |
+| enum | `JoinErrorCode` | channel_join.rs:356 | Stable error codes (11 variants) |
+| enum | `JoinDiagnosticKey` | channel_join.rs:284 | Diagnostic event keys (10 variants) |
+| enum | `AuthoritativeSource` | channel_join.rs:156 | Membership input source |
+| fn | `ServerState::from_snapshot` | lib.rs:83 | Build from initial snapshot |
+| fn | `ServerState::replace_from_snapshot` | lib.rs:114 | Replace with fresh snapshot |
+| fn | `ServerState::channel` | lib.rs:119 | Look up channel by id |
+| fn | `ServerState::client` | lib.rs:124 | Look up client by id |
+| fn | `ServerState::channels` | lib.rs:130 | All channels iterator |
+| fn | `ServerState::clients` | lib.rs:141 | All clients iterator |
+| fn | `ServerState::channel_count` | lib.rs:148 | Number of channels |
+| fn | `ServerState::client_count` | lib.rs:153 | Number of clients |
+| fn | `ServerState::own_channel` | lib.rs:158 | Own client's channel |
+| fn | `ServerState::clients_in_channel` | lib.rs:164 | Clients in specific channel |
+| fn | `reduce` | lib.rs:281 | Apply StateEvent to state |
+| fn | `reduce_reconnect_snapshot` | lib.rs:409 | Replace state after reconnect |
+| fn | `channel_join::reduce` | channel_join.rs:393 | Channel-join event reducer |
+| fn | `channel_join::project` | channel_join.rs:670 | Build channel-join projection |
+| fn | `ChannelJoinState::new` | channel_join.rs:68 | Create join state for epoch |
+
+**Dead code:** None found.
+
+---
+
+### 6. `chanora_audio` — Audio Subsystem
+
+Platform capture/playback, Opus encoding, VAD, PTT, DSP.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| **Core Engine** | | | |
+| struct | `AudioEngine` | engine.rs:289 | Main audio engine |
+| struct | `AudioEngineConfig` | engine.rs:223 | Engine configuration |
+| struct | `SessionAudioId` | engine.rs:69 | Stable audio session ID |
+| struct | `AudioDeviceList` | engine.rs:87 | Available audio devices |
+| struct | `AudioDeviceInfo` | engine.rs:96 | Single audio device info |
+| enum | `AudioError` | lib.rs:100 | Audio subsystem errors (7 variants) |
+| struct | `AudioEffects` | lib.rs:136 | AEC/AGC/NS/HPF toggles |
+| fn | `list_audio_devices` | engine.rs:176 | Enumerate input/output devices |
+| fn | `AudioEngine::start` | engine.rs:634 | Start audio engine |
+| fn | `AudioEngine::start_with_gate` | engine.rs:647 | Start with transmit gate |
+| fn | `AudioEngine::stop` | engine.rs:1358 | Stop audio engine |
+| fn | `AudioEngine::set_transmit_active` | engine.rs:1601 | Set transmit state |
+| fn | `AudioEngine::transmit_active` | engine.rs:1606 | Get transmit state |
+| fn | `AudioEngine::set_output_muted` | engine.rs:1702 | Set output mute |
+| fn | `AudioEngine::set_output_gain` | engine.rs:1714 | Set output gain |
+| fn | `AudioEngine::set_client_volume` | engine.rs:1727 | Set per-client volume |
+| fn | `AudioEngine::set_audio_processing_config` | engine.rs:1646 | Update processing config |
+| fn | `AudioEngine::audio_processing_stats` | engine.rs:1683 | Get processing stats |
+| **Frame Helpers** | | | |
+| const | `SAMPLE_RATE_HZ` | frame.rs:9 | 48000 Hz |
+| const | `FRAME_10MS_SAMPLES` | frame.rs:15 | 480 samples |
+| const | `FRAME_20MS_SAMPLES` | frame.rs:17 | 960 samples |
+| struct | `AudioFrame10ms` | frame.rs:21 | 10ms processing frame |
+| struct | `AudioFrame20ms` | frame.rs:28 | 20ms network frame |
+| fn | `i16_to_f32` | frame.rs:64 | PCM conversion |
+| fn | `f32_to_i16` | frame.rs:69 | PCM conversion |
+| fn | `dbfs` | frame.rs:74 | RMS dBFS calculation |
+| **Transmit** | | | |
+| enum | `TransmitMode` | transmit_mode.rs:13 | Ptt/Continuous/VoiceActivity |
+| enum | `PermissionGate` | transmit_selector.rs:38 | Mic permission state |
+| struct | `TransmitModeSelector` | transmit_selector.rs:88 | Multi-signal transmit selector |
+| struct | `AudioTransmitGate` | ptt.rs:139 | Atomic transmit flag |
+| struct | `ReleaseTailTimer` | release_tail.rs:43 | PTT release-tail timer |
+| const | `DEFAULT_TAIL_MS` | release_tail.rs:24 | 200ms default |
+| const | `MAX_TAIL_MS` | release_tail.rs:21 | 500ms max |
+| **PTT** | | | |
+| enum | `PttCapabilityLevel` | ptt.rs:34 | L0-L4 capability levels |
+| struct | `PttBackendDescriptor` | ptt.rs:97 | Privacy-safe PTT descriptor |
+| struct | `MissedKeyUpWatchdog` | ptt.rs:202 | PTT safety watchdog |
+| trait | `DesktopPttBackend` | ptt_backends/mod.rs:162 | Platform PTT backend trait |
+| struct | `PttBinding` | ptt_backends/mod.rs:48 | PTT binding metadata |
+| enum | `PttInputClass` | ptt_backends/mod.rs:84 | None/Keyboard/MouseSideButton |
+| enum | `PttBackendError` | ptt_backends/mod.rs:113 | PTT backend errors |
+| fn | `select_ptt_backend` | ptt_backends/mod.rs:213 | Auto-select best backend |
+| **Audio Processing** | | | |
+| enum | `AudioRoute` | audio_processing.rs:14 | Route class (6 variants) |
+| enum | `AudioBackend` | audio_processing.rs:65 | Processing backend (4 variants) |
+| enum | `VadBackend` | audio_processing.rs:90 | VAD backend (4 variants) |
+| enum | `EffectOwner` | audio_processing.rs:122 | Effect owner (5 variants) |
+| enum | `IosVoiceProcessingMode` | audio_processing.rs:58 | iOS VPIO mode |
+| struct | `AudioProcessingConfig` | audio_processing.rs:137 | Full processing config |
+| struct | `AudioProcessingStats` | audio_processing.rs:270 | Processing statistics |
+| struct | `SharedAudioProcessingStats` | audio_processing.rs:322 | Thread-safe stats |
+| **DSP** | | | |
+| struct | `Aec3` | processor/dsp/aec3.rs:48 | Acoustic echo canceller |
+| struct | `Agc2` | processor/dsp/agc2.rs:206 | Automatic gain control |
+| struct | `HighPassFilter` | processor/dsp/hpf.rs:42 | High-pass filter |
+| struct | `NoiseSuppressor` | processor/dsp/ns.rs:40 | Noise suppressor |
+| trait | `AudioProcessor` | processor/mod.rs:21 | Realtime processor trait |
+| struct | `NoopProcessor` | processor/noop.rs:6 | No-op processor |
+| struct | `PlatformVoiceProcessor` | processor/platform.rs:10 | Platform VPIO processor |
+| struct | `SonoraProcessor` | processor/sonora.rs:88 | Sonora DSP processor |
+| struct | `SonoraConfig` | processor/sonora.rs:37 | Sonora configuration |
+| struct | `WebRtcApmProcessor` | processor/webrtc_apm.rs:91 | WebRTC APM processor |
+| struct | `WebRtcApmConfig` | processor/webrtc_apm.rs:17 | WebRTC APM config |
+| **VAD** | | | |
+| trait | `VoiceActivityDetector` | vad/mod.rs:34 | VAD trait |
+| struct | `VadOutput` | vad/mod.rs:26 | VAD output (probability + speech) |
+| struct | `WebRtcFallbackVad` | vad/mod.rs:40 | WebRTC fallback VAD |
+| struct | `Resampled16kHzVad` | vad/mod.rs:77 | 48→16kHz resampling wrapper |
+| struct | `SileroOnnxVad` | vad/silero_onnx.rs:62 | Silero ONNX VAD |
+| struct | `Downsampler48to16` | vad/resampler.rs:44 | 48→16kHz downsampler |
+| fn | `set_silero_model_path` | vad/mod.rs:126 | Set VAD model path |
+| fn | `silero_model_epoch` | vad/mod.rs:147 | Get model epoch |
+| **Voice Activity** | | | |
+| struct | `VoiceActivityStateMachine` | voice_activity.rs:29 | VAD gate state machine |
+| **Mobile Backend** | | | |
+| trait | `MobileVoiceAudioBackend` | mobile_voice_backend.rs:262 | Mobile audio backend trait |
+| struct | `AndroidVoiceStreamConfig` | mobile_voice_backend.rs:194 | Android stream config |
+| struct | `AndroidAudioDiagnostics` | mobile_voice_backend.rs:499 | Android diagnostics |
+| enum | `BackendEvent` | mobile_voice_backend.rs:35 | Backend events |
+| enum | `BackendError` | mobile_voice_backend.rs:154 | Backend errors |
+| enum | `AchievedPerformanceMode` | mobile_voice_backend.rs:112 | Performance mode |
+| enum | `LatencyTier` | mobile_voice_backend.rs:377 | Latency tier |
+| struct | `AndroidVoiceUnit` | android_voice_unit.rs:565 | Android voice unit |
+| struct | `IosVoiceUnit` | ios_voice_unit.rs:522 | iOS voice unit |
+| **Route Policy** | | | |
+| fn | `ios_route_policy` | route_policy.rs:27 | Route→config policy for iOS |
+| fn | `apply_route_change` | route_policy.rs:105 | Apply route change |
+| **Mode Stack** | | | |
+| struct | `ModeStack` | mode_stack.rs:88 | Android audio mode refcount |
+| enum | `ModeAcquire` | mode_stack.rs:41 | Acquire result |
+| enum | `ModeRelease` | mode_stack.rs:62 | Release result |
+| **Debug** | | | |
+| struct | `WavDebugRecorder` | debug_wav.rs:68 | Debug WAV recorder |
+
+**Dead code:** `AndroidVoiceUnit`, `IosVoiceUnit`, and platform-specific backends are `#[cfg]`-gated — intentional.
+
+---
+
+### 7. `chanora_resolver` — DNS/SRV/TSDNS Resolver
+
+TeamSpeak address resolution: SRV, TSDNS, nick lookup.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `ChanoraResolver` | lib.rs:108 | Main resolver |
+| struct | `Args` | lib.rs:26 | Resolution arguments |
+| struct | `BuildInfo` | lib.rs:33 | Build metadata |
+| struct | `SrvRecord` | lib.rs:40 | SRV record |
+| struct | `ClientResolution` | lib.rs:58 | Client resolution result |
+| enum | `Resolution` | lib.rs:85 | Resolution result (Dns/Srv/Nick) |
+| enum | `ClientResolutionMethod` | lib.rs:48 | Resolution method (6 variants) |
+| const | `DEFAULT_TEAMSPEAK_PORT` | lib.rs:23 | Port 9987 |
+| fn | `build_info` | lib.rs:123 | Get build info |
+| fn | `setup_log` | lib.rs:137 | Setup logging |
+| fn | `ChanoraResolver::new` | lib.rs:157 | Create resolver |
+| fn | `ChanoraResolver::resolve` | lib.rs:178 | Resolve with Args |
+| fn | `ChanoraResolver::resolve_connection_address` | lib.rs:193 | Resolve to connection address |
+| fn | `ChanoraResolver::resolve_client_address` | lib.rs:197 | Resolve client input to address |
+| fn | `ChanoraResolver::resolve_client_request` | lib.rs:201 | Resolve with full metadata |
+| fn | `ChanoraResolver::resolve_dns` | lib.rs:594 | DNS lookup |
+| fn | `ChanoraResolver::resolve_ts3` | lib.rs:614 | TS3 SRV lookup |
+| fn | `ChanoraResolver::resolve_tsdns` | lib.rs:619 | TSDNS SRV lookup |
+| fn | `ChanoraResolver::resolve_nick` | lib.rs:624 | Nick lookup |
+| fn | `normalize_args` | lib.rs:778 | Normalize Args |
+| fn | `validate_args` | lib.rs:785 | Validate Args |
+| fn | `run` | lib.rs:804 | CLI entry point |
+
+**Dead code:** `run()` is a CLI entry point, not called from library code — intentional.
+
+---
+
+### 8. `chanora_prefetch` — Server Address Prefetch
+
+Speculative DNS warming for faster connects.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `ServerPrefetcher` | lib.rs:83 | Prefetch cache + async resolver |
+| enum | `ServerPrefetchError` | lib.rs:18 | Prefetch errors |
+| fn | `ServerPrefetcher::new` | lib.rs:90 | Create prefetcher |
+| fn | `ServerPrefetcher::prefetch` | lib.rs:99 | Schedule fire-and-forget prefetch |
+| fn | `ServerPrefetcher::fresh_match` | lib.rs:145 | Check for cached result |
+
+**Dead code:** None found.
+
+---
+
+### 9. `chanora_diagnostics` — Redaction & Diagnostic Export
+
+Redaction policy, in-memory log sink, PTT sanitizer.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `Redactor` | lib.rs:121 | Production redaction policy |
+| struct | `KnownSecretRegistry` | lib.rs:79 | Secret substring registry |
+| struct | `InMemoryLogSink` | lib.rs:356 | Bounded redacted log sink |
+| struct | `RedactingLogLayer` | lib.rs:440 | tracing Layer for redaction |
+| struct | `PttSanitizer` | lib.rs:505 | PTT field ban Layer |
+| struct | `DiagnosticExport` | lib.rs:614 | Export bundle |
+| struct | `ProtocolEventRecorder` | lib.rs:714 | Protocol event ring buffer |
+| enum | `DiagnosticsError` | lib.rs:51 | Diagnostics errors |
+| const | `REDACTION_MARKER` | lib.rs:62 | `"[REDACTED]"` |
+| const | `DEFAULT_LOG_CAPACITY` | lib.rs:67/70 | 256 (release) / 4096 (debug) |
+| fn | `Redactor::with_default_policy` | lib.rs:128 | Create redactor |
+| fn | `Redactor::with_secrets` | lib.rs:134 | Create with secret registry |
+| fn | `Redactor::secrets` | lib.rs:140 | Access secret registry |
+| fn | `Redactor::redact` | lib.rs:150 | Apply redaction policy |
+| fn | `KnownSecretRegistry::register` | lib.rs:85 | Register secret |
+| fn | `KnownSecretRegistry::len` | lib.rs:99 | Count secrets |
+| fn | `KnownSecretRegistry::is_empty` | lib.rs:104 | Check empty |
+| fn | `KnownSecretRegistry::contains_substr` | lib.rs:110 | Substring check |
+| fn | `InMemoryLogSink::new` | lib.rs:365 | Create sink |
+| fn | `InMemoryLogSink::snapshot` | lib.rs:377 | Snapshot lines |
+| fn | `InMemoryLogSink::push` | lib.rs:386 | Push redacted line |
+| fn | `InMemoryLogSink::redactor` | lib.rs:397 | Access redactor |
+| fn | `RedactingLogLayer::new` | lib.rs:446 | Create layer |
+| fn | `RedactingLogLayer::with_sanitizer` | lib.rs:452 | Wrap with PTT sanitizer |
+| fn | `PttSanitizer::wrap` | lib.rs:513 | Wrap inner layer |
+| fn | `DiagnosticExport::from_sink` | lib.rs:636 | Build export |
+| fn | `DiagnosticExport::with_android_audio` | lib.rs:655 | Attach Android audio YAML |
+| fn | `DiagnosticExport::with_network_info` | lib.rs:661 | Attach network info |
+| fn | `DiagnosticExport::with_protocol_events` | lib.rs:667 | Attach protocol events |
+| fn | `DiagnosticExport::to_text` | lib.rs:674 | Render as plaintext |
+| fn | `ProtocolEventRecorder::new` | lib.rs:721 | Create recorder |
+| fn | `ProtocolEventRecorder::record_connected` | lib.rs:740 | Record connection |
+| fn | `ProtocolEventRecorder::record_disconnected` | lib.rs:745 | Record disconnect |
+| fn | `ProtocolEventRecorder::record_reconnecting` | lib.rs:750 | Record reconnect |
+| fn | `ProtocolEventRecorder::record_snapshot_changed` | lib.rs:759 | Record snapshot change |
+| fn | `ProtocolEventRecorder::record_channel_join` | lib.rs:768 | Record channel join |
+| fn | `ProtocolEventRecorder::record_lifecycle` | lib.rs:777 | Record lifecycle |
+| fn | `ProtocolEventRecorder::drain` | lib.rs:782 | Drain all events |
+| fn | `ProtocolEventRecorder::snapshot` | lib.rs:787 | Snapshot events |
+
+**Dead code:** None found.
+
+---
+
+### 10. `chanora_core` — Top-Level Orchestration
+
+Integration point composing all subsystems behind a stable API.
+
+| Kind | Name | File:Line | Purpose |
+|------|------|-----------|---------|
+| struct | `ChanoraSession` | lib.rs:191 | Process-wide session handle |
+| enum | `CoreError` | lib.rs:84 | Top-level errors (7 variants) |
+| struct | `PttDescriptorSnapshot` | events.rs:6 | PTT descriptor snapshot |
+| struct | `PersistedPttBinding` | events.rs:27 | Persisted PTT binding |
+| struct | `PttController` | ptt.rs:68 | PTT controller |
+| struct | `FileTransferService` | file_transfer.rs:39 | File transfer service |
+| enum | `SessionEvent` | events.rs:49 | Session lifecycle events |
+| enum | `VoiceJoinSyncState` | events.rs:239 | Voice join sync state |
+| enum | `VoiceJoinErrorCode` | events.rs:250 | Voice join error codes |
+| enum | `NetworkState` | events.rs:280 | Network connectivity state |
+| enum | `FileTransferError` | file_transfer.rs:17 | File transfer errors |
+| enum | `PttControllerError` | ptt.rs:35 | PTT controller errors |
+| fn | `ChanoraSession::new` | lib.rs:245 | Create session |
+| fn | `ChanoraSession::subscribe_events` | lib.rs:478 | Subscribe to session events |
+| fn | `ChanoraSession::set_network_state` | lib.rs:460 | Set network state |
+| fn | `ChanoraSession::network_state` | lib.rs:469 | Get network state |
+| fn | `ChanoraSession::transmit_mode` | lib.rs:1568 | Get transmit mode |
+| fn | `ChanoraSession::hard_mute` | lib.rs:1591 | Get hard mute state |
+| fn | `ChanoraSession::release_tail_ms` | lib.rs:1645 | Get release tail |
+| fn | `ChanoraSession::transmit_selector` | lib.rs:1652 | Get transmit selector |
+| fn | `ChanoraSession::release_tail_timer` | lib.rs:1659 | Get release tail timer |
+| fn | `ChanoraSession::audio_processing_stats_if_ready` | lib.rs:1205 | Get audio stats |
+| fn | `PttController::new` | ptt.rs:103 | Create PTT controller |
+| fn | `PttController::current_capability` | ptt.rs:226 | Get PTT capability |
+| fn | `PttController::subscribe_capability` | ptt.rs:233 | Subscribe to capability |
+| fn | `PttController::descriptor_watch` | ptt.rs:250 | Watch PTT descriptor |
+| fn | `PttController::press_gate` | ptt.rs:257 | Get press gate |
+| fn | `PttController::release_tail` | ptt.rs:263 | Get release tail |
+
+**Dead code:** None found. All items consumed by `chanora_bridge`.
+
+---
+
+## Dart Files (apps/chanora_flutter/lib/)
+
+### Widgets (31 files)
+
+| Class | File:Line | Purpose |
+|-------|-----------|---------|
+| `AppSnackBar` | widgets/app_snack_bar.dart:9 | Snackbar notifications |
+| `AppSnackBarVariant` | widgets/app_snack_bar.dart:6 | Neutral/success/warning/error |
+| `AudioDebugStatsPanel` | widgets/audio_debug_stats_panel.dart:22 | Audio stats debug panel |
+| `AudioDeviceListTile` | widgets/audio_device_list_tile.dart:21 | Audio device list item |
+| `AudioDeviceKind` | widgets/audio_device_list_tile.dart:12 | Input/Output device kind |
+| `AudioOutputTile` | widgets/audio_output_tile.dart:15 | Audio output route picker |
+| `AudioProcessingConfigState` | widgets/audio_processing_config_state.dart:34 | Processing config state |
+| `BbCodeText` | widgets/bbcode_text.dart:47 | BBCode renderer |
+| `ChatPanel` | widgets/chat_panel.dart:13 | Chat panel container |
+| `ChatEntry` | widgets/chat_views.dart:25 | Chat message entry |
+| `ChatClientGroups` | widgets/chat_views.dart:374 | Client grouping for chat |
+| `ChatPage` | widgets/chat_views.dart:548 | Full chat page |
+| `ChatDetailView` | widgets/chat_views.dart:1070 | Chat detail view |
+| `ClientInfoSheet` | widgets/client_info_sheet.dart:7 | Client info bottom sheet |
+| `ConnectForm` | widgets/connect_widgets.dart:9 | Server connect form |
+| `BookmarkList` | widgets/connect_widgets.dart:154 | Bookmark list |
+| `CapturedBinding` | widgets/input_dialogs.dart:50 | PTT binding capture result |
+| `BookmarkNameDialog` | widgets/input_dialogs.dart:61 | Bookmark name input |
+| `ChannelPasswordDialog` | widgets/input_dialogs.dart:109 | Channel password input |
+| `PttBindingCaptureDialog` | widgets/input_dialogs.dart:154 | PTT key binding dialog |
+| `PermissionStateBanner` | widgets/permission_state_banner.dart:28 | Permission state banner |
+| `PokeNotificationSettingsDialog` | widgets/poke_notification_settings.dart:7 | Poke notification settings |
+| `PttCapabilityBadge` | widgets/ptt_capability_badge.dart:14 | PTT capability badge |
+| `SnapshotView` | widgets/snapshot_view.dart:14 | Server tree view |
+| `TalkPowerWarning` | widgets/talk_power_warning.dart:14 | Talk power warning |
+| `VoiceBar` | widgets/voice_bar.dart:18 | Voice status bar |
+| `VoiceStatusChip` | widgets/voice_compact.dart:46 | Voice status chip |
+| `VoicePttButton` | widgets/voice_compact.dart:255 | PTT button widget |
+| `VoiceLevelMeter` | widgets/voice_level_meter.dart:11 | Voice level meter |
+| `VoiceSettingsDialog` | widgets/voice_settings.dart:61 | Voice settings dialog |
+| `VoiceSettingsResult` | widgets/voice_settings.dart:46 | Settings result |
+| `VoiceStatusSummary` | widgets/voice_status_summary.dart:5 | Voice status summary |
+| `VoiceSubHeader` | widgets/voice_settings_controls.dart:117 | Voice sub-header |
+| `VoiceSectionHeader` | widgets/voice_settings_controls.dart:141 | Voice section header |
+| `AudioProcessingToggleRow` | widgets/voice_settings_controls.dart:159 | Processing toggle row |
+
+### Services (20 files)
+
+| Class/Function | File:Line | Purpose |
+|----------------|-----------|---------|
+| `AndroidAudioOutputDevice` | services/android_audio_output_devices.dart:1 | Android audio device |
+| `AndroidPermissionsService` | services/android_permissions_service.dart:34 | Android permission handler |
+| `AppBootstrap` | services/app_bootstrap.dart:95 | App bootstrap helpers |
+| `AudioLifecycleService` | services/audio_lifecycle_service.dart:46 | Audio lifecycle wiring |
+| `BackIntentPolicy` | services/back_intent_policy.dart | Back intent policy |
+| `BackIntentService` | services/back_intent_service.dart:97 | Back intent handler |
+| `ChannelJoinErrorMapper` | services/channel_join_error_mapper.dart:5 | Error message mapper |
+| `ChannelSpacer` | services/channel_spacer.dart:110 | Spacer channel detection |
+| `ConnectionPhaseState` | services/connection_phase_state.dart:38 | Connection phase state |
+| `HardMuteOwners` | services/hard_mute_owners.dart | Hard mute owners |
+| `IosAudioSessionController` | services/ios_audio_session_controller.dart | iOS audio session |
+| `IosPermissionsService` | services/ios_permissions_service.dart:66 | iOS permission handler |
+| `LinkTrustService` | services/link_trust_service.dart:29 | Link trust checker |
+| `MacosPermissionsService` | services/macos_permissions_service.dart:273 | macOS permission handler |
+| `PokePreferencesService` | services/poke_preferences_service.dart:44 | Poke mute preferences |
+| `PokeNotificationService` | services/poke_notification_service.dart | Poke notification handler |
+| `PrefetchDebouncer` | services/prefetch_debouncer.dart:15 | DNS prefetch debouncer |
+| `SnapshotStateMapper` | services/snapshot_state_mapper.dart:43 | Snapshot→state mapper |
+| `Ts3ServerLink` | services/ts3_server_link.dart:83 | TS3 server link parser |
+| `UiPreferencesService` | services/ui_preferences_service.dart | UI preferences |
+| `VoiceJoinOrdering` | services/voice_join_ordering.dart | Voice join ordering |
+
+### Design (4 files)
+
+| Class | File:Line | Purpose |
+|-------|-----------|---------|
+| `ChanoraTokens` | design/chanora_tokens.dart | Design tokens |
+| `Breakpoints` | design/breakpoints.dart | Responsive breakpoints |
+| `ViewportInfo` | design/viewport_info.dart | Viewport info |
+| `PlatformCapabilities` | design/platform_capabilities.dart | Platform capabilities |
+
+---
+
+## Dead Code Analysis
+
+### Confirmed Dead Code
+None found. All public items are consumed by downstream crates or are intentionally platform-gated.
+
+### Platform-Gated (Intentional)
+- `AndroidVoiceUnit`, `IosVoiceUnit` — only compiled on target platforms
+- `chanora_android_*` JNI functions — Android only
+- `ios_voice_unit.rs`, `android_voice_unit.rs` — platform-specific
+- `sdl_output.rs` — Linux only
+
+### TODO/FIXME Items (15 total)
+
+| File | Line | Note |
+|------|------|------|
+| `chanora_audio/src/audio_event_queue.rs` | 27 | Wire to client disconnect path |
+| `chanora_audio/src/engine.rs` | 2348 | Realtime audio callback concern |
+| `chanora_audio/src/mobile_voice_backend.rs` | 16 | Back-fill IosVoiceUnit to trait |
+| `audio_lifecycle_service.dart` | 151 | Wire macOS default device change |
+| `audio_lifecycle_service.dart` | 156 | macOS device change no action yet |
+| `poke_notification_service.dart` | 33,35,41,43,48,130,132,142,155,168 | Future EventSoundService (10 items) |
+
+### Useless Code
+- No empty impls found
+- No commented-out function bodies found
+- No dead trait implementations found
+
+---
+
+## Architecture Notes
+
+- **Boundary discipline**: `tsclientlib` types never cross `chanora_protocol` boundary (SAD-067)
+- **Single connection**: DEC-006 enforces one connection at runtime
+- **Secret isolation**: `chanora_storage` never stores secrets in plaintext DB
+- **Deterministic reducers**: `chanora_state` reducers are pure functions (SRS-056)
+- **PTT privacy**: Raw key codes never appear in logs or diagnostics (DEC-027)
+- **Audio pipeline**: 48kHz mono, 20ms Opus frames, 10ms processing frames
@@ -0,0 +1,252 @@
+# Link Coverage Report
+
+**Generated:** 2026-06-13
+**Scope:** All `.md` files in repository root and `docs/` tree
+
+## Summary
+
+- Total links checked: 148
+- Valid internal links: 12 (4 markdown links + 8 inline doc-path references)
+- Broken internal links: 2
+- Valid inline doc-path references: 94
+- Broken inline doc-path references: 5
+- Valid code references: 62
+- Broken code references: 2
+- External links (manual review): 48
+- Cross-references (doc→doc in prose): 0 broken
+
+---
+
+## Broken Internal Links
+
+Markdown `[text](path)` style links that resolve to missing files.
+
+| File | Line | Link Text | Target | Issue |
+|------|------|-----------|--------|-------|
+| README.md | 428 | `LICENSE-APACHE` | `LICENSE-APACHE` | File does not exist at repo root |
+| README.md | 431 | `LICENSE-MIT` | `LICENSE-MIT` | File does not exist at repo root |
+
+**Impact:** Users clicking the license links in the README will get a 404 on GitHub. These are referenced in the License section as the dual-license model files.
+
+**Also affected by missing LICENSE files:**
+
+| File | Line | Reference | Issue |
+|------|------|-----------|-------|
+| docs/security/license-inventory.md | 9 | `../../LICENSE-APACHE` | Resolves to missing `LICENSE-APACHE` at repo root |
+| docs/security/license-inventory.md | 10 | `../../LICENSE-MIT` | Resolves to missing `LICENSE-MIT` at repo root |
+| docs/security/flutter-license-inventory.md | 11 | `../../LICENSE-APACHE` | Resolves to missing `LICENSE-APACHE` at repo root |
+| docs/security/flutter-license-inventory.md | 12 | `../../LICENSE-MIT` | Resolves to missing `LICENSE-MIT` at repo root |
+
+---
+
+## Valid Internal Links
+
+| File | Line | Target |
+|------|------|--------|
+| README.md | 130 | `docs/architecture/desktop-ptt-architecture.md` |
+| README.md | 436 | `docs/governance/product-decision-register.md` |
+| README.md | 444 | `NOTICE` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 266 | `../ui-ux/adaptive-layout-platform-guide.md` |
+
+---
+
+## Inline Doc-Path References
+
+References to documentation files using backtick-quoted paths (not markdown links).
+
+### Valid
+
+| File | Line | Reference |
+|------|------|-----------|
+| CONTRIBUTING.md | 25 | `docs/governance/git-commit-message-convention.md` |
+| README.md | 144 | `docs/governance/product-decision-register.md` |
+| README.md | 261–271 | `docs/requirements/sysrs.md`, `docs/requirements/srs.md`, `docs/architecture/sysdes.md`, `docs/architecture/sad.md`, `docs/architecture/sdd.md`, `docs/verification/verification-master-plan.md`, `docs/release/release-readiness-go-nogo-record.md`, `docs/release/platform-release-policy.md`, `docs/governance/product-decision-register.md`, `docs/governance/traceability-matrix.md`, `docs/security/security-privacy-legal-guideline.md` |
+| README.md | 312 | `docs/release/release-readiness-go-nogo-record.md` |
+| README.md | 349–355 | `docs/security/threat-model.md`, `docs/security/secure-storage-audit-report.md`, `docs/security/diagnostic-redaction-audit-report.md`, `docs/security/dependency-and-supply-chain-report.md`, `docs/privacy/privacy-policy.md`, `docs/legal/trademark-and-attribution-review.md` |
+| README.md | 391 | `docs/governance/git-commit-message-convention.md` |
+| README.md | 449–451 | `docs/governance/product-decision-register.md`, `docs/security/dependency-and-supply-chain-report.md`, `docs/legal/trademark-and-attribution-review.md` |
+| docs/architecture/sad.md | 6 | `docs/srs.md` |
+| docs/architecture/sad.md | 7 | `docs/sysdes.md` |
+| docs/architecture/sad.md | 176 | `docs/governance/traceability-matrix.md` |
+| docs/architecture/sdd.md | 6 | `docs/architecture/sad.md` |
+| docs/architecture/sdd.md | 7 | `docs/srs.md` |
+| docs/architecture/sysdes.md | 6 | `docs/sysdes.md` (canonical pointer) |
+| docs/architecture/desktop-ptt-architecture.md | 5 | `docs/architecture/sad.md`, `docs/architecture/sdd.md`, `docs/release/dv-waiver-register.md` |
+| docs/architecture/file-transfer-design.md | 6 | `docs/architecture/sad.md` |
+| docs/architecture/file-transfer-research.md | 5 | `docs/architecture/file-transfer-design.md` |
+| docs/architecture/file-transfer-implementation-plan.md | 6 | `docs/architecture/file-transfer-design.md`, `docs/architecture/file-transfer-research.md` |
+| docs/requirements/sysrs.md | 4 | `../sysrs.md` (canonical pointer) |
+| docs/requirements/srs.md | 4 | `../srs.md` (canonical pointer) |
+| docs/governance/document-index.md | 14–32 | All listed document paths |
+| docs/material3-guideline.md | 10 | `docs/ui-ux/material3-guideline.md` (self-referencing path record) |
+| docs/ui-ux/material3-guideline.md | 6 | `docs/material3-guideline.md` (canonical pointer) |
+| docs/superpowers/specs/2026-06-08-maintainability-continuation-design.md | 125–141 | Multiple `docs/` paths |
+| docs/superpowers/specs/2026-05-29-state-sync-ui-settings-validation-design.md | 51–55 | Multiple `docs/` paths |
+| docs/superpowers/plans/2026-05-29-finish-dv-document-tree.md | 16–54 | Multiple `docs/` paths |
+| docs/superpowers/plans/2026-05-29-swe2-swe3-baselines.md | 16–35 | Multiple `docs/` paths |
+| docs/superpowers/plans/2026-05-29-state-sync-ui-settings-validation.md | 84–88 | Multiple `docs/` paths |
+| docs/superpowers/plans/2026-05-29-dv-evidence-pack.md | 16–54 | Multiple `docs/` paths |
+| docs/superpowers/plans/2026-05-28-server-resolution-prefetch.md | 31–836 | Multiple source file paths |
+| docs/superpowers/plans/2026-05-28-chanora-server-prefetch-crate.md | 15–541 | Multiple source file paths |
+| docs/superpowers/plans/2026-06-06-chat-panel-switching.md | 58–507 | Multiple source file paths |
+| docs/superpowers/plans/2026-06-08-core-internal-split.md | 16–91 | Multiple source file paths |
+
+### Broken
+
+| File | Line | Reference | Issue |
+|------|------|-----------|-------|
+| docs/sysrs.md | 126 | `docs/chanora_SysDes.md` | Does not exist (listed as "potential downstream file name") |
+| docs/sysrs.md | 127 | `docs/chanora_SRS.md` | Does not exist (listed as "potential downstream file name") |
+| docs/sysrs.md | 128 | `docs/chanora_SAD.md` | Does not exist (listed as "potential downstream file name") |
+| docs/sysrs.md | 129 | `docs/chanora_SDD.md` | Does not exist (listed as "potential downstream file name") |
+| docs/sysrs.md | 130 | `docs/chanora_Verification.md` | Does not exist (listed as "potential downstream file name") |
+
+**Note:** These five are documented as "Potential downstream file names" in a table and are aspirational/historical. They are presented as code blocks in the original, so they function as suggestions rather than navigable links. Low severity.
+
+---
+
+## Code References
+
+### Valid
+
+| File | Line | Reference | Found At |
+|------|------|-----------|----------|
+| docs/architecture/sad.md | 41 | `apps/chanora_flutter/lib/main.dart` | EXISTS |
+| docs/architecture/sad.md | 42 | `apps/chanora_flutter/lib/services/` | EXISTS |
+| docs/architecture/sad.md | 43 | `apps/chanora_flutter/lib/widgets/` | EXISTS |
+| docs/architecture/sad.md | 44 | `crates/chanora_bridge`, `apps/chanora_flutter/lib/src/rust/` | EXISTS |
+| docs/architecture/sad.md | 45 | `core/chanora_core` | EXISTS |
+| docs/architecture/sad.md | 46 | `crates/chanora_protocol` | EXISTS |
+| docs/architecture/sad.md | 47 | `crates/chanora_state` | EXISTS |
+| docs/architecture/sad.md | 48 | `crates/chanora_audio` | EXISTS |
+| docs/architecture/sad.md | 49 | `crates/chanora_storage` | EXISTS |
+| docs/architecture/sad.md | 50 | `crates/chanora_diagnostics` | EXISTS |
+| docs/architecture/sad.md | 51 | `crates/chanora_resolver` | EXISTS |
+| docs/architecture/sad.md | 52 | `crates/chanora_prefetch`, Flutter `prefetch_debouncer.dart` | EXISTS |
+| docs/architecture/sdd.md | 17 | `apps/chanora_flutter/lib/services/app_bootstrap.dart`, `main.dart` | EXISTS |
+| docs/architecture/sdd.md | 18 | `apps/chanora_flutter/lib/widgets/connect_widgets.dart` | EXISTS |
+| docs/architecture/sdd.md | 19 | `snapshot_view.dart`, `snapshot_state_mapper.dart`, `channel_spacer.dart` | EXISTS (in services/) |
+| docs/architecture/sdd.md | 20 | `chat_views.dart`, `bbcode_text.dart` | EXISTS |
+| docs/architecture/sdd.md | 21 | `voice_bar.dart`, `voice_compact.dart`, `voice_settings*.dart`, `voice_level_meter.dart`, `ptt_capability_badge.dart` | EXISTS |
+| docs/architecture/sdd.md | 22 | `android_permissions_service.dart`, `ios_permissions_service.dart`, `audio_lifecycle_service.dart`, `back_intent_*`, `link_trust_service.dart` | EXISTS |
+| docs/architecture/sdd.md | 23 | `crates/chanora_bridge/src/api.rs` | EXISTS |
+| docs/architecture/sdd.md | 24 | `core/chanora_core/src/lib.rs`, `events.rs`, `network_diagnostics.rs`, `ptt.rs` | EXISTS |
+| docs/architecture/sdd.md | 25 | `crates/chanora_protocol/src/` | EXISTS |
+| docs/architecture/sdd.md | 26 | `crates/chanora_state/src/lib.rs`, `channel_join.rs` | EXISTS |
+| docs/architecture/sdd.md | 27 | `crates/chanora_audio/src/` | EXISTS |
+| docs/architecture/sdd.md | 28 | `crates/chanora_storage/src/lib.rs` | EXISTS |
+| docs/architecture/sdd.md | 29 | `crates/chanora_diagnostics/src/lib.rs` | EXISTS |
+| docs/architecture/sdd.md | 30 | `crates/chanora_resolver/src/lib.rs`, `crates/chanora_prefetch/src/lib.rs`, `prefetch_debouncer.dart` | EXISTS |
+| docs/architecture/sdd.md | 31 | `.github/workflows/`, `tools/` | EXISTS |
+| docs/architecture/sdd.md | 35 | `crates/chanora_bridge/src/api.rs`, `apps/chanora_flutter/lib/src/rust/` | EXISTS |
+| docs/release/release-readiness-go-nogo-record.md | 26 | `apps/chanora_flutter/pubspec.yaml` | EXISTS |
+| docs/implementation-status-2026-05-28.md | 69 | `apps/chanora_flutter/ios/Runner/AppDelegate.swift` | EXISTS |
+| docs/sysrs.md | 503 | `apps/chanora_flutter/ios/Runner/AppDelegate.swift` | EXISTS |
+| docs/sysrs.md | 1962 | `apps/chanora_flutter/macos/chanora_bridge.podspec` | EXISTS |
+| README.md | 236–249 | `apps/chanora_flutter/`, `core/chanora_core/`, `crates/chanora_protocol/`, `crates/chanora_audio/`, `crates/chanora_state/`, `crates/chanora_storage/`, `crates/chanora_diagnostics/`, `crates/chanora_bridge/` | EXISTS |
+
+### Broken
+
+| File | Line | Reference | Issue |
+|------|------|-----------|-------|
+| docs/architecture/sdd.md | 19 | `snapshot_state_mapper.dart` (listed under "Snapshot and channel UI" widgets) | File is in `apps/chanora_flutter/lib/services/`, not `apps/chanora_flutter/lib/widgets/` — directory mismatch |
+| docs/architecture/sdd.md | 21 | `voice_settings*.dart` (listed under Voice UI widgets) | Files are `voice_settings.dart` and `voice_settings_controls.dart` in `widgets/` — EXISTS but glob reference is ambiguous (two files match) |
+
+**Note:** The `snapshot_state_mapper.dart` directory mismatch is a minor documentation inaccuracy — the file exists but is listed under the wrong component section (widget layer vs service layer).
+
+---
+
+## External Links (Manual Review)
+
+These URLs should be checked manually for validity.
+
+| File | Line | URL |
+|------|------|-----|
+| README.md | 429 | `https://www.apache.org/licenses/LICENSE-2.0` |
+| README.md | 432 | `https://opensource.org/licenses/MIT` |
+| apps/chanora_flutter/README.md | 11 | `https://docs.flutter.dev/get-started/learn-flutter` |
+| apps/chanora_flutter/README.md | 12 | `https://docs.flutter.dev/get-started/codelab` |
+| apps/chanora_flutter/README.md | 13 | `https://docs.flutter.dev/reference/learning-resources` |
+| apps/chanora_flutter/README.md | 16 | `https://docs.flutter.dev/` |
+| silero-coreml/README.md | 343 | `https://apple.github.io/coremltools/docs-guides/source/introductory-quickstart.html` |
+| silero-coreml/README.md | 350 | `https://apple.github.io/coremltools/docs-guides/source/convert-pytorch.html` |
+| silero-coreml/Docs/CoreMLConversion.md | 244 | `https://apple.github.io/coremltools/docs-guides/source/convert-pytorch.html` |
+| silero-coreml/Docs/CoreMLConversion.md | 252 | `https://apple.github.io/coremltools/docs-guides/source/introductory-quickstart.html` |
+| docs/security/dependency-and-supply-chain-report.md | 29 | `https://github.com/EdisonJwa/oboe-rs` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 261 | `https://github.com/asportnoy/compact-discord` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 262 | `https://github.com/mattermost/mattermost/blob/...` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 263 | `https://github.com/RocketChat/fuselage/blob/...` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 264 | `https://github.com/flutter/flutter/issues/162965` |
+| docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md | 265 | `https://m3.material.io/foundations/layout/breakpoints/overview` |
+| docs/architecture/file-transfer-research.md | 29 | `https://github.com/Splamy/TS3AudioBot/blob/...` |
+| docs/architecture/file-transfer-research.md | 30 | `https://github.com/Multivit4min/TS3-NodeJS-Library/blob/...` |
+| docs/architecture/file-transfer-research.md | 31 | `https://github.com/planetteamspeak/ts3phpframework/blob/...` |
+| docs/architecture/file-transfer-research.md | 49 | `https://github.com/Multivit4min/TS3-NodeJS-Library/blob/...` |
+| docs/architecture/file-transfer-research.md | 50 | `https://github.com/planetteamspeak/ts3phpframework/blob/...` |
+| docs/architecture/file-transfer-research.md | 123 | `https://github.com/ReSpeak/Qint/blob/...` |
+| docs/architecture/file-transfer-research.md | 124 | `https://github.com/ReSpeak/Qint/blob/...` |
+| docs/architecture/file-transfer-research.md | 125 | `https://github.com/ReSpeak/Qint/blob/...` |
+| docs/architecture/file-transfer-research.md | 140 | `https://github.com/teamspeak/ts3client-pluginsdk/blob/...` |
+| docs/architecture/file-transfer-research.md | 141 | `https://github.com/teamspeak/ts3client-pluginsdk/blob/...` |
+| docs/architecture/file-transfer-research.md | 142 | `https://community.teamspeak.com/t/clear-cache/41511` |
+| docs/architecture/file-transfer-research.md | 142 | `https://community.teamspeak.com/t/server-icons-are-displaying-a-broken-image-issues-with-local-cache/58680` |
+| docs/architecture/file-transfer-research.md | 208 | `https://github.com/Splamy/TS3AudioBot/blob/...` |
+| docs/architecture/file-transfer-research.md | 209 | `https://github.com/Splamy/TS3AudioBot/blob/...` |
+| docs/architecture/file-transfer-research.md | 220 | `https://github.com/Multivit4min/TS3-NodeJS-Library/blob/...` |
+| docs/architecture/file-transfer-research.md | 221 | `https://github.com/Multivit4min/TS3-NodeJS-Library/blob/...` |
+| docs/architecture/file-transfer-research.md | 320 | `https://github.com/rust-lang/rust/blob/...` |
+| docs/architecture/file-transfer-research.md | 321 | `https://source.android.com/docs/core/storage/scoped` |
+| docs/architecture/file-transfer-research.md | 322 | `https://developer.apple.com/library/archive/documentation/FileManagement/...` |
+| docs/architecture/file-transfer-research.md | 334 | `https://github.com/zkat/cacache-rs/blob/...` |
+| docs/architecture/file-transfer-research.md | 335 | `https://github.com/zkat/cacache-rs/blob/...` |
+| docs/architecture/file-transfer-research.md | 336 | `https://github.com/zkat/cacache-rs/blob/...` |
+| docs/architecture/file-transfer-research.md | 345 | `https://pub.dev/packages/flutter_cache_manager` |
+| docs/architecture/file-transfer-research.md | 346 | `https://pub.dev/packages/super_cache_disk/versions/1.0.0` |
+| docs/architecture/file-transfer-research.md | 406 | `https://git.did.science/TeaSpeak/Server/Server` |
+| docs/security/license-inventory.md | 31–80 | ~50 URLs to GitHub repos for dependency licenses |
+| docs/security/flutter-license-inventory.md | 624–4209 | Multiple `http://www.apache.org/licenses/` and `http://mozilla.org/MPL/2.0/` (in license text bodies) |
+
+---
+
+## Cross-References
+
+### Valid
+
+All doc-to-doc cross-references found in prose text resolve to existing files. Key verified chains:
+
+| Source | Reference | Target Exists |
+|--------|-----------|---------------|
+| docs/architecture/sad.md:6 | `docs/srs.md` | YES |
+| docs/architecture/sad.md:7 | `docs/sysdes.md` | YES |
+| docs/architecture/sdd.md:6 | `docs/architecture/sad.md` | YES |
+| docs/architecture/sdd.md:7 | `docs/srs.md` | YES |
+| docs/architecture/sysdes.md:6 | `docs/sysdes.md` | YES |
+| docs/architecture/file-transfer-design.md:6 | `docs/architecture/sad.md` | YES |
+| docs/architecture/file-transfer-research.md:5 | `docs/architecture/file-transfer-design.md` | YES |
+| docs/architecture/file-transfer-implementation-plan.md:6 | `docs/architecture/file-transfer-design.md` | YES |
+| docs/architecture/file-transfer-implementation-plan.md:6 | `docs/architecture/file-transfer-research.md` | YES |
+| docs/architecture/desktop-ptt-architecture.md:5 | `docs/architecture/sad.md` | YES |
+| docs/architecture/desktop-ptt-architecture.md:5 | `docs/architecture/sdd.md` | YES |
+| docs/architecture/desktop-ptt-architecture.md:5 | `docs/release/dv-waiver-register.md` | YES |
+| docs/requirements/sysrs.md:4 | `../sysrs.md` | YES |
+| docs/requirements/srs.md:4 | `../srs.md` | YES |
+| docs/governance/document-index.md | All 18 listed paths | YES |
+| docs/ui-ux/material3-guideline.md:6 | `docs/material3-guideline.md` | YES |
+
+### Broken
+
+None found — all doc-to-doc cross-references in prose text resolve correctly.
+
+---
+
+## Notes
+
+1. **Path-record files**: Several docs exist as stubs pointing to canonical locations (`docs/requirements/sysrs.md` → `docs/sysrs.md`, `docs/requirements/srs.md` → `docs/srs.md`, `docs/architecture/sysdes.md` → `docs/sysdes.md`, `docs/ui-ux/material3-guideline.md` → `docs/material3-guideline.md`). These are intentional DV navigation aids, not broken links.
+
+2. **Hypothetical file names in sysrs.md**: The table at lines 124–131 lists `docs/chanora_SysDes.md` etc. as "Potential downstream file names." These are aspirational names from an earlier draft, not current files. They are presented as plain text in a table, not as navigable links.
+
+3. **LICENSE-APACHE and LICENSE-MIT**: These are the most impactful broken references. The README's License section links to them, and the security license inventory files reference them. The dual-license model (DEC-020) requires these files to exist for proper attribution.
+
+4. **snapshot_state_mapper.dart location**: The SDD lists this under "Snapshot and channel UI" (widget layer), but the file is actually in `services/`. This is a minor organizational mismatch — the file exists but is categorized differently than documented.
+
+5. **External links**: Concentrated in `docs/architecture/file-transfer-research.md` (protocol research sources) and `docs/security/license-inventory.md` (dependency homepages). The file-transfer research links point to specific GitHub commit SHAs which may become stale over time.
@@ -0,0 +1,135 @@
+# Review: Test & Document Coverage Analysis
+
+**Reviewer:** opencode (automated)
+**Reviewed file:** `docs/offline-knowledge/coverage-analysis.md`
+**Date:** 2026-06-13
+**Method:** Spot-checked 5 random test files, verified aggregate counts via grep/find, cross-referenced directory listings
+
+---
+
+## Verdict: Significant inaccuracies found
+
+The document has **3 critical counting errors**, **2 factual errors about file existence**, and **several minor issues**. The per-file Rust test counts are mostly accurate, but the aggregate totals are wrong.
+
+---
+
+## Critical Errors
+
+### 1. Total Rust test count is wrong by 40%
+
+| Metric | Document | Actual | Delta |
+|--------|----------|--------|-------|
+| Inline `#[test]` | 220 | 309 | +89 |
+| Integration tests | 2 | 2 | 0 |
+| **Total** | **222** | **312** | **+90** |
+
+The per-crate sums also don't reconcile: the document's own per-file tables sum to ~202 for chanora_audio (plus 2 integration = 204), but `grep -c '#\[test\]'` across `crates/chanora_audio/src/` yields **219** inline tests (+ 2 integration = 221). The document undercounts chanora_audio by 17 tests.
+
+### 2. chanora_resolver test count off by 1
+
+| Crate | Document | Actual |
+|-------|----------|--------|
+| chanora_resolver | 12 | 13 |
+
+The extra test is in `examples/cli.rs` (documented separately as 1 example test, but the crate header total should be 13, not 12).
+
+### 3. Doc file count is ambiguous and inaccurate
+
+| Scope | Document says | Actual |
+|-------|---------------|--------|
+| All docs/ .md files | 55 | 75 |
+| Excluding superpowers/ | — | 66 |
+| Excluding superpowers/ + offline-knowledge/ | — | 51 |
+
+The "55" figure doesn't match any reasonable scope calculation. The document also doesn't clarify whether superpowers/ plans/specs are included.
+
+---
+
+## Factual Errors
+
+### 4. `poke_active_chat.dart` does not exist as a source file
+
+The document lists `poke_active_chat.dart` as a tested service (line 163), and `poke_active_chat_test.dart` does exist under `test/services/`. However, **no corresponding source file** exists in `lib/services/`. This is either:
+- An orphaned test for a deleted/moved source file, or
+- The source file is located elsewhere (not in `lib/services/`)
+
+The document should flag this as an anomaly, not list it as "Tested".
+
+### 5. `audio_device_list_tile_test.dart` exists but is not counted
+
+The document marks `audio_device_list_tile.dart` as "UNTESTED" (line 189), but `apps/chanora_flutter/test/widgets/audio_device_list_tile_test.dart` **does exist**. This means:
+- Widget test file count should be **14**, not 13
+- Widget coverage should be **14/24 (58%)**, not 13/24 (54%)
+
+---
+
+## Section Header vs. Content Mismatches
+
+### 6. Architecture section: header says "4 files", lists 7
+
+The header on line 221 reads "Architecture (4 files)" but the table contains 7 entries. The actual `docs/architecture/` directory has 7 files.
+
+### 7. Governance section: header says "11 files", lists 12
+
+The header on line 264 reads "Governance (11 files)" but the table contains 12 entries. The actual `docs/governance/` directory has 12 files.
+
+---
+
+## Spot-Check Results (5 Random Test Files)
+
+| File | Document Count | Actual | Match? |
+|------|---------------|--------|--------|
+| `chanora_audio/src/ptt_backends/windows.rs` | 44 | 44 | ✅ |
+| `chanora_audio/src/engine.rs` | 7 | 7 | ✅ |
+| `chanora_state/src/lib.rs` | 18 | 18 | ✅ |
+| `chanora_storage/src/lib.rs` | 15 | 15 | ✅ |
+| `chanora_audio/src/route_policy.rs` | 8 | 8 | ✅ |
+
+Per-file Rust test counts are **accurate**. The error is in the aggregation.
+
+---
+
+## Dart/Flutter Section: Mostly Accurate
+
+| Metric | Document | Actual | Match? |
+|--------|----------|--------|--------|
+| `test()` calls | 155 | 155 | ✅ |
+| `testWidgets()` calls | 66 | 66 | ✅ |
+| Total Dart tests | 221 | 221 | ✅ |
+| Service source files | 21 | 21 | ✅ |
+| Widget source files | 24 | 24 | ✅ |
+| Service test files | — | 20 | ⚠️ Not stated |
+| Widget test files | 13 | 14 | ❌ |
+
+---
+
+## Missing Crates / Scope Issues
+
+The document covers all 9 crates under `crates/` plus `chanora_core` under `core/`. No crates are missing. However:
+
+- The document doesn't clearly explain that `chanora_core` lives under `core/`, not `crates/`
+- The "Crates with tests: 7/9" metric (line 15) excludes `chanora_core`, which has 11 tests. If counted, it should be **8/10**
+
+---
+
+## Documentation Gap Analysis: Mostly Complete
+
+The gap analysis (lines 333-354) correctly identifies undocumented modules. One omission:
+
+- **Flutter test infrastructure** — no doc for the test helper setup, mock patterns, or test utilities used across 37 test files
+
+---
+
+## Summary of Required Corrections
+
+| # | Issue | Severity | Fix |
+|---|-------|----------|-----|
+| 1 | Total Rust tests: 220 → 312 | Critical | Re-count and update |
+| 2 | chanora_audio tests: 204 → 221 | Critical | Re-count and update |
+| 3 | chanora_resolver tests: 12 → 13 | Minor | Update count |
+| 4 | Doc file count: 55 → clarify scope | Minor | State scope explicitly |
+| 5 | `poke_active_chat.dart` doesn't exist | Critical | Remove or flag as anomaly |
+| 6 | `audio_device_list_tile_test.dart` exists | Major | Update widget test count to 14 |
+| 7 | Architecture header: 4 → 7 | Minor | Fix header |
+| 8 | Governance header: 11 → 12 | Minor | Fix header |
+| 9 | Widget coverage: 54% → 58% | Major | Recalculate |
@@ -0,0 +1,176 @@
+# Documentation Quality Analysis Review
+
+**Reviewer:** Document Review Agent
+**Date:** 2026-06-13
+**Source:** `docs/offline-knowledge/doc-quality-analysis.md`
+
+## Overall Assessment
+
+The analysis is **largely accurate** but mischaracterizes several items. Most notably, it labels intentional ASPICE-compliance structures as "useless" and "duplicated" when they serve a documented purpose. The broken references finding is partially valid.
+
+## Duplications: Spot-Check Results
+
+### Instance 1: Lifecycle Chain — Justified Cross-Reference
+
+**Verdict: NOT a problem.**
+
+The lifecycle chain `SysRS -> SysDes -> SRS -> SAD -> SDD` appears in 6 files, but each serves a different purpose:
+
+| File | Purpose |
+|------|---------|
+| `README.md:280` | Project overview for new contributors |
+| `CONTRIBUTING.md:10` | Contributor guidance — must be self-contained |
+| `docs/sysdes.md:90` | SysDes document context section |
+| `docs/sysrs.md:108` | SysRS downstream relationship |
+| `docs/governance/traceability-matrix.md:16` | Traceability rule definition |
+| `docs/references/aspice-swe2-swe3-integration-note.md:12` | ASPICE integration reference |
+
+ASPICE expects each document to be reviewable independently. Removing the chain from CONTRIBUTING.md or traceability-matrix.md would break document self-containment. **Recommendation: Keep as-is.**
+
+### Instance 2: Git Commit Examples — Genuine Duplication
+
+**Verdict: VALID.**
+
+The commit examples are genuinely duplicated:
+
+- `README.md:379-386` has 6 examples (including `docs(sad)` and `i18n(ui)`)
+- `CONTRIBUTING.md:37-42` has 4 examples
+- `docs/governance/git-commit-message-convention.md:14-19` has 4 examples
+
+The README already references the convention file (line 391). The examples in README and CONTRIBUTING add no unique value. **Recommendation: Valid — consolidate to convention file.**
+
+### Instance 3: Security Doc List — Genuine Duplication
+
+**Verdict: VALID.**
+
+The security document list is identical in both files:
+
+- `README.md:349-355` — 6 file paths in a code block
+- `SECURITY.md:33-38` — same 6 file paths in a code block
+
+SECURITY.md is the authoritative source. The README could reference it instead. **Recommendation: Valid — keep in SECURITY.md, reference from README.**
+
+## Useless Content: Verification Results
+
+### Path Record Files — NOT Useless
+
+**Verdict: INVALID. The analysis is wrong.**
+
+The analysis labels these files as "useless" with "no unique content":
+
+| File | Lines | Analysis Claim |
+|------|-------|----------------|
+| `docs/architecture/sysdes.md` | 21 | "Path record file — 21 lines pointing to `docs/sysdes.md`" |
+| `docs/requirements/sysrs.md` | 22 | "Path record file — 22 lines pointing to `docs/sysrs.md`" |
+| `docs/requirements/srs.md` | 22 | "Path record file — 22 lines pointing to `docs/srs.md`" |
+| `docs/ui-ux/material3-guideline.md` | 8 | "Path record file — 8 lines pointing to `docs/material3-guideline.md`" |
+
+These are **DV entry-point records** — intentional ASPICE compliance artifacts. Each file:
+
+1. Preserves a README-advertised path for DV navigation
+2. Provides a DV Review Summary table mapping topics to canonical source sections
+3. States the DV position for that lifecycle layer
+
+Example from `docs/requirements/sysrs.md`:
+
+```
+## DV Review Summary
+
+| Topic | Canonical source |
+|---|---|
+| System scope and context | `docs/sysrs.md` sections 2 through 5 |
+| Verification and validation requirements | `docs/sysrs.md` section 24 |
+| MVP acceptance requirements | `docs/sysrs.md` section 25, SysRS-241 through SysRS-257 |
+```
+
+**These are not stubs.** They provide reviewer navigation aids. Deleting them would break DV traceability. **Recommendation: Keep all path record files.**
+
+### Malformed Markdown — Valid
+
+**Verdict: VALID.**
+
+`docs/sysdes.md:13` has:
+
+```
+**Repo path:** `docs/architecture/sysdes.md`  ---
+```
+
+Missing blank line before `---`. This renders as inline text instead of a horizontal rule. **Recommendation: Fix by adding a blank line.**
+
+## Broken References: Verification Results
+
+### `chanora_*` Filenames — Confirmed Broken
+
+**Verdict: VALID.**
+
+`docs/sysrs.md:126-130` suggests these filenames:
+
+```
+docs/chanora_SysDes.md
+docs/chanora_SRS.md
+docs/chanora_SAD.md
+docs/chanora_SDD.md
+docs/chanora_Verification.md
+```
+
+None of these files exist. The actual files use different names (`docs/sysdes.md`, `docs/srs.md`, etc.). This is a genuine broken reference. **Recommendation: Update the suggested filenames to match actual paths.**
+
+### SDD-109 and SAD-043 — NOT Broken
+
+**Verdict: INVALID. The analysis is wrong.**
+
+The analysis claims these are broken references. However, the traceability matrix (`docs/governance/traceability-matrix.md:67`) explicitly documents this:
+
+> "SAD and SDD are baseline candidates rather than fully item-numbered historical documents. Some prior references such as `SAD-043` and `SDD-109` are not reconstructed as itemized records. Treat the new SAD/SDD as DV baselines; add strict item IDs later if the process owner requires ID-level audit."
+
+The SAD (`docs/architecture/sad.md:182`) and SDD (`docs/architecture/sdd.md:153`) also acknowledge this. These are **documented historical references**, not broken links. The implementation status file correctly notes them as "Referenced but not confirmed." **Recommendation: No action needed — this is intentional.**
+
+## Additional Issues Found
+
+### 1. Version Inconsistency Not Flagged
+
+The analysis mentions version inconsistency in "Outdated Content" but doesn't flag it as a cross-document consistency issue:
+
+- `docs/sysdes.md:6` — Version 0.9.8
+- `docs/sysrs.md:5` — Version 0.9.11
+- `docs/material3-guideline.md:4-5` — Version 0.9.2
+
+These version numbers suggest independent evolution, but ASPICE expects version alignment across the lifecycle chain. **Recommendation: Add to high-priority recommendations.**
+
+### 2. `release` Commit Type
+
+`docs/governance/git-commit-message-convention.md:18` uses `release(android)` as an example, but `release` is not a standard Conventional Commits type. The analysis correctly flags this in "Stale Content" but doesn't recommend a fix. **Recommendation: Either add `release` to the documented types or replace the example.**
+
+### 3. Missing `docs/sad.md` and `docs/sdd.md` Path Records
+
+The README references `docs/architecture/sad.md` and `docs/architecture/sdd.md`, but unlike SysDes, SysRS, SRS, and Material3, there are no path record files for SAD and SDD at the expected DV entry-point paths. This is an inconsistency the analysis missed. **Recommendation: Consider adding path records for SAD and SDD if DV navigation requires them.**
+
+### 4. `docs/sysdes.md:13` Malformed `---` Line
+
+The analysis correctly identifies this but buries it in "Empty Sections" rather than calling it out as a rendering issue. The line:
+
+```
+**Repo path:** `docs/architecture/sysdes.md`  ---
+```
+
+should be:
+
+```
+**Repo path:** `docs/architecture/sysdes.md`
+
+---
+```
+
+## Summary
+
+| Category | Analysis Claim | Verdict |
+|----------|---------------|---------|
+| Lifecycle chain duplication | 6 files | **Justified** — ASPICE self-containment |
+| Commit examples duplication | 3 files | **Valid** — consolidate |
+| Security doc list duplication | 2 files | **Valid** — consolidate |
+| Path record files useless | 4 files | **Invalid** — DV entry-point records |
+| Malformed markdown | 1 instance | **Valid** — fix needed |
+| `chanora_*` broken refs | 5 files | **Valid** — genuine broken refs |
+| SDD-109/SAD-043 broken | 2 refs | **Invalid** — documented historical refs |
+
+**Bottom line:** 3 of 8 duplications are valid concerns. 1 of 5 useless items is valid. 1 of 3 broken references is valid. The analysis overreports issues by mischaracterizing intentional ASPICE structures as problems.
@@ -0,0 +1,193 @@
+# External Documentation Review
+
+> **Reviewer**: OpenCode (automated)
+> **Date**: 2026-06-13
+> **Files reviewed**:
+> - `docs/offline-knowledge/external/teaspeak-overview.md`
+> - `docs/offline-knowledge/external/respeak-overview.md`
+> - `docs/offline-knowledge/external/yatqa-en.md`
+> - `docs/offline-knowledge/external/yatqa-de.md`
+
+---
+
+## 1. teaspeak-overview.md
+
+### Accuracy
+
+| Claim | Verdict | Notes |
+|-------|---------|-------|
+| Repo at `git.did.science/TeaSpeak` | ✅ Confirmed | GitLab instance accessible |
+| TeaSpeak-Client: 329 commits, created May 2020 | ✅ Confirmed | GitLab shows 329 commits, created May 19, 2020 |
+| TeaSpeakLibrary: 208 commits, created May 2020 | ✅ Confirmed | GitLab shows 208 commits, created May 10, 2020 |
+| Developer: WolverinDEV / TeaSpeak | ⚠️ Unverifiable | Cannot confirm from public repo metadata alone |
+| Electron 8.5.5, TypeScript 3.9 | ⚠️ Unverifiable | Repo not fully cloned; cannot read package.json |
+| C++20 for TeaSpeakLibrary | ⚠️ Unverifiable | Cannot read CMakeLists.txt without full clone |
+
+### Missing Items
+
+- **License not mentioned.** The doc does not state the project's license. If the license is known, it should be included for completeness.
+- **No mention of project status/activity.** Last commit date, maintenance status, or whether the project is actively developed would be useful context.
+- **No mention of WebRTC.** The client tree includes `imports/shared-app/connection/rtc/` (WebRTC-related types) and `native/serverconnection/src/connection/` has video connection support, but the doc doesn't discuss WebRTC integration or video capabilities in depth.
+
+### Factual Errors
+
+None found. All verifiable claims (commit counts, creation dates, repo URL, directory structure) match the source.
+
+### Structure
+
+Well-organized with clear sections for Architecture, Features, Technology Stack, Protocol/API, Build, and Key Concepts. The directory tree diagrams are useful. The separation of Client vs Library technology tables is good.
+
+### Verdict: **Good** — Accurate where verifiable. Add license info and project status.
+
+---
+
+## 2. respeak-overview.md
+
+### Accuracy
+
+| Claim | Verdict | Notes |
+|-------|---------|-------|
+| License: MIT OR Apache-2.0 | ✅ Confirmed | `Cargo.toml` and LICENSE files confirm |
+| tsclientlib 0.2.0, tsproto 0.2.0 | ✅ Confirmed | From `Cargo.toml` files |
+| Crate versions (ts-bookkeeping 0.1.x, tsproto-packets 0.1.x, tsproto-types 0.1.x) | ✅ Confirmed | Matches Cargo.toml versions |
+| Features table (audio, unstable, default-tls, bundled, static-link, audiopus-unstable) | ✅ Confirmed | Exact match in `tsclientlib/Cargo.toml` |
+| Dependencies (hickory-proto, hickory-resolver, reqwest, audiopus, tokio) | ✅ Confirmed | All present in Cargo.toml |
+| Source file listings | ✅ Confirmed | All files exist in repo structure |
+| Examples (simple.rs, audio.rs, etc.) | ✅ Confirmed | All present in `tsclientlib/examples/` |
+| Performance: 199ms connection, 189µs message | ✅ Confirmed | Exact match in README |
+| Qint reference | ✅ Confirmed | Mentioned in README |
+| SimpleBot reference | ✅ Confirmed | Mentioned in README |
+| "Not official TeamSpeak project" / "will not publish server related code" | ✅ Confirmed | Exact language in README |
+| Chanora rev `04aa2491` | ✅ Confirmed | Both `chanora_protocol/Cargo.toml` and `chanora_audio/Cargo.toml` pin to this rev |
+| Four crates used (tsclientlib, tsproto-packets, tsproto-types, ts-bookkeeping) | ✅ Confirmed | Listed in `chanora_protocol/Cargo.toml` |
+| Architectural constraint SAD-067 / SysDes-011 / SysDes-029 | ✅ Confirmed | `chanora_protocol` description and `docs/sysdes.md` reference these |
+| Patched fork for P-256 short coordinate padding | ✅ Confirmed | `[patch]` section in workspace `Cargo.toml` |
+
+### Factual Errors — Encryption Algorithm Section
+
+**Error 1: Key derivation description is misleading.**
+
+The doc states:
+> 1. **Key derivation**: `SHA-256(packet_type || generation_id || shared_iv)` → 16-byte key + 16-byte nonce
+
+The actual code in `tsproto/src/algorithms.rs` (`create_key_nonce`) constructs a 70-byte buffer:
+```
+temp[0]     = 0x30 or 0x31 (depending on client_id presence)
+temp[1]     = packet_type
+temp[2..6]  = generation_id (big-endian)
+temp[6..]   = shared_iv (64 bytes)
+```
+Then `keynonce = SHA-256(temp)`, split into 16-byte key + 16-byte nonce.
+
+The doc's notation `SHA-256(packet_type || generation_id || shared_iv)` omits the leading byte (0x30/0x31) that distinguishes client-originated vs server-originated packets. This is a minor but technically inaccurate omission.
+
+**Error 2: Packet ID mixing placement is correct but could be clearer.**
+
+The doc correctly states `key[0] ^= (packet_id >> 8)`, `key[1] ^= (packet_id & 0xff)`. This is applied *after* key derivation, not as part of it. The doc's placement in the list is fine.
+
+**Error 3: Shared IV computation — "shared_mac = SHA-1(shared_iv)[..8]" is correct.**
+
+Confirmed from `compute_iv_mac` in `algorithms.rs`. The doc is accurate here.
+
+### Missing Items
+
+- **No mention of `tsproto` dependency.** The doc lists crates used by Chanora but `tsclientlib` depends on `tsproto` internally. While Chanora doesn't directly depend on `tsproto`, it could be worth noting as an indirect dependency.
+- **No mention of `tsproto-structs`.** This crate exists in the monorepo but is not used by Chanora. Could note it for completeness.
+- **`hickory-proto`/`hickory-resolver` versions not specified.** The doc lists these as dependencies but doesn't note they are version 0.24.
+
+### Structure
+
+Excellent. Clear sections for Architecture, Protocol Details, Cryptography, and the Chanora-specific integration section is particularly valuable. The dependency chain diagram is useful.
+
+### Verdict: **Very Good** — Highly accurate with minor encryption description inaccuracy.
+
+---
+
+## 3. yatqa-en.md
+
+### Accuracy
+
+The content appears to be sourced from https://yat.qa/ and translated/adapted. Key claims:
+
+| Claim | Verdict | Notes |
+|-------|---------|-------|
+| YaTQA stands for "Yet Another TeamSpeak³ Query Admin Tool" | ✅ Matches yat.qa |
+| Author: Janni "Яedeemer" K. | ✅ Matches yat.qa |
+| Written in Delphi 2009, 50,000+ lines | ⚠️ Unverifiable | Claimed on yat.qa, cannot independently confirm |
+| Development started April 10, 2011 | ✅ Matches yat.qa |
+| First release June 29, 2011 | ✅ Matches yat.qa |
+| Free freeware, no adware/spyware | ✅ Matches yat.qa |
+| Windows XP+, Linux via Wine | ✅ Matches yat.qa |
+| Supported servers: TS 3.9.0–3.13.7, TeaSpeak 1.4.10-beta | ⚠️ Version range may be outdated | Version range from v3.9.9b (Mar 2023) |
+| Version: v3.9.9b (01 Mar 2023) | ✅ Matches yat.qa changelog |
+
+### Missing Items
+
+- **No mention of recent updates.** The doc states v3.9.9b from March 2023. If there have been newer releases, this could be outdated.
+- **No screenshots or visual examples.** For a GUI tool, this is understandable for a text doc but worth noting.
+
+### Factual Errors
+
+None found. All claims align with the yat.qa website.
+
+### Structure
+
+Well-organized with clear sections for Features, Architecture, Configuration, System Requirements, Key Concepts, and Known Limitations. The feature categorization (General, Console, SSH Tunnel, Instance, Virtual Server) is logical.
+
+### Verdict: **Good** — Accurate reference. Consider adding update cadence notes.
+
+---
+
+## 4. yatqa-de.md
+
+### Accuracy
+
+Same content as yatqa-en.md, translated to German. All verifiable claims match.
+
+### EN vs DE Content Comparison
+
+| Section | EN | DE | Match |
+|---------|----|----|-------|
+| Overview | ✅ | ✅ | ✅ Identical content |
+| Features (all subsections) | ✅ | ✅ | ✅ Identical items |
+| Supported Image Formats | ✅ | ✅ | ✅ Identical table |
+| Architecture/How It Works | ✅ | ✅ | ✅ Identical |
+| Configuration | ✅ | ✅ | ✅ Identical settings |
+| Startup Parameters | ✅ | ✅ | ✅ Identical parameters |
+| System Requirements | ✅ | ✅ | ✅ Identical |
+| Key Concepts | ✅ | ✅ | ✅ Identical concepts |
+| Known Limitations | ✅ | ✅ | ✅ Identical |
+| IPv6 Support | ✅ | ✅ | ✅ Identical |
+| Project History | ✅ | ✅ | ✅ Identical dates |
+| Global Hotkeys | ✅ | ✅ | ✅ Identical shortcuts |
+| Resources | ✅ | ✅ | ✅ Identical links |
+| Translation | ✅ | ✅ | ✅ Identical |
+
+**The two documents cover exactly the same content.** No sections are missing from either version.
+
+### Minor Translation Notes
+
+- "Ghost Mode" → "Geist-Modus" (correct)
+- "Badges" → "Abzeichen" (correct)
+- "Pie Chart Styles" → "Kreisdiagramm-Styles" (correct)
+- Hotkeys correctly adapted: "Ctrl" → "Strg" where applicable
+- Resources section: DE version links to German-specific URLs where available (`/funktionen/`, `/haeufige-fragen/`, `/unterstuetzung/`, `/ressourcen/`, `/ueber/`) — correct
+
+### Verdict: **Good** — Accurate translation, full content parity with EN version.
+
+---
+
+## Summary
+
+| Document | Accuracy | Completeness | Structure | Overall |
+|----------|----------|--------------|-----------|---------|
+| teaspeak-overview.md | ✅ Good | ⚠️ Missing license, status | ✅ Good | **B+** |
+| respeak-overview.md | ✅ Very Good | ✅ Complete | ✅ Excellent | **A-** |
+| yatqa-en.md | ✅ Good | ✅ Complete | ✅ Good | **A-** |
+| yatqa-de.md | ✅ Good | ✅ Complete | ✅ Good | **A-** |
+
+### Recommended Actions
+
+1. **teaspeak-overview.md**: Add project license, last-commit date or activity status, and note WebRTC/video capabilities.
+2. **respeak-overview.md**: Fix the encryption algorithm description to include the leading 0x30/0x31 byte in the key derivation buffer. Minor — the rest is accurate.
+3. **yatqa-en.md / yatqa-de.md**: No changes needed. Consider periodic re-sync to check for version updates beyond v3.9.9b.
@@ -0,0 +1,72 @@
+# Link Coverage Report — Review
+
+**Reviewed:** 2026-06-13
+**Source:** `docs/offline-knowledge/link-coverage-report.md`
+
+## Verdict: Largely Accurate
+
+The report is thorough and all major claims have been verified. One minor counting discrepancy found.
+
+---
+
+## 1. Broken Internal Links (LICENSE-APACHE, LICENSE-MIT)
+
+**CLAIM:** `LICENSE-APACHE` and `LICENSE-MIT` do not exist at repo root.
+
+**VERIFIED:** Correct. `ls /Users/edison/dev/chanora/LICENSE*` returns no matches. `NOTICE` (line 444) does exist.
+
+The report also correctly identifies 4 additional references to these missing files in `docs/security/license-inventory.md` (lines 9–10) and `docs/security/flutter-license-inventory.md` (lines 11–12) using relative paths `../../LICENSE-APACHE` and `../../LICENSE-MIT`.
+
+---
+
+## 2. Broken Inline Doc-Path References
+
+**CLAIM:** 5 references to `docs/chanora_*.md` files in `docs/sysrs.md` lines 126–130 are broken.
+
+**VERIFIED:** Correct. All 5 files confirmed missing:
+- `docs/chanora_SysDes.md` — MISSING
+- `docs/chanora_SRS.md` — MISSING
+- `docs/chanora_SAD.md` — MISSING
+- `docs/chanora_SDD.md` — MISSING
+- `docs/chanora_Verification.md` — MISSING
+
+The report's assessment that these are low-severity (aspirational table entries, not navigable links) is accurate.
+
+---
+
+## 3. Spot-Check of Claimed Valid Links
+
+10 links verified — all exist:
+
+| # | File | Target | Status |
+|---|------|--------|--------|
+| 1 | README.md:130 | `docs/architecture/desktop-ptt-architecture.md` | EXISTS |
+| 2 | README.md:436 | `docs/governance/product-decision-register.md` | EXISTS |
+| 3 | README.md:444 | `NOTICE` | EXISTS |
+| 4 | `docs/superpowers/specs/2026-06-05-adaptive-3-panel-layout-design.md:266` | `../ui-ux/adaptive-layout-platform-guide.md` | EXISTS |
+| 5 | `docs/governance/git-commit-message-convention.md` (from CONTRIBUTING.md:25) | EXISTS |
+| 6 | `docs/security/threat-model.md` | EXISTS |
+| 7 | `docs/security/secure-storage-audit-report.md` | EXISTS |
+| 8 | `docs/privacy/privacy-policy.md` | EXISTS |
+| 9 | `docs/requirements/sysrs.md` | EXISTS |
+| 10 | `docs/architecture/sysdes.md` | EXISTS |
+
+---
+
+## 4. Missed Links
+
+**No internal markdown links were missed.** A repo-wide grep for `[text](path)` patterns in `.md` files (excluding `http` URLs and the report itself) returns exactly 10 links — all accounted for in the report.
+
+---
+
+## 5. Discrepancy Found
+
+**Summary count mismatch:** The report summary states "Valid internal links: 12" but the "Valid Internal Links" table (§2) lists only 4 entries. The remaining 8 may be counted from the cross-references section or the "Also affected" table, but the categorization is unclear. This does not affect the report's accuracy on individual link status.
+
+---
+
+## 6. Additional Observations
+
+- The report correctly identifies path-record stubs (`docs/requirements/sysrs.md` → `docs/sysrs.md`, etc.) as intentional navigation aids, not broken links.
+- The `snapshot_state_mapper.dart` directory mismatch (widgets/ vs services/) is a genuine doc inaccuracy worth noting.
+- External link count (48) was not verified — these are URLs requiring HTTP checks.