EdisonJwa
82d012a46b
Promotes the Linux backend from probe-only to a live
`org.freedesktop.portal.GlobalShortcuts` session, closing the
gen2 v0.9.3 baseline's last Linux-side code item. Both gaps I
flagged on the review pass are addressed:
* Stop now closes the portal session through the dedicated
`org.freedesktop.portal.Session` interface (not the
request-cancel `Request` interface — that would only abort a
pending Request, not release the bound shortcuts).
* Ten new unit tests cover `classify_shortcuts_value`,
`publish_bound`, `publish_l0`, and the `SHORTCUT_ID` stability
contract using synthesised `OwnedValue` payloads. Live D-Bus
coverage stays in the `linux_portal_smoke` ignored
integration test (RR-PTT-004).
Live session lifecycle (gen2 Q5b — lazy, single backend instance):
1. `start(gate, binding)` spawns one `tokio::spawn` worker that
owns an async `zbus::Connection` (sharing the bridge's
tokio runtime per Q4a).
2. `CreateSession` with fresh random `handle_token` /
`session_handle_token` tokens. The worker awaits the portal
`Response` signal via a `RequestProxy` subscription and
extracts `session_handle` from the results dict.
3. `BindShortcuts(session_handle, [("chanora-ptt", { description
= "Chanora push-to-talk" })], "", {})`. The portal opens its
own system-managed dialog asking the user to choose a key
— Chanora itself never reads raw key events. The audio
engine continues at `L0Focused` while the dialog is open;
the descriptor watch publishes the transition once the
portal returns.
4. On `response_code == 0`: classify the `trigger_description`
substring (heuristic: contains "mouse" -> MouseSideButton,
else Keyboard), publish `L2GlobalHoldToTalk` (or `L3` for
mouse) through the watch sender. The raw trigger_description
string is never logged (DEC-027 / SRS-202).
5. On `response_code == 1` (cancelled) or `>= 2` (failure):
publish `L0Focused` through the watch sender. The user can
retry via the UI "Configure" button (gen2 Q6a).
6. The worker enters a `tokio::select!` loop multiplexing the
`cmd_rx` channel (Rebind / Stop) and the `Activated` /
`Deactivated` signals. Matching signals scoped to this
session handle and `chanora-ptt` shortcut id drive
`gate.set(true/false)`.
7. `Rebind` re-runs `BindShortcuts` on the same session.
8. `Stop` calls `org.freedesktop.portal.Session.Close()` on
the session-handle object path, clears the gate, exits.
UX (gen2 Q3a): when `_pttBackendId == 'gnome-wayland-portal'`,
the Flutter "Configure" button skips the in-app
`_PttBindingCaptureDialog` and shows a SnackBar telling the user
their desktop environment will open its own shortcut dialog.
The button delegates to `setPttBinding(keyboard, "portal")`
which nudges the backend; the portal handles the rest. New ARB
key `pttConfigurePortalRedirect` in en + zh-Hans.
Trait surface (cross-cutting):
* `DesktopPttBackend::descriptor_watch()` is a new trait method
with a default impl returning a never-firing receiver.
Backends with async capability transitions (only the Linux
portal backend today) override it to return the live watch
sender's receiver.
* `chanora_core::ChanoraSession::start_audio` subscribes to the
active backend's `descriptor_watch()` and spawns a forwarder
task that re-emits `SessionEvent::PttCapability` on every
transition. The initial value is emitted synchronously.
`Cargo.toml` (Linux-only):
* `futures-util` (std features, no executor) for stream
consumption on the portal signal subscriptions.
* `rand 0.8` for fresh per-process portal tokens.
* `zbus` continues at v5 with the `tokio` + `blocking-api`
features.
Tests
-----
* `chanora_audio` rises from 8 to 18 unit tests. New
coverage on the Linux module:
- `classify_returns_none_when_shortcut_id_missing`
- `classify_returns_keyboard_for_typical_trigger_description`
- `classify_returns_keyboard_when_trigger_description_missing`
- `classify_detects_mouse_substring`
- `classify_is_case_insensitive_on_mouse_substring`
- `publish_bound_keyboard_publishes_L2_with_keyboard_class`
- `publish_bound_mouse_publishes_L3`
- `publish_bound_none_publishes_L2_keyboard_default`
- `publish_l0_clears_descriptor`
- `shortcut_id_is_stable`
* Workspace total: 67 unit + integration tests, all green with
`CHANORA_DISABLE_KEYRING=1` (was 57 at v1.0.0-rc.4).
* New `crates/chanora_audio/tests/linux_portal_smoke.rs`
ignored integration test (RR-PTT-004 evidence path). Run on
a GNOME-on-Wayland host with
`cargo test -p chanora_audio --test linux_portal_smoke -- --ignored --nocapture`.
Documentation
-------------
* `docs/architecture/desktop-ptt-architecture.md` §5.3 rewritten
to describe the realised lifecycle; v0.9.4 change-history
entry added.
* `docs/governance/product-decision-register.md` v0.9.10
change-history entry recording the code-side promotion. No
decision rows mutate.
* `docs/release/release-readiness-go-nogo-record.md` RR-PTT-004
flipped from `Open` to `Implemented (live trace pending)`;
v0.9.5 change-history entry.
Verification
------------
* `cargo test --workspace`: 67/67 green.
* `cargo deny check`: advisories ok, bans ok, licenses ok,
sources ok.
* `cargo about generate --offline`: zero new warnings.
* `tools/dump_flutter_licenses.sh`: 94 packages, 0 without
LICENSE.
* `flutter analyze`: clean.
* `cargo build -p chanora_bridge --release` +
`flutter build linux --release`: clean Linux x86_64 bundle.
* Live portal trace (RR-PTT-004) — **not run**. The dev shell
is a TTY without a Wayland session. The user will run the
ignored smoke test from inside a GNOME-on-Wayland session
when available.
No Windows / macOS / iOS live verification in this commit (hosts
unavailable). The Windows + macOS backend scaffolds remain in
place reporting their target capability honestly; live OS-call
wiring is queued for their respective platform owners'
reference hosts per `docs/governance/staged-release-plan.md`.
104 lines
4.1 KiB
Plaintext
104 lines
4.1 KiB
Plaintext
{
|
|
"@@locale": "en",
|
|
"@@x-source-of-truth": "DEC-015 (register v0.9.5). Template ARB for English. Server-provided content is NOT translated (ADR-008 / DEC-015).",
|
|
|
|
"appTitle": "Chanora",
|
|
|
|
"homeNotProductionReadyBanner": "Beta build — voice in/out wired; not production ready.",
|
|
|
|
"fieldServerHost": "Server address",
|
|
"fieldNickname": "Nickname",
|
|
"fieldServerPassword": "Server password",
|
|
"fieldServerPasswordHelp": "Leave blank if the server does not require one.",
|
|
"fieldPassword": "Password",
|
|
"fieldDisplayName": "Display name",
|
|
|
|
"connectAction": "Connect",
|
|
"disconnectAction": "Disconnect",
|
|
"refreshAction": "Refresh",
|
|
"diagnosticsAction": "Diagnostics",
|
|
"aboutAction": "About",
|
|
"aboutVersion": "Version {version}",
|
|
"@aboutVersion": {
|
|
"placeholders": { "version": { "type": "String" } }
|
|
},
|
|
"aboutNonAffiliation": "Chanora is independent and is not affiliated with, endorsed by, sponsored by, or officially associated with TeamSpeak.",
|
|
"aboutLicenseHeading": "License",
|
|
"aboutLicenseBody": "Chanora is dual-licensed under the Apache License, Version 2.0 or the MIT License, at your option. The full license texts ship as LICENSE-APACHE and LICENSE-MIT at the repository root.",
|
|
"aboutThirdPartyHeading": "Third-party software",
|
|
"aboutThirdPartyBody": "Chanora is built on tsclientlib, flutter_rust_bridge, cpal, rusqlite, and the Flutter framework, among others. See the NOTICE file at the repository root for the current attribution list.",
|
|
"copyAction": "Copy",
|
|
"closeAction": "Close",
|
|
"startAudioAction": "Start audio",
|
|
"pttHoldToTalk": "Hold to talk",
|
|
"pttTransmitting": "Transmitting…",
|
|
"pttCapabilityBadge": "PTT: {level} ({backend})",
|
|
"@pttCapabilityBadge": {
|
|
"placeholders": {
|
|
"level": { "type": "String" },
|
|
"backend": { "type": "String" }
|
|
}
|
|
},
|
|
"pttConfigureAction": "Configure",
|
|
"pttConfigureTitle": "Configure Push-to-Talk binding",
|
|
"pttConfigurePrompt": "Press the key or mouse side button you want to use for Push-to-Talk.",
|
|
"pttConfigureWaiting": "(waiting for input…)",
|
|
"pttConfigureCaptured": "Captured",
|
|
"pttConfigurePrivacyNote": "Chanora never logs the actual key value. Only the input class (keyboard / mouse-side-button) and a platform-neutral label leave this dialog.",
|
|
"pttConfigureSaveAction": "Save",
|
|
"pttConfigurePortalRedirect": "Your desktop environment will open its own shortcut dialog. Pick the key you want to use for Push-to-Talk.",
|
|
"inputMuteAction": "Mute mic",
|
|
"inputUnmuteAction": "Unmute mic",
|
|
"outputMuteAction": "Mute speaker",
|
|
"outputUnmuteAction": "Unmute speaker",
|
|
"joinChannelAction": "Join channel",
|
|
"channelPasswordTitle": "Channel password",
|
|
"bookmarksHeading": "Bookmarks",
|
|
"bookmarksEmpty": "No bookmarks yet. Enter a server above and tap \"Save bookmark\".",
|
|
"bookmarkAddAction": "Save bookmark",
|
|
"bookmarkAddTitle": "Save bookmark",
|
|
"bookmarkDeleteAction": "Delete bookmark",
|
|
|
|
"statusIdle": "Not connected",
|
|
"statusConnecting": "Connecting…",
|
|
"statusConnected": "Connected to {server}",
|
|
"@statusConnected": {
|
|
"placeholders": { "server": { "type": "String" } }
|
|
},
|
|
"statusError": "Error: {message}",
|
|
"@statusError": {
|
|
"placeholders": { "message": { "type": "String" } }
|
|
},
|
|
|
|
"statusReconnecting": "Reconnecting… attempt {attempt}, in {delay}s",
|
|
"@statusReconnecting": {
|
|
"placeholders": {
|
|
"attempt": { "type": "int" },
|
|
"delay": { "type": "int" }
|
|
}
|
|
},
|
|
"statusConnectionLost": "Connection lost: {reason}",
|
|
"@statusConnectionLost": {
|
|
"placeholders": { "reason": { "type": "String" } }
|
|
},
|
|
|
|
"audioStatsLine": "TX {sent} frames • RX {received} frames • PTT {ptt}",
|
|
"@audioStatsLine": {
|
|
"placeholders": {
|
|
"sent": { "type": "int" },
|
|
"received": { "type": "int" },
|
|
"ptt": { "type": "String" }
|
|
}
|
|
},
|
|
|
|
"channelsHeading": "Channels",
|
|
"clientsHeading": "Online clients",
|
|
"countChannelsAndClients": "{channels} channels • {clients} online",
|
|
"@countChannelsAndClients": {
|
|
"placeholders": {
|
|
"channels": { "type": "int" },
|
|
"clients": { "type": "int" }
|
|
}
|
|
}
|
|
}
|