docs: evaluate tsdeclarations codegen, map permissions, verify encoding (TODO-063,068,069)
tsdeclarations eval: direct codegen redundant (already via tsproto), but permission ID generation and error code enum have high value. Permission mapping: 253 TS3 permissions identified, 7 P1 for chat/moderation. Encoding verification: tsclientlib uses strict UTF-8, UCS-2 is edge case.
This commit is contained in:
@@ -457,6 +457,7 @@
|
||||
- **Description:** Chanora forks `tsclientlib` for a p256 fix. Submit PR upstream to reduce fork maintenance burden.
|
||||
- **Effort:** M
|
||||
- **Dependencies:** None
|
||||
- **Status:** PR DRAFT READY — `docs/references/upstream-p256-pr-draft.md` (2026-06-11)
|
||||
|
||||
### TODO-058 — Monitor tsdeclarations for TS5 protocol updates
|
||||
- **Priority:** P2
|
||||
@@ -464,6 +465,7 @@
|
||||
- **Description:** No full TS5 client protocol exists yet. Watch `tsdeclarations` repo for updates that may affect Chanora compatibility.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None (ongoing)
|
||||
- **Status:** MONITORING — no TS5 protocol updates detected; `tsdeclarations` last checked 2026-06-11
|
||||
|
||||
### TODO-059 — Build auto-reconnect logic internally
|
||||
- **Priority:** P2
|
||||
@@ -488,6 +490,7 @@
|
||||
- **Description:** YaTQA's `/ressourcen/` section has comprehensive unofficial server error codes. Extract for Chanora error handling reference.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None
|
||||
- **Status:** VERIFIED COMPLETE — 170+ error codes in yatqa-offline-reference.md §9, cross-reference with ReSpeak in §13 (2026-06-11)
|
||||
|
||||
### TODO-061 — Extract anti-flood/rate-limiting reference from YaTQA
|
||||
- **Priority:** P3
|
||||
@@ -495,6 +498,7 @@
|
||||
- **Description:** YaTQA documents anti-flood mechanics and rate limiting. Use as reference when implementing Chanora's rate limiting.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None
|
||||
- **Status:** PARTIALLY COMPLETE — summary tiers in yatqa-offline-reference.md §5; detailed action table still needs backfill (see TODO-081)
|
||||
|
||||
---
|
||||
|
||||
@@ -521,7 +525,8 @@
|
||||
- **Description:** TS claims UTF-8 but uses UCS-2 (BMP only). Mobile apps use CESU-8. Server 3.2.0+ adds partial emoji support. tsclientlib/tsproto delivers Rust `String` (UTF-8) via `str::from_utf8()` at the protocol layer (ReSpeak §1.8.3 confirms: "Command string encoded in UTF-8"). If encoding bugs exist, the fix belongs in the EdisonJwa/tsclientlib fork, not in chanora_protocol.
|
||||
- **Verification:** Confirm tsclientlib handles UCS-2 correctly. Document encoding behavior in protocol-implementation-traps.md (TODO-070).
|
||||
- **Effort:** S (verification + documentation)
|
||||
- **Status:** Scope revised from implementation to verification (2026-06-11)
|
||||
- **Status:** VERIFIED — strict UTF-8 via `str::from_utf8()`, no UCS-2/CESU-8 code exists, non-UTF-8 causes errors not corruption (2026-06-11)
|
||||
- **Evidence:** `docs/references/encoding-verification.md`
|
||||
- **Dependencies:** TODO-070 (protocol traps doc)
|
||||
|
||||
### TODO-064 — Implement client-side anti-flood point awareness
|
||||
@@ -579,6 +584,7 @@
|
||||
- **Description:** TS3 server 3.1.6-3.1.7 has IPv6 canonicalization bug in Blacklist2 protocol. Chanora should be aware when connecting to older servers.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None
|
||||
- **Status:** DOCUMENTED — trap #6 in protocol-implementation-traps.md (2026-06-11)
|
||||
|
||||
### TODO-072 — Establish connection/message performance benchmarks
|
||||
- **Priority:** P3
|
||||
@@ -586,6 +592,7 @@
|
||||
- **Description:** tsclientlib benchmarks: ~199ms connect, ~189µs/message. Use as baseline for Chanora's performance testing.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None
|
||||
- **Status:** DOCUMENT CREATED — `docs/references/performance-benchmarks.md` (2026-06-11)
|
||||
|
||||
### TODO-073 — Assess web client feasibility
|
||||
- **Priority:** P3
|
||||
@@ -593,6 +600,7 @@
|
||||
- **Description:** TeaSpeak's web client was a compelling installation-less option. Evaluate whether a future Chanora web client makes sense. Not current scope.
|
||||
- **Effort:** S
|
||||
- **Dependencies:** None
|
||||
- **Status:** ASSESSMENT COMPLETE — `docs/references/web-client-feasibility.md`; verdict: defer indefinitely (UDP transport blocker) (2026-06-11)
|
||||
|
||||
---
|
||||
|
||||
|
||||
Reference in New Issue
Block a user