rigplane 2.2.0__tar.gz → 2.3.0__tar.gz

{rigplane-2.2.0 → rigplane-2.3.0}/.github/scripts/check-rebrand-allowlist.sh

@@ -44,6 +44,12 @@ ALLOWLIST=(
     # Intentional historical / migration references.
     'README.md'
     'docs/CHANGELOG.md'
+    # User-facing migration guide for v1.x icom-lan -> v2.x rigplane;
+    # the legacy names are the literal subject of the page.
+    'docs/migrate.md'
+    # mkdocs nav label for the migration guide reads
+    # "Migration from icom-lan" -- legacy name is intentional.
+    'mkdocs.yml'
     'tests/golden/wsjtx_dual_rx_session.txt'
     # pyproject.toml — preserved console-script alias `icom-lan` (line 43),
     # hatch packages list keeping `src/icom_lan` shim, ruff per-file-ignores

{rigplane-2.2.0 → rigplane-2.3.0}/.github/workflows/agent-review-gate.yml

@@ -20,6 +20,9 @@ jobs:
   agent-review:
     name: Update Agent Review Gate status
     if: github.event_name == 'pull_request' || github.event.issue.pull_request
+    # API-only workflow via actions/github-script -- no compile/test toolchain
+    # needed. Keep this on GitHub-hosted runners so PR merges are not blocked
+    # when self-hosted build runners are offline or occupied.
     runs-on: ubuntu-latest
     timeout-minutes: 2
 

{rigplane-2.2.0 → rigplane-2.3.0}/.github/workflows/full.yml

@@ -19,7 +19,11 @@ jobs:
     if: >-
       github.event_name != 'push' ||
       contains(github.event.head_commit.message, '[full-ci]')
-    runs-on: ubuntu-latest
+    # Self-hosted Mac mini build-tier runner. Python 3.11/3.12/3.13, uv,
+    # Node 24, Rust, and the Tauri/audio system libs are pre-baked in the
+    # image, so the matrix avoids ubuntu-latest pickup + apt install passes.
+    # Operator doc: rigplane-tower/docs/development/mac-mini-self-hosted-runners.md.
+    runs-on: [self-hosted, linux, build]
     timeout-minutes: 25
     strategy:
       matrix:
@@ -54,6 +58,11 @@ jobs:
           cd frontend
           npm ci
 
+      - name: i18n catalog lint
+        run: |
+          cd frontend
+          npm run i18n:check
+
       - name: Frontend type-check
         run: |
           cd frontend

{rigplane-2.2.0 → rigplane-2.3.0}/.github/workflows/quick.yml

@@ -28,7 +28,11 @@ concurrency:
 
 jobs:
   quick:
-    runs-on: ubuntu-latest
+    # Self-hosted Mac mini build-tier runner. Python 3.11+/uv/Node 24/Rust
+    # and the Tauri/audio system libs are pre-baked in the image, so this
+    # job avoids the ubuntu-latest pickup + apt install passes. Operator
+    # doc: rigplane-tower/docs/development/mac-mini-self-hosted-runners.md.
+    runs-on: [self-hosted, linux, build]
     timeout-minutes: 10
 
     steps:
@@ -78,6 +82,7 @@ jobs:
         run: |
           cd frontend
           npm ci
+          npm run i18n:check
           npm run check
           npx vitest run
           npm run build
@@ -85,6 +90,21 @@ jobs:
           mkdir -p ../src/rigplane/web/static
           cp -r dist/* ../src/rigplane/web/static/
 
+      - name: Frontend i18n visual smoke (RP-ML-006)
+        if: steps.filter.outputs.frontend == 'true'
+        # Runs the localization screenshot pack against the freshly built
+        # `frontend/dist/`. The self-hosted Mac mini Linux runner needs the
+        # Playwright system deps (libnss3, libnspr4, etc.) installed at the
+        # OS level via `npx playwright install --with-deps chromium` (one
+        # time, by the runner operator) before this step can pass. Marked
+        # continue-on-error until provisioning lands; the baseline tests
+        # still run + the screenshots upload as artifacts for review.
+        continue-on-error: true
+        run: |
+          cd frontend
+          npx playwright install chromium >/dev/null 2>&1 || true
+          npm run test:e2e:i18n
+
       - name: Type-check web boundary
         if: steps.filter.outputs.frontend == 'true'
         run: uv run mypy --strict src/rigplane/web

{rigplane-2.2.0 → rigplane-2.3.0}/.github/workflows/rebrand-gate.yml

@@ -21,6 +21,9 @@ concurrency:
 
 jobs:
   grep-gate:
+    # Sub-second git-grep + bash filter, no toolchain needed. Keep this on a
+    # GitHub-hosted runner so protected-branch merges are not blocked when
+    # self-hosted runners are offline or occupied.
     runs-on: ubuntu-latest
     timeout-minutes: 2
 

{rigplane-2.2.0 → rigplane-2.3.0}/.gitignore

@@ -41,6 +41,7 @@ config/
 .firecrawl/
 .playwright-mcp/
 .copilot-tmp/
+.agents/
 
 # Backups (local safety copies, not for repo)
 .backups/
@@ -75,6 +76,8 @@ mockups/
 scripts/
 # But CI scripts under .github/ are tracked.
 !.github/scripts/
+# And frontend tooling scripts (e.g. i18n lint) are tracked.
+!frontend/scripts/
 
 # Local RAG / AI tooling
 .rag-update.sh

{rigplane-2.2.0 → rigplane-2.3.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: rigplane
-Version: 2.2.0
-Summary: Python library for controlling Icom transceivers over LAN (UDP) — no wfview/hamlib required
+Version: 2.3.0
+Summary: Multi-vendor radio control library and Web UI for IP-connected ham transceivers (Icom, Yaesu, Xiegu, Lab599) — no wfview/hamlib required
 Project-URL: Homepage, https://rigplane.dev/
 Project-URL: Documentation, https://rigplane.dev/
 Project-URL: Repository, https://github.com/rigplane/rigplane-core
@@ -9,8 +9,8 @@ Project-URL: Issues, https://github.com/rigplane/rigplane-core/issues
 Author-email: Sergey Morozik <morozsm@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
-Keywords: amateur-radio,ci-v,ham-radio,ic-705,ic-7610,icom,rigplane,transceiver
-Classifier: Development Status :: 3 - Alpha
+Keywords: amateur-radio,cat,ci-v,ftx-1,ham-radio,ic-705,ic-7300,ic-7610,icom,lab599,rigctld,rigplane,transceiver,xiegu,yaesu
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3.11
@@ -18,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Ham Radio
 Requires-Python: >=3.11
+Requires-Dist: aiohttp>=3.13.3
 Requires-Dist: numpy
 Requires-Dist: opuslib
 Requires-Dist: platformdirs>=4.2

{rigplane-2.2.0 → rigplane-2.3.0}/docs/CHANGELOG.md

@@ -7,6 +7,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.3.0] — 2026-05-20
+
+### Added
+- Added the Core Svelte i18n runtime, locale store, pluralization helpers,
+  pseudo-locale tooling, and bundled `en-US`, `ru-RU`, and `ja-JP` locale
+  catalogs for the first localized Core web surfaces (#1528, #1534, #1536).
+- Added the Core language preference UX and the cross-app locale preference
+  contract used by local shells and integrations to hand off language hints
+  without overwriting the user's stable Core preference (#1529, #1531).
+- Added localization QA coverage: string inventory, runtime/unit tests,
+  pseudo-locale smoke tests, visual QA fixtures, and Playwright i18n
+  screenshot coverage for desktop and mobile app surfaces (#1530, #1533).
+- Added localized server toast reason codes and migrated the P0 Core web
+  surfaces to the i18n runtime, including app shell, status bar, install
+  prompt, language selector, diagnostics dialog, and shared toasts (#1532).
+
+### Changed
+- Moved quick/full/rebrand/agent-review CI workflows to the Mac mini
+  build-tier runner while preserving the existing required gates (#1512,
+  #1513, #1514).
+- Moved the lightweight rebrand and agent-review gate jobs to GitHub-hosted
+  runners so protected-branch release fixes are not blocked when the
+  self-hosted gate runner is unavailable.
+- Refined public packaging metadata and docs SEO/navigation for the
+  multi-vendor RigPlane framing, including Project Overview, migration
+  guidance, per-page descriptions, and setup-guide download CTAs (#1510,
+  #1511, #1538, #1540, #1541, #1542).
+
+### Fixed
+- Stabilized the audio-scope aspect ratio in the web UI (#1519).
+- Fixed WebView/Tauri audio compatibility by allowing browser clients to
+  request PCM16 RX transport, adding a PCM16 TX microphone fallback when
+  WebCodecs are unavailable, and guarding async PTT startup/release races
+  before keying transmit (#1543).
+- Fixed Japanese pilot copy after linguistic validation (#1537).
+- Fixed release packaging so the generated frontend bundle is included in
+  sdist/wheel artifacts without relying on a local absolute `web/static`
+  symlink.
+- Fixed PyPI runtime dependency metadata so installed wheels can import and
+  serve the Web UI diagnostics upload path without relying on dev-only
+  dependencies.
+- Refreshed the frontend lockfile to pick up Svelte/devalue security fixes;
+  `npm audit --omit=dev` now reports zero vulnerabilities.
+
+### Docs
+- Added the Core user-facing string inventory, locale contract, translator
+  guide, i18n contribution notes, and visual QA documentation (#1527, #1535).
+
 ## [2.2.0] — 2026-05-11
 
 ### Added
@@ -1294,7 +1342,8 @@ These deprecation closures were announced in v0.19 and dropped on schedule.
 - Transport layer, authentication, CI-V commands, meters, PTT, keep-alive.
 - Clean-room Icom LAN UDP protocol implementation.
 
-[Unreleased]: https://github.com/rigplane/rigplane-core/compare/v2.2.0...HEAD
+[Unreleased]: https://github.com/rigplane/rigplane-core/compare/v2.3.0...HEAD
+[2.3.0]: https://github.com/rigplane/rigplane-core/compare/v2.2.0...v2.3.0
 [2.2.0]: https://github.com/rigplane/rigplane-core/compare/v2.1.2...v2.2.0
 [2.1.2]: https://github.com/rigplane/rigplane-core/compare/v2.1.1...v2.1.2
 [2.1.1]: https://github.com/rigplane/rigplane-core/compare/v2.1.0...v2.1.1

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/audio-recipes.md

@@ -1,3 +1,7 @@
+---
+description: Copy-paste recipes for RX and TX audio with RigPlane — PCM and Opus contracts, browser playback, microphone capture, and radio-native LAN audio.
+---
+
 # Audio Recipes (copy/paste)
 
 Practical scenarios for the current `rigplane` audio API.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/cli.md

@@ -1,3 +1,7 @@
+---
+description: Full RigPlane CLI reference — connect, scan, tune, serve the Web UI, run rigctld, and stream audio from the terminal on macOS, Linux, and Windows.
+---
+
 # CLI Reference
 
 The `rigplane` CLI provides quick access to radio control from the terminal.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/commands.md

@@ -1,3 +1,7 @@
+---
+description: CI-V commands supported by RigPlane — frequency, mode, filter, AGC, attenuator, preamp, meters, and per-radio extensions exposed in a Python API.
+---
+
 # CI-V Commands
 
 The library supports a comprehensive set of CI-V commands for controlling your Icom transceiver.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/configuration.md

@@ -1,3 +1,7 @@
+---
+description: Configure RigPlane backends, credentials, and runtime options — LAN versus USB serial, environment variables, and per-radio configuration tips.
+---
+
 # Configuration
 
 ## Backend Selection

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/connection.md

@@ -1,3 +1,7 @@
+---
+description: Understand the RigPlane connection lifecycle to an Icom radio — discovery, login, keep-alive, control and audio streams, and clean shutdown.
+---
+
 # Connection Lifecycle
 
 Understanding the connection sequence helps with debugging and advanced usage.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/diagnostic-reports.md

@@ -1,3 +1,7 @@
+---
+description: Generate redacted RigPlane diagnostic reports — bundle logs, radio state, runtime config, and environment into a single ZIP for support and triage.
+---
+
 # Diagnostic Reports
 
 When something goes wrong with `rigplane` — a CAT timeout, a stuck audio

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/ic705-usb-setup.md

@@ -1,3 +1,7 @@
+---
+description: Configure the Icom IC-705 for USB serial CI-V and USB audio control from macOS with RigPlane — field-friendly setup with no network required.
+---
+
 # IC-705 USB Serial Backend Setup (macOS)
 
 This guide shows how to control the IC-705 via **USB serial CI-V + USB audio devices** instead of the default LAN backend.
@@ -355,3 +359,12 @@ ls -l /dev/cu.*
 
     **Software validation:** Contract tests with mock IC-705 profile pass (13/13 tests).
     **Hardware validation:** Blocked on IC-705 procurement (tracked in MSMA-20).
+
+## Get the Packaged Desktop App
+
+!!! tip "Prefer a packaged desktop app?"
+    This guide covers the open-source `rigplane` Python library. If you want
+    a polished desktop application with a GUI for IC-705 control on macOS
+    and Linux, check out RigPlane Pro.
+
+    [Download RigPlane Pro for Mac and Linux →](https://rigplane.com/downloads/?utm_source=docs.rigplane.dev&utm_medium=cta&utm_campaign=ic705-usb-setup)

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/ic7300-usb-setup.md

@@ -1,3 +1,7 @@
+---
+description: Set up the Icom IC-7300 over USB serial CI-V and USB audio from macOS with RigPlane — low-latency direct control without LAN, hamlib, or RS-BA1.
+---
+
 # IC-7300 USB Serial Backend Setup (macOS)
 
 This guide shows how to control the IC-7300 via **USB serial CI-V + USB audio devices** instead of the default LAN backend.
@@ -246,3 +250,12 @@ os.environ["ICOM_SERIAL_CIV_MIN_INTERVAL_MS"] = "100"
 - [IC-705 USB Setup](ic705-usb-setup.md) — Portable transceiver
 - [Audio Recipes](audio-recipes.md) — RX/TX examples
 - [WSJT-X Setup](wsjtx-setup.md) — Digital mode integration
+
+## Get the Packaged Desktop App
+
+!!! tip "Prefer a packaged desktop app?"
+    This guide covers the open-source `rigplane` Python library. If you want
+    a polished desktop application with a GUI for IC-7300 control on macOS
+    and Linux, check out RigPlane Pro.
+
+    [Download RigPlane Pro for Mac and Linux →](https://rigplane.com/downloads/?utm_source=docs.rigplane.dev&utm_medium=cta&utm_campaign=ic7300-usb-setup)

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/ic7610-usb-setup.md

@@ -1,3 +1,7 @@
+---
+description: Step-by-step guide to control the Icom IC-7610 from macOS over USB serial CI-V and USB audio with RigPlane — no LAN, hamlib, or RS-BA1 required.
+---
+
 # IC-7610 USB Serial Backend Setup (macOS)
 
 This guide shows how to control the IC-7610 via **USB serial CI-V + USB audio devices** instead of the default LAN backend.
@@ -468,3 +472,12 @@ If you're currently using the LAN backend and want to switch to serial:
 ---
 
 **Hardware validated**: 2026-03-06, IC-7610 over USB on macOS (Darwin arm64), Python 3.11.14, pytest 9.0.2 (issue #146)
+
+## Get the Packaged Desktop App
+
+!!! tip "Prefer a packaged desktop app?"
+    This guide covers the open-source `rigplane` Python library. If you want
+    a polished desktop application with a GUI for IC-7610 control on macOS
+    and Linux, check out RigPlane Pro.
+
+    [Download RigPlane Pro for Mac and Linux →](https://rigplane.com/downloads/?utm_source=docs.rigplane.dev&utm_medium=cta&utm_campaign=ic7610-usb-setup)

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/ic9700-usb-setup.md

@@ -1,3 +1,7 @@
+---
+description: Control the dual-receiver Icom IC-9700 via USB serial CI-V or LAN from macOS with RigPlane — both transport options covered end to end.
+---
+
 # IC-9700 USB Serial Backend Setup (macOS)
 
 This guide shows how to control the **IC-9700 dual-receiver transceiver** via USB serial CI-V + USB audio devices or LAN network connection.
@@ -311,3 +315,12 @@ ConnectionError: failed to connect to 192.168.1.100
 - [IC-7300 USB Setup](ic7300-usb-setup.md) — Single-receiver desktop radio
 - [Audio Recipes](audio-recipes.md) — RX/TX dual-receiver examples
 - [Web UI Guide](web-ui.md) — Dual-receiver web interface
+
+## Get the Packaged Desktop App
+
+!!! tip "Prefer a packaged desktop app?"
+    This guide covers the open-source `rigplane` Python library. If you want
+    a polished desktop application with a GUI for IC-9700 control on macOS
+    and Linux, check out RigPlane Pro.
+
+    [Download RigPlane Pro for Mac and Linux →](https://rigplane.com/downloads/?utm_source=docs.rigplane.dev&utm_medium=cta&utm_campaign=ic9700-usb-setup)

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/installation.md

@@ -1,3 +1,7 @@
+---
+description: Install RigPlane from PyPI on macOS, Linux, or Windows — Python 3.11+ requirements, optional extras, and verifying the install against a real radio.
+---
+
 # Installation
 
 ## Requirements

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/profiles.md

@@ -1,3 +1,7 @@
+---
+description: Declarative operating profiles for RigPlane — describe desired radio state (frequency, mode, data, VOX) and let the library reconcile it for you.
+---
+
 # Radio Profiles
 
 Radio profiles let you describe the **desired radio state** declaratively — set only the fields you want to change, and the system figures out how to get there.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/quickstart.md

@@ -1,3 +1,7 @@
+---
+description: Get your first RigPlane connection to an Icom radio over LAN in under five minutes — credentials, discovery, and a basic frequency read in Python.
+---
+
 # Quick Start
 
 Get your first connection in under 5 minutes.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/radios.md

@@ -1,3 +1,7 @@
+---
+description: Radios supported by RigPlane — Icom IC-7610, IC-7300, IC-705, IC-9700, plus Yaesu, Xiegu, and Lab599 models defined by TOML rig profiles.
+---
+
 # Supported Radios
 
 Radio support in rigplane is defined by **TOML rig profiles** in `rigs/`.

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/rig-profiles.md

@@ -1,3 +1,7 @@
+---
+description: Add a new radio to RigPlane by writing a TOML rig profile — capabilities, CI-V commands, hardware parameters, and registration in the rig loader.
+---
+
 # Adding a New Radio (Rig Profiles)
 
 ## Overview

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/troubleshooting.md

@@ -1,3 +1,7 @@
+---
+description: Troubleshooting RigPlane radio control — discovery timeouts, authentication failures, audio dropouts, USB serial issues, and Web UI connection problems.
+---
+
 # Troubleshooting
 
 ## Connection Issues

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/web-ui.md

@@ -1,3 +1,7 @@
+---
+description: RigPlane's built-in browser Web UI for ham radio control — live tuning, scope and waterfall, meters, and RX/TX audio streaming from any browser.
+---
+
 # Web UI
 
 rigplane ships with a built-in browser UI for live control, scope/waterfall, meters,

{rigplane-2.2.0 → rigplane-2.3.0}/docs/guide/wsjtx-setup.md

@@ -1,3 +1,7 @@
+---
+description: Configure WSJT-X, JTDX, and JS8Call against RigPlane's built-in rigctld server for FT8, FT4, and JS8 on Icom radios — no Hamlib install needed.
+---
+
 # WSJT-X / JTDX / JS8Call Setup Guide
 
 This guide covers configuring WSJT-X (and compatible apps like JTDX, JS8Call)
@@ -194,3 +198,12 @@ Tested with:
 - **MacLoggerDX** (macOS logging)
 
 Any application that supports `Hamlib NET rigctl` should work.
+
+## Get the Packaged Desktop App
+
+!!! tip "Prefer a packaged desktop app?"
+    This guide covers the open-source `rigplane` Python library. If you want
+    a polished desktop application with a GUI that handles WSJT-X / JTDX /
+    JS8Call integration on macOS and Linux, check out RigPlane Pro.
+
+    [Download RigPlane Pro for Mac and Linux →](https://rigplane.com/downloads/?utm_source=docs.rigplane.dev&utm_medium=cta&utm_campaign=wsjtx-setup)