From dc2186599ecb58930ddfaaff79178622dedfa9fd Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:18:08 -0400
Subject: [PATCH 01/17] docs(wcb-6.2.1): sweep spec + plan

Design and implementation plan for the WCB firmware 6.2.1 sweep
(droidnet-command-library 4.3.0), generated against WCB 66845b9a
(SoftwareVersion 6.2.1_021242RSEP2026) and WcbCmd 0.8.0 @ 168f1e5.

Spec records the id policy (D1 minor release, maestro.wcb.* as new ids;
D2 4.2.0 templates and param names frozen), maestro-native left as is
(D3), one version number (D4), firmware requirements in names (D5), the
out-of-scope list (D6), per-board tables, ordering hazards, and how
DroidNet's unpublished 2.2.0 ids map to 4.3.0.

FlthyHPs: every sketch from v1.6 through the author's v2.1 dispatches
005 solid / 006 rainbow / 007 short circuit and accepts X/Y/Z; the
v1.8 manual table is the pre-v1.6 order. 4.3.0 follows the firmware.

BOARD_AUTHORING_GUIDE: the composer shows neither firmware nor
routing.notes, so firmware requirements go in command/component names.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 docs/BOARD_AUTHORING_GUIDE.md                 |   8 +
 .../2026-09-15-wcb-firmware-6.2.1-sweep.md    | 150 ++++++
 ...6-09-15-wcb-firmware-6.2.1-sweep-design.md | 451 ++++++++++++++++++
 3 files changed, 609 insertions(+)
 create mode 100644 docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
 create mode 100644 docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md

diff --git a/docs/BOARD_AUTHORING_GUIDE.md b/docs/BOARD_AUTHORING_GUIDE.md
index f67e4a6..fb68e1d 100644
--- a/docs/BOARD_AUTHORING_GUIDE.md
+++ b/docs/BOARD_AUTHORING_GUIDE.md
@@ -107,6 +107,14 @@ confirm-before-firing warning in the UI. Use `movement` for anything that moves
 hardware, `power` for power switching, `config` for settings that change state.
 When unsure, pick the more cautious class.
 
+**Firmware requirements go in the name.** Neither the composer nor the hosted
+reference shows a component's `firmware` or `routing.notes`, so users never see
+them. When a command needs newer firmware than the rest of its board, say so in
+the command `name` — e.g. `"Go Home (WCB 6.2+)"`. When the whole board needs it,
+put it in the component `name` and the matching manifest entry. Keep `firmware`
+and `routing.notes` accurate anyway: they are the reviewer's record of what was
+verified.
+
 **`commentLabel` — the auto-note on insert.** When a step is added, the composer
 attaches this string as the step's `*** …` comment (its human label in the wire
 string). It supports two bits of grammar, so the note can describe the actual
diff --git a/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md b/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
new file mode 100644
index 0000000..e56fd01
--- /dev/null
+++ b/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
@@ -0,0 +1,150 @@
+# WCB Firmware v6.2.1 Command Sweep — Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** Publish droidnet-command-library **4.3.0** on top of 4.2.0: the WCB 6.2.1 command surface (Maestro comma verbs, a new DFPlayer board, HCR/MP3/WLED updates, 66 new `wcb-native` commands, range fixes) plus the FlthyHPs sequence-code fix — without breaking any value stored under a 4.2.0 id.
+
+**Architecture:** JSON board authoring against the schema-driven engine; no engine or schema change. Guard tests land first and pass on 4.2.0; each board commit keeps its file's existing formatting so the diff stays reviewable.
+
+**Tech Stack:** Node 20, ajv, jest. `npm ci`, `npm run validate`, `npm test`, `npx jest test/wcb-621.test.js`.
+
+**Spec:** `docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md` (decisions D1-D6, per-board tables, id map, FlthyHPs evidence).
+
+**Firmware source of truth:** greghulette/Wireless_Communication_Board-WCB @ `66845b9a` (`Code/WCB/`), greghulette/WcbCmd 0.8.0 @ `168f1e5` (`src/`), WCB 6.1.5 tag `v6.1.5_290119RJUN2026` for "(WCB 6.2+)" decisions, FlthyHPs v1.81 / v2.1 sketches.
+
+## Global Constraints
+
+- **Re-read every cited firmware line before encoding a template, range or enum.** If firmware and the spec disagree, follow firmware and say so in the commit message.
+- **D2 freeze:** every 4.2.0 id keeps a byte-identical `template` and ordered param names. Only add ids. The one exception is A11 (three FlthyHPs templates), whitelisted in the freeze test.
+- **D5 naming:** a command that needs 6.2 inside a board that also works on older firmware gets " (WCB 6.2+)" in `name`; a 6.2-only board carries it in the component and manifest `name`.
+- **Hand-edit board files.** Do not regenerate a board with a JSON re-serializer: `wcb-native`, `wcb-hcr` and `wcb-wled` are compact files and a `JSON.stringify(o, null, 2)` rewrite produces thousand-line diffs. `maestro.json` is already fully expanded.
+- **Categories:** every command has a `category` listed in the component `categories`. Non-standard names (`Volume`, `Variables`, `Routing`, `Advanced`) warn only.
+- **Examples:** at least one per command, no `^`, and every example on a WCB board must decode to its own id (A2 test b). `wcb-verb` examples stay within 187 characters (A2 test c).
+- **Order:** specific literals before catch-alls (first match wins).
+- **Gate per commit:** `npm run validate` exits 0 and `npm test` is green.
+- **Commits:** conventional messages; end with the `Co-Authored-By` trailer.
+
+---
+
+### Task A0: Prepare
+
+- [ ] `git fetch origin && git status` — clean; `main == origin/main == 82b6a04`.
+- [ ] If `origin/main` moved: rebase this plan onto it; if the new tip changed `libraryVersion`, target the next minor instead of 4.3.0.
+- [ ] `git switch -c wcb-firmware-6.2.1-sweep`
+- [ ] `npm ci && npm run validate && npm test` — baseline green (4.2.0: 11 suites, 324 tests).
+
+### Task A1: Docs — `docs(wcb-6.2.1): sweep spec + plan`
+
+**Files:** create the spec and this plan; modify `docs/BOARD_AUTHORING_GUIDE.md`.
+
+- [ ] Spec: goal, firmware refs, D1-D6, per-board tables, out-of-scope list, ordering hazards, DroidNet 2.2.0 → 4.3.0 id map, FlthyHPs decision and evidence.
+- [ ] Guide: after the "`safety` matters" paragraph, add that the composer shows neither `firmware` nor `routing.notes`, so a firmware requirement goes in the command or component name, e.g. "(WCB 6.2+)".
+
+### Task A2: Guard tests — `test: freeze 4.2.0 ids/templates; WCB examples parse to their own command`
+
+Lands before any board edit and must pass on 4.2.0.
+
+**Files:** create `test/fixtures/catalog-4.2.0-commands.json`, `test/wcb-621.test.js`.
+
+- [ ] Generate the fixture once at `82b6a04` from `require('./src/load-node.js').readCatalog()`: `{ "<id>": { "board": "<component id>", "template": "<template>" | null, "params": ["<name>", …] } }` for all 397 commands, in manifest order, one entry per line. Commit it — CI checks out with depth 1, so the test cannot read git history.
+- [ ] `test/wcb-621.test.js`, using the `loadEngine()` pattern (`jest.resetModules()` + `require`):
+  - **(a)** every fixture id still resolves with the same `template` and ordered param names (D2). Header: "update this fixture only on a major release". An explicit allowlist (empty in A2) pins `{ from, to }` for sanctioned template fixes.
+  - **(b)** every example on `maestro`, `wcb-hcr`, `wcb-mp3`, `wcb-wled`, `wcb-native`, and `wcb-dfp` when present: `match(ex).commandId === cmd.id`. Scoped: the whole catalog already fails on `ap.logic.text` / `ap.logic.font` (decode as `rseries.*`), and `test/web.test.js` only checks that an example parses to *some* command.
+  - **(c)** every example on a `kind === 'wcb-verb'` board is at most 187 characters (`WCB.ino:216-223`, `ETM_MAX_CMD_WITH_CRC`).
+- [ ] Later commits append board-specific assertions to this file.
+
+### Task A3: `feat(maestro): WCB 6.2 comma verbs and get queries; ids 0-9; subroutines 0-127`
+
+**File:** `libraries/boards/maestro.json` (fully expanded JSON; key-order-preserving edit is fine).
+
+**Firmware to re-check:** `WCB.ino:6729-6786` (`processMaestroCommand`), `WCB_Help.cpp:430-459`, `WCB_Maestro.cpp:397`; WcbCmd `WcbMaestro.h:32-51`, `WcbMaestro.cpp:6-21`; 6.1.5 `WCB_Maestro.cpp:143-168`, `WCB.ino:4871-4876`.
+
+- [ ] `maestro.id` codes `0` All, `1`-`8` #1-#8, `9` All local (this WCB) — id 9 works on 6.1.5 too.
+- [ ] New `maestro.queryId` codes `1`-`8`.
+- [ ] Component: name "Maestro (WCB ;M verbs)" (manifest too); `firmware` "WCB 6.2.1_021242RSEP2026"; `categories` `["Sequences","Movement","System"]`; `routing` `{ "class": "wcb-verb", "notes": … }` — comma forms need 6.2.1 on sender and Maestro host; 6.1.x runs a comma form as subroutine 0; id 0 / 1-8 / 9 meaning; subroutines are Pololu data bytes 0-127 (help says 0-255); get queries take 1-8, are async, write `m<id>pos<ch>` / `m<id>moving` / `m<id>err`, are read by an `IF` in a later trigger, and must never be wrapped in `;W`; `getMovingState` is Mini Maestro only.
+- [ ] `maestro.trigger` `seq` max 9 → 127 (template unchanged).
+- [ ] Add the 12 `maestro.wcb.*` commands from the spec table (all `encoder: template`; `channel` int 0-23).
+- [ ] Tests: `;M11` and `;M91` → `maestro.trigger`; `;M1,5` → `maestro.wcb.sub`; `;M3,5,1000` → `maestro.wcb.subParam`; `;M2,goHome` → `maestro.wcb.goHome` while bare `goHome` → `maestro.goHome`; all 12 `;M{id},` templates have names ending "(WCB 6.2+)".
+
+### Task A4: `feat(wcb-dfp): DFPlayer Mini board (;D, verbs, WCB 6.2+)`
+
+**File:** create `libraries/boards/wcb-dfp.json` (format like `wcb-mp3.json`); modify `libraries/manifest.json`.
+
+**Firmware to re-check:** WcbCmd `WcbDfPlayer.cpp:51-168`; `WCB_DFP.cpp:144-327`; `WCB_Help.cpp:566-593`; `WCB.ino:6426-6428`.
+
+- [ ] Component, enums (`dfp.eq`, `dfp.device`, `dfp.loopAll`) and the 22 commands from the spec table. `dfp.play`, `dfp.stop`, `dfp.volume` keep DroidNet's templates and param names (D1).
+- [ ] Manifest entry `{ "id": "wcb-dfp", "file": "boards/wcb-dfp.json", "name": "WCB · DFPlayer Mini (WCB 6.2+)", "confidence": "high" }` right after `wcb-mp3`.
+- [ ] Update the component-count pin in `test/load-node.test.js` if it is checked before A12 (21 → 22).
+
+### Task A5: `feat(wcb-hcr): TRIGGER, all-channel VOL/VOLUP/VOLDN steps; FN codes per 6.2.1`
+
+**File:** `libraries/boards/wcb-hcr.json` (hand-edit, compact formatting).
+
+**Firmware to re-check:** `WCB_HCR.cpp:263-299`, `:365-409`; WcbCmd `WcbHcr.cpp:7-36`; `WCB.ino:6391-6408`, `:6430`.
+
+- [ ] `firmware` "WCB 6.2.1_021242RSEP2026"; `routing.notes` about host routing on 6.2.1 vs local-only on 6.1.x. Keep the word "host".
+- [ ] `hcr.fn`: `fn` → new enum `hcr.fnCode`; `chan` max 99; `track` 0-9999. Template unchanged.
+- [ ] Add `hcr.trigger`, `hcr.volAll`, `hcr.volUpAllStep`, `hcr.volDownAllStep` at the anchors in the spec.
+- [ ] Do not touch `hcr.emotion` / `hcr.channel`.
+
+### Task A6: `docs(wcb-mp3): 6.2.1 host routing`
+
+- [ ] `wcb-mp3.json`: `firmware` "WCB 6.2.1_021242RSEP2026"; `routing.notes` (host routing on 6.2.1, `WCB.ino:6424`; local-only on 6.1.x). Verbs unchanged (WcbCmd `WcbMp3.cpp:32-93`).
+
+### Task A7: `fix(wcb-wled): preset starts at 1; 6.2.1 metadata`
+
+- [ ] `wled.preset` `preset` min 0 → 1.
+- [ ] `firmware` "WCB 6.2.1_021242RSEP2026"; component and manifest name "WCB · WLED Lighting (WCB 6.2+)" (6.1.5 has no `;L`, 6.1.5 `WCB.ino:4697-4718`).
+- [ ] `routing.notes`: needs 6.2.1; receiving WCB must know the WLED id (`?WLED,<id>:W<n>S<port>:<baud>` or WDP), no fallback; one mesh hop, no read-back; ≤187 characters with ETM checksum on.
+- [ ] Other nine ids unchanged; skip `wled.fxSpeed`.
+
+### Task A8: `fix(wcb-native): 6.2.1 ranges and grammar corrections`
+
+**File:** `libraries/boards/wcb-native.json` (hand-edit, compact formatting; templates and param names unchanged).
+
+- [ ] `firmware` "WCB 6.2.1_021242RSEP2026"; new enums `wcb.portUsb`, `wcb.devBaud`, `wcb.hcrField`, `wcb.varScope`, `wcb.varOp`, `wcb.varDir`; `categories` per spec.
+- [ ] Apply the fix table in the spec (`wcb.maestro` spec pattern, `wcb.num`/`wcb.qty` 20, `wcb.routeWcb` 20, `wcb.routeSerial` S0, `wcb.timer` 1800000, `wcb.maestroClear` 8, `wcb.hcrPort` baud, `wcb.hcrPoll` min 3, `wcb.hcrGet` field enum, `wcb.etmMiss` 100, map destination patterns). Re-read `addSerialMonitorMapping` / `addPWMMapping` and check how a per-destination `R` interacts with the `,R,` literal of `wcb.mapSerialRaw`.
+- [ ] Mark `?FUNCCHAR,?` as 6.2.1-only (`WCB.ino:4903-4910`).
+
+### Task A9: `feat(wcb-native): 66 commands for WCB 6.2.1 (and missed 6.1.5 surface)`
+
+- [ ] Insert the 66 commands at the anchors in the spec's "66 new commands" table; → items precede their catch-all.
+- [ ] `wcb.pwmPulse` `;P{port}{width}`: `port` must be a single-digit enum or pattern (1-5), never an int — two adjacent int placeholders match greedily.
+- [ ] Every 6.2+ command gets " (WCB 6.2+)"; `wcb.mapPwmClearOut` is `power` (reboots); `wcb.identify` is `cosmetic`.
+- [ ] Tests: `?ALIAS,CLEAR` → `wcb.aliasClear`; `?ALIAS,clear` → no match; `?VAR,CLEAR,ALL` → `wcb.varClearAll`; `?DFP,ONERR,CLEAR` → `wcb.dfpOnErrClear`; `?MAESTRO,REMOTE` → `wcb.maestroRemote`; `?MAESTRO,M1:W2S1:57600` → `wcb.maestro`; `;Wdome,;A,PLAY,1` → `wcb.routeAlias`; `;W2,;A,PLAY,1` → `wcb.routeWcb`; `;Cwave,L` → `wcb.runSeqLocal`; `;Cwave` → `wcb.runSeq`; `;P11500` → `wcb.pwmPulse` with port `1`, width `1500`.
+
+### Task A10 (optional): `docs(maestro-native): not a WCB grammar`
+
+- [ ] `routing.notes` only (D3): bare Pololu action grammar for NaviCore and local controllers; a WCB does not translate it; use `maestro` (`;M{id},…`) on a WCB; WcbCmd omits restartScript, setSpeedAccel and setEasing (`WcbMaestro.h:48-51`).
+
+### Task A11: `fix(flthy-hps): sequence codes per FlthyHPs v1.81 firmware`
+
+**Decision recorded in the spec: follow the firmware source** (every sketch from v1.6 through v2.1 dispatches 005 solid, 006 rainbow, 007 short circuit and accepts X/Y/Z; the v1.8 manual table is the pre-v1.6 order).
+
+- [ ] `flthy-hps.json`: `flthy.led.shortcircuit` → `{designator}007{color}`; `flthy.led.solid` → `{designator}005{color}`; `flthy.led.rainbow` → `{designator}006`; restore `X` (Front & Rear), `Y` (Front & Top), `Z` (Rear & Top) in `flthy.designator`; update examples.
+- [ ] `test/wcb-621.test.js`: add exactly these three ids to the template-fix allowlist with their 4.2.0 and corrected templates, and a one-line reason.
+- [ ] Tests that pin the old codes: `test/engine.test.js` (`A0065`, `A007|240`, `A0057`, and the `A007^*** Flthy rainbow` wire strings), `test/load-node.test.js` (`A0065` → `A0055`), `test/fixtures/commands.sample.json`.
+- [ ] Docs and examples: `README.md` quick start (`A007^*** Flthy Rainbow`, `A0065`), `docs/INTEGRATION_GUIDE.md` (`A0065`, `A007^*** Flthy rainbow`), `examples/node-example.js`, the `durationSuffix` example in `schema/library.schema.json`.
+- [ ] Add a superseded-by note to `docs/superpowers/specs/2026-07-06-flthy-hps-full-command-reference-design.md` (decisions 1 and 2; decision 3, the servo codes, stands).
+
+### Task A12: `release: bump library to 4.3.0 (WCB 6.2.1 sweep)`
+
+- [ ] `libraries/manifest.json`: `libraryVersion` 4.3.0; `generatedFrom` += `; WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0 (2026-09)`; 22 boards.
+- [ ] `releases.json`: `latest.libraryVersion` and `libraries[0].libraryVersion` 4.3.0; `releasedAt` = merge date; `latest.notes` one string starting "Minor:" (Maestro comma verbs and queries, ids 0-9 / subs 0-127; `wcb-dfp` with 22 verbs; HCR TRIGGER and all-channel volume, FN codes; 66 `wcb-native` commands and range fixes; WLED presets from 1; FlthyHPs codes follow firmware v1.6+; text fields need a host engine 3.1.0 or later; catalog 21 → 22).
+- [ ] `package.json` and `package-lock.json` (both `version` fields) 4.3.0 — hand-edit, or `npm --no-git-tag-version version 4.3.0`.
+- [ ] Test pins: `test/load-node.test.js` `'4.3.0'` and `toBe(22)`; `test/engine.test.js` `'4.3.0'`.
+- [ ] Gate: `npm run validate` (warnings only for non-standard categories), `npm test` green.
+
+### Task A13: PR, CI, merge
+
+- [ ] Push the branch; open "WCB firmware 6.2.1 sweep (4.3.0)", linking the spec and summarizing the D1 id policy.
+- [ ] CI `validate-and-test` green; resolve review threads (conversation resolution is required).
+- [ ] Merge (branch protection needs one approval; an author cannot approve their own PR). Record the merge SHA.
+- [ ] In the PR body, flag for NaviCore: the new `maestro.wcb.*` ids and the sequence ids (`wcb.runSeqLocal`, `wcb.runSeqLongLocal`, `wcb.seqNames`, `wcb.seqGet`, `wcb.timerStop`) that its local `wcb-sequences` split will not move automatically.
+
+### Task A14: After-merge checks
+
+Wait at least 300 s (raw.githubusercontent.com `max-age=300`), then:
+
+- [ ] `releases.json` on `main` reports `4.3.0`; `libraries/manifest.json` reports `4.3.0` and 22 boards.
+- [ ] GitHub Pages: `reference.html` lists `wcb-dfp` and the `maestro.wcb.*` commands; `index.html` composes `;D,PLAY,5`.
diff --git a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
new file mode 100644
index 0000000..42e946d
--- /dev/null
+++ b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
@@ -0,0 +1,451 @@
+# WCB Firmware v6.2.1 — Command Sweep (4.3.0)
+
+**Date:** 2026-09-15
+**Status:** Draft (implementation on branch `wcb-firmware-6.2.1-sweep`)
+**Library base:** `main` @ `82b6a04` — libraryVersion 4.2.0, 21 boards, 397 commands
+**Firmware source:** [greghulette/Wireless_Communication_Board-WCB](https://github.com/greghulette/Wireless_Communication_Board-WCB) @ `66845b9a` — `Code/WCB/WCB.ino:181` `SoftwareVersion = "6.2.1_021242RSEP2026"`
+**Shared translators:** [greghulette/WcbCmd](https://github.com/greghulette/WcbCmd) 0.8.0 @ `168f1e5` (2026-08-05) — the `;M` / `;A` / `;D` / `;H` / `;L` text-to-device translators that 6.2.1 compiles in (`WCB.ino:87`)
+**Baseline for "(WCB 6.2+)":** WCB `v6.1.5_290119RJUN2026` (`5cd4b6ba`). There is no 6.2.0 release, so "6.2+" means 6.2.1 or later.
+**Plan:** [`docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md`](../plans/2026-09-15-wcb-firmware-6.2.1-sweep.md)
+
+All firmware references below are `Code/WCB/<file>:<line>` at `66845b9a` unless marked
+6.1.5 (`v6.1.5_290119RJUN2026`) or WcbCmd (`src/<file>:<line>` at `168f1e5`).
+
+## Goal
+
+The 4.1.0 sweep modeled WCB 6.1.5. WCB 6.2.1 adds:
+
+- a DFPlayer Mini verb family (`;D,`);
+- comma and verb spellings of `;M` (Pololu servo verbs and asynchronous get queries);
+- host routing for `;A`, `;D` and `;H` (the command runs on the board that hosts the device);
+- alias routing (`;W<alias>,…`), local-only sequence runs (`;C<key>,L`), persistent variables (`;VP`);
+- whole `?` config families: WDP discovery, WLED, DFP, MP3/HCR remote hosts, the controller peer, the mesh channel.
+
+The 4.1.0 sweep also missed part of the 6.1.5 surface (`;P`, `;V` / `IF`, `?VAR`, `?ALIAS`,
+`?STOP`, `?IDENTIFY`, …), and 4.2.0 carries a few ranges copied from stale help text.
+
+This sweep brings the catalog to 6.2.1 as a **minor** release (4.3.0) without breaking any
+value stored under a 4.2.0 command id, and corrects the FlthyHPs LED sequence codes (see
+"FlthyHPs sequence codes").
+
+## Engine facts that shape the design
+
+- **First match wins.** `match()` walks components in manifest order and commands in array
+  order, and returns the first anchored template regex that matches
+  (`src/droidnet-command-library.js:293`, `:297-306`). Specific literals must come before
+  catch-all patterns.
+- **Int ranges are UI-only.** Int params always match `(-?\d+)`; `min` / `max` bound the
+  composer control, never the parser. Enum and `pattern` params do constrain the parser.
+- **The composer never shows `firmware` or `routing.notes`.** Neither
+  `src/droidnet-command-library-ui.js` nor the hosted site (`assets/*.js`) reads them, so a
+  firmware requirement a user must see goes in a name (D5). The fields stay accurate as the
+  reviewer's record of what was verified.
+- **Existing tests would not catch a wrong match.** `test/web.test.js` checks that an example
+  parses to *some* command. The new guard test checks it parses to *its own* command.
+
+## Decisions
+
+### D1 — 4.3.0 is a minor release
+
+- No 4.2.0 command id is removed, renamed or re-templated (the FlthyHPs template fix is the one
+  documented exception; see D2).
+- The WCB `;M{id},…` verbs are published under **new** ids, `maestro.wcb.*`. The ids
+  `maestro.goHome`, `maestro.stopScript` and `maestro.setTarget` already belong to the
+  `maestro-native` board (bare Pololu action grammar); reusing them for `;M` forms would be a
+  rename, i.e. 5.0.0.
+- DroidNet's unpublished `wled.power`, `wled.brightness`, `wled.effect`, `wled.effectTuned` and
+  `wled.palette` are **not** added. They emit the same wire strings as the published
+  `wled.on/off/toggle`, `wled.bri`, `wled.fx`, `wled.fxfull` and `wled.pal`, and would shadow
+  them (or be shadowed).
+- `dfp.play`, `dfp.stop` and `dfp.volume` keep DroidNet's templates and param names (`track`
+  1-2999; `volume` 0-30, default 20), so wire text DroidNet already stored decodes unchanged.
+
+### D2 — existing ids may tighten; templates and param names are frozen
+
+- Ranges, enums and patterns on existing ids may change (patch-class fixes).
+- Every 4.2.0 id keeps a byte-identical `template` and the same ordered list of param names.
+  `test/wcb-621.test.js` enforces this against `test/fixtures/catalog-4.2.0-commands.json`
+  (generated from the real catalog at `82b6a04`). The fixture changes only on a major release.
+- `wcb.mapSerial`, `wcb.mapSerialRaw` and `wcb.mapPwm` keep `{dest}`; only its `pattern` widens.
+- **Exception:** the three FlthyHPs LED templates (`flthy.led.solid`, `flthy.led.rainbow`,
+  `flthy.led.shortcircuit`) are corrected to the firmware's codes. Their param names do not
+  change. The freeze test lists them in an explicit allowlist that pins both the 4.2.0 and the
+  corrected template, so nothing else can slip through.
+
+### D3 — `maestro-native` stays as is
+
+It is the bare Pololu action grammar used by NaviCore (upstream PR #8). A WCB does not
+translate it; WcbCmd leaves out `restartScript`, `setSpeedAccel` and `setEasing`
+(WcbCmd `WcbMaestro.h:48-51`). At most add `routing.notes` pointing WCB users at the `maestro`
+board. Its channel max of 31 is left to its author.
+
+### D4 — one version number
+
+`package.json` `version` and `package-lock.json` `version` (top level and `packages[""]`) move
+to `4.3.0` together with `libraries/manifest.json` and `releases.json`. Neither package file
+has tracked the catalog before (`2.1.1` / `1.0.0`).
+
+### D5 — firmware requirements go in names
+
+- A command that needs 6.2 inside a board that otherwise works on older firmware gets the
+  suffix **" (WCB 6.2+)"** in its `name`.
+- A board that only exists on 6.2 (`wcb-dfp`, `wcb-wled`) carries "(WCB 6.2+)" in the
+  component `name` and in its manifest `name`.
+- `docs/BOARD_AUTHORING_GUIDE.md` records the rule for future boards.
+
+### D6 — left out of 4.3.0
+
+| Item | Why |
+|---|---|
+| `?OTA`, `?OTALOCAL` (`WCB.ino:5345`, `:5359`) | The Wizard's OTA transfer protocol (base64 chunks), not a user command |
+| `?MGMT`, `?RTERM`, `WCB_WEBTOOL_CONFIG_PULL`, `?CHK`, `?CS` | Internal / bootstrap machine protocols |
+| `?STATS,RPT,…` (`WCB.ino:5539`) | Machine-to-machine reports |
+| Legacy aliases (`?SPECIAL`, `?HWx`, `?BAUDSx,…`, `;H,VOLDOWN`, …) | Deprecated spellings; author canonical forms only (as in 4.1.0) |
+| Implicit `,key` callbacks (`;A,PLAY,5,key`, `;D,PLAY,5,key`) | Ambiguous next to the explicit `,ONFIN,key` form |
+| No-comma `;S{port}{msg}` | Would turn existing `targetPrefix` values such as `;S3T52` into route commands |
+| Bare `;L,<verb>` (lowest-id local WLED, `WCB_WLED.cpp:125-137`) | Undocumented in help; needs an empty-code enum on `wledId` |
+| Safety class of `wcb.runSeq`, `wcb.runSeqLong`, `wcb.timer` (`config` today) | These can trigger movement; changing the class is a follow-up review |
+
+## Board changes
+
+Values below come from the cited firmware lines (the grammar, range and routing claims were
+spot-checked against `66845b9a` while writing this spec). Each implementation commit re-reads
+its citations before encoding a template, range or enum; where firmware and this table
+disagree, the firmware wins and the commit message says so.
+
+### `maestro` (wcb-verb) — comma verbs and get queries
+
+Grammar: `processMaestroCommand` (`WCB.ino:6729-6786`), help (`WCB_Help.cpp:430-459`),
+WcbCmd `WcbMaestro.h:32-41`, `WcbMaestro.cpp:6-21`, `:98-120`.
+
+- **Component:** name "Maestro (WCB ;M verbs)" (manifest too); `firmware` "WCB
+  6.2.1_021242RSEP2026"; `categories` `["Sequences","Movement","System"]`; `routing.notes`
+  cover the facts below.
+- **`maestro.id`** codes: `0` All, `1`-`8` #1-#8, `9` All local (this WCB). Id 9 is **not**
+  6.2-only: 6.1.5 already sends `;M9…` to every local Maestro (6.1.5 `WCB_Maestro.cpp:143-168`).
+- **New `maestro.queryId`** codes `1`-`8`: get queries reject 0 and 9
+  (`WCB_Maestro.cpp:397`, `WCB_Help.cpp:451`).
+- **`maestro.trigger`** `seq` max 9 → 127. Firmware accepts 0-255 (`WCB.ino:6750-6754`), but a
+  Pololu data byte is 0-127. Template `;M{id}{seq}` unchanged.
+- Comma forms need 6.2.1 on the sending board **and** the Maestro host. 6.1.x reads `;M1,5` as
+  id 1 with `",5".toInt()` = subroutine **0** (6.1.5 `WCB.ino:4871-4876`).
+- get* queries are asynchronous and write RAM variables `m<id>pos<ch>`, `m<id>moving`,
+  `m<id>err`; an `IF` in a separate, later trigger reads them; never wrap a get in `;W`
+  (`WCB_Help.cpp:451-459`). `getMovingState` is Mini Maestro only.
+
+| id | name | template | params | category | safety | example |
+|---|---|---|---|---|---|---|
+| `maestro.wcb.sub` | Run Subroutine (WCB 6.2+) | `;M{id},{sub}` | sub 0-127 | Sequences | movement | `;M1,5` |
+| `maestro.wcb.subParam` | Run Subroutine with Parameter (WCB 6.2+) | `;M{id},{sub},{param}` | sub 0-127, param 0-16383 | Sequences | movement | `;M3,5,1000` |
+| `maestro.wcb.subVerb` | Run Subroutine, sub verb (WCB 6.2+) | `;M{id},sub,{sub}` | sub 0-127 | Sequences | movement | `;M2,sub,5` |
+| `maestro.wcb.subVerbParam` | Run Subroutine with Parameter, sub verb (WCB 6.2+) | `;M{id},sub,{sub},{param}` | sub 0-127, param 0-16383 | Sequences | movement | `;M2,sub,5,1000` |
+| `maestro.wcb.stopScript` | Stop Script (WCB 6.2+) | `;M{id},stopScript` | — | Sequences | movement | `;M1,stopScript` |
+| `maestro.wcb.goHome` | Go Home (WCB 6.2+) | `;M{id},goHome` | — | Movement | movement | `;M2,goHome` |
+| `maestro.wcb.setTarget` | Set Servo Target (WCB 6.2+) | `;M{id},setTarget,{channel},{target}` | channel 0-23; target 0-16383, default 6000 | Movement | movement | `;M1,setTarget,0,6000` |
+| `maestro.wcb.setSpeed` | Set Speed Limit (WCB 6.2+) | `;M{id},setSpeed,{channel},{speed}` | channel 0-23; speed 0-16383, default 0 | Movement | movement | `;M5,setSpeed,3,10` |
+| `maestro.wcb.setAccel` | Set Acceleration Limit (WCB 6.2+) | `;M{id},setAccel,{channel},{accel}` | channel 0-23; accel 0-255 | Movement | movement | `;M2,setAccel,0,5` |
+| `maestro.wcb.getPosition` | Read Servo Position (WCB 6.2+) | `;M{id},getPosition,{channel}` | id = `maestro.queryId`; channel 0-23 | System | cosmetic | `;M2,getPosition,0` |
+| `maestro.wcb.getMovingState` | Read Moving State (WCB 6.2+) | `;M{id},getMovingState` | id = `maestro.queryId` | System | cosmetic | `;M2,getMovingState` |
+| `maestro.wcb.getErrors` | Read Errors (WCB 6.2+) | `;M{id},getErrors` | id = `maestro.queryId` | System | cosmetic | `;M2,getErrors` |
+
+Channel max 23 is the largest Maestro (Mini Maestro 24); the frame builder accepts up to 127.
+
+### `wcb-dfp` (new, wcb-verb) — DFPlayer Mini
+
+Grammar: WcbCmd `WcbDfPlayer.cpp:51-168`; config `WCB_DFP.cpp:144-327`; help
+`WCB_Help.cpp:566-593`; routing `WCB.ino:6426-6428`.
+
+- **Component:** id `wcb-dfp`, name "WCB · DFPlayer Mini (WCB 6.2+)", `kind` wcb-verb,
+  `confidence` high, `firmware` "WCB 6.2.1_021242RSEP2026", `categories`
+  `["Sound","Volume","System"]`. Manifest entry right after `wcb-mp3` (the `;D,` prefix is
+  unique, so position does not affect matching).
+- **`routing.notes`:** needs `?DFP,S<port>` (baud fixed at 9600); `;D` runs on the local host,
+  else the `?DFP,REMOTE` board, else a board advertising a DFPlayer over WDP; volume 0 = silent,
+  30 = loudest (the reverse of `;A`); allow 1.5-3 s after power-on; clone modules may ignore
+  RANDOM, EQ and LOOPFOLDER.
+- **Enums:** `dfp.eq` 0 Normal, 1 Pop, 2 Rock, 3 Jazz, 4 Classic, 5 Bass; `dfp.device` 1 USB,
+  2 SD card, 3 AUX, 4 Sleep, 5 Flash; `dfp.loopAll` 0 Off, 1 On.
+- **22 commands**, all `cosmetic` except `dfp.device` and `dfp.reset` (`config`). Callback key
+  pattern `[A-Za-z0-9_]+`.
+
+| id | template | params | example |
+|---|---|---|---|
+| `dfp.play` | `;D,PLAY,{track}` | track 1-2999 | `;D,PLAY,5` |
+| `dfp.playCb` | `;D,PLAY,{track},ONFIN,{key}` | track, key | `;D,PLAY,5,ONFIN,done` |
+| `dfp.folder` | `;D,FOLDER,{folder},{track}` | folder 1-99, track 1-255 | `;D,FOLDER,1,5` |
+| `dfp.folderCb` | `;D,FOLDER,{folder},{track},ONFIN,{key}` | folder, track, key | `;D,FOLDER,1,5,ONFIN,done` |
+| `dfp.mp3Folder` | `;D,MP3FOLDER,{track}` | track 1-9999 | `;D,MP3FOLDER,3` |
+| `dfp.mp3FolderCb` | `;D,MP3FOLDER,{track},ONFIN,{key}` | track, key | `;D,MP3FOLDER,3,ONFIN,done` |
+| `dfp.stop`, `dfp.pause`, `dfp.resume`, `dfp.next`, `dfp.prev`, `dfp.random` | `;D,STOP`, `;D,PAUSE`, `;D,RESUME`, `;D,NEXT`, `;D,PREV`, `;D,RANDOM` | — | same as template |
+| `dfp.loop` | `;D,LOOP,{track}` | track 1-2999 | `;D,LOOP,5` |
+| `dfp.loopAll` | `;D,LOOPALL,{state}` | `dfp.loopAll` | `;D,LOOPALL,1` |
+| `dfp.loopFolder` | `;D,LOOPFOLDER,{folder}` | folder 1-99 | `;D,LOOPFOLDER,1` |
+| `dfp.eq` | `;D,EQ,{preset}` | `dfp.eq` | `;D,EQ,2` |
+| `dfp.volume` | `;D,VOL,{volume}` | volume 0-30, default 20 | `;D,VOL,20` |
+| `dfp.volUp`, `dfp.volDown` | `;D,VOLUP`, `;D,VOLDN` | — (steps of 2) | same as template |
+| `dfp.device` | `;D,DEVICE,{source}` | `dfp.device` | `;D,DEVICE,2` |
+| `dfp.reset` | `;D,RESET` | — | `;D,RESET` |
+| `dfp.status` | `;D,STATUS` | — | `;D,STATUS` |
+
+### `wcb-hcr` — TRIGGER, all-channel volume steps, FN codes
+
+Grammar: `WCB_HCR.cpp:263-285` (FN), `:290-299` (TRIGGER), `:365-409` (VOL / VOLUP / VOLDN);
+WcbCmd `WcbHcr.cpp:7-36`.
+
+- **Component:** `firmware` "WCB 6.2.1_021242RSEP2026" (replaces the stale "WCB 6.1.0
+  HCR_Integration"); `routing.notes`: on 6.2.1 `;H` runs on the board that **hosts** the HCR —
+  this board, else the `?HCR,REMOTE,W<n>` board, else a board advertising HCR over WDP
+  (`WCB.ino:6391-6408`, `:6430`); 6.1.x runs `;H` on the local board only. Keep the word
+  "host" (a DroidNet test matches it).
+- **`hcr.fn`** (template unchanged): `fn` becomes enum `hcr.fnCode` — 2 SetEmotion, 3 Trigger,
+  4 Stimulate, 5 Overload, 6 Muse, 7 Muse gap (6.2+), 8 Stop all, 9 Stop emote, 10 Override
+  (6.2+), 11 Reset emotions, 13 Set muse (6.2+), 14 Play WAV, 16 Stop WAV, 17 Set volume,
+  18 Vol up all (6.2+), 19 Vol down all (6.2+). Codes 12 and 15 are rejected. `chan` max 99
+  (fn 7); `track` 0-9999 (fn 14).
+- **Do not touch** `hcr.emotion` / `hcr.channel`: `test/library.test.js` requires them
+  byte-identical to `hcr-native.json`.
+
+| id | name | template | params | category | example | insert before |
+|---|---|---|---|---|---|---|
+| `hcr.trigger` | Emotional Trigger | `;H,TRIGGER,{emotion},{strength}` | `hcr.emotion`, `hcr.strength` | Emotion | `;H,TRIGGER,M,MOD` | `hcr.play` |
+| `hcr.volAll` | Set Volume, all channels (WCB 6.2+) | `;H,VOL,{level}` | level 0-100 | Volume | `;H,VOL,60` | `hcr.volUp` |
+| `hcr.volUpAllStep` | Volume Up by step, all channels | `;H,VOLUP,{step}` | step 1-100, default 5 | Volume | `;H,VOLUP,10` | `hcr.volDown` |
+| `hcr.volDownAllStep` | Volume Down by step, all channels | `;H,VOLDN,{step}` | step 1-100, default 5 | Volume | `;H,VOLDN,10` | `hcr.fadeIn` |
+
+All four are `cosmetic`.
+
+### `wcb-mp3` — host routing notes
+
+`firmware` "WCB 6.2.1_021242RSEP2026". `routing.notes`: on 6.2.1 `;A` runs on the MP3 host
+(local, `?MP3,REMOTE,W<n>`, or a board advertising it over WDP; `WCB.ino:6424`); 6.1.x plays
+only on the local board. Verbs unchanged (WcbCmd `WcbMp3.cpp:32-93`).
+
+### `wcb-wled` — preset range and 6.2 naming
+
+- `wled.preset` `preset` min 0 → 1 (WLED preset ids are 1-250).
+- `firmware` "WCB 6.2.1_021242RSEP2026". Component and manifest name "WCB · WLED Lighting (WCB
+  6.2+)": 6.1.5 has no `;L` dispatch (6.1.5 `WCB.ino:4697-4718`; 6.2.1 `WCB.ino:6432-6433`).
+- `routing.notes`: needs 6.2.1; the receiving WCB must know the WLED id (`?WLED,<id>:W<n>S<port>:<baud>`
+  or learned over WDP) — no fallback; forwarded one mesh hop, no read-back; a mesh-routed
+  command must stay within 187 characters while the ETM checksum is on.
+- The other nine ids are unchanged. `wled.fxSpeed` (FX with speed but no intensity, WcbCmd
+  `WcbWled.cpp:80-90`) is skipped.
+
+### `wcb-native` — range and grammar fixes (templates unchanged)
+
+New enums: `wcb.portUsb` (`0` "S0 (USB)" plus the `wcb.port` values), `wcb.devBaud` (9600,
+19200, 38400, 57600, 115200), `wcb.hcrField` (`EMOTION,H|S|M|C`, `DURATION`, `OVERRIDE`,
+`MUSE`, `WAVCOUNT`, `PLAYING,V|A|B`, `VOL,V|A|B`), `wcb.varScope` (`V` Volatile (RAM), `VP`
+Persistent (NVS, WCB 6.2+)), `wcb.varOp` (TOGGLE, INC, DEC, true, false), `wcb.varDir` (INC,
+DEC). `categories` become `["Setup","Config","Routing","Movement","Sequences","Variables","System","Power"]`.
+
+| Id | Change | Firmware |
+|---|---|---|
+| `wcb.maestro` | `spec` pattern `.+` → `M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+(?:,M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+)*`; today `?MAESTRO,REMOTE` parses as `wcb.maestro` | `WCB.ino:5437` |
+| `wcb.num`, `wcb.qty` | max 9 → 20 | `WCB.ino:5298-5305`, `WCB_Storage.cpp:447-451` |
+| `wcb.routeWcb` | `wcb` max 20 | `WCB.ino:6553-6566` |
+| `wcb.routeSerial` | port → `wcb.portUsb`; 6.2.1 strips one comma, 6.1.x put ",msg" on the wire | `WCB.ino:6450-6463` |
+| `wcb.timer` | ms max 1800000 | `command_timer.cpp:166` |
+| `wcb.maestroClear` | id max 8 | `WCB_Maestro.cpp:817` |
+| `wcb.hcrPort` | baud → `wcb.devBaud` (S3-S5 only 9600) | `WCB_HCR.cpp:631-640` |
+| `wcb.hcrPoll` | min 3 (0 / OFF = off → `wcb.hcrPollOff`) | `WCB_HCR.cpp:568-575` |
+| `wcb.hcrGet` | `field` → `wcb.hcrField` | `WCB_HCR.cpp:586-604` |
+| `wcb.etmMiss` | max 100 | `WCB.ino:5211-5217` |
+| `wcb.mapSerial`, `wcb.mapSerialRaw` | `dest` pattern → comma list of `S0-S5` / `W1-20S0-5`, optional `R` per destination; re-check against the `,R,` literal in `mapSerialRaw` | `WCB_Storage.cpp` `addSerialMonitorMapping` |
+| `wcb.mapPwm` | `dest` pattern → comma list of `S1-S5` / `W1-20S1-5` | `WCB_PWM.cpp` `addPWMMapping` |
+
+`?FUNCCHAR,?` (existing example) only works on 6.2.1, which exempts FUNCCHAR/CMDCHAR from the
+trailing-`?` help shortcut (`WCB.ino:4903-4910`); say so in the command name or notes.
+
+### `wcb-native` — 66 new commands
+
+Names, safety and categories follow the 4.1.0 conventions (`config` for `?` setup, `cosmetic`
+for read-only queries and identify, `movement` for `;P`, `power` for anything that reboots).
+Every command marked 6.2+ gets " (WCB 6.2+)". An arrow (→) marks a command that must precede
+the catch-all after it.
+
+| Insert before | Commands (id: template) | Firmware |
+|---|---|---|
+| `wcb.mac2` | `wcb.meshChannel` `?WCBCH,{ch}` 1-11 (6.2+, applies on reboot) · → `wcb.aliasClear` `?ALIAS,CLEAR` · → `wcb.aliasList` `?ALIAS,LIST` · `wcb.alias` `?ALIAS,{name}` pattern `(?![Cc][Ll][Ee][Aa][Rr]$\|[Ll][Ii][Ss][Tt]$)[A-Za-z][^,;?]{0,23}` · `wcb.controllerOn` `?CONTROLLER,ON` · `wcb.controllerOnId` `?CONTROLLER,ON,{id}` 1-20 · `wcb.controllerOff` `?CONTROLLER,OFF` (controller 6.2+) · `wcb.ledPin` `?LED,PIN,{gpio}` 0-48 · `wcb.ledPinQuery` `?LED,PIN` · `wcb.identify` `?IDENTIFY` (cosmetic) | `WCB.ino:5323`, `:5372-5384`, `:5394-5420`, `:5678-5681`, `:5629`; `WCB_Storage.cpp:212-240` |
+| `wcb.bcastReset` | `wcb.bcastOutUsb` `?BCAST,OUT,S0,{state}` (6.2+) | `WCB.ino:5133` |
+| `wcb.mapPwmList` | `wcb.mapPwmClearOut` `?MAP,PWM,CLEAR,OUT,S{port}` — **safety `power`**, it reboots | `WCB.ino:5026-5033` |
+| near `wcb.kyber*` | `wcb.kyberLocalMaestros` `?KYBER,LOCAL,S{port},{spec}` (spec = the Maestro spec pattern above) | `WCB_Help.cpp:213` |
+| `wcb.maestro` | → `wcb.maestroRemote` `?MAESTRO,REMOTE` | `WCB.ino:5437-5441` |
+| `wcb.mp3*` block | `wcb.mp3Remote` `?MP3,REMOTE,W{wcb}` 1-20 · `wcb.mp3RemoteOff` `?MP3,REMOTE,OFF` (6.2+) | `WCB_MP3.cpp:206-209` |
+| `wcb.hcrPort` | `wcb.dfpCfg` `?DFP,S{port}:9600:V{vol}` (vol 0-30) · `wcb.dfpPort` `?DFP,S{port}` · `wcb.dfpList` · `wcb.dfpClear` · `wcb.dfpRemote` `?DFP,REMOTE,W{wcb}` · `wcb.dfpRemoteOff` · → `wcb.dfpOnErrClear` `?DFP,ONERR,CLEAR` · `wcb.dfpOnErr` `?DFP,ONERR,{key}` (all 6.2+) | `WCB_DFP.cpp:144-327` |
+| `wcb.hcrList` | `wcb.hcrPollOff` `?HCR,POLL,OFF` · `wcb.hcrRemote` `?HCR,REMOTE,W{wcb}` (6.2+) · `wcb.hcrRemoteOff` `?HCR,REMOTE,OFF` (6.2+) | `WCB_HCR.cpp:537-562`, `:568-575` |
+| `wcb.routeSerial` | `wcb.wledCfg` `?WLED,{id}:W{wcb}S{port}:{baud}` (id 1-9, wcb 1-20, port `wcb.portUsb`, baud `wcb.devBaud`; `?WLED,1:W3S2:115200`) · `wcb.wledList` · `wcb.wledStatus` · `wcb.wledClear` · `wcb.wledClearId` `?WLED,CLEAR,{id}` (all 6.2+) | `WCB_WLED.cpp:229-353` |
+| `wcb.timer` | `wcb.routeAlias` `;W{alias},{message}`, alias `[A-Za-z][^,;?]{0,23}` (6.2+) · `wcb.pwmPulse` `;P{port}{width}` port single-digit 1-5 (enum or pattern, see hazards), width 500-2500, Movement / movement | `WCB.ino:6525-6550`, `:6788-6834` |
+| `wcb.seqList` | `wcb.seqNames` `?SEQ,NAMES` · `wcb.seqGet` `?SEQ,GET,{key}` (6.2+) | `WCB.ino:5497`, `:5513` |
+| after `wcb.runSeqLong` | `wcb.runSeqLocal` `;C{key},L` · `wcb.runSeqLongLocal` `;SEQ{key},L` (6.2+; on 6.1 the `,L` becomes part of the key) · `wcb.timerStop` `?STOP` | `WCB.ino:6654-6691`, `:7053`; `command_timer.cpp:66-78` |
+| `wcb.etmOn` | `wcb.varSet` `;{scope},{name},{value}` (name `[A-Za-z0-9_]{1,15}`, value int) · `wcb.varOp` `;{scope},{name},{op}` · `wcb.varStep` `;{scope},{name},{dir},{n}` · `wcb.if` `IF,{cond}` (gates the next step; cannot ride inside a `;W` or `;T` payload) · `wcb.varList` `?VAR,LIST` · `wcb.varSetNvs` `?VAR,SET,{name},{value}` · `wcb.varGet` `?VAR,GET,{name}` · → `wcb.varClearAll` `?VAR,CLEAR,ALL` · `wcb.varClear` `?VAR,CLEAR,{name}` | `WCB_Variables.cpp:63-73`, `:209-337`, `:372`, `:435`; `WCB.ino:6568-6581` |
+| `wcb.stats` | `wcb.debugMgmt` `?DEBUG,MGMT,{state}` · `wcb.debugRaw` `?DEBUG,RAW,{state}` · `wcb.track` `?TRACK,{state}` · `wcb.trackStatus` `?TRACK,STATUS` · `wcb.version` `?VERSION` · `wcb.peersLive` `?PEERSLIVE` (6.2+) · WDP (all 6.2+): `wcb.wdpList` `?WDP,LIST`, `wcb.wdpDetail` `?WDP,{wcb}`, `wcb.wdpStatus`, `wcb.wdpDump`, `wcb.wdpDa`, `wcb.wdpPoll`, `wcb.wdpEnable` `?WDP,{state}`, `wcb.wdpAutojoin`, `wcb.wdpAutojoinSet` `?WDP,AUTOJOIN,{state}`, `wcb.wdpAdd` `?WDP,ADD,{wcb}`, `wcb.wdpForget` `?WDP,FORGET,{wcb}`, `wcb.wdpClear` | `WCB.ino:4965-4976`, `:5336`, `:5551`, `:5749`; `WCB_WDP.cpp:1201-1276` |
+
+Behavior changes between 6.1 and 6.2 that existing commands' notes should mention:
+
+- `;C<key>` / `;SEQ<key>` now run on **every** mesh board that stores the key
+  (`WCB.ino:6654-6691`); 6.1.5 ran them locally. `,L` restores local-only.
+- `;A`, `;D`, `;H` run on the device host (`routeStoredOrCap`, `WCB.ino:6391-6408`).
+- `;V` is now volatile (RAM only); `;VP` is persistent (`WCB_Variables.cpp:203-220`). In 6.1.5
+  `;V` persisted.
+
+### `maestro-native` (optional)
+
+`routing.notes` only: "Bare Pololu action grammar used by NaviCore and local controllers; a WCB
+does not translate it. For a WCB use the `maestro` board (`;M{id},…`)." No other change (D3).
+
+## Ordering and grammar hazards
+
+First-match-wins makes these pairs order-sensitive. The guard test (b) catches any regression
+because every example on the WCB boards must decode to its own id.
+
+| Specific (must come first) | Catch-all it would lose to |
+|---|---|
+| `wcb.aliasClear` `?ALIAS,CLEAR`, `wcb.aliasList` `?ALIAS,LIST` | `wcb.alias` `?ALIAS,{name}` (the negative lookahead also keeps any-case CLEAR/LIST out, matching the firmware's case-insensitive compare at `WCB.ino:5374-5379`; `?ALIAS,clear` stays a raw step) |
+| `wcb.maestroRemote` `?MAESTRO,REMOTE` | `wcb.maestro` `?MAESTRO,{spec}` (also fixed by tightening `spec`) |
+| `wcb.dfpOnErrClear` `?DFP,ONERR,CLEAR` | `wcb.dfpOnErr` `?DFP,ONERR,{key}` |
+| `wcb.varClearAll` `?VAR,CLEAR,ALL` | `wcb.varClear` `?VAR,CLEAR,{name}` |
+| existing `wcb.maestroClearAll`, `wcb.mp3OnErrClear`, `wcb.seqClearAll` (4.1.0 `43c6721`) | their `{…}` siblings |
+
+Not order-sensitive, but worth a test:
+
+- `;Cwave,L` vs `;Cwave` — the key pattern excludes `,`, so `wcb.runSeq` cannot claim `,L`.
+- `;Wdome,…` vs `;W2,…` — an alias starts with a letter, a board number is digits
+  (`WCB.ino:6525-6566`).
+- `;M2,goHome` (`maestro.wcb.goHome`) vs bare `goHome` (`maestro.goHome`, `maestro-native`) —
+  distinct boards, no shared id.
+- `;H,VOL,60` vs `;H,VOL,A,80`, `;H,VOLUP` vs `;H,VOLUP,10` vs `;H,VOLUP,A,5` — anchored
+  templates with different field counts.
+- **`wcb.pwmPulse` `;P{port}{width}`:** two adjacent placeholders. An int `port` would match
+  greedily (`;P11500` → port `1150`, width `0`), so `port` must be a single-digit enum or
+  pattern. Firmware reads exactly one digit, port 1-5, width 500-2500 (`WCB.ino:6791-6794`).
+- Whole-catalog self-match is **not** a goal: `ap.logic.text` / `ap.logic.font` examples already
+  decode as `rseries.*` (earlier in the manifest). The guard is scoped to the WCB boards.
+
+## FlthyHPs sequence codes
+
+**Decision: follow the firmware source.** 4.3.0 ships the fix (plan task A11):
+`flthy.led.solid` → `{designator}005{color}`, `flthy.led.rainbow` → `{designator}006`,
+`flthy.led.shortcircuit` → `{designator}007{color}`, and `flthy.designator` regains `X`
+(Front & Rear), `Y` (Front & Top), `Z` (Rear & Top).
+
+2.3.0 (`b38b5d2`) set solid 006 / rainbow 007 / short circuit 005 and dropped X/Y/Z, following
+the command table of *FlthyHPs Manual v1.8* (see
+`2026-07-06-flthy-hps-full-command-reference-design.md`). That table describes the sketch
+**before v1.6**. From v1.6 on, every release — v1.81 (the last v1) and the author's current
+v2.1 — dispatches 005 solid, 006 rainbow, 007 short circuit, and accepts X/Y/Z.
+
+| Source | Lines | 005 | 006 | 007 | X/Y/Z |
+|---|---|---|---|---|---|
+| FlthyHPs v1.3 / v1.4 / v1.5 sketches ([apsteven/FlthyHP](https://github.com/apsteven/FlthyHP) @ `bdbcbe3`, a copy of the 2geekswebdesign.com distribution) | v1.3 `Sketches/FlthyHPs_v1.3.ino:84-86`, dispatch `:793-795`; v1.4 `:86-88`, `:761-763`; v1.5 `:87-89`, `:762-764` | short circuit | solid | rainbow | yes (v1.3 `:692-694`) |
+| FlthyHPs v1.6 | `Sketches/FlthyHPs_v1.6.ino:114-116`, dispatch `:866-868` | solid | rainbow | short circuit | yes (`:759-761`) |
+| **FlthyHPs v1.81** | `Sketches/FlthyHPs_v1.8.ino:3` ("v1.81"), table `:118-120`, designators `:794-796` and `:813-817`, function = digits 3-4 `:802`, dispatch `:932-934` (`case 5: ledColor`, `case 6: rainbow`, `case 7: ShortCircuit`), `LEDFunction = functionState` `:1418`, short-circuit default color when `functionState==7` `:1426` | solid | rainbow | short circuit | yes |
+| FlthyHPs v2.1, author's repo ([ryan-sondgeroth/FlthyHPs](https://github.com/ryan-sondgeroth/FlthyHPs) @ `aea19d8`) | `PCA9685/FlthyHPs_v2.1.ino:440-442` (`SOLID_COLOR = 5`, `RAINBOW = 6`, `SHORT_CIRCUIT = 7`), function digits `:1019`, designator masks `:1122-1125`; `Maestro/FlthyHPs_v2.1_Maestro/FlthyHPs_v2.1_Maestro.ino:450-452`, `:1045`, `:1180-1182` | solid | rainbow | short circuit | yes |
+| Author's current manual (same repo) | `docs/README.md:349-351` (X/Y/Z), `:362-363`, examples `:404` "R0053 — Rear HP LEDs set solid Green", `:406` "T006 — Starts Rainbow", `:436` `A006\|45` rainbow | solid | rainbow | short circuit | yes |
+| *FlthyHPs Manual v1.8* PDF, command table (p. 22) | 05 Short Circuit, 06 Toggles Color, 07 Rainbow; examples `R0063`, `T007` | short circuit | solid | rainbow | F/R/T/A only |
+
+- The v1.81 sketch header's own example "A007\|25 would run the Rainbow Sequence"
+  (`FlthyHPs_v1.8.ino:155`) is the same leftover: it is the v1.3 wording and contradicts the
+  table 35 lines above it and the dispatch. The v1.8 manual's MarcDuino section (`A006|10` =
+  rainbow) already matched the source.
+- v1.6 moved short circuit out of the random auto-twitch range: twitch picks
+  `random(2,7)` = functions 2-6 (`FlthyHPs_v1.6.ino:905`, `FlthyHPs_v1.8.ino:976`), so solid and
+  rainbow can twitch and short circuit cannot. That is the renumbering's evident purpose.
+- The servo codes the 2.3.0 spec chose from the table (1 preset, 2 RC L/R, 3 RC U/D, 4 random)
+  match the v1.81 dispatch (`FlthyHPs_v1.8.ino:956-961`); they stay.
+- A C2B5 working copy of v1.81 has the identical dispatch; it differs from the stock sketch
+  only in user settings.
+- This catalog already agrees with the source elsewhere: `astropixels-holo` (the AstroPixelsPlus
+  `@HP` port of the same holoprojector grammar) publishes `ap.hp.native.solid` `@HP{dev}005{color}`,
+  `ap.hp.native.rainbow` `@HP{dev}006` and `ap.hp.native.shortcircuit` `@HP{dev}007{color}`.
+
+**Effect on stored values.** Wire text never changes; decoding follows what the firmware does.
+`A0057` (4.x "Short Circuit, Orange") becomes `flthy.led.solid` orange. `A0065` and `A007`
+(4.x "Solid" / "Rainbow") no longer match a template and survive as raw steps; on v1.6+
+firmware they run rainbow and short circuit respectively. DroidNet's bundled 2.1.0 catalog
+already emits 005 / 006, so adopting 4.3.0 is not a user-facing regression.
+
+**Hardware check** (recommended, not blocking): send `A0055` (solid blue) and `A006` (rainbow)
+to a v1.81 board.
+
+**Freeze-test exception.** The A2 fixture keeps the 4.2.0 templates. A11 adds exactly these
+three ids to the freeze test's allowlist, each pinning its 4.2.0 and corrected template.
+
+## How DroidNet's unpublished 2.2.0 ids map to 4.3.0
+
+DroidNet's `feature/wcb-6.2.1` branch bundled a local "2.2.0" catalog that was never
+published (and whose version number collides with published 2.2.0, `3a1b16a`). Nothing in
+DroidNet stores command ids — Comlink buttons, Studio sessions, the Maestro serial editor and
+WCB rows store wire text only — so the map below changes how text is *displayed*, never what
+is stored.
+
+| id | DroidNet 2.2.0 (branch) | Published 4.2.0 | 4.3.0 |
+|---|---|---|---|
+| `maestro.goHome`, `maestro.stopScript`, `maestro.setTarget` | `;M{id},…` | `maestro-native` bare verbs | unchanged (native) |
+| `maestro.subParam` | `;M{id},{sub},{param}` | — | not used; the form is `maestro.wcb.subParam` |
+| `maestro.wcb.*` (12) | — | — | new |
+| `maestro.id` | codes 0-9 | codes 0-2 | codes 0-9 |
+| `wled.power`, `wled.brightness`, `wled.effect`, `wled.effectTuned`, `wled.palette` | DroidNet only | — | not added (D1) |
+| `wled.preset` | `{id}` enum, 1-250 | `{wledId}` int, 0-250 | published shape, min 1 |
+| `wled.color` | named-color enum | hex `pattern` | unchanged |
+| `dfp.play`, `dfp.stop`, `dfp.volume` | as in the `wcb-dfp` table | — | same template and params, plus 19 more `dfp.*` |
+| `mp.mode` / `magic-panel` | DroidNet | `iamp.mode` / `ia-magic-panel` since 4.0.0 | unchanged |
+| `flthy.led.solid`, `flthy.led.rainbow` | 005 / 006 | 006 / 007 | 005 / 006 (firmware) |
+
+| Wire text | DroidNet `main` (2.1.0) / branch (2.2.0) | 4.3.0 |
+|---|---|---|
+| `T52` | `mp.mode` | `iamp.mode` |
+| `;M2,goHome` | raw / command | `maestro.wcb.goHome` |
+| `;M91` | trigger | `maestro.trigger` (id 9) |
+| `;D,PLAY,5` | raw / `dfp.play` | `dfp.play` |
+| `;L1,ON` | raw / `wled.power` | `wled.on` |
+| `;A,PLAY,1` | raw | `mp3.play` |
+| `A0055`, `A006` | solid / rainbow | solid / rainbow |
+
+## Guard tests
+
+Committed before any board edit and green on 4.2.0:
+
+- `test/fixtures/catalog-4.2.0-commands.json` — `{ "<id>": { "board", "template", "params": [names] } }`
+  for all 397 commands, generated once from the real catalog at `82b6a04` (CI checks out with
+  depth 1, so the test cannot read history).
+- `test/wcb-621.test.js`:
+  - **(a)** every fixture id still resolves with the same `template` and ordered param names
+    (D2), except the allowlisted FlthyHPs fixes;
+  - **(b)** every example on `maestro`, `wcb-hcr`, `wcb-mp3`, `wcb-wled`, `wcb-native` and
+    (once present) `wcb-dfp` matches its own command;
+  - **(c)** every example on a `wcb-verb` board is at most **187** characters — the ETM
+    limit with checksums on (`WCB.ino:216-223`, `ETM_MAX_CMD_WITH_CRC`). The help text says 188
+    (`WCB_Help.cpp:295`); the code is authoritative.
+- Later commits append board-specific assertions (the order-sensitive pairs above, `;M1,5` →
+  `maestro.wcb.sub`, `;M91` → `maestro.trigger`, …).
+
+## Versioning and release
+
+- `libraries/manifest.json` `libraryVersion` 4.2.0 → **4.3.0**; `generatedFrom` appends
+  `; WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0 (2026-09)`; boards 21 → 22.
+- `releases.json` `latest.libraryVersion` and `libraries[0].libraryVersion` 4.3.0, new
+  `releasedAt`, one-string `notes` starting "Minor:". The notes say text fields need a host
+  engine 3.1.0 or later: older DroidNet builds show these notes in their update dialog and
+  render `pattern` params as number inputs.
+- `package.json` / `package-lock.json` 4.3.0 (D4). Test pins in `test/load-node.test.js` and
+  `test/engine.test.js` follow.
+- Expected validator warnings only: non-standard categories (`Variables`, `Volume`, …).
+
+## Consumers
+
+- **DroidNet** re-vendors the published 4.3.0 tree byte-for-byte (catalog, engine and UI
+  together) after merge, and moves its Studio and Maestro serial loaders to its effective
+  catalog API. Its own tests move to `maestro.wcb.*`, the published `wled.*` ids and
+  `ia-magic-panel`.
+- **NaviCore** vendors the library and splits a `wcb-sequences` board locally. The new sequence
+  ids (`wcb.runSeqLocal`, `wcb.runSeqLongLocal`, `wcb.seqNames`, `wcb.seqGet`,
+  `wcb.timerStop`) are not moved by its split automatically; mention them in the PR.
+
+## Verification status
+
+Verified against source only (WCB `66845b9a`, WcbCmd `168f1e5`, the Pololu Maestro guide, the
+WLED JSON API, FlthyHPs sketches). Not yet bench-tested: Maestro verbs and get queries, `;D`,
+`;L`, the `?WDP` family, DFPlayer clone quirks, the FlthyHPs check above. Boards stay
+`confidence: high` under the CONTRIBUTING definition ("verified against firmware/official
+docs").

From 20933da7a8bb66370ddf1b9007d0ddb35d52f05c Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:20:05 -0400
Subject: [PATCH 02/17] test: freeze 4.2.0 ids/templates; WCB examples parse to
 their own command

Guards for the WCB 6.2.1 sweep, landed before any board edit and green
on 4.2.0:

- test/fixtures/catalog-4.2.0-commands.json: every 4.2.0 command id
  (397) with its board, template and ordered param names, generated once
  from a pristine export of 82b6a04 via src/load-node.js readCatalog().
  Committed because CI checks out with depth 1.
- test/wcb-621.test.js
  (a) every frozen id still resolves with the same template and param
      names (D2); an explicit, empty TEMPLATE_FIXES allowlist pins
      from/to for sanctioned template corrections;
  (b) every example on maestro, wcb-hcr, wcb-mp3, wcb-wled, wcb-native
      (and wcb-dfp once added) matches its own command id, catching
      first-match-wins ordering regressions web.test.js cannot see;
  (c) wcb-verb examples stay within the 187-char ETM limit
      (WCB 6.2.1 WCB.ino:216-223 ETM_MAX_CMD_WITH_CRC).

Mutation-checked in a scratch copy: a changed template, a removed id, a
catch-all moved ahead of its literals, an over-long example and a wrong
allowlist entry each fail the matching assertion.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 test/fixtures/catalog-4.2.0-commands.json | 399 ++++++++++++++++++++++
 test/wcb-621.test.js                      | 101 ++++++
 2 files changed, 500 insertions(+)
 create mode 100644 test/fixtures/catalog-4.2.0-commands.json
 create mode 100644 test/wcb-621.test.js

diff --git a/test/fixtures/catalog-4.2.0-commands.json b/test/fixtures/catalog-4.2.0-commands.json
new file mode 100644
index 0000000..46ce722
--- /dev/null
+++ b/test/fixtures/catalog-4.2.0-commands.json
@@ -0,0 +1,399 @@
+{
+  "flthy.led.leia": { "board": "flthy-hps", "template": "{designator}001", "params": ["designator"] },
+  "flthy.led.colorproj": { "board": "flthy-hps", "template": "{designator}002{color}", "params": ["designator","color"] },
+  "flthy.led.dimpulse": { "board": "flthy-hps", "template": "{designator}003{color}{speed}", "params": ["designator","color","speed"] },
+  "flthy.led.cycle": { "board": "flthy-hps", "template": "{designator}004{color}", "params": ["designator","color"] },
+  "flthy.led.shortcircuit": { "board": "flthy-hps", "template": "{designator}005{color}", "params": ["designator","color"] },
+  "flthy.led.clearauto": { "board": "flthy-hps", "template": "{designator}0{mode}", "params": ["designator","mode"] },
+  "flthy.led.solid": { "board": "flthy-hps", "template": "{designator}006{color}", "params": ["designator","color"] },
+  "flthy.led.rainbow": { "board": "flthy-hps", "template": "{designator}007", "params": ["designator"] },
+  "flthy.servo.preset": { "board": "flthy-hps", "template": "{designator}101{position}", "params": ["designator","position"] },
+  "flthy.servo.rc-lr": { "board": "flthy-hps", "template": "{designator}102", "params": ["designator"] },
+  "flthy.servo.rc-ud": { "board": "flthy-hps", "template": "{designator}103", "params": ["designator"] },
+  "flthy.servo.random": { "board": "flthy-hps", "template": "{designator}104", "params": ["designator"] },
+  "flthy.servo.wag-lr": { "board": "flthy-hps", "template": "{designator}105", "params": ["designator"] },
+  "flthy.servo.wag-ud": { "board": "flthy-hps", "template": "{designator}106", "params": ["designator"] },
+  "flthy.servo.autotwitch": { "board": "flthy-hps", "template": "{designator}1{mode}", "params": ["designator","mode"] },
+  "flthy.special.sequence": { "board": "flthy-hps", "template": "{special}", "params": ["special"] },
+  "iamp.mode": { "board": "ia-magic-panel", "template": "T{mode}", "params": ["mode"] },
+  "pdmp.pattern": { "board": "pd-magic-panel", "template": "T{pattern}", "params": ["pattern"] },
+  "pdmp.pattern.timed": { "board": "pd-magic-panel", "template": "T{pattern}:{duration}", "params": ["pattern","duration"] },
+  "pdmp.demo": { "board": "pd-magic-panel", "template": "DEMO", "params": [] },
+  "pdmp.brightness": { "board": "pd-magic-panel", "template": "B{level}", "params": ["level"] },
+  "pdmp.speed": { "board": "pd-magic-panel", "template": "V{speed}", "params": ["speed"] },
+  "pdmp.color": { "board": "pd-magic-panel", "template": "C {color}", "params": ["color"] },
+  "pdmp.rgb": { "board": "pd-magic-panel", "template": "C {r},{g},{b}", "params": ["r","g","b"] },
+  "pdmp.transition": { "board": "pd-magic-panel", "template": "TRANSITION {state}", "params": ["state"] },
+  "pdmp.text": { "board": "pd-magic-panel", "template": "TEXT:{message}", "params": ["message"] },
+  "pdmp.text.bounce": { "board": "pd-magic-panel", "template": "TEXT_BOUNCE:{message}", "params": ["message"] },
+  "pdmp.text.save": { "board": "pd-magic-panel", "template": "TEXTSAVE{slot}:{message}", "params": ["slot","message"] },
+  "pdmp.text.load": { "board": "pd-magic-panel", "template": "TEXTLOAD{slot}", "params": ["slot"] },
+  "pdmp.font": { "board": "pd-magic-panel", "template": "FONT {font}", "params": ["font"] },
+  "pdmp.playlist": { "board": "pd-magic-panel", "template": "PLAYLIST_RUN:{ids}", "params": ["ids"] },
+  "pdmp.startup": { "board": "pd-magic-panel", "template": "START {pattern}", "params": ["pattern"] },
+  "pdmp.mode": { "board": "pd-magic-panel", "template": "P{mode}", "params": ["mode"] },
+  "pdmp.save": { "board": "pd-magic-panel", "template": "SAVE", "params": [] },
+  "pdmp.load": { "board": "pd-magic-panel", "template": "LOAD", "params": [] },
+  "pdmp.on": { "board": "pd-magic-panel", "template": "ON", "params": [] },
+  "pdmp.off": { "board": "pd-magic-panel", "template": "OFF", "params": [] },
+  "rseries.effect": { "board": "rseries-logic", "template": null, "params": ["effect","color","speed","seconds","target"] },
+  "rseries.text": { "board": "rseries-logic", "template": "@{address}M{text}", "params": ["address","text"] },
+  "rseries.font": { "board": "rseries-logic", "template": "@{address}P{font}", "params": ["address","font"] },
+  "rseries.cfg.wifi": { "board": "rseries-logic", "template": "#LEWIFI{state}", "params": ["state"] },
+  "rseries.cfg.remote": { "board": "rseries-logic", "template": "#LEREMOTE{state}", "params": ["state"] },
+  "rseries.sys.restart": { "board": "rseries-logic", "template": "#LERESTART", "params": [] },
+  "rseries.sys.zero": { "board": "rseries-logic", "template": "#LEZERO", "params": [] },
+  "hcr.stim": { "board": "wcb-hcr", "template": ";H,STIM,{emotion},{strength}", "params": ["emotion","strength"] },
+  "hcr.play": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file}", "params": ["channel","file"] },
+  "hcr.vol": { "board": "wcb-hcr", "template": ";H,VOL,{channel},{level}", "params": ["channel","level"] },
+  "hcr.volUp": { "board": "wcb-hcr", "template": ";H,VOLUP,{channel},{step}", "params": ["channel","step"] },
+  "hcr.volUpAll": { "board": "wcb-hcr", "template": ";H,VOLUP", "params": [] },
+  "hcr.volDown": { "board": "wcb-hcr", "template": ";H,VOLDN,{channel},{step}", "params": ["channel","step"] },
+  "hcr.volDownAll": { "board": "wcb-hcr", "template": ";H,VOLDN", "params": [] },
+  "hcr.fadeIn": { "board": "wcb-hcr", "template": ";H,FADEIN,{channel},{sec}", "params": ["channel","sec"] },
+  "hcr.fadeOut": { "board": "wcb-hcr", "template": ";H,FADEOUT,{channel},{sec}", "params": ["channel","sec"] },
+  "hcr.playFade": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file},FADEIN,{sec}", "params": ["channel","file","sec"] },
+  "hcr.overload": { "board": "wcb-hcr", "template": ";H,OVERLOAD", "params": [] },
+  "hcr.setEmotion": { "board": "wcb-hcr", "template": ";H,SETEMOTION,{emotion},{value}", "params": ["emotion","value"] },
+  "hcr.override": { "board": "wcb-hcr", "template": ";H,OVERRIDE,{state}", "params": ["state"] },
+  "hcr.muse": { "board": "wcb-hcr", "template": ";H,MUSE", "params": [] },
+  "hcr.museSet": { "board": "wcb-hcr", "template": ";H,MUSE,{mode}", "params": ["mode"] },
+  "hcr.museGap": { "board": "wcb-hcr", "template": ";H,MUSE,GAP,{min},{max}", "params": ["min","max"] },
+  "hcr.stopEmote": { "board": "wcb-hcr", "template": ";H,STOPEMOTE", "params": [] },
+  "hcr.resetEmotions": { "board": "wcb-hcr", "template": ";H,RESETEMOTIONS", "params": [] },
+  "hcr.stop": { "board": "wcb-hcr", "template": ";H,STOP", "params": [] },
+  "hcr.stopWav": { "board": "wcb-hcr", "template": ";H,STOPWAV,{channel}", "params": ["channel"] },
+  "hcr.fn": { "board": "wcb-hcr", "template": ";H,FN,{fn},{chan},{track}", "params": ["fn","chan","track"] },
+  "hcr.raw": { "board": "wcb-hcr", "template": ";H,RAW,{payload}", "params": ["payload"] },
+  "mp3.play": { "board": "wcb-mp3", "template": ";A,PLAY,{track}", "params": ["track"] },
+  "mp3.playCb": { "board": "wcb-mp3", "template": ";A,PLAY,{track},ONFIN,{key}", "params": ["track","key"] },
+  "mp3.playFs": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track}", "params": ["track"] },
+  "mp3.playFsCb": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track},ONFIN,{key}", "params": ["track","key"] },
+  "mp3.stop": { "board": "wcb-mp3", "template": ";A,STOP", "params": [] },
+  "mp3.next": { "board": "wcb-mp3", "template": ";A,NEXT", "params": [] },
+  "mp3.prev": { "board": "wcb-mp3", "template": ";A,PREV", "params": [] },
+  "mp3.vol": { "board": "wcb-mp3", "template": ";A,VOL,{level}", "params": ["level"] },
+  "mp3.volUp": { "board": "wcb-mp3", "template": ";A,VOLUP", "params": [] },
+  "mp3.volDown": { "board": "wcb-mp3", "template": ";A,VOLDN", "params": [] },
+  "mp3.count": { "board": "wcb-mp3", "template": ";A,COUNT", "params": [] },
+  "mp3.ver": { "board": "wcb-mp3", "template": ";A,VER", "params": [] },
+  "maestro.trigger": { "board": "maestro", "template": ";M{id}{seq}", "params": ["id","seq"] },
+  "maestro.setTarget": { "board": "maestro-native", "template": "setTarget,{channel},{position}", "params": ["channel","position"] },
+  "maestro.goHome": { "board": "maestro-native", "template": "goHome", "params": [] },
+  "maestro.setSpeed": { "board": "maestro-native", "template": "setSpeed,{channel},{value}", "params": ["channel","value"] },
+  "maestro.setAccel": { "board": "maestro-native", "template": "setAccel,{channel},{value}", "params": ["channel","value"] },
+  "maestro.setSpeedAccel": { "board": "maestro-native", "template": "setSpeedAccel,{channel},{speed},{accel}", "params": ["channel","speed","accel"] },
+  "maestro.setEasing": { "board": "maestro-native", "template": "setEasing,{profile}", "params": ["profile"] },
+  "maestro.restartScript": { "board": "maestro-native", "template": "restartScript,{sub}", "params": ["sub"] },
+  "maestro.stopScript": { "board": "maestro-native", "template": "stopScript", "params": [] },
+  "psi.mode": { "board": "psi-pro", "template": "{address}T{mode}", "params": ["address","mode"] },
+  "psi.swipe": { "board": "psi-pro", "template": "{address}A", "params": ["address"] },
+  "psi.default": { "board": "psi-pro", "template": "{address}D", "params": ["address"] },
+  "psi.cfg.alwaysOn": { "board": "psi-pro", "template": "0P{onoff}", "params": ["onoff"] },
+  "psi.cfg.brightSource": { "board": "psi-pro", "template": "1P{source}", "params": ["source"] },
+  "psi.cfg.brightSave": { "board": "psi-pro", "template": "2P{level}", "params": ["level"] },
+  "psi.cfg.brightTemp": { "board": "psi-pro", "template": "3P{level}", "params": ["level"] },
+  "hcr.native.stimulus": { "board": "hcr-native", "template": "<S{emotion}{intensity}>", "params": ["emotion","intensity"] },
+  "hcr.native.overload": { "board": "hcr-native", "template": "<SE>", "params": [] },
+  "hcr.native.muse": { "board": "hcr-native", "template": "<M{state}>", "params": ["state"] },
+  "hcr.native.museSingle": { "board": "hcr-native", "template": "<MM>", "params": [] },
+  "hcr.native.museMinGap": { "board": "hcr-native", "template": "<MN{seconds}>", "params": ["seconds"] },
+  "hcr.native.museMaxGap": { "board": "hcr-native", "template": "<MX{seconds}>", "params": ["seconds"] },
+  "hcr.native.playWav": { "board": "hcr-native", "template": "<C{channel}{file}>", "params": ["channel","file"] },
+  "hcr.native.playWavRandom": { "board": "hcr-native", "template": "<C{channel}{fileFrom}C{fileTo}>", "params": ["channel","fileFrom","fileTo"] },
+  "hcr.native.stop": { "board": "hcr-native", "template": "<PS{target}>", "params": ["target"] },
+  "hcr.native.volume": { "board": "hcr-native", "template": "<PV{target}{level}>", "params": ["target","level"] },
+  "hcr.native.canonMode": { "board": "hcr-native", "template": "<OA{mode}>", "params": ["mode"] },
+  "hcr.native.personalityOverride": { "board": "hcr-native", "template": "<O{state}>", "params": ["state"] },
+  "hcr.native.resetEmotions": { "board": "hcr-native", "template": "<OR>", "params": [] },
+  "hcr.native.setEmotion": { "board": "hcr-native", "template": "<O{emotion}{value}>", "params": ["emotion","value"] },
+  "hcr.native.memoryPlay": { "board": "hcr-native", "template": "<RRP{slot}>", "params": ["slot"] },
+  "hcr.native.memorySave": { "board": "hcr-native", "template": "<RRS{slot}>", "params": ["slot"] },
+  "hcr.native.memoryMode": { "board": "hcr-native", "template": "<R{mode}>", "params": ["mode"] },
+  "hcr.native.query": { "board": "hcr-native", "template": "<Q{query}>", "params": ["query"] },
+  "chirp.play": { "board": "chirp", "template": "PLAY:{index}", "params": ["index"] },
+  "chirp.stop": { "board": "chirp", "template": "STOP", "params": [] },
+  "chirp.stop.stream": { "board": "chirp", "template": "STOP:{stream}", "params": ["stream"] },
+  "chirp.vol": { "board": "chirp", "template": "VOL:{volume}", "params": ["volume"] },
+  "chirp.vol.stream": { "board": "chirp", "template": "VOL:{stream},{volume}", "params": ["stream","volume"] },
+  "chirp.stat": { "board": "chirp", "template": "STAT:{stream}", "params": ["stream"] },
+  "chirp.list": { "board": "chirp", "template": "LIST", "params": [] },
+  "chirp.gman": { "board": "chirp", "template": "GMAN", "params": [] },
+  "chirp.gnme": { "board": "chirp", "template": "GNME:{bank},{page},{index}", "params": ["bank","page","index"] },
+  "chirp.baud": { "board": "chirp", "template": "BAUD:{rate}", "params": ["rate"] },
+  "chirp.bpage": { "board": "chirp", "template": "BPAGE:{page}", "params": ["page"] },
+  "chirp.ccrc": { "board": "chirp", "template": "CCRC", "params": [] },
+  "chirp.musb": { "board": "chirp", "template": "MUSB:{on}", "params": ["on"] },
+  "chirp.pvoice": { "board": "chirp", "template": "PVOICE:{filename}", "params": ["filename"] },
+  "chirp.play.full": { "board": "chirp", "template": "PLAY:{index},{bank},{page},{volume}", "params": ["index","bank","page","volume"] },
+  "chirp.chirp": { "board": "chirp", "template": "CHRP:{startHz},{endHz},{durationMs}", "params": ["startHz","endHz","durationMs"] },
+  "uppity.playseq": { "board": "r2uppityspinner-alt", "template": ":PS{seq}", "params": ["seq"] },
+  "uppity.lifter.seek": { "board": "r2uppityspinner-alt", "template": ":PP{position}", "params": ["position"] },
+  "uppity.lifter.seek.speed": { "board": "r2uppityspinner-alt", "template": ":PP{position},{speed}", "params": ["position","speed"] },
+  "uppity.lifter.seek.random": { "board": "r2uppityspinner-alt", "template": ":PPR", "params": [] },
+  "uppity.lifter.home": { "board": "r2uppityspinner-alt", "template": ":PH", "params": [] },
+  "uppity.lifter.home.speed": { "board": "r2uppityspinner-alt", "template": ":PH{speed}", "params": ["speed"] },
+  "uppity.estop": { "board": "r2uppityspinner-alt", "template": ":PX", "params": [] },
+  "uppity.rotary.spin": { "board": "r2uppityspinner-alt", "template": ":PR{speed}", "params": ["speed"] },
+  "uppity.rotary.spin.random": { "board": "r2uppityspinner-alt", "template": ":PRR{max}", "params": ["max"] },
+  "uppity.rotary.abs": { "board": "r2uppityspinner-alt", "template": ":PA{degrees}", "params": ["degrees"] },
+  "uppity.rotary.abs.speed": { "board": "r2uppityspinner-alt", "template": ":PA{degrees},{speed},{maxspeed}", "params": ["degrees","speed","maxspeed"] },
+  "uppity.rotary.abs.random": { "board": "r2uppityspinner-alt", "template": ":PAR", "params": [] },
+  "uppity.rotary.rel": { "board": "r2uppityspinner-alt", "template": ":PD{degrees}", "params": ["degrees"] },
+  "uppity.rotary.rel.random": { "board": "r2uppityspinner-alt", "template": ":PDR", "params": [] },
+  "uppity.movemode.auto": { "board": "r2uppityspinner-alt", "template": ":PM", "params": [] },
+  "uppity.movemode.aggr": { "board": "r2uppityspinner-alt", "template": ":PM{level}", "params": ["level"] },
+  "uppity.movemode.params": { "board": "r2uppityspinner-alt", "template": ":PM,{liftSpeed},{rotSpeed},{minInterval},{maxInterval}", "params": ["liftSpeed","rotSpeed","minInterval","maxInterval"] },
+  "uppity.light": { "board": "r2uppityspinner-alt", "template": ":PL{mode}", "params": ["mode"] },
+  "uppity.light.random": { "board": "r2uppityspinner-alt", "template": ":PLR", "params": [] },
+  "uppity.wait": { "board": "r2uppityspinner-alt", "template": ":PW{seconds}", "params": ["seconds"] },
+  "uppity.wait.random": { "board": "r2uppityspinner-alt", "template": ":PWR{max}", "params": ["max"] },
+  "uppity.cfg.calibrate": { "board": "r2uppityspinner-alt", "template": "#PSC", "params": [] },
+  "uppity.cfg.setId": { "board": "r2uppityspinner-alt", "template": "#PID{id}", "params": ["id"] },
+  "uppity.cfg.zero": { "board": "r2uppityspinner-alt", "template": "#PZERO", "params": [] },
+  "uppity.cfg.factory": { "board": "r2uppityspinner-alt", "template": "#PFACTORY", "params": [] },
+  "uppity.cfg.restart": { "board": "r2uppityspinner-alt", "template": "#PRESTART", "params": [] },
+  "uppity.cfg.debug": { "board": "r2uppityspinner-alt", "template": "#PDEBUG{state}", "params": ["state"] },
+  "uppity.cfg.wifiReset": { "board": "r2uppityspinner-alt", "template": "#PWIFIRESET", "params": [] },
+  "uppity.cfg.wifi": { "board": "r2uppityspinner-alt", "template": "#PWIFI{state}", "params": ["state"] },
+  "uppity.cfg.aggression": { "board": "r2uppityspinner-alt", "template": "#PAGGRESSION{level}", "params": ["level"] },
+  "uppity.cfg.motor": { "board": "r2uppityspinner-alt", "template": "#PMOTOR{type}", "params": ["type"] },
+  "uppity.cfg.expert": { "board": "r2uppityspinner-alt", "template": "#PEXPERT{state}", "params": ["state"] },
+  "uppity.cfg.status": { "board": "r2uppityspinner-alt", "template": "#PSTATUS", "params": [] },
+  "uppity.cfg.config": { "board": "r2uppityspinner-alt", "template": "#PCONFIG", "params": [] },
+  "uppity.cfg.listSeq": { "board": "r2uppityspinner-alt", "template": "#PL", "params": [] },
+  "uppity.cfg.deleteSeq": { "board": "r2uppityspinner-alt", "template": "#PD{seq}", "params": ["seq"] },
+  "uppity.cfg.rc": { "board": "r2uppityspinner-alt", "template": "#PRC{state}", "params": ["state"] },
+  "uppity.cfg.rotaryToggle": { "board": "r2uppityspinner-alt", "template": "#PR", "params": [] },
+  "uppity.cfg.baud": { "board": "r2uppityspinner-alt", "template": "#PBAUD{rate}", "params": ["rate"] },
+  "uppity.cfg.lifterLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"] },
+  "uppity.cfg.rotaryLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"] },
+  "rad.rotate.abs": { "board": "roam-a-dome", "template": ":DPA{deg}", "params": ["deg"] },
+  "rad.rotate.absRamp": { "board": "roam-a-dome", "template": ":DPA{deg},{speed},{maxspeed}", "params": ["deg","speed","maxspeed"] },
+  "rad.rotate.absRandom": { "board": "roam-a-dome", "template": ":DPAR", "params": [] },
+  "rad.rotate.rel": { "board": "roam-a-dome", "template": ":DPD{deg}", "params": ["deg"] },
+  "rad.rotate.relRandom": { "board": "roam-a-dome", "template": ":DPDR", "params": [] },
+  "rad.spin": { "board": "roam-a-dome", "template": ":DPR{speed}", "params": ["speed"] },
+  "rad.home": { "board": "roam-a-dome", "template": ":DPH", "params": [] },
+  "rad.wait": { "board": "roam-a-dome", "template": ":DPW{seconds}", "params": ["seconds"] },
+  "rad.waitRandom": { "board": "roam-a-dome", "template": ":DPWR{min},{max}", "params": ["min","max"] },
+  "rad.playSeq": { "board": "roam-a-dome", "template": ":DPS{number}", "params": ["number"] },
+  "rad.togglePin": { "board": "roam-a-dome", "template": ":DPT{pin}", "params": ["pin"] },
+  "rad.cfg.zero": { "board": "roam-a-dome", "template": "#DPZERO", "params": [] },
+  "rad.cfg.factory": { "board": "roam-a-dome", "template": "#DPFACTORY", "params": [] },
+  "rad.cfg.restart": { "board": "roam-a-dome", "template": "#DPRESTART", "params": [] },
+  "rad.cfg.status": { "board": "roam-a-dome", "template": "#DPSTATUS", "params": [] },
+  "rad.cfg.config": { "board": "roam-a-dome", "template": "#DPCONFIG", "params": [] },
+  "rad.cfg.setupVelocity": { "board": "roam-a-dome", "template": "#DPSETUPVELOCITY{value}", "params": ["value"] },
+  "rad.cfg.setup": { "board": "roam-a-dome", "template": "#DPSETUP", "params": [] },
+  "rad.cfg.maxspeed": { "board": "roam-a-dome", "template": "#DPMAXSPEED{value}", "params": ["value"] },
+  "rad.cfg.homespeed": { "board": "roam-a-dome", "template": "#DPHOMESPEED{value}", "params": ["value"] },
+  "rad.cfg.autospeed": { "board": "roam-a-dome", "template": "#DPAUTOSPEED{value}", "params": ["value"] },
+  "rad.cfg.targetspeed": { "board": "roam-a-dome", "template": "#DPTARGETSPEED{value}", "params": ["value"] },
+  "rad.cfg.minspeed": { "board": "roam-a-dome", "template": "#DPMINSPEED{value}", "params": ["value"] },
+  "rad.cfg.inputspeed": { "board": "roam-a-dome", "template": "#DPINPUTSPEED{value}", "params": ["value"] },
+  "rad.cfg.autoleft": { "board": "roam-a-dome", "template": "#DPAUTOLEFT{value}", "params": ["value"] },
+  "rad.cfg.autoright": { "board": "roam-a-dome", "template": "#DPAUTORIGHT{value}", "params": ["value"] },
+  "rad.cfg.fudge": { "board": "roam-a-dome", "template": "#DPFUDGE{value}", "params": ["value"] },
+  "rad.cfg.homePosHere": { "board": "roam-a-dome", "template": "#DPHOMEPOS", "params": [] },
+  "rad.cfg.homePos": { "board": "roam-a-dome", "template": "#DPHOMEPOS{deg}", "params": ["deg"] },
+  "rad.cfg.automin": { "board": "roam-a-dome", "template": "#DPAUTOMIN{value}", "params": ["value"] },
+  "rad.cfg.automax": { "board": "roam-a-dome", "template": "#DPAUTOMAX{value}", "params": ["value"] },
+  "rad.cfg.homemin": { "board": "roam-a-dome", "template": "#DPHOMEMIN{value}", "params": ["value"] },
+  "rad.cfg.homemax": { "board": "roam-a-dome", "template": "#DPHOMEMAX{value}", "params": ["value"] },
+  "rad.cfg.targetmin": { "board": "roam-a-dome", "template": "#DPTARGETMIN{value}", "params": ["value"] },
+  "rad.cfg.targetmax": { "board": "roam-a-dome", "template": "#DPTARGETMAX{value}", "params": ["value"] },
+  "rad.cfg.timeout": { "board": "roam-a-dome", "template": "#DPTIMEOUT{value}", "params": ["value"] },
+  "rad.cfg.report": { "board": "roam-a-dome", "template": "#DPREPORT{value}", "params": ["value"] },
+  "rad.cfg.home": { "board": "roam-a-dome", "template": "#DPHOME{state}", "params": ["state"] },
+  "rad.cfg.auto": { "board": "roam-a-dome", "template": "#DPAUTO{state}", "params": ["state"] },
+  "rad.cfg.autosafety": { "board": "roam-a-dome", "template": "#DPAUTOSAFETY{state}", "params": ["state"] },
+  "rad.cfg.autorestart": { "board": "roam-a-dome", "template": "#DPAUTORESTART{state}", "params": ["state"] },
+  "rad.cfg.invert": { "board": "roam-a-dome", "template": "#DPINVERT{state}", "params": ["state"] },
+  "rad.cfg.scale": { "board": "roam-a-dome", "template": "#DPSCALE{state}", "params": ["state"] },
+  "rad.cfg.ascale": { "board": "roam-a-dome", "template": "#DPASCALE{value}", "params": ["value"] },
+  "rad.cfg.dscale": { "board": "roam-a-dome", "template": "#DPDSCALE{value}", "params": ["value"] },
+  "rad.cfg.serialin": { "board": "roam-a-dome", "template": "#DPSERIALIN{state}", "params": ["state"] },
+  "rad.cfg.serialout": { "board": "roam-a-dome", "template": "#DPSERIALOUT{state}", "params": ["state"] },
+  "rad.cfg.serialbaud": { "board": "roam-a-dome", "template": "#DPSERIALBAUD{baud}", "params": ["baud"] },
+  "rad.cfg.syrenbaud": { "board": "roam-a-dome", "template": "#DPSYRENBAUD{baud}", "params": ["baud"] },
+  "rad.cfg.syrenaddrin": { "board": "roam-a-dome", "template": "#DPSYRENADDRIN{value}", "params": ["value"] },
+  "rad.cfg.syrenaddrout": { "board": "roam-a-dome", "template": "#DPSYRENADDROUT{value}", "params": ["value"] },
+  "rad.cfg.syrenaddr": { "board": "roam-a-dome", "template": "#DPSYRENADDR{value}", "params": ["value"] },
+  "rad.cfg.sensorbaud": { "board": "roam-a-dome", "template": "#DPSENSORBAUD{baud}", "params": ["baud"] },
+  "rad.cfg.pwmin": { "board": "roam-a-dome", "template": "#DPPWMIN{state}", "params": ["state"] },
+  "rad.cfg.pwmout": { "board": "roam-a-dome", "template": "#DPPWMOUT{state}", "params": ["state"] },
+  "rad.cfg.pwmarc": { "board": "roam-a-dome", "template": "#DPPWMARC{state}", "params": ["state"] },
+  "rad.cfg.pwmmin": { "board": "roam-a-dome", "template": "#DPPWMMIN{value}", "params": ["value"] },
+  "rad.cfg.pwmmax": { "board": "roam-a-dome", "template": "#DPPWMMAX{value}", "params": ["value"] },
+  "rad.cfg.pwmneutral": { "board": "roam-a-dome", "template": "#DPPWMNEUTRAL{value}", "params": ["value"] },
+  "rad.cfg.pwmdeadband": { "board": "roam-a-dome", "template": "#DPPWMDEADBAND{value}", "params": ["value"] },
+  "rad.cfg.pin": { "board": "roam-a-dome", "template": "#DPPIN{pin}{value}", "params": ["pin","value"] },
+  "rad.cfg.wifi": { "board": "roam-a-dome", "template": "#DPWIFI{state}", "params": ["state"] },
+  "rad.cfg.remote": { "board": "roam-a-dome", "template": "#DPREMOTE{state}", "params": ["state"] },
+  "rad.cfg.rname": { "board": "roam-a-dome", "template": "#DPRNAME{name}", "params": ["name"] },
+  "rad.cfg.rsecret": { "board": "roam-a-dome", "template": "#DPRSECRET{secret}", "params": ["secret"] },
+  "rad.cfg.pair": { "board": "roam-a-dome", "template": "#DPPAIR", "params": [] },
+  "rad.cfg.unpair": { "board": "roam-a-dome", "template": "#DPUNPAIR", "params": [] },
+  "rad.cfg.listSeq": { "board": "roam-a-dome", "template": "#DPL", "params": [] },
+  "rad.cfg.deleteSeq": { "board": "roam-a-dome", "template": "#DPD{slot}", "params": ["slot"] },
+  "rad.cfg.storeSeq": { "board": "roam-a-dome", "template": "#DPS{slot}:{body}", "params": ["slot","body"] },
+  "rad.cfg.debug": { "board": "roam-a-dome", "template": "#DPDEBUG{state}", "params": ["state"] },
+  "rad.cfg.joy": { "board": "roam-a-dome", "template": "#DPJOY", "params": [] },
+  "ap.cfg.wifi": { "board": "astropixels-plus", "template": "#APWIFI{state}", "params": ["state"] },
+  "ap.cfg.remote": { "board": "astropixels-plus", "template": "#APREMOTE{state}", "params": ["state"] },
+  "ap.cfg.rname": { "board": "astropixels-plus", "template": "#APRNAME{name}", "params": ["name"] },
+  "ap.cfg.rsecret": { "board": "astropixels-plus", "template": "#APRSECRET{secret}", "params": ["secret"] },
+  "ap.cfg.pair": { "board": "astropixels-plus", "template": "#APPAIR", "params": [] },
+  "ap.cfg.unpair": { "board": "astropixels-plus", "template": "#APUNPAIR", "params": [] },
+  "ap.cfg.zero": { "board": "astropixels-plus", "template": "#APZERO", "params": [] },
+  "ap.cfg.restart": { "board": "astropixels-plus", "template": "#APRESTART", "params": [] },
+  "ap.panel.macro": { "board": "astropixels-plus", "template": ":{action}{group}", "params": ["action","group"] },
+  "ap.panel.dynamic": { "board": "astropixels-plus", "template": ":{code}${rest}", "params": ["code","rest"] },
+  "ap.seq.play": { "board": "astropixels-plus", "template": ":SE{seq}", "params": ["seq"] },
+  "ap.snd.play": { "board": "astropixels-sound", "template": "${bank}{nn}", "params": ["bank","nn"] },
+  "ap.snd.random": { "board": "astropixels-sound", "template": "$R", "params": [] },
+  "ap.snd.off": { "board": "astropixels-sound", "template": "$O", "params": [] },
+  "ap.snd.stop": { "board": "astropixels-sound", "template": "$s", "params": [] },
+  "ap.snd.leia": { "board": "astropixels-sound", "template": "$L", "params": [] },
+  "ap.snd.cantinaMusic": { "board": "astropixels-sound", "template": "$C", "params": [] },
+  "ap.snd.beepCantina": { "board": "astropixels-sound", "template": "$c", "params": [] },
+  "ap.snd.scream": { "board": "astropixels-sound", "template": "$S", "params": [] },
+  "ap.snd.faint": { "board": "astropixels-sound", "template": "$F", "params": [] },
+  "ap.snd.disco": { "board": "astropixels-sound", "template": "$D", "params": [] },
+  "ap.snd.starwars": { "board": "astropixels-sound", "template": "$W", "params": [] },
+  "ap.snd.march": { "board": "astropixels-sound", "template": "$M", "params": [] },
+  "ap.snd.volUp": { "board": "astropixels-sound", "template": "$+", "params": [] },
+  "ap.snd.volDown": { "board": "astropixels-sound", "template": "$-", "params": [] },
+  "ap.snd.volMid": { "board": "astropixels-sound", "template": "$m", "params": [] },
+  "ap.snd.volMax": { "board": "astropixels-sound", "template": "$f", "params": [] },
+  "ap.snd.volMin": { "board": "astropixels-sound", "template": "$p", "params": [] },
+  "ap.psi.effect": { "board": "astropixels-psi", "template": "@{addr}P{effect}", "params": ["addr","effect"] },
+  "ap.logic.effect": { "board": "astropixels-logics", "template": "@{addr}T{effect}", "params": ["addr","effect"] },
+  "ap.logic.text": { "board": "astropixels-logics", "template": "@{addr}M{text}", "params": ["addr","text"] },
+  "ap.logic.font": { "board": "astropixels-logics", "template": "@{addr}P{font}", "params": ["addr","font"] },
+  "ap.hp.on": { "board": "astropixels-holo", "template": "*ON{dev}", "params": ["dev"] },
+  "ap.hp.off": { "board": "astropixels-holo", "template": "*OF{dev}", "params": ["dev"] },
+  "ap.hp.resetAll": { "board": "astropixels-holo", "template": "*ST00", "params": [] },
+  "ap.hp.random": { "board": "astropixels-holo", "template": "*RD{dev}", "params": ["dev"] },
+  "ap.hp.dimPulse": { "board": "astropixels-holo", "template": "*HPS3{dev}", "params": ["dev"] },
+  "ap.hp.rainbow": { "board": "astropixels-holo", "template": "*HPS6{dev}", "params": ["dev"] },
+  "ap.hp.position": { "board": "astropixels-holo", "template": "*HP{pos}{dev}", "params": ["pos","dev"] },
+  "ap.hp.wag": { "board": "astropixels-holo", "template": "*HW{dev}", "params": ["dev"] },
+  "ap.hp.nod": { "board": "astropixels-holo", "template": "*HN{dev}", "params": ["dev"] },
+  "ap.hp.radar": { "board": "astropixels-holo", "template": "*HRS{mode}", "params": ["mode"] },
+  "ap.hp.legacyOn": { "board": "astropixels-holo", "template": "@{ldev}T1", "params": ["ldev"] },
+  "ap.hp.legacyOff": { "board": "astropixels-holo", "template": "@{ldev}D", "params": ["ldev"] },
+  "ap.hp.native.leia": { "board": "astropixels-holo", "template": "@HP{dev}001", "params": ["dev"] },
+  "ap.hp.native.colorproj": { "board": "astropixels-holo", "template": "@HP{dev}002{color}", "params": ["dev","color"] },
+  "ap.hp.native.dimpulse": { "board": "astropixels-holo", "template": "@HP{dev}003{color}{speed}", "params": ["dev","color","speed"] },
+  "ap.hp.native.cycle": { "board": "astropixels-holo", "template": "@HP{dev}004{color}", "params": ["dev","color"] },
+  "ap.hp.native.solid": { "board": "astropixels-holo", "template": "@HP{dev}005{color}", "params": ["dev","color"] },
+  "ap.hp.native.rainbow": { "board": "astropixels-holo", "template": "@HP{dev}006", "params": ["dev"] },
+  "ap.hp.native.shortcircuit": { "board": "astropixels-holo", "template": "@HP{dev}007{color}", "params": ["dev","color"] },
+  "ap.hp.native.clearauto": { "board": "astropixels-holo", "template": "@HP{dev}0{mode}", "params": ["dev","mode"] },
+  "ap.hp.native.preset": { "board": "astropixels-holo", "template": "@HP{dev}101{position}", "params": ["dev","position"] },
+  "ap.hp.native.rcLR": { "board": "astropixels-holo", "template": "@HP{dev}102", "params": ["dev"] },
+  "ap.hp.native.rcUD": { "board": "astropixels-holo", "template": "@HP{dev}103", "params": ["dev"] },
+  "ap.hp.native.randomPos": { "board": "astropixels-holo", "template": "@HP{dev}104", "params": ["dev"] },
+  "ap.hp.native.wag": { "board": "astropixels-holo", "template": "@HP{dev}105", "params": ["dev"] },
+  "ap.hp.native.nod": { "board": "astropixels-holo", "template": "@HP{dev}106", "params": ["dev"] },
+  "ap.hp.native.autotwitch": { "board": "astropixels-holo", "template": "@HP{dev}1{mode}", "params": ["dev","mode"] },
+  "ap.hp.native.sequence": { "board": "astropixels-holo", "template": "@HP{seq}", "params": ["seq"] },
+  "ap.servo.quickMove": { "board": "astropixels-servo", "template": ":SQ{index},{pulse}", "params": ["index","pulse"] },
+  "ap.servo.move": { "board": "astropixels-servo", "template": ":SM{index},{pulse}", "params": ["index","pulse"] },
+  "ap.servo.moveTimed": { "board": "astropixels-servo", "template": ":SM{index},{moveTime},{pulse}", "params": ["index","moveTime","pulse"] },
+  "ap.servo.moveDelayed": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{pulse}", "params": ["index","startDelay","moveTime","pulse"] },
+  "ap.servo.moveFrom": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{startPulse},{pulse}", "params": ["index","startDelay","moveTime","startPulse","pulse"] },
+  "ap.servo.limits3": { "board": "astropixels-servo", "template": ":SL{index},{start},{end}", "params": ["index","start","end"] },
+  "ap.servo.limits4": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral}", "params": ["index","start","end","neutral"] },
+  "ap.servo.limits5": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral},{group}", "params": ["index","start","end","neutral","group"] },
+  "ap.servo.easing": { "board": "astropixels-servo", "template": ":SF{easingId}${group}", "params": ["easingId","group"] },
+  "wcb.hw": { "board": "wcb-native", "template": "?HW,{ver}", "params": ["ver"] },
+  "wcb.num": { "board": "wcb-native", "template": "?WCB,{n}", "params": ["n"] },
+  "wcb.qty": { "board": "wcb-native", "template": "?WCBQ,{n}", "params": ["n"] },
+  "wcb.mac2": { "board": "wcb-native", "template": "?MAC,2,{hex}", "params": ["hex"] },
+  "wcb.mac3": { "board": "wcb-native", "template": "?MAC,3,{hex}", "params": ["hex"] },
+  "wcb.epass": { "board": "wcb-native", "template": "?EPASS,{password}", "params": ["password"] },
+  "wcb.baud": { "board": "wcb-native", "template": "?BAUD,S{port},{rate}", "params": ["port","rate"] },
+  "wcb.label": { "board": "wcb-native", "template": "?LABEL,S{port},{text}", "params": ["port","text"] },
+  "wcb.labelClear": { "board": "wcb-native", "template": "?LABEL,CLEAR,S{port}", "params": ["port"] },
+  "wcb.labelClearAll": { "board": "wcb-native", "template": "?LABEL,CLEAR,ALL", "params": [] },
+  "wcb.bcastIn": { "board": "wcb-native", "template": "?BCAST,IN,S{port},{state}", "params": ["port","state"] },
+  "wcb.bcastOut": { "board": "wcb-native", "template": "?BCAST,OUT,S{port},{state}", "params": ["port","state"] },
+  "wcb.bcastReset": { "board": "wcb-native", "template": "?BCAST,RESET", "params": [] },
+  "wcb.mapSerial": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},{dest}", "params": ["port","dest"] },
+  "wcb.mapSerialRaw": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},R,{dest}", "params": ["port","dest"] },
+  "wcb.mapSerialList": { "board": "wcb-native", "template": "?MAP,SERIAL,LIST", "params": [] },
+  "wcb.mapSerialClear": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,S{port}", "params": ["port"] },
+  "wcb.mapSerialClearAll": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,ALL", "params": [] },
+  "wcb.mapPwm": { "board": "wcb-native", "template": "?MAP,PWM,S{port},{dest}", "params": ["port","dest"] },
+  "wcb.mapPwmOut": { "board": "wcb-native", "template": "?MAP,PWM,OUT,S{port}", "params": ["port"] },
+  "wcb.mapPwmList": { "board": "wcb-native", "template": "?MAP,PWM,LIST", "params": [] },
+  "wcb.mapPwmClear": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,S{port}", "params": ["port"] },
+  "wcb.mapPwmClearAll": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,ALL", "params": [] },
+  "wcb.mapClearAll": { "board": "wcb-native", "template": "?MAP,CLEAR,ALL", "params": [] },
+  "wcb.kyberLocal": { "board": "wcb-native", "template": "?KYBER,LOCAL", "params": [] },
+  "wcb.kyberRemote": { "board": "wcb-native", "template": "?KYBER,REMOTE", "params": [] },
+  "wcb.kyberClear": { "board": "wcb-native", "template": "?KYBER,CLEAR", "params": [] },
+  "wcb.kyberList": { "board": "wcb-native", "template": "?KYBER,LIST", "params": [] },
+  "wcb.maestroList": { "board": "wcb-native", "template": "?MAESTRO,LIST", "params": [] },
+  "wcb.maestroClear": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,{id}", "params": ["id"] },
+  "wcb.maestroClearAll": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,ALL", "params": [] },
+  "wcb.maestro": { "board": "wcb-native", "template": "?MAESTRO,{spec}", "params": ["spec"] },
+  "wcb.mp3Cfg": { "board": "wcb-native", "template": "?MP3,{spec}", "params": ["spec"] },
+  "wcb.mp3List": { "board": "wcb-native", "template": "?MP3,LIST", "params": [] },
+  "wcb.mp3OnErrClear": { "board": "wcb-native", "template": "?MP3,ONERR,CLEAR", "params": [] },
+  "wcb.mp3OnErr": { "board": "wcb-native", "template": "?MP3,ONERR,{key}", "params": ["key"] },
+  "wcb.mp3Clear": { "board": "wcb-native", "template": "?MP3,CLEAR", "params": [] },
+  "wcb.hcrPort": { "board": "wcb-native", "template": "?HCR,PORT,S{port}:{baud}", "params": ["port","baud"] },
+  "wcb.hcrPoll": { "board": "wcb-native", "template": "?HCR,POLL,{sec}", "params": ["sec"] },
+  "wcb.hcrList": { "board": "wcb-native", "template": "?HCR,LIST", "params": [] },
+  "wcb.hcrStatus": { "board": "wcb-native", "template": "?HCR,STATUS", "params": [] },
+  "wcb.hcrRefresh": { "board": "wcb-native", "template": "?HCR,REFRESH", "params": [] },
+  "wcb.hcrClear": { "board": "wcb-native", "template": "?HCR,CLEAR", "params": [] },
+  "wcb.hcrGet": { "board": "wcb-native", "template": "?HCR,GET,{field}", "params": ["field"] },
+  "wcb.routeSerial": { "board": "wcb-native", "template": ";S{port},{message}", "params": ["port","message"] },
+  "wcb.routeWcb": { "board": "wcb-native", "template": ";W{wcb},{message}", "params": ["wcb","message"] },
+  "wcb.timer": { "board": "wcb-native", "template": ";T{ms},{command}", "params": ["ms","command"] },
+  "wcb.seqSave": { "board": "wcb-native", "template": "?SEQ,SAVE,{key},{value}", "params": ["key","value"] },
+  "wcb.seqList": { "board": "wcb-native", "template": "?SEQ,LIST", "params": [] },
+  "wcb.seqClearAll": { "board": "wcb-native", "template": "?SEQ,CLEAR,ALL", "params": [] },
+  "wcb.seqClear": { "board": "wcb-native", "template": "?SEQ,CLEAR,{key}", "params": ["key"] },
+  "wcb.runSeq": { "board": "wcb-native", "template": ";C{key}", "params": ["key"] },
+  "wcb.runSeqLong": { "board": "wcb-native", "template": ";SEQ{key}", "params": ["key"] },
+  "wcb.etmOn": { "board": "wcb-native", "template": "?ETM,ON", "params": [] },
+  "wcb.etmOff": { "board": "wcb-native", "template": "?ETM,OFF", "params": [] },
+  "wcb.etmTimeout": { "board": "wcb-native", "template": "?ETM,TIMEOUT,{ms}", "params": ["ms"] },
+  "wcb.etmHb": { "board": "wcb-native", "template": "?ETM,HB,{sec}", "params": ["sec"] },
+  "wcb.etmMiss": { "board": "wcb-native", "template": "?ETM,MISS,{count}", "params": ["count"] },
+  "wcb.etmBoot": { "board": "wcb-native", "template": "?ETM,BOOT,{sec}", "params": ["sec"] },
+  "wcb.etmCount": { "board": "wcb-native", "template": "?ETM,COUNT,{n}", "params": ["n"] },
+  "wcb.etmDelay": { "board": "wcb-native", "template": "?ETM,DELAY,{ms}", "params": ["ms"] },
+  "wcb.etmChar": { "board": "wcb-native", "template": "?ETM,CHAR", "params": [] },
+  "wcb.etmChksum": { "board": "wcb-native", "template": "?ETM,CHKSM,{state}", "params": ["state"] },
+  "wcb.debug": { "board": "wcb-native", "template": "?DEBUG,{state}", "params": ["state"] },
+  "wcb.debugEtm": { "board": "wcb-native", "template": "?DEBUG,ETM,{state}", "params": ["state"] },
+  "wcb.debugPwm": { "board": "wcb-native", "template": "?DEBUG,PWM,{state}", "params": ["state"] },
+  "wcb.debugMaestro": { "board": "wcb-native", "template": "?DEBUG,MAESTRO,{state}", "params": ["state"] },
+  "wcb.debugHcr": { "board": "wcb-native", "template": "?DEBUG,HCR,{state}", "params": ["state"] },
+  "wcb.stats": { "board": "wcb-native", "template": "?STATS", "params": [] },
+  "wcb.statsReset": { "board": "wcb-native", "template": "?STATS,RESET", "params": [] },
+  "wcb.delim": { "board": "wcb-native", "template": "?DELIM,{char}", "params": ["char"] },
+  "wcb.funcChar": { "board": "wcb-native", "template": "?FUNCCHAR,{char}", "params": ["char"] },
+  "wcb.cmdChar": { "board": "wcb-native", "template": "?CMDCHAR,{char}", "params": ["char"] },
+  "wcb.config": { "board": "wcb-native", "template": "?config", "params": [] },
+  "wcb.backup": { "board": "wcb-native", "template": "?backup", "params": [] },
+  "wcb.reboot": { "board": "wcb-native", "template": "?reboot", "params": [] },
+  "wcb.eraseNvs": { "board": "wcb-native", "template": "?ERASE,NVS", "params": [] },
+  "wled.on": { "board": "wcb-wled", "template": ";L{wledId},ON", "params": ["wledId"] },
+  "wled.off": { "board": "wcb-wled", "template": ";L{wledId},OFF", "params": ["wledId"] },
+  "wled.toggle": { "board": "wcb-wled", "template": ";L{wledId},TOGGLE", "params": ["wledId"] },
+  "wled.bri": { "board": "wcb-wled", "template": ";L{wledId},BRI,{level}", "params": ["wledId","level"] },
+  "wled.preset": { "board": "wcb-wled", "template": ";L{wledId},PS,{preset}", "params": ["wledId","preset"] },
+  "wled.color": { "board": "wcb-wled", "template": ";L{wledId},COL,{color}", "params": ["wledId","color"] },
+  "wled.fx": { "board": "wcb-wled", "template": ";L{wledId},FX,{index}", "params": ["wledId","index"] },
+  "wled.fxfull": { "board": "wcb-wled", "template": ";L{wledId},FX,{index},{speed},{intensity}", "params": ["wledId","index","speed","intensity"] },
+  "wled.pal": { "board": "wcb-wled", "template": ";L{wledId},PAL,{index}", "params": ["wledId","index"] },
+  "wled.json": { "board": "wcb-wled", "template": ";L{wledId},JSON,{payload}", "params": ["wledId","payload"] }
+}
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
new file mode 100644
index 0000000..b16d1c8
--- /dev/null
+++ b/test/wcb-621.test.js
@@ -0,0 +1,101 @@
+// WCB firmware 6.2.1 sweep guards (spec 2026-09-15-wcb-firmware-6.2.1-sweep-design).
+//
+// (a) 4.2.0 freeze. test/fixtures/catalog-4.2.0-commands.json records every command id
+//     published in 4.2.0 (commit 82b6a04) with its template and ordered param names. Stored
+//     wire strings and host apps depend on both, so a minor/patch release may add ids and
+//     tighten ranges/enums/patterns, but must not remove an id or change its template or
+//     param names. Update this fixture only on a major release.
+// (b) Every example on the WCB boards decodes to its OWN command. Matching is first-match-wins
+//     in manifest order, so a greedy template (e.g. ?ALIAS,{name}) can silently claim a more
+//     specific sibling (?ALIAS,CLEAR). test/web.test.js only checks that an example parses to
+//     SOME command. Scoped to the WCB boards: the whole catalog is not self-matching today
+//     (ap.logic.text / ap.logic.font examples decode as rseries.*).
+// (c) wcb-verb examples fit the ETM limit of a mesh-routed command: 187 characters with the
+//     checksum on (WCB 6.2.1 WCB.ino:216-223, ETM_MAX_CMD_WITH_CRC; the help text's "188" is
+//     off by one).
+//
+// Board-specific assertions for the sweep are appended below the guards.
+const { readCatalog } = require('../src/load-node.js');
+const FROZEN_420 = require('./fixtures/catalog-4.2.0-commands.json');
+
+function loadEngine() { jest.resetModules(); return require('../src/droidnet-command-library.js'); }
+
+// Sanctioned template corrections to 4.2.0 ids (patch-class firmware fixes). Each entry pins
+// both the frozen 4.2.0 template and the corrected one, plus the reason, so nothing else can
+// change under cover of an allowlisted id. Param names stay frozen regardless.
+//   'some.id': { from: '<4.2.0 template>', to: '<corrected template>', why: '<firmware ref>' },
+const TEMPLATE_FIXES = {};
+
+const WCB_BOARDS = ['maestro', 'wcb-hcr', 'wcb-mp3', 'wcb-wled', 'wcb-native', 'wcb-dfp'];
+const ETM_MAX_CMD_WITH_CRC = 187;
+
+describe('WCB 6.2.1 sweep guards', () => {
+  let cb;
+  beforeEach(() => {
+    cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+
+  test('the 4.2.0 fixture is complete (397 commands)', () => {
+    expect(Object.keys(FROZEN_420)).toHaveLength(397);
+  });
+
+  test('(a) every 4.2.0 id still resolves with the same template and ordered param names', () => {
+    const drift = [];
+    for (const [id, frozen] of Object.entries(FROZEN_420)) {
+      const cmd = cb.getCommand(id);
+      if (!cmd) { drift.push(`${id}: removed (was on ${frozen.board})`); continue; }
+      const template = typeof cmd.template === 'string' ? cmd.template : null;
+      const fix = TEMPLATE_FIXES[id];
+      if (fix) {
+        if (fix.from !== frozen.template) drift.push(`${id}: allowlist 'from' ${JSON.stringify(fix.from)} is not the 4.2.0 template ${JSON.stringify(frozen.template)}`);
+        if (template !== fix.to) drift.push(`${id}: template ${JSON.stringify(template)} is not the allowlisted fix ${JSON.stringify(fix.to)}`);
+      } else if (template !== frozen.template) {
+        drift.push(`${id}: template ${JSON.stringify(frozen.template)} -> ${JSON.stringify(template)}`);
+      }
+      const params = (cmd.params || []).map(p => p.name);
+      if (JSON.stringify(params) !== JSON.stringify(frozen.params)) {
+        drift.push(`${id}: params ${JSON.stringify(frozen.params)} -> ${JSON.stringify(params)}`);
+      }
+    }
+    expect(drift).toEqual([]);
+  });
+
+  test('(a) every template-fix allowlist entry names a frozen 4.2.0 id', () => {
+    for (const id of Object.keys(TEMPLATE_FIXES)) expect(FROZEN_420).toHaveProperty([id]);
+  });
+
+  test('(b) every example on the WCB boards decodes to its own command', () => {
+    const present = cb.getComponents().map(c => c.id).filter(id => WCB_BOARDS.includes(id));
+    // Guard against a board rename silently emptying the scope; wcb-dfp arrives in 4.3.0.
+    expect(present).toEqual(expect.arrayContaining(['maestro', 'wcb-hcr', 'wcb-mp3', 'wcb-wled', 'wcb-native']));
+    const wrong = [];
+    let checked = 0;
+    for (const boardId of present) {
+      for (const cmd of cb.getCommands(boardId)) {
+        for (const ex of (cmd.examples || [])) {
+          checked++;
+          const hit = cb.match(ex);
+          if (!hit || hit.commandId !== cmd.id) wrong.push(`${boardId} ${cmd.id}: ${ex} -> ${hit ? hit.commandId : 'no match'}`);
+        }
+      }
+    }
+    expect(checked).toBeGreaterThan(0);
+    expect(wrong).toEqual([]);
+  });
+
+  test(`(c) wcb-verb examples fit the ${ETM_MAX_CMD_WITH_CRC}-character ETM limit`, () => {
+    const verbBoards = cb.getComponents().filter(c => c.kind === 'wcb-verb');
+    expect(verbBoards.length).toBeGreaterThan(0);
+    const tooLong = [];
+    for (const comp of verbBoards) {
+      for (const cmd of cb.getCommands(comp.id)) {
+        for (const ex of (cmd.examples || [])) {
+          if (ex.length > ETM_MAX_CMD_WITH_CRC) tooLong.push(`${cmd.id}: ${ex.length} chars`);
+        }
+      }
+    }
+    expect(tooLong).toEqual([]);
+  });
+});

From fe36c31bf947fe941a537fa2adedc221b3ffc1e4 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:29:49 -0400
Subject: [PATCH 03/17] feat(maestro): WCB 6.2 comma verbs and get queries; ids
 0-9; subroutines 0-127

Firmware re-read: WCB 6.2.1 @ 66845b9a WCB.ino:6729-6786 (processMaestroCommand),
WCB_Maestro.cpp:245-527 (sendMaestroServoVerb, handleMaestroGet :396-397,
maestroVerbForwardText), WCB_Help.cpp:430-459; WcbCmd 0.8.0 WcbMaestro.h:10-51,
WcbMaestro.cpp:6-182; 6.1.5 WCB.ino:4871-4876 and WCB_Maestro.cpp:143-168;
Pololu Maestro guide 5.c (data bytes 0-127) and 5.e (target/speed/accel,
Get Moving State on Mini Maestros only).

- maestro.id codes 0-9: 0 All, 1-8, 9 "All local (this WCB)". Id 9 is not
  6.2-only; 6.1.5 already fans ;M9<seq> out to the local Maestros.
- New maestro.queryId (1-8): handleMaestroGet rejects 0 and 9.
- maestro.trigger seq max 9 -> 127 (firmware accepts 0-255, but the
  subroutine goes on the wire as one Pololu data byte). Template and param
  names unchanged (D2).
- 12 new maestro.wcb.* ids, all named "(WCB 6.2+)": sub, subParam, subVerb,
  subVerbParam, stopScript (Sequences); goHome, setTarget, setSpeed,
  setAccel (Movement); getPosition, getMovingState, getErrors (System,
  cosmetic, queryId). Channels 0-23; new params carry range labels and
  defaults, and id defaults to #1 rather than the All broadcast.
- Component: name "Maestro (WCB ;M verbs)" (manifest too), firmware
  "WCB 6.2.1_021242RSEP2026", categories Sequences/Movement/System,
  routing.notes covering the 6.1.x subroutine-0 hazard, id meanings,
  the 0-127 subroutine range, async get queries into m<id>pos<ch> /
  m<id>moving / m<id>err read by a later IF, no ;W around a get, and
  getMovingState being Mini Maestro only.

Refinement of the spec's "comma forms need 6.2.1 on the sender and the
Maestro host": per maestroVerbForwardText / sendMaestroCommand, a 6.2.1
board forwards a plain ;M<id>,<n> as the legacy ;M<id><n>, so only verbs
and subroutines with a parameter reach the host in comma form. The notes
say exactly that.

Tests (test/wcb-621.test.js): ;M11/;M91 -> maestro.trigger; ;M1,5 ->
maestro.wcb.sub; ;M3,5,1000 -> maestro.wcb.subParam; ;M2,goHome ->
maestro.wcb.goHome while bare goHome stays maestro.goHome (no shared id);
get queries on id 0/9 stay raw; all 12 ;M{id}, templates are named
"(WCB 6.2+)"; component/manifest metadata.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 libraries/boards/maestro.json | 434 +++++++++++++++++++++++++++++++++-
 libraries/manifest.json       |   2 +-
 test/wcb-621.test.js          |  85 +++++++
 3 files changed, 516 insertions(+), 5 deletions(-)

diff --git a/libraries/boards/maestro.json b/libraries/boards/maestro.json
index 5b9fac0..80268d5 100644
--- a/libraries/boards/maestro.json
+++ b/libraries/boards/maestro.json
@@ -15,6 +15,71 @@
         {
           "code": "2",
           "label": "#2"
+        },
+        {
+          "code": "3",
+          "label": "#3"
+        },
+        {
+          "code": "4",
+          "label": "#4"
+        },
+        {
+          "code": "5",
+          "label": "#5"
+        },
+        {
+          "code": "6",
+          "label": "#6"
+        },
+        {
+          "code": "7",
+          "label": "#7"
+        },
+        {
+          "code": "8",
+          "label": "#8"
+        },
+        {
+          "code": "9",
+          "label": "All local (this WCB)"
+        }
+      ]
+    },
+    "maestro.queryId": {
+      "label": "Maestro",
+      "values": [
+        {
+          "code": "1",
+          "label": "#1"
+        },
+        {
+          "code": "2",
+          "label": "#2"
+        },
+        {
+          "code": "3",
+          "label": "#3"
+        },
+        {
+          "code": "4",
+          "label": "#4"
+        },
+        {
+          "code": "5",
+          "label": "#5"
+        },
+        {
+          "code": "6",
+          "label": "#6"
+        },
+        {
+          "code": "7",
+          "label": "#7"
+        },
+        {
+          "code": "8",
+          "label": "#8"
         }
       ]
     }
@@ -22,11 +87,13 @@
   "components": [
     {
       "id": "maestro",
-      "name": "Maestro (sequence trigger)",
+      "name": "Maestro (WCB ;M verbs)",
       "kind": "wcb-verb",
       "confidence": "high",
+      "firmware": "WCB 6.2.1_021242RSEP2026",
       "routing": {
-        "class": "wcb-verb"
+        "class": "wcb-verb",
+        "notes": "Run Sequence (;M<id><seq>) works on every WCB firmware. The comma forms, named \"(WCB 6.2+)\", need WCB 6.2.1 on the board that parses them: WCB 6.1.x reads any comma form as ;M<id>0 and runs subroutine 0 instead (6.1.5 WCB.ino:4871-4876). A 6.2.1 board passes a plain ;M<id>,<n> on to another board as ;M<id><n>, but verbs and subroutines with a parameter travel as typed, so the WCB hosting the Maestro needs 6.2.1 as well (WCB_Maestro.cpp maestroVerbForwardText). Id 0 = every Maestro on the mesh; 1-8 = the Maestro configured with that id (?MAESTRO,M<id>:W<wcb>S<port>:<baud>); 9 = every Maestro configured on the receiving WCB, or its S1 Maestro addressed as the WCB's own number when none is configured (also on 6.1.5, unless that board has a Maestro configured as id 9). Subroutines are Pololu data bytes 0-127: the firmware help says 0-255, but a Pololu data byte cannot exceed 127. Channels are 0-based, 0-23 (Mini Maestro 24). Target is in quarter-microseconds (6000 = 1.5 ms; 0 stops the pulses); speed 0 and acceleration 0 mean unlimited. get* queries take ids 1-8 only and are asynchronous: the answer lands in the RAM variables m<id>pos<ch>, m<id>moving (0/1) and m<id>err (not saved to NVS), which an IF in a separate, later trigger reads (e.g. IF,m2moving=0). Never wrap a get in ;W: the answer would stay on the target board (WCB_Help.cpp:451-459). getMovingState works on Mini Maestro only (Pololu Maestro guide 5.e)."
       },
       "commands": [
         {
@@ -45,7 +112,7 @@
               "name": "seq",
               "type": "int",
               "min": 0,
-              "max": 9,
+              "max": 127,
               "required": true
             }
           ],
@@ -54,10 +121,369 @@
           ],
           "commentLabel": "Maestro seq",
           "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.sub",
+          "name": "Run Subroutine (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},{sub}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "sub",
+              "label": "Subroutine (0-127)",
+              "type": "int",
+              "min": 0,
+              "max": 127,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M1,5"
+          ],
+          "commentLabel": "Maestro sub",
+          "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.subParam",
+          "name": "Run Subroutine with Parameter (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},{sub},{param}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "sub",
+              "label": "Subroutine (0-127)",
+              "type": "int",
+              "min": 0,
+              "max": 127,
+              "default": 0,
+              "required": true
+            },
+            {
+              "name": "param",
+              "label": "Parameter (0-16383)",
+              "type": "int",
+              "min": 0,
+              "max": 16383,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M3,5,1000"
+          ],
+          "commentLabel": "Maestro sub+param",
+          "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.subVerb",
+          "name": "Run Subroutine, sub verb (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},sub,{sub}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "sub",
+              "label": "Subroutine (0-127)",
+              "type": "int",
+              "min": 0,
+              "max": 127,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,sub,5"
+          ],
+          "commentLabel": "Maestro sub",
+          "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.subVerbParam",
+          "name": "Run Subroutine with Parameter, sub verb (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},sub,{sub},{param}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "sub",
+              "label": "Subroutine (0-127)",
+              "type": "int",
+              "min": 0,
+              "max": 127,
+              "default": 0,
+              "required": true
+            },
+            {
+              "name": "param",
+              "label": "Parameter (0-16383)",
+              "type": "int",
+              "min": 0,
+              "max": 16383,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,sub,5,1000"
+          ],
+          "commentLabel": "Maestro sub+param",
+          "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.stopScript",
+          "name": "Stop Script (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},stopScript",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M1,stopScript"
+          ],
+          "commentLabel": "Maestro stop script",
+          "category": "Sequences"
+        },
+        {
+          "id": "maestro.wcb.goHome",
+          "name": "Go Home (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},goHome",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,goHome"
+          ],
+          "commentLabel": "Maestro home",
+          "category": "Movement"
+        },
+        {
+          "id": "maestro.wcb.setTarget",
+          "name": "Set Servo Target (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},setTarget,{channel},{target}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "channel",
+              "label": "Channel (0-23)",
+              "type": "int",
+              "min": 0,
+              "max": 23,
+              "default": 0,
+              "required": true
+            },
+            {
+              "name": "target",
+              "label": "Target (¼µs; 6000 = 1.5 ms)",
+              "type": "int",
+              "min": 0,
+              "max": 16383,
+              "default": 6000,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M1,setTarget,0,6000"
+          ],
+          "commentLabel": "Maestro target",
+          "category": "Movement"
+        },
+        {
+          "id": "maestro.wcb.setSpeed",
+          "name": "Set Speed Limit (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},setSpeed,{channel},{speed}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "channel",
+              "label": "Channel (0-23)",
+              "type": "int",
+              "min": 0,
+              "max": 23,
+              "default": 0,
+              "required": true
+            },
+            {
+              "name": "speed",
+              "label": "Speed (0-16383, 0 = unlimited)",
+              "type": "int",
+              "min": 0,
+              "max": 16383,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M5,setSpeed,3,10"
+          ],
+          "commentLabel": "Maestro speed",
+          "category": "Movement"
+        },
+        {
+          "id": "maestro.wcb.setAccel",
+          "name": "Set Acceleration Limit (WCB 6.2+)",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";M{id},setAccel,{channel},{accel}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.id",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "channel",
+              "label": "Channel (0-23)",
+              "type": "int",
+              "min": 0,
+              "max": 23,
+              "default": 0,
+              "required": true
+            },
+            {
+              "name": "accel",
+              "label": "Accel (0-255, 0 = unlimited)",
+              "type": "int",
+              "min": 0,
+              "max": 255,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,setAccel,0,5"
+          ],
+          "commentLabel": "Maestro accel",
+          "category": "Movement"
+        },
+        {
+          "id": "maestro.wcb.getPosition",
+          "name": "Read Servo Position (WCB 6.2+)",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";M{id},getPosition,{channel}",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.queryId",
+              "default": "1",
+              "required": true
+            },
+            {
+              "name": "channel",
+              "label": "Channel (0-23)",
+              "type": "int",
+              "min": 0,
+              "max": 23,
+              "default": 0,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,getPosition,0"
+          ],
+          "commentLabel": "Maestro get pos",
+          "category": "System"
+        },
+        {
+          "id": "maestro.wcb.getMovingState",
+          "name": "Read Moving State (WCB 6.2+)",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";M{id},getMovingState",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.queryId",
+              "default": "1",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,getMovingState"
+          ],
+          "commentLabel": "Maestro get moving",
+          "category": "System"
+        },
+        {
+          "id": "maestro.wcb.getErrors",
+          "name": "Read Errors (WCB 6.2+)",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";M{id},getErrors",
+          "params": [
+            {
+              "name": "id",
+              "enum": "maestro.queryId",
+              "default": "1",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";M2,getErrors"
+          ],
+          "commentLabel": "Maestro get errors",
+          "category": "System"
         }
       ],
       "categories": [
-        "Sequences"
+        "Sequences",
+        "Movement",
+        "System"
       ]
     }
   ]
diff --git a/libraries/manifest.json b/libraries/manifest.json
index d28d669..fa0f860 100644
--- a/libraries/manifest.json
+++ b/libraries/manifest.json
@@ -43,7 +43,7 @@
     {
       "id": "maestro",
       "file": "boards/maestro.json",
-      "name": "Maestro (sequence trigger)",
+      "name": "Maestro (WCB ;M verbs)",
       "confidence": "high"
     },
     {
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index b16d1c8..45e403c 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -99,3 +99,88 @@ describe('WCB 6.2.1 sweep guards', () => {
     expect(tooLong).toEqual([]);
   });
 });
+
+// ---------------------------------------------------------------------------------------------
+// maestro (A3): WCB 6.2 ;M comma verbs and get queries. Grammar: WCB 6.2.1 WCB.ino
+// processMaestroCommand, WCB_Maestro.cpp sendMaestroServoVerb / handleMaestroGet, WcbCmd
+// WcbMaestro::build. maestro-native is the bare NaviCore action grammar and shares no id.
+describe('maestro: WCB 6.2 comma verbs and get queries', () => {
+  let cb;
+  let manifest;
+  beforeEach(() => {
+    cb = loadEngine();
+    const cat = readCatalog();
+    manifest = cat.manifest;
+    cb.loadLibrary(cat.boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+
+  const codes = (enumId) => cb.getEnum(enumId).values.map(v => v.code);
+
+  test('maestro.id is 0-9 (0 = all, 9 = this WCB); get queries take 1-8 only', () => {
+    expect(codes('maestro.id')).toEqual(['0', '1', '2', '3', '4', '5', '6', '7', '8', '9']);
+    expect(codes('maestro.queryId')).toEqual(['1', '2', '3', '4', '5', '6', '7', '8']);
+    for (const id of ['maestro.wcb.getPosition', 'maestro.wcb.getMovingState', 'maestro.wcb.getErrors']) {
+      expect(cb.getCommand(id).params.find(p => p.name === 'id').enum).toBe('maestro.queryId');
+    }
+  });
+
+  test('Run Sequence keeps ;M{id}{seq}, accepts id 9 and subroutines up to 127', () => {
+    expect(cb.match(';M11')).toMatchObject({ commandId: 'maestro.trigger', params: { id: '1', seq: '1' } });
+    expect(cb.match(';M91')).toMatchObject({ commandId: 'maestro.trigger', params: { id: '9', seq: '1' } });
+    expect(cb.match(';M0127')).toMatchObject({ commandId: 'maestro.trigger', params: { id: '0', seq: '127' } });
+    expect(cb.getCommand('maestro.trigger').params.find(p => p.name === 'seq').max).toBe(127);
+  });
+
+  test('comma subroutine forms decode to their own ids', () => {
+    expect(cb.match(';M1,5')).toMatchObject({ commandId: 'maestro.wcb.sub', params: { id: '1', sub: '5' } });
+    expect(cb.match(';M3,5,1000')).toMatchObject({ commandId: 'maestro.wcb.subParam', params: { id: '3', sub: '5', param: '1000' } });
+    expect(cb.match(';M2,sub,5')).toMatchObject({ commandId: 'maestro.wcb.subVerb', params: { id: '2', sub: '5' } });
+    expect(cb.match(';M2,sub,5,1000')).toMatchObject({ commandId: 'maestro.wcb.subVerbParam', params: { id: '2', sub: '5', param: '1000' } });
+  });
+
+  test(';M2,goHome is the WCB verb; bare goHome stays on maestro-native (no shared id)', () => {
+    const wcb = cb.match(';M2,goHome');
+    const native = cb.match('goHome');
+    expect(wcb).toMatchObject({ commandId: 'maestro.wcb.goHome', params: { id: '2' } });
+    expect(native).toMatchObject({ commandId: 'maestro.goHome' });
+    expect(cb.getCommand(wcb.commandId)._component.id).toBe('maestro');
+    expect(cb.getCommand(native.commandId)._component.id).toBe('maestro-native');
+    const wcbIds = new Set(cb.getCommands('maestro').map(c => c.id));
+    expect(cb.getCommands('maestro-native').filter(c => wcbIds.has(c.id))).toEqual([]);
+  });
+
+  test('servo verbs encode with their defaults', () => {
+    expect(cb.encode(cb.getCommand('maestro.wcb.setTarget'), { id: '1', channel: '0' })).toBe(';M1,setTarget,0,6000');
+    expect(cb.match(';M5,setSpeed,3,10')).toMatchObject({ commandId: 'maestro.wcb.setSpeed', params: { id: '5', channel: '3', speed: '10' } });
+    expect(cb.match(';M2,setAccel,0,5')).toMatchObject({ commandId: 'maestro.wcb.setAccel', params: { id: '2', channel: '0', accel: '5' } });
+  });
+
+  test('get queries reject the fan-out ids 0 and 9 (they stay raw)', () => {
+    expect(cb.match(';M8,getErrors')).toMatchObject({ commandId: 'maestro.wcb.getErrors', params: { id: '8' } });
+    expect(cb.match(';M2,getPosition,0')).toMatchObject({ commandId: 'maestro.wcb.getPosition', params: { id: '2', channel: '0' } });
+    expect(cb.match(';M0,getMovingState')).toBeNull();
+    expect(cb.match(';M9,getPosition,0')).toBeNull();
+  });
+
+  test('all 12 ;M{id}, commands are named "(WCB 6.2+)"; Run Sequence is not', () => {
+    const comma = cb.getCommands('maestro').filter(c => c.template.startsWith(';M{id},'));
+    expect(comma.map(c => c.id).sort()).toEqual([
+      'maestro.wcb.getErrors', 'maestro.wcb.getMovingState', 'maestro.wcb.getPosition', 'maestro.wcb.goHome',
+      'maestro.wcb.setAccel', 'maestro.wcb.setSpeed', 'maestro.wcb.setTarget', 'maestro.wcb.stopScript',
+      'maestro.wcb.sub', 'maestro.wcb.subParam', 'maestro.wcb.subVerb', 'maestro.wcb.subVerbParam',
+    ]);
+    for (const c of comma) expect(c.name).toMatch(/ \(WCB 6\.2\+\)$/);
+    expect(cb.getCommand('maestro.trigger').name).not.toMatch(/6\.2/);
+  });
+
+  test('component metadata: name matches the manifest, 6.2.1 firmware, notes cover the 6.1 hazard', () => {
+    const comp = cb.getComponents().find(c => c.id === 'maestro');
+    expect(comp.name).toBe('Maestro (WCB ;M verbs)');
+    expect(manifest.boards.find(b => b.id === 'maestro').name).toBe(comp.name);
+    expect(comp.firmware).toBe('WCB 6.2.1_021242RSEP2026');
+    expect(comp.categories).toEqual(['Sequences', 'Movement', 'System']);
+    expect(comp.routing.class).toBe('wcb-verb');
+    expect(comp.routing.notes).toMatch(/subroutine 0/);
+    expect(comp.routing.notes).toMatch(/1-8/);
+  });
+});

From d92d978580635b4d3213fa771d3f454ea3f82acc Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:29:17 -0400
Subject: [PATCH 04/17] feat(wcb-dfp): DFPlayer Mini board (;D, verbs, WCB
 6.2+)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

New wcb-verb board libraries/boards/wcb-dfp.json, "WCB · DFPlayer Mini
(WCB 6.2+)", firmware WCB 6.2.1_021242RSEP2026, categories Sound, Volume,
System. Listed in the manifest right after wcb-mp3 (the ;D, prefix is
unique, so position does not affect matching).

21 commands, re-checked against WcbCmd 0.8.0 DfPlayerCodec::handle
(WcbDfPlayer.cpp:51-168), WCB_DFP.cpp:69-91 and WCB_Help.cpp:566-593:
- PLAY track 1-2999, FOLDER folder 1-99 / track 1-255, MP3FOLDER 1-9999,
  each with an ONFIN,<key> callback variant
- STOP, PAUSE, RESUME, NEXT, PREV, RANDOM
- LOOP 1-2999, LOOPALL 0/1, LOOPFOLDER 1-99, EQ 0-5 (Normal..Bass)
- VOL 0-30 (default 20), VOLUP, VOLDN
- RESET (safety config), STATUS
dfp.play, dfp.stop and dfp.volume keep DroidNet 2.2.0's templates and
param names.

;D,DEVICE,<n> is documented but not modeled: WCB 6.2.1 rejects it.
processDFPCommand strips the leading "D," (WCB_DFP.cpp:72-74) and
DfPlayerCodec::handle strips an optional leading 'D' again
(WcbDfPlayer.cpp:54), so the codec sees "EVICE,<n>". Confirmed by
compiling WcbDfPlayer.cpp with a copy of that dispatch. routing.notes and
a test record this; adding dfp.device later is a minor.

test/load-node.test.js: catalog board count 21 -> 22.
test/wcb-621.test.js: wcb-dfp assertions (manifest position and names,
verb list, DroidNet-compatible ids, firmware ranges, ONFIN decoding,
LOOP*/VOL* disambiguation, safety, DEVICE left raw).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 libraries/boards/wcb-dfp.json | 108 ++++++++++++++++++++++++++++++++++
 libraries/manifest.json       |   6 ++
 test/load-node.test.js        |   2 +-
 test/wcb-621.test.js          |  89 ++++++++++++++++++++++++++++
 4 files changed, 204 insertions(+), 1 deletion(-)
 create mode 100644 libraries/boards/wcb-dfp.json

diff --git a/libraries/boards/wcb-dfp.json b/libraries/boards/wcb-dfp.json
new file mode 100644
index 0000000..315c4cd
--- /dev/null
+++ b/libraries/boards/wcb-dfp.json
@@ -0,0 +1,108 @@
+{
+  "$schema": "droidnet-command-library/library/v1",
+  "enums": {
+    "dfp.eq": {
+      "label": "Equalizer",
+      "values": [
+        { "code": "0", "label": "Normal" },
+        { "code": "1", "label": "Pop" },
+        { "code": "2", "label": "Rock" },
+        { "code": "3", "label": "Jazz" },
+        { "code": "4", "label": "Classic" },
+        { "code": "5", "label": "Bass" }
+      ]
+    },
+    "dfp.loopAll": {
+      "label": "Loop all",
+      "values": [
+        { "code": "0", "label": "Off" },
+        { "code": "1", "label": "On" }
+      ]
+    }
+  },
+  "components": [
+    {
+      "id": "wcb-dfp",
+      "name": "WCB · DFPlayer Mini (WCB 6.2+)",
+      "kind": "wcb-verb",
+      "confidence": "high",
+      "firmware": "WCB 6.2.1_021242RSEP2026",
+      "routing": {
+        "class": "wcb-verb",
+        "notes": "Needs WCB 6.2.1 with a DFPlayer Mini configured (?DFP,S<port>; the baud is fixed at 9600). WCB 6.1.x has no ;D. ;D runs on the board that hosts the DFPlayer: this board if it has one, else the stored ?DFP,REMOTE,W<n> host, else an online board that advertises a DFPlayer over WDP (WCB.ino:6426-6428). Volume is 0 (silent) to 30 (loudest), the reverse of the MP3 Trigger's ;A scale; VOLUP/VOLDN step by 2. ONFIN,<key> runs stored command ;C<key> when the track finishes; STOP and RESET cancel it. The module needs about 1.5-3 s after power-on before it accepts commands, and clone modules may ignore RANDOM, EQ and LOOPFOLDER (WCB_Help.cpp:589-593). Verbs and ranges: WcbCmd 0.8.0 DfPlayerCodec::handle (WcbDfPlayer.cpp:51-168). Not modeled: the bare ,<key> callback, and ;D,DEVICE,<n> (1 USB, 2 SD, 3 AUX, 4 Sleep, 5 Flash), which 6.2.1 rejects as unknown: processDFPCommand strips the leading D (WCB_DFP.cpp:72-74) and DfPlayerCodec::handle strips a second one (WcbDfPlayer.cpp:54), leaving EVICE,<n>."
+      },
+      "commands": [
+        { "id": "dfp.play", "name": "Play Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,PLAY,{track}",
+          "params": [ { "name": "track", "type": "int", "min": 1, "max": 2999, "required": true } ],
+          "examples": [";D,PLAY,5"], "commentLabel": "DFPlayer play", "category": "Sound" },
+        { "id": "dfp.playCb", "name": "Play Track + Callback", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,PLAY,{track},ONFIN,{key}",
+          "params": [ { "name": "track", "type": "int", "min": 1, "max": 2999, "required": true },
+                      { "name": "key", "pattern": "[A-Za-z0-9_]+", "required": true } ],
+          "examples": [";D,PLAY,5,ONFIN,done"], "commentLabel": "DFPlayer play+cb", "category": "Sound" },
+        { "id": "dfp.folder", "name": "Play Folder Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,FOLDER,{folder},{track}",
+          "params": [ { "name": "folder", "type": "int", "min": 1, "max": 99, "required": true },
+                      { "name": "track", "type": "int", "min": 1, "max": 255, "required": true } ],
+          "examples": [";D,FOLDER,1,5"], "commentLabel": "DFPlayer folder", "category": "Sound" },
+        { "id": "dfp.folderCb", "name": "Play Folder Track + Callback", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,FOLDER,{folder},{track},ONFIN,{key}",
+          "params": [ { "name": "folder", "type": "int", "min": 1, "max": 99, "required": true },
+                      { "name": "track", "type": "int", "min": 1, "max": 255, "required": true },
+                      { "name": "key", "pattern": "[A-Za-z0-9_]+", "required": true } ],
+          "examples": [";D,FOLDER,1,5,ONFIN,done"], "commentLabel": "DFPlayer folder+cb", "category": "Sound" },
+        { "id": "dfp.mp3Folder", "name": "Play /MP3 Folder Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,MP3FOLDER,{track}",
+          "params": [ { "name": "track", "type": "int", "min": 1, "max": 9999, "required": true } ],
+          "examples": [";D,MP3FOLDER,3"], "commentLabel": "DFPlayer MP3 folder", "category": "Sound" },
+        { "id": "dfp.mp3FolderCb", "name": "Play /MP3 Folder Track + Callback", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,MP3FOLDER,{track},ONFIN,{key}",
+          "params": [ { "name": "track", "type": "int", "min": 1, "max": 9999, "required": true },
+                      { "name": "key", "pattern": "[A-Za-z0-9_]+", "required": true } ],
+          "examples": [";D,MP3FOLDER,3,ONFIN,done"], "commentLabel": "DFPlayer MP3 folder+cb", "category": "Sound" },
+        { "id": "dfp.stop", "name": "Stop", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,STOP", "params": [], "examples": [";D,STOP"], "commentLabel": "DFPlayer stop", "category": "Sound" },
+        { "id": "dfp.pause", "name": "Pause", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,PAUSE", "params": [], "examples": [";D,PAUSE"], "commentLabel": "DFPlayer pause", "category": "Sound" },
+        { "id": "dfp.resume", "name": "Resume", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,RESUME", "params": [], "examples": [";D,RESUME"], "commentLabel": "DFPlayer resume", "category": "Sound" },
+        { "id": "dfp.next", "name": "Next Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,NEXT", "params": [], "examples": [";D,NEXT"], "commentLabel": "DFPlayer next", "category": "Sound" },
+        { "id": "dfp.prev", "name": "Previous Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,PREV", "params": [], "examples": [";D,PREV"], "commentLabel": "DFPlayer prev", "category": "Sound" },
+        { "id": "dfp.random", "name": "Random Play", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,RANDOM", "params": [], "examples": [";D,RANDOM"], "commentLabel": "DFPlayer random", "category": "Sound" },
+        { "id": "dfp.loop", "name": "Loop Track", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,LOOP,{track}",
+          "params": [ { "name": "track", "type": "int", "min": 1, "max": 2999, "required": true } ],
+          "examples": [";D,LOOP,5"], "commentLabel": "DFPlayer loop", "category": "Sound" },
+        { "id": "dfp.loopAll", "name": "Loop All Tracks", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,LOOPALL,{state}",
+          "params": [ { "name": "state", "enum": "dfp.loopAll", "required": true } ],
+          "examples": [";D,LOOPALL,1"], "commentLabel": "DFPlayer loop all", "category": "Sound" },
+        { "id": "dfp.loopFolder", "name": "Loop Folder", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,LOOPFOLDER,{folder}",
+          "params": [ { "name": "folder", "type": "int", "min": 1, "max": 99, "required": true } ],
+          "examples": [";D,LOOPFOLDER,1"], "commentLabel": "DFPlayer loop folder", "category": "Sound" },
+        { "id": "dfp.eq", "name": "Equalizer", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,EQ,{preset}",
+          "params": [ { "name": "preset", "enum": "dfp.eq", "required": true } ],
+          "examples": [";D,EQ,2"], "commentLabel": "DFPlayer EQ", "category": "Sound" },
+        { "id": "dfp.volume", "name": "Set Volume", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,VOL,{volume}",
+          "params": [ { "name": "volume", "type": "int", "min": 0, "max": 30, "default": 20, "required": true } ],
+          "examples": [";D,VOL,20"], "commentLabel": "DFPlayer volume", "category": "Volume" },
+        { "id": "dfp.volUp", "name": "Volume Up (+2)", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,VOLUP", "params": [], "examples": [";D,VOLUP"], "commentLabel": "DFPlayer vol up", "category": "Volume" },
+        { "id": "dfp.volDown", "name": "Volume Down (-2)", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,VOLDN", "params": [], "examples": [";D,VOLDN"], "commentLabel": "DFPlayer vol down", "category": "Volume" },
+        { "id": "dfp.reset", "name": "Reset Module", "safety": "config", "encoder": "template",
+          "template": ";D,RESET", "params": [], "examples": [";D,RESET"], "commentLabel": "DFPlayer reset", "category": "System" },
+        { "id": "dfp.status", "name": "Query Play Status", "safety": "cosmetic", "encoder": "template",
+          "template": ";D,STATUS", "params": [], "examples": [";D,STATUS"], "commentLabel": "DFPlayer status", "category": "System" }
+      ],
+      "categories": ["Sound", "Volume", "System"]
+    }
+  ]
+}
diff --git a/libraries/manifest.json b/libraries/manifest.json
index fa0f860..dc9b025 100644
--- a/libraries/manifest.json
+++ b/libraries/manifest.json
@@ -40,6 +40,12 @@
       "name": "WCB · MP3 Trigger",
       "confidence": "high"
     },
+    {
+      "id": "wcb-dfp",
+      "file": "boards/wcb-dfp.json",
+      "name": "WCB · DFPlayer Mini (WCB 6.2+)",
+      "confidence": "high"
+    },
     {
       "id": "maestro",
       "file": "boards/maestro.json",
diff --git a/test/load-node.test.js b/test/load-node.test.js
index b605b05..b88e342 100644
--- a/test/load-node.test.js
+++ b/test/load-node.test.js
@@ -11,7 +11,7 @@ test('readCatalog returns the manifest and every board, in order', () => {
 test('loadCatalog({ load: false }) returns the merged catalog object', () => {
   const lib = loadCatalog({ load: false });
   expect(lib.libraryVersion).toBe('4.2.0');
-  expect(lib.components.length).toBe(21);
+  expect(lib.components.length).toBe(22);
 });
 
 test('loadCatalog() loads the engine and resolves commands', () => {
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index 45e403c..839a181 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -184,3 +184,92 @@ describe('maestro: WCB 6.2 comma verbs and get queries', () => {
     expect(comp.routing.notes).toMatch(/1-8/);
   });
 });
+
+// ---- wcb-dfp: DFPlayer Mini ;D verbs (WCB 6.2+) --------------------------------------------
+// Grammar and ranges: WcbCmd 0.8.0 DfPlayerCodec::handle (WcbDfPlayer.cpp:51-168), which WCB
+// 6.2.1 links; dispatch WCB_DFP.cpp:69-91; host routing WCB.ino:6426-6428; help WCB_Help.cpp:566-593.
+describe('wcb-dfp: DFPlayer Mini (;D, WCB 6.2+)', () => {
+  let cb;
+  beforeEach(() => {
+    cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+
+  test('is listed right after wcb-mp3 and names WCB 6.2+ in the component and the manifest', () => {
+    const { manifest } = readCatalog();
+    const ids = manifest.boards.map(b => b.id);
+    expect(ids.indexOf('wcb-dfp')).toBe(ids.indexOf('wcb-mp3') + 1);
+    const comp = cb.getComponents().find(c => c.id === 'wcb-dfp');
+    expect(comp).toMatchObject({ kind: 'wcb-verb', confidence: 'high', firmware: 'WCB 6.2.1_021242RSEP2026' });
+    expect(comp.name).toBe('WCB · DFPlayer Mini (WCB 6.2+)');
+    expect(manifest.boards.find(b => b.id === 'wcb-dfp').name).toBe(comp.name);
+  });
+
+  test('models the 21 verbs WCB 6.2.1 accepts, in order', () => {
+    expect(cb.getCommands('wcb-dfp').map(c => c.template)).toEqual([
+      ';D,PLAY,{track}', ';D,PLAY,{track},ONFIN,{key}',
+      ';D,FOLDER,{folder},{track}', ';D,FOLDER,{folder},{track},ONFIN,{key}',
+      ';D,MP3FOLDER,{track}', ';D,MP3FOLDER,{track},ONFIN,{key}',
+      ';D,STOP', ';D,PAUSE', ';D,RESUME', ';D,NEXT', ';D,PREV', ';D,RANDOM',
+      ';D,LOOP,{track}', ';D,LOOPALL,{state}', ';D,LOOPFOLDER,{folder}', ';D,EQ,{preset}',
+      ';D,VOL,{volume}', ';D,VOLUP', ';D,VOLDN',
+      ';D,RESET', ';D,STATUS',
+    ]);
+  });
+
+  test('keeps the ids, templates and params of the DroidNet 2.2.0 dfp board', () => {
+    const play = cb.getCommand('dfp.play');
+    expect(play.template).toBe(';D,PLAY,{track}');
+    expect(play.params).toEqual([expect.objectContaining({ name: 'track', type: 'int', min: 1, max: 2999 })]);
+    expect(cb.getCommand('dfp.stop').template).toBe(';D,STOP');
+    const vol = cb.getCommand('dfp.volume');
+    expect(vol.template).toBe(';D,VOL,{volume}');
+    expect(vol.params).toEqual([expect.objectContaining({ name: 'volume', type: 'int', min: 0, max: 30, default: 20 })]);
+    expect(cb.encode(vol, {}, {})).toBe(';D,VOL,20');
+  });
+
+  test('ranges and enums follow DfPlayerCodec::handle', () => {
+    const range = (id, name) => { const p = cb.getCommand(id).params.find(x => x.name === name); return [p.min, p.max]; };
+    expect(range('dfp.folder', 'folder')).toEqual([1, 99]);
+    expect(range('dfp.folder', 'track')).toEqual([1, 255]);
+    expect(range('dfp.mp3Folder', 'track')).toEqual([1, 9999]);
+    expect(range('dfp.loop', 'track')).toEqual([1, 2999]);
+    expect(range('dfp.loopFolder', 'folder')).toEqual([1, 99]);
+    expect(cb.getEnum('dfp.eq').values.map(v => v.code)).toEqual(['0', '1', '2', '3', '4', '5']);
+    expect(cb.getEnum('dfp.loopAll').values.map(v => v.code)).toEqual(['0', '1']);
+  });
+
+  test('ONFIN callbacks decode to their own ids; the bare ,key form stays raw', () => {
+    expect(cb.match(';D,PLAY,5')).toMatchObject({ commandId: 'dfp.play', params: { track: '5' } });
+    expect(cb.match(';D,PLAY,5,ONFIN,done')).toMatchObject({ commandId: 'dfp.playCb', params: { track: '5', key: 'done' } });
+    expect(cb.match(';D,FOLDER,1,5,ONFIN,done')).toMatchObject({ commandId: 'dfp.folderCb', params: { folder: '1', track: '5', key: 'done' } });
+    expect(cb.match(';D,MP3FOLDER,3,ONFIN,done')).toMatchObject({ commandId: 'dfp.mp3FolderCb', params: { track: '3', key: 'done' } });
+    expect(cb.match(';D,PLAY,5,done')).toBeNull();
+    const v = ';D,PLAY,5,ONFIN,done^*** DFPlayer play+cb^;D,VOL,0';
+    expect(cb.buildWCBValue(cb.parseWCBValue(v))).toBe(v);
+  });
+
+  test('LOOP / LOOPALL / LOOPFOLDER and VOL / VOLUP / VOLDN do not shadow each other', () => {
+    expect(cb.match(';D,LOOP,5').commandId).toBe('dfp.loop');
+    expect(cb.match(';D,LOOPALL,1').commandId).toBe('dfp.loopAll');
+    expect(cb.match(';D,LOOPFOLDER,1').commandId).toBe('dfp.loopFolder');
+    expect(cb.match(';D,VOL,20').commandId).toBe('dfp.volume');
+    expect(cb.match(';D,VOLUP').commandId).toBe('dfp.volUp');
+    expect(cb.match(';D,VOLDN').commandId).toBe('dfp.volDown');
+  });
+
+  test('only RESET is non-cosmetic', () => {
+    const nonCosmetic = cb.getCommands('wcb-dfp').filter(c => c.safety !== 'cosmetic').map(c => `${c.id}:${c.safety}`);
+    expect(nonCosmetic).toEqual(['dfp.reset:config']);
+  });
+
+  // ;D,DEVICE,<n> is documented (WCB_Help.cpp:581) but WCB 6.2.1 rejects it: processDFPCommand
+  // strips the leading "D," (WCB_DFP.cpp:72-74), then DfPlayerCodec::handle strips an optional
+  // leading 'D' again (WcbDfPlayer.cpp:54), so "DEVICE,2" reaches the verb table as "EVICE,2".
+  // Add dfp.device (a minor) once a WcbCmd fix ships in WCB firmware.
+  test(';D,DEVICE,<n> is not modeled while WCB 6.2.1 rejects it', () => {
+    expect(cb.getCommand('dfp.device')).toBeNull();
+    expect(cb.match(';D,DEVICE,2')).toBeNull();
+  });
+});

From c3960465abecdc2ac0631daa4247cb28cd164513 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:29:31 -0400
Subject: [PATCH 05/17] feat(wcb-hcr): TRIGGER, all-channel VOL/VOLUP/VOLDN
 steps; FN codes per 6.2.1

- hcr.trigger ;H,TRIGGER,{emotion},{strength} (WCB_HCR.cpp:290-299; also on 6.1.5).
- hcr.volAll ;H,VOL,{level} "(WCB 6.2+)": 6.2.1 treats a missing channel as all
  of V/A/B (WCB_HCR.cpp:365-388); 6.1.5 requires a channel.
- hcr.volUpAllStep / hcr.volDownAllStep ;H,VOLUP|VOLDN,{step} (1-100, default 5):
  a bare step bumps every channel on 6.1.5 and 6.2.1 (WCB_HCR.cpp:389-413).
- hcr.fn: fn becomes enum hcr.fnCode with the codes HcrCodec::normalize accepts
  (WcbCmd WcbHcr.cpp:7-36): 2-11, 13, 14, 16-19; 7, 10, 13, 18 and 19 are
  labelled 6.2+ (absent from the 6.1.5 switch). chan max 9 -> 99 (fn 7 muse
  gap). Template and param names unchanged.
- firmware "WCB 6.2.1_021242RSEP2026" (was the stale 6.1.0 HCR_Integration);
  routing.notes document 6.2.1 host routing (local, ?HCR,REMOTE,W<n>, WDP
  owner; WCB.ino:6391-6409, 6429-6431) vs 6.1.x local-only.
- hcr.emotion / hcr.channel untouched (byte-identical with hcr-native).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 libraries/boards/wcb-hcr.json | 119 ++++++++++++++++++++++++++++++++--
 test/wcb-621.test.js          |  75 +++++++++++++++++++++
 2 files changed, 190 insertions(+), 4 deletions(-)

diff --git a/libraries/boards/wcb-hcr.json b/libraries/boards/wcb-hcr.json
index f15be91..0c38a89 100644
--- a/libraries/boards/wcb-hcr.json
+++ b/libraries/boards/wcb-hcr.json
@@ -79,6 +79,27 @@
         { "code": "OFF", "label": "Off" },
         { "code": "TOGGLE", "label": "Toggle" }
       ]
+    },
+    "hcr.fnCode": {
+      "label": "Function",
+      "values": [
+        { "code": "2", "label": "2 · Set emotion" },
+        { "code": "3", "label": "3 · Trigger" },
+        { "code": "4", "label": "4 · Stimulate" },
+        { "code": "5", "label": "5 · Overload" },
+        { "code": "6", "label": "6 · Muse (once)" },
+        { "code": "7", "label": "7 · Muse gap (WCB 6.2+)" },
+        { "code": "8", "label": "8 · Stop all" },
+        { "code": "9", "label": "9 · Stop emote" },
+        { "code": "10", "label": "10 · Override emotions (WCB 6.2+)" },
+        { "code": "11", "label": "11 · Reset emotions" },
+        { "code": "13", "label": "13 · Muse on/off (WCB 6.2+)" },
+        { "code": "14", "label": "14 · Play WAV" },
+        { "code": "16", "label": "16 · Stop WAV" },
+        { "code": "17", "label": "17 · Set volume" },
+        { "code": "18", "label": "18 · Volume up all (WCB 6.2+)" },
+        { "code": "19", "label": "19 · Volume down all (WCB 6.2+)" }
+      ]
     }
   },
   "components": [
@@ -87,9 +108,10 @@
       "name": "WCB · HCR Vocalizer",
       "kind": "wcb-verb",
       "confidence": "high",
-      "firmware": "WCB 6.1.0 HCR_Integration",
+      "firmware": "WCB 6.2.1_021242RSEP2026",
       "routing": {
-        "class": "wcb-verb"
+        "class": "wcb-verb",
+        "notes": "Needs a WCB with the HCR Vocalizer configured (?HCR,PORT,S<port>:<baud>). On WCB 6.2.1 ;H runs on the board that hosts the HCR: this board if it has one, else the stored ?HCR,REMOTE,W<n> host, else an online board that advertises HCR over WDP (WCB.ino:6391-6409, 6429-6431). A ;H that arrived over the mesh runs where it lands and is never forwarded again. WCB 6.1.x runs ;H only on the board that receives it (6.1.5 WCB.ino:4711-4712); prefix ;W<n>, to reach another board. Needs 6.2+: Set Volume for all channels (;H,VOL,<level>, WCB_HCR.cpp:365-388; 6.1.5 requires a channel) and FN codes 7, 10, 13, 18 and 19. TRIGGER and the all-channel VOLUP/VOLDN step also work on 6.1.5. FN codes follow WcbCmd HcrCodec::normalize (WcbHcr.cpp:7-36; 12 and 15 are rejected); chan runs to 99 for fn 7 (muse gap), track to 9999 for fn 14 (Play WAV). Volume levels are accepted as 0-100, but 6.2.1 sends at most 99 to the HCR (hcrSetVol, WCB_HCR.cpp:84-87)."
       },
       "commands": [
         {
@@ -116,6 +138,30 @@
           "commentLabel": "HCR stimulus",
           "category": "Emotion"
         },
+        {
+          "id": "hcr.trigger",
+          "name": "Emotional Trigger",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";H,TRIGGER,{emotion},{strength}",
+          "params": [
+            {
+              "name": "emotion",
+              "enum": "hcr.emotion",
+              "required": true
+            },
+            {
+              "name": "strength",
+              "enum": "hcr.strength",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";H,TRIGGER,M,MOD"
+          ],
+          "commentLabel": "HCR trigger",
+          "category": "Emotion"
+        },
         {
           "id": "hcr.play",
           "name": "Play WAV",
@@ -168,6 +214,27 @@
           "commentLabel": "HCR volume",
           "category": "Volume"
         },
+        {
+          "id": "hcr.volAll",
+          "name": "Set Volume, all channels (WCB 6.2+)",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";H,VOL,{level}",
+          "params": [
+            {
+              "name": "level",
+              "type": "int",
+              "min": 0,
+              "max": 100,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";H,VOL,60"
+          ],
+          "commentLabel": "HCR volume all",
+          "category": "Volume"
+        },
         {
           "id": "hcr.volUp",
           "name": "Volume Up (channel)",
@@ -208,6 +275,28 @@
           "commentLabel": "HCR vol up all",
           "category": "Volume"
         },
+        {
+          "id": "hcr.volUpAllStep",
+          "name": "Volume Up by step, all channels",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";H,VOLUP,{step}",
+          "params": [
+            {
+              "name": "step",
+              "type": "int",
+              "min": 1,
+              "max": 100,
+              "default": 5,
+              "required": false
+            }
+          ],
+          "examples": [
+            ";H,VOLUP,10"
+          ],
+          "commentLabel": "HCR vol up all (step)",
+          "category": "Volume"
+        },
         {
           "id": "hcr.volDown",
           "name": "Volume Down (channel)",
@@ -248,6 +337,28 @@
           "commentLabel": "HCR vol down all",
           "category": "Volume"
         },
+        {
+          "id": "hcr.volDownAllStep",
+          "name": "Volume Down by step, all channels",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";H,VOLDN,{step}",
+          "params": [
+            {
+              "name": "step",
+              "type": "int",
+              "min": 1,
+              "max": 100,
+              "default": 5,
+              "required": false
+            }
+          ],
+          "examples": [
+            ";H,VOLDN,10"
+          ],
+          "commentLabel": "HCR vol down all (step)",
+          "category": "Volume"
+        },
         {
           "id": "hcr.fadeIn",
           "name": "Fade In",
@@ -367,8 +478,8 @@
           "examples": [";H,STOPWAV,A"], "commentLabel": "HCR stop wav", "category": "Sound" },
         { "id": "hcr.fn", "name": "Function (numeric)", "safety": "cosmetic", "encoder": "template",
           "template": ";H,FN,{fn},{chan},{track}",
-          "params": [ { "name": "fn", "type": "int", "min": 0, "max": 99, "required": true },
-                      { "name": "chan", "type": "int", "min": 0, "max": 9, "required": true },
+          "params": [ { "name": "fn", "enum": "hcr.fnCode", "required": true },
+                      { "name": "chan", "type": "int", "min": 0, "max": 99, "required": true },
                       { "name": "track", "type": "int", "min": 0, "max": 9999, "required": true } ],
           "examples": [";H,FN,14,1,5"], "commentLabel": "HCR fn", "category": "System" },
         { "id": "hcr.raw", "name": "Raw Passthrough", "safety": "cosmetic", "encoder": "template",
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index 839a181..a285581 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -273,3 +273,78 @@ describe('wcb-dfp: DFPlayer Mini (;D, WCB 6.2+)', () => {
     expect(cb.match(';D,DEVICE,2')).toBeNull();
   });
 });
+
+// wcb-hcr, wcb-mp3, wcb-wled (A5-A7).
+describe('WCB 6.2.1: wcb-hcr / wcb-mp3 / wcb-wled', () => {
+  const FW_621 = 'WCB 6.2.1_021242RSEP2026';
+  let cb;
+  let manifest;
+  beforeEach(() => {
+    cb = loadEngine();
+    const cat = readCatalog();
+    manifest = cat.manifest;
+    cb.loadLibrary(cat.boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+  const component = id => cb.getComponents().find(c => c.id === id);
+  const param = (cmdId, name) => cb.getCommand(cmdId).params.find(p => p.name === name);
+
+  describe('wcb-hcr', () => {
+    test('is labelled for 6.2.1 and documents host routing (DroidNet matches /host/)', () => {
+      const hcr = component('wcb-hcr');
+      expect(hcr.firmware).toBe(FW_621);
+      expect(hcr.routing.notes).toMatch(/host/i);
+      expect(hcr.routing.notes).toMatch(/\?HCR,REMOTE,W<n>/);
+    });
+
+    test('TRIGGER sits beside STIM and decodes to its own command (WCB_HCR.cpp:290-299)', () => {
+      expect(cb.encode(cb.getCommand('hcr.trigger'), { emotion: 'M', strength: 'MOD' }, {})).toBe(';H,TRIGGER,M,MOD');
+      expect(cb.match(';H,TRIGGER,C,STRONG')).toMatchObject({ commandId: 'hcr.trigger', params: { emotion: 'C', strength: 'STRONG' } });
+      expect(cb.match(';H,STIM,H,STRONG')).toMatchObject({ commandId: 'hcr.stim' });
+    });
+
+    test('VOL without a channel sets all channels (6.2+) and does not shadow the per-channel form', () => {
+      expect(cb.getCommand('hcr.volAll').name).toMatch(/\(WCB 6\.2\+\)$/);
+      expect(param('hcr.volAll', 'level')).toMatchObject({ min: 0, max: 100 });
+      expect(cb.match(';H,VOL,60')).toMatchObject({ commandId: 'hcr.volAll', params: { level: '60' } });
+      expect(cb.match(';H,VOL,A,80')).toMatchObject({ commandId: 'hcr.vol', params: { channel: 'A', level: '80' } });
+    });
+
+    test('VOLUP/VOLDN take an optional all-channel step (6.1.5 and 6.2.1, default 5)', () => {
+      for (const [verb, stepId, bareId, chanId] of [
+        ['VOLUP', 'hcr.volUpAllStep', 'hcr.volUpAll', 'hcr.volUp'],
+        ['VOLDN', 'hcr.volDownAllStep', 'hcr.volDownAll', 'hcr.volDown'],
+      ]) {
+        const cmd = cb.getCommand(stepId);
+        expect(cmd.name).not.toMatch(/6\.2/);
+        expect(param(stepId, 'step')).toMatchObject({ min: 1, max: 100, default: 5 });
+        expect(cb.encode(cmd, {}, {})).toBe(`;H,${verb},5`);
+        expect(cb.match(`;H,${verb},10`)).toMatchObject({ commandId: stepId, params: { step: '10' } });
+        expect(cb.match(`;H,${verb}`)).toMatchObject({ commandId: bareId });
+        expect(cb.match(`;H,${verb},B,10`)).toMatchObject({ commandId: chanId, params: { channel: 'B', step: '10' } });
+      }
+    });
+
+    test('FN takes only the firmware function codes (WcbHcr.cpp:7-36); template unchanged', () => {
+      expect(cb.getCommand('hcr.fn').template).toBe(';H,FN,{fn},{chan},{track}');
+      expect(param('hcr.fn', 'fn').enum).toBe('hcr.fnCode');
+      expect(cb.getEnum('hcr.fnCode').values.map(v => v.code))
+        .toEqual(['2', '3', '4', '5', '6', '7', '8', '9', '10', '11', '13', '14', '16', '17', '18', '19']);
+      // Codes the 6.1.5 FN switch lacks are flagged 6.2+.
+      const newIn62 = cb.getEnum('hcr.fnCode').values.filter(v => /\(WCB 6\.2\+\)$/.test(v.label)).map(v => v.code);
+      expect(newIn62).toEqual(['7', '10', '13', '18', '19']);
+      expect(param('hcr.fn', 'chan')).toMatchObject({ min: 0, max: 99 });
+      expect(param('hcr.fn', 'track')).toMatchObject({ min: 0, max: 9999 });
+      expect(cb.match(';H,FN,14,1,5')).toMatchObject({ commandId: 'hcr.fn', params: { fn: '14', chan: '1', track: '5' } });
+      expect(cb.match(';H,FN,7,30,60')).toMatchObject({ commandId: 'hcr.fn', params: { fn: '7', chan: '30', track: '60' } });
+      expect(cb.match(';H,FN,19,0,10')).toMatchObject({ commandId: 'hcr.fn', params: { fn: '19' } });
+      // 0, 1, 12 and 15 are rejected by the firmware, so they stay raw text.
+      for (const code of ['0', '1', '12', '15']) expect(cb.match(`;H,FN,${code},0,0`)).toBeNull();
+    });
+
+    test('hcr.trigger, hcr.volAll, hcr.volUpAllStep, hcr.volDownAllStep are cosmetic', () => {
+      for (const id of ['hcr.trigger', 'hcr.volAll', 'hcr.volUpAllStep', 'hcr.volDownAllStep']) {
+        expect(cb.getCommand(id).safety).toBe('cosmetic');
+      }
+    });
+  });
+});

From 0948166fbbeee4cca624d5036bb4ed193af77b0f Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:29:43 -0400
Subject: [PATCH 06/17] docs(wcb-mp3): 6.2.1 host routing

- firmware "WCB 6.2.1_021242RSEP2026".
- routing.notes: on 6.2.1 ;A runs on the MP3 host (this board, else the stored
  ?MP3,REMOTE,W<n> board, else an online WDP owner; WCB.ino:6391-6409,
  6423-6425) and a mesh-delivered ;A is never re-forwarded; 6.1.x plays only on
  the receiving board (6.1.5 WCB.ino:4709-4710). Volume scale 0 loudest to 64
  inaudible, 5-step VOLUP/VOLDN.
- Verbs and ranges unchanged: 6.2.1 delegates to WcbCmd Mp3Codec::handle
  (WcbMp3.cpp:32-93), which matches the board.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 libraries/boards/wcb-mp3.json |  7 +++++--
 test/wcb-621.test.js          | 10 ++++++++++
 2 files changed, 15 insertions(+), 2 deletions(-)

diff --git a/libraries/boards/wcb-mp3.json b/libraries/boards/wcb-mp3.json
index 54c6cb0..1dac756 100644
--- a/libraries/boards/wcb-mp3.json
+++ b/libraries/boards/wcb-mp3.json
@@ -7,8 +7,11 @@
       "name": "WCB · MP3 Trigger",
       "kind": "wcb-verb",
       "confidence": "high",
-      "firmware": "WCB 6.1.5_290119RJUN2026",
-      "routing": { "class": "wcb-verb" },
+      "firmware": "WCB 6.2.1_021242RSEP2026",
+      "routing": {
+        "class": "wcb-verb",
+        "notes": "Needs a WCB with the SparkFun MP3 Trigger configured (?MP3,S<port>:<baud>:V<vol>). On WCB 6.2.1 ;A runs on the board that hosts the MP3 Trigger: this board if it has one, else the stored ?MP3,REMOTE,W<n> host, else an online board that advertises MP3 over WDP (WCB.ino:6391-6409, 6423-6425). An ;A that arrived over the mesh runs where it lands and is never forwarded again. WCB 6.1.x plays only on the board that receives it (6.1.5 WCB.ino:4709-4710); prefix ;W<n>, to reach another board. The verbs and ranges are unchanged in 6.2.1 (WcbCmd Mp3Codec::handle, WcbMp3.cpp:32-93): VOL runs from 0 (loudest) to 64 (inaudible), VOLUP/VOLDN move 5 steps, and PLAY/PLAYFS send the stored volume before the track."
+      },
       "commands": [
         { "id": "mp3.play", "name": "Play Track", "safety": "cosmetic", "encoder": "template",
           "template": ";A,PLAY,{track}",
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index a285581..47f7e02 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -347,4 +347,14 @@ describe('WCB 6.2.1: wcb-hcr / wcb-mp3 / wcb-wled', () => {
       }
     });
   });
+
+  describe('wcb-mp3', () => {
+    test('is labelled for 6.2.1 and documents host routing', () => {
+      const mp3 = component('wcb-mp3');
+      expect(mp3.firmware).toBe(FW_621);
+      expect(mp3.routing.notes).toMatch(/host/i);
+      expect(mp3.routing.notes).toMatch(/\?MP3,REMOTE,W<n>/);
+      expect(cb.match(';A,PLAY,1,ONFIN,wave')).toMatchObject({ commandId: 'mp3.playCb' });
+    });
+  });
 });

From 5c6574ebd870c88f5515b8065819d0ec1347ce2a Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:29:56 -0400
Subject: [PATCH 07/17] fix(wcb-wled): preset starts at 1; 6.2.1 metadata
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- wled.preset: preset min 0 -> 1. WLED preset slots are 1-250 (WLED JSON API
  psave/pdel); WcbWled::build passes the number through unchecked.
- Component and manifest name "WCB · WLED Lighting (WCB 6.2+)": 6.1.5 has no ;L
  dispatch (6.1.5 WCB.ino:4697-4718; 6.2.1 WCB.ino:6432-6433).
- firmware "WCB 6.2.1_021242RSEP2026" (was "WCB WCB_WLED").
- routing.notes: the receiving WCB must know the id (?WLED,<id>:W<wcb>S<port>:<baud>
  or WDP auto-add), no fallback for an unknown id (WCB_WLED.cpp:110-157); one
  mesh hop, no re-forward, no read-back; mesh-routed commands stay within 187
  characters while ?ETM,CHKSM is on (WCB.ino:216-223).
- The other nine wled.* ids are unchanged.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
---
 libraries/boards/wcb-wled.json |  9 +++++----
 libraries/manifest.json        |  2 +-
 test/wcb-621.test.js           | 15 +++++++++++++++
 3 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/libraries/boards/wcb-wled.json b/libraries/boards/wcb-wled.json
index fab1d06..2cc9899 100644
--- a/libraries/boards/wcb-wled.json
+++ b/libraries/boards/wcb-wled.json
@@ -4,12 +4,13 @@
   "components": [
     {
       "id": "wcb-wled",
-      "name": "WCB · WLED Lighting",
+      "name": "WCB · WLED Lighting (WCB 6.2+)",
       "kind": "wcb-verb",
       "confidence": "high",
-      "firmware": "WCB WCB_WLED",
+      "firmware": "WCB 6.2.1_021242RSEP2026",
       "routing": {
-        "class": "wcb-verb"
+        "class": "wcb-verb",
+        "notes": "Needs WCB 6.2.1: 6.1.5 has no ;L dispatch and answers \"Invalid Serial Command\" (6.1.5 WCB.ino:4697-4718; 6.2.1 WCB.ino:6432-6433). The receiving WCB must already know the WLED id, either configured with ?WLED,<id>:W<wcb>S<port>:<baud> or learned over WDP from the board that hosts it; an unknown id only prints \"WLED <id> not configured\" and there is no fallback (WCB_WLED.cpp:110-157). A remote id is forwarded one mesh hop to its host (ETM-ACKed); a ;L that arrived over the mesh is never forwarded again. Fire-and-forget: the WCB never reads WLED state back. While ETM checksums are on (?ETM,CHKSM,ON) a mesh-routed command must stay within 187 characters (WCB.ino:216-223, ETM_MAX_CMD_WITH_CRC; the help text's 188 is off by one), which matters for JSON payloads. Verbs follow WcbCmd WcbWled::build (WcbWled.cpp:24-101). Preset ids are 1-250 (WLED JSON API psave/pdel)."
       },
       "commands": [
         {
@@ -73,7 +74,7 @@
           "template": ";L{wledId},PS,{preset}",
           "params": [
             { "name": "wledId", "label": "WLED ID (1-9)", "type": "int", "min": 1, "max": 9, "default": 1, "required": true },
-            { "name": "preset", "label": "Preset #", "type": "int", "min": 0, "max": 250, "default": 1, "required": true }
+            { "name": "preset", "label": "Preset #", "type": "int", "min": 1, "max": 250, "default": 1, "required": true }
           ],
           "examples": [";L1,PS,3"],
           "commentLabel": "WLED preset",
diff --git a/libraries/manifest.json b/libraries/manifest.json
index dc9b025..7d503b0 100644
--- a/libraries/manifest.json
+++ b/libraries/manifest.json
@@ -133,7 +133,7 @@
     {
       "id": "wcb-wled",
       "file": "boards/wcb-wled.json",
-      "name": "WCB · WLED Lighting",
+      "name": "WCB · WLED Lighting (WCB 6.2+)",
       "confidence": "high"
     }
   ]
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index 47f7e02..b1c13e4 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -357,4 +357,19 @@ describe('WCB 6.2.1: wcb-hcr / wcb-mp3 / wcb-wled', () => {
       expect(cb.match(';A,PLAY,1,ONFIN,wave')).toMatchObject({ commandId: 'mp3.playCb' });
     });
   });
+
+  describe('wcb-wled', () => {
+    test('the whole board is named for WCB 6.2+ in the component and the manifest', () => {
+      const wled = component('wcb-wled');
+      expect(wled.name).toBe('WCB · WLED Lighting (WCB 6.2+)');
+      expect(manifest.boards.find(b => b.id === 'wcb-wled').name).toBe(wled.name);
+      expect(wled.firmware).toBe(FW_621);
+      expect(wled.routing.notes).toMatch(/187/);
+    });
+
+    test('presets start at 1 (WLED preset ids are 1-250)', () => {
+      expect(param('wled.preset', 'preset')).toMatchObject({ min: 1, max: 250, default: 1 });
+      expect(cb.match(';L1,PS,3')).toMatchObject({ commandId: 'wled.preset', params: { wledId: '1', preset: '3' } });
+    });
+  });
 });

From ff0fbc5457255ec7afa3778c2eb902f84305c79a Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:32:49 -0400
Subject: [PATCH 08/17] fix(wcb-native): 6.2.1 ranges and grammar corrections

Re-read against WCB 6.2.1 @ 66845b9a (SoftwareVersion
6.2.1_021242RSEP2026). Templates and ordered param names are unchanged
(the 4.2.0 freeze test still passes); only ranges, enums and patterns
tighten or widen. Hand-edited in place to keep the file's formatting.

- firmware -> "WCB 6.2.1_021242RSEP2026"; add routing.notes recording
  the 6.1.x vs 6.2.1 behavior differences a reviewer needs (;S comma,
  ;C/;SEQ mesh fan-out and ,L, ;V volatile vs ;VP, ?FUNCCHAR,? / ?CMDCHAR,?
  6.2.1-only, ?CONTROLLER = ?SPECIAL on 6.1.x, IF limits, the
  ?MAP,PWM,CLEAR,OUT reboot)
- new enums wcb.portUsb (S0 USB + S1-S5), wcb.devBaud
  (9600-115200), wcb.hcrField (the 14 GET fields)
- wcb.num / wcb.qty max 20 (WCB.ino:5298-5305, WCB_Storage.cpp:447-451)
- wcb.routeWcb wcb max 20 (WCB.ino:6553-6566)
- wcb.routeSerial port -> wcb.portUsb (WCB.ino:6450-6463)
- wcb.timer ms max 1800000 (command_timer.cpp:166)
- wcb.maestroClear id max 8 (WCB_Maestro.cpp:817)
- wcb.maestro spec .+ -> M<id>:W<wcb>S<port>:<baud> list, so
  ?MAESTRO,REMOTE no longer parses as a Maestro spec (WCB.ino:5437)
- wcb.hcrPort baud -> wcb.devBaud (WCB_HCR.cpp:630-633)
- wcb.hcrPoll min 3 (WCB_HCR.cpp:568-575)
- wcb.hcrGet field -> wcb.hcrField (WCB_HCR.cpp:586-604)
- wcb.etmMiss max 100 (WCB.ino:5211-5217)
- wcb.mapSerial / wcb.mapSerialRaw dest -> comma list of S0-S5 /
  W1-20S0-5 with an optional R per destination
  (WCB_Storage.cpp addSerialMonitorMapping); a destination cannot start
  with R, so the ,R, literal of mapSerialRaw stays unambiguous
- wcb.mapPwm dest -> comma list of S1-S5 / W1-20S1-5
  (WCB_PWM.cpp addPWMMapping)

Tests appended to test/wcb-621.test.js pin each range, the S0 route,
the HCR baud/field sets, the Maestro spec tightening and the map
destination grammar (including the R suffix vs the ,R, literal).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 libraries/boards/wcb-native.json | 49 ++++++++++++++++--------
 test/wcb-621.test.js             | 65 ++++++++++++++++++++++++++++++++
 2 files changed, 98 insertions(+), 16 deletions(-)

diff --git a/libraries/boards/wcb-native.json b/libraries/boards/wcb-native.json
index d7140f0..c035677 100644
--- a/libraries/boards/wcb-native.json
+++ b/libraries/boards/wcb-native.json
@@ -4,16 +4,30 @@
     "wcb.port": { "label": "Serial Port", "values": [
       { "code": "1", "label": "S1" }, { "code": "2", "label": "S2" }, { "code": "3", "label": "S3" },
       { "code": "4", "label": "S4" }, { "code": "5", "label": "S5" } ] },
+    "wcb.portUsb": { "label": "Serial Port", "values": [
+      { "code": "0", "label": "S0 (USB)" }, { "code": "1", "label": "S1" }, { "code": "2", "label": "S2" },
+      { "code": "3", "label": "S3" }, { "code": "4", "label": "S4" }, { "code": "5", "label": "S5" } ] },
     "wcb.baud": { "label": "Baud", "values": [
       { "code": "110", "label": "110" }, { "code": "300", "label": "300" }, { "code": "600", "label": "600" },
       { "code": "1200", "label": "1200" }, { "code": "2400", "label": "2400" }, { "code": "9600", "label": "9600" },
       { "code": "14400", "label": "14400" }, { "code": "19200", "label": "19200" }, { "code": "38400", "label": "38400" },
       { "code": "57600", "label": "57600" }, { "code": "115200", "label": "115200" },
       { "code": "128000", "label": "128000" }, { "code": "256000", "label": "256000" } ] },
+    "wcb.devBaud": { "label": "Baud", "values": [
+      { "code": "9600", "label": "9600" }, { "code": "19200", "label": "19200" }, { "code": "38400", "label": "38400" },
+      { "code": "57600", "label": "57600" }, { "code": "115200", "label": "115200" } ] },
     "wcb.hwVersion": { "label": "Hardware", "values": [
       { "code": "1", "label": "v1.0" }, { "code": "21", "label": "v2.1" }, { "code": "23", "label": "v2.3" },
       { "code": "24", "label": "v2.4" }, { "code": "31", "label": "v3.1" }, { "code": "32", "label": "v3.2" } ] },
-    "wcb.onOff": { "label": "State", "values": [ { "code": "ON", "label": "On" }, { "code": "OFF", "label": "Off" } ] }
+    "wcb.onOff": { "label": "State", "values": [ { "code": "ON", "label": "On" }, { "code": "OFF", "label": "Off" } ] },
+    "wcb.hcrField": { "label": "Field", "values": [
+      { "code": "EMOTION,H", "label": "Emotion: Happy" }, { "code": "EMOTION,S", "label": "Emotion: Sad" },
+      { "code": "EMOTION,M", "label": "Emotion: Mad" }, { "code": "EMOTION,C", "label": "Emotion: Scared" },
+      { "code": "DURATION", "label": "Duration" }, { "code": "OVERRIDE", "label": "Override" },
+      { "code": "MUSE", "label": "Muse" }, { "code": "WAVCOUNT", "label": "WAV count" },
+      { "code": "PLAYING,V", "label": "Playing: Vocalizer" }, { "code": "PLAYING,A", "label": "Playing: channel A" },
+      { "code": "PLAYING,B", "label": "Playing: channel B" }, { "code": "VOL,V", "label": "Volume: Vocalizer" },
+      { "code": "VOL,A", "label": "Volume: channel A" }, { "code": "VOL,B", "label": "Volume: channel B" } ] }
   },
   "components": [
     {
@@ -21,7 +35,10 @@
       "name": "WCB (native config)",
       "kind": "device-native",
       "confidence": "high",
-      "firmware": "WCB 6.1.5_290119RJUN2026",
+      "firmware": "WCB 6.2.1_021242RSEP2026",
+      "routing": {
+        "notes": "Typed at a WCB console or sent to its serial/ESP-NOW input (? = function character, ; = command character). Checked against WCB 6.2.1 source; commands without \"(WCB 6.2+)\" also exist in 6.1.5. Board numbers are 1-20 (MAX_WCB_COUNT). Firmware differences: ;S<port>,<msg> strips the comma on 6.2.1, while 6.1.x forwarded \",<msg>\"; ;C<key> / ;SEQ<key> run on every mesh board that stores the key on 6.2.1 (6.1.x ran them locally), and ,L (6.2+) keeps a run on this board; ;V is volatile (RAM only) on 6.2.1 but persistent on 6.1.5, and ;VP needs 6.2.1 (6.1.5 reads ;VP,x,1 as a variable named P); ?FUNCCHAR,? and ?CMDCHAR,? need 6.2.1 (6.1.x treats a trailing ? as a help request); ?CONTROLLER is ?SPECIAL on 6.1.x. IF gates the next ^-delimited step and cannot ride inside a ;W or ;T payload; set and test a variable in separate sequences. ?MAP,PWM,CLEAR,OUT reboots the board."
+      },
       "commands": [
         {
           "id": "wcb.hw",
@@ -53,7 +70,7 @@
               "name": "n",
               "type": "int",
               "min": 1,
-              "max": 9,
+              "max": 20,
               "required": true
             }
           ],
@@ -74,7 +91,7 @@
               "name": "n",
               "type": "int",
               "min": 1,
-              "max": 9,
+              "max": 20,
               "required": true
             }
           ],
@@ -296,7 +313,7 @@
             },
             {
               "name": "dest",
-              "pattern": "(?:S[1-5]|W[1-9]S[1-5])",
+              "pattern": "(?:S[0-5]|W(?:[1-9]|1[0-9]|20)S[0-5])R?(?:,(?:S[0-5]|W(?:[1-9]|1[0-9]|20)S[0-5])R?)*",
               "required": true
             }
           ],
@@ -320,7 +337,7 @@
             },
             {
               "name": "dest",
-              "pattern": "(?:S[1-5]|W[1-9]S[1-5])",
+              "pattern": "(?:S[0-5]|W(?:[1-9]|1[0-9]|20)S[0-5])R?(?:,(?:S[0-5]|W(?:[1-9]|1[0-9]|20)S[0-5])R?)*",
               "required": true
             }
           ],
@@ -389,7 +406,7 @@
             },
             {
               "name": "dest",
-              "pattern": "(?:S[1-5]|W[1-9]S[1-5])",
+              "pattern": "(?:S[1-5]|W(?:[1-9]|1[0-9]|20)S[1-5])(?:,(?:S[1-5]|W(?:[1-9]|1[0-9]|20)S[1-5]))*",
               "required": true
             }
           ],
@@ -552,7 +569,7 @@
               "name": "id",
               "type": "int",
               "min": 1,
-              "max": 9,
+              "max": 8,
               "required": true
             }
           ],
@@ -584,7 +601,7 @@
           "params": [
             {
               "name": "spec",
-              "pattern": ".+",
+              "pattern": "M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+(?:,M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+)*",
               "required": true
             }
           ],
@@ -685,7 +702,7 @@
             },
             {
               "name": "baud",
-              "enum": "wcb.baud",
+              "enum": "wcb.devBaud",
               "required": true
             }
           ],
@@ -705,7 +722,7 @@
             {
               "name": "sec",
               "type": "int",
-              "min": 0,
+              "min": 3,
               "max": 3600,
               "required": true
             }
@@ -777,7 +794,7 @@
           "params": [
             {
               "name": "field",
-              "pattern": ".+",
+              "enum": "wcb.hcrField",
               "required": true
             }
           ],
@@ -796,7 +813,7 @@
           "params": [
             {
               "name": "port",
-              "enum": "wcb.port",
+              "enum": "wcb.portUsb",
               "required": true
             },
             {
@@ -822,7 +839,7 @@
               "name": "wcb",
               "type": "int",
               "min": 1,
-              "max": 9,
+              "max": 20,
               "required": true
             },
             {
@@ -848,7 +865,7 @@
               "name": "ms",
               "type": "int",
               "min": 0,
-              "max": 600000,
+              "max": 1800000,
               "required": true
             },
             {
@@ -1049,7 +1066,7 @@
               "name": "count",
               "type": "int",
               "min": 1,
-              "max": 99,
+              "max": 100,
               "required": true
             }
           ],
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index b1c13e4..89ceb5b 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -373,3 +373,68 @@ describe('WCB 6.2.1: wcb-hcr / wcb-mp3 / wcb-wled', () => {
     });
   });
 });
+
+// ---- wcb-native (WCB (native config)) --------------------------------------------------------
+// Ranges and grammars re-read from WCB 6.2.1 @ 66845b9a; 4.2.0 templates and param names stay frozen.
+describe('wcb-native: WCB 6.2.1 ranges and grammar', () => {
+  let cb;
+  beforeEach(() => {
+    cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+  const param = (id, name) => cb.getCommand(id).params.find(p => p.name === name);
+  const codes = (enumId) => cb.getEnum(enumId).values.map(v => v.code);
+  const roundTrips = (wire) => expect(cb.buildWCBValue(cb.parseWCBValue(wire))).toBe(wire);
+
+  test('board is generated against 6.2.1', () => {
+    expect(cb.getComponents().find(c => c.id === 'wcb-native').firmware).toBe('WCB 6.2.1_021242RSEP2026');
+  });
+
+  test('numeric ranges follow the firmware', () => {
+    expect(param('wcb.num', 'n').max).toBe(20);            // WCB.ino:5298-5305, MAX_WCB_COUNT
+    expect(param('wcb.qty', 'n').max).toBe(20);            // WCB_Storage.cpp:447-451
+    expect(param('wcb.routeWcb', 'wcb').max).toBe(20);     // WCB.ino:6553-6566
+    expect(param('wcb.timer', 'ms').max).toBe(1800000);    // command_timer.cpp:166
+    expect(param('wcb.maestroClear', 'id').max).toBe(8);   // WCB_Maestro.cpp:817
+    expect(param('wcb.etmMiss', 'count').max).toBe(100);   // WCB.ino:5211-5217
+    expect(param('wcb.hcrPoll', 'sec').min).toBe(3);       // WCB_HCR.cpp:568-575
+  });
+
+  test(';S routes to S0 (USB) as well as S1-S5', () => {
+    expect(codes(param('wcb.routeSerial', 'port').enum)).toEqual(['0', '1', '2', '3', '4', '5']);
+    expect(cb.match(';S0,hello')).toEqual({ commandId: 'wcb.routeSerial', params: { port: '0', message: 'hello' } });
+  });
+
+  test('HCR port baud and GET fields are the firmware sets', () => {
+    expect(codes(param('wcb.hcrPort', 'baud').enum)).toEqual(['9600', '19200', '38400', '57600', '115200']);
+    expect(codes(param('wcb.hcrGet', 'field').enum)).toHaveLength(14);
+    expect(cb.match('?HCR,GET,EMOTION,H')).toEqual({ commandId: 'wcb.hcrGet', params: { field: 'EMOTION,H' } });
+    expect(cb.match('?HCR,GET,VOL,B')).toEqual({ commandId: 'wcb.hcrGet', params: { field: 'VOL,B' } });
+    expect(cb.match('?HCR,GET,BOGUS')).toBeNull();
+    expect(cb.match('?HCR,PORT,S1:256000')).toBeNull();
+  });
+
+  test('?MAESTRO spec is the M<id>:W<wcb>S<port>:<baud> list, not free text', () => {
+    expect(cb.match('?MAESTRO,M1:W2S1:57600')).toEqual({ commandId: 'wcb.maestro', params: { spec: 'M1:W2S1:57600' } });
+    expect(cb.match('?MAESTRO,M1:W1S2:115200,M2:W12S1:57600').commandId).toBe('wcb.maestro');
+    const remote = cb.match('?MAESTRO,REMOTE');
+    expect(remote && remote.commandId).not.toBe('wcb.maestro');
+  });
+
+  test('serial map destinations: comma list, S0-S5 / W1-20, per-destination R, and the ,R, raw source', () => {
+    expect(cb.match('?MAP,SERIAL,S1,S2R,W12S0')).toEqual({ commandId: 'wcb.mapSerial', params: { port: '1', dest: 'S2R,W12S0' } });
+    expect(cb.match('?MAP,SERIAL,S5,R,W3S2,W20S5R')).toEqual({ commandId: 'wcb.mapSerialRaw', params: { port: '5', dest: 'W3S2,W20S5R' } });
+    // The ,R, literal belongs to mapSerialRaw only: a destination cannot start with R.
+    const raw = cb.match('?MAP,SERIAL,S5,R,W3S2');
+    expect(raw.commandId).toBe('wcb.mapSerialRaw');
+    expect(cb.match('?MAP,SERIAL,S1,W21S1')).toBeNull();
+    for (const w of ['?MAP,SERIAL,S1,S2R,W12S0', '?MAP,SERIAL,S5,R,W3S2,W20S5R']) roundTrips(w);
+  });
+
+  test('PWM map destinations: comma list of S1-S5 / W1-20S1-5', () => {
+    expect(cb.match('?MAP,PWM,S1,S2,W20S5')).toEqual({ commandId: 'wcb.mapPwm', params: { port: '1', dest: 'S2,W20S5' } });
+    expect(cb.match('?MAP,PWM,S1,S0')).toBeNull();
+    roundTrips('?MAP,PWM,S1,S2,W20S5');
+  });
+});

From c3ed835126b68f62ec3c9d39bc457481760f467d Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:37:29 -0400
Subject: [PATCH 09/17] feat(wcb-native): 66 commands for WCB 6.2.1 (and missed
 6.1.5 surface)

Adds 66 new command ids to wcb-native (77 -> 143), each re-read against
WCB 6.2.1 @ 66845b9a, with 6.1.5 (v6.1.5_290119RJUN2026 = 5cd4b6ba)
checked to decide the name suffix: the 40 commands 6.1.5 lacks end in
"(WCB 6.2+)"; the 26 it already had do not. No 4.2.0 id, template or
param name changes. Inserted by hand at the ordering anchors, keeping
the file's formatting (the diff is additions plus the enum and
categories lines).

- Setup (before wcb.mac2): ?WCBCH mesh channel 1-11; ?ALIAS CLEAR /
  LIST / <name>; ?CONTROLLER ON / ON,<id> / OFF; ?LED,PIN[,gpio 0-48];
  ?IDENTIFY (cosmetic)
- Config: ?BCAST,OUT,S0; ?MAP,PWM,CLEAR,OUT,S<port> (safety power, it
  reboots); ?KYBER,LOCAL,S<port>,<maestro specs>; ?MAESTRO,REMOTE
  (before ?MAESTRO,{spec}); ?MP3,REMOTE W<n> / OFF; the ?DFP family
  (S<port>:9600:V<vol>, S<port>, LIST, CLEAR, REMOTE, ONERR); ?HCR,POLL,OFF
  and ?HCR,REMOTE W<n> / OFF; the ?WLED family (<id>:W<wcb>S<port>:<baud>,
  LIST, STATUS, CLEAR, CLEAR,<id>)
- Routing / Movement (before wcb.timer): ;W<alias>,<message>;
  ;P<port><width> 500-2500 (movement; port is a one-digit enum so it
  cannot swallow the width)
- Sequences: ?SEQ,NAMES, ?SEQ,GET,<key>; ;C<key>,L and ;SEQ<key>,L
  (local-only runs); ?STOP
- Variables (before wcb.etmOn): ;V / ;VP set, TOGGLE/INC/DEC/true/false,
  INC/DEC by n; IF,<cond>[,AND|OR,<cond>...]; ?VAR LIST / SET / GET /
  CLEAR,ALL / CLEAR,<name>
- System (before wcb.stats): ?DEBUG,MGMT / RAW; ?TRACK ON|OFF / STATUS;
  ?VERSION; ?PEERSLIVE; the ?WDP family (LIST, <n>, STATUS, DUMP, DA,
  POLL, ON|OFF, AUTOJOIN[,ON|OFF], ADD, FORGET, CLEAR)
- enums wcb.varScope, wcb.varOp, wcb.varDir; categories gain Movement
  and Variables (Variables is a non-standard name; the validator warns)

Where the firmware is stricter than the scratch proposal:
- wcb.wledCfg port uses wcb.port (S1-S5), not wcb.portUsb: a WLED is
  never on S0/USB (WCB_WLED.cpp:311).
- wcb.alias, wcb.dfpOnErr and wcb.varClear exclude any-case CLEAR /
  LIST / ALL, because the firmware compares those words
  case-insensitively (WCB.ino:5375-5378, WCB_DFP.cpp:189,
  WCB_Variables.cpp:328); ?ALIAS,clear, ?DFP,ONERR,clear and
  ?VAR,CLEAR,all stay raw steps instead of being mislabelled. The
  ONERR key is capped at 23 characters (onErrCmd[24]).

Tests appended to test/wcb-621.test.js: the exact 66-id set, the name
suffix split, safety classes, literal-before-catch-all pairs (ALIAS,
VAR,CLEAR,ALL, DFP,ONERR,CLEAR, MAESTRO,REMOTE), any-case raw steps,
;W alias vs number, ;C<key>,L vs ;C<key>, ;P11500 -> port 1 width 1500,
variable and IF grammar, device/config/system verbs with optional
arguments, and byte-identical round-trips of every new example.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 libraries/boards/wcb-native.json | 1380 ++++++++++++++++++++++++++++--
 test/wcb-621.test.js             |  149 ++++
 2 files changed, 1436 insertions(+), 93 deletions(-)

diff --git a/libraries/boards/wcb-native.json b/libraries/boards/wcb-native.json
index c035677..c0c3308 100644
--- a/libraries/boards/wcb-native.json
+++ b/libraries/boards/wcb-native.json
@@ -27,7 +27,14 @@
       { "code": "MUSE", "label": "Muse" }, { "code": "WAVCOUNT", "label": "WAV count" },
       { "code": "PLAYING,V", "label": "Playing: Vocalizer" }, { "code": "PLAYING,A", "label": "Playing: channel A" },
       { "code": "PLAYING,B", "label": "Playing: channel B" }, { "code": "VOL,V", "label": "Volume: Vocalizer" },
-      { "code": "VOL,A", "label": "Volume: channel A" }, { "code": "VOL,B", "label": "Volume: channel B" } ] }
+      { "code": "VOL,A", "label": "Volume: channel A" }, { "code": "VOL,B", "label": "Volume: channel B" } ] },
+    "wcb.varScope": { "label": "Scope", "values": [
+      { "code": "V", "label": "Volatile (RAM)" }, { "code": "VP", "label": "Persistent (NVS, WCB 6.2+)" } ] },
+    "wcb.varOp": { "label": "Operation", "values": [
+      { "code": "TOGGLE", "label": "Toggle (0 / 1)" }, { "code": "INC", "label": "Increment by 1" },
+      { "code": "DEC", "label": "Decrement by 1" }, { "code": "true", "label": "Set true (1)" },
+      { "code": "false", "label": "Set false (0)" } ] },
+    "wcb.varDir": { "label": "Direction", "values": [ { "code": "INC", "label": "Increment" }, { "code": "DEC", "label": "Decrement" } ] }
   },
   "components": [
     {
@@ -101,6 +108,167 @@
           "commentLabel": "WCB quantity",
           "category": "Setup"
         },
+        {
+          "id": "wcb.meshChannel",
+          "name": "Set Mesh Channel, applies on reboot (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WCBCH,{ch}",
+          "params": [
+            {
+              "name": "ch",
+              "type": "int",
+              "min": 1,
+              "max": 11,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WCBCH,6"
+          ],
+          "commentLabel": "WCB mesh channel",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.aliasClear",
+          "name": "Clear Board Alias",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?ALIAS,CLEAR",
+          "params": [],
+          "examples": [
+            "?ALIAS,CLEAR"
+          ],
+          "commentLabel": "WCB alias clear",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.aliasList",
+          "name": "Show Board Alias",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?ALIAS,LIST",
+          "params": [],
+          "examples": [
+            "?ALIAS,LIST"
+          ],
+          "commentLabel": "WCB alias list",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.alias",
+          "name": "Set Board Alias",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?ALIAS,{name}",
+          "params": [
+            {
+              "name": "name",
+              "pattern": "(?![Cc][Ll][Ee][Aa][Rr]$|[Ll][Ii][Ss][Tt]$)[A-Za-z][^,;?]{0,23}",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?ALIAS,Dome"
+          ],
+          "commentLabel": "WCB alias",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.controllerOn",
+          "name": "Controller Peer On (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?CONTROLLER,ON",
+          "params": [],
+          "examples": [
+            "?CONTROLLER,ON"
+          ],
+          "commentLabel": "WCB controller on",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.controllerOnId",
+          "name": "Controller Peer On, custom id (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?CONTROLLER,ON,{id}",
+          "params": [
+            {
+              "name": "id",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true,
+              "default": 20
+            }
+          ],
+          "examples": [
+            "?CONTROLLER,ON,20"
+          ],
+          "commentLabel": "WCB controller on id",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.controllerOff",
+          "name": "Controller Peer Off (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?CONTROLLER,OFF",
+          "params": [],
+          "examples": [
+            "?CONTROLLER,OFF"
+          ],
+          "commentLabel": "WCB controller off",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.ledPin",
+          "name": "Set Status LED Pin",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?LED,PIN,{gpio}",
+          "params": [
+            {
+              "name": "gpio",
+              "type": "int",
+              "min": 0,
+              "max": 48,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?LED,PIN,38"
+          ],
+          "commentLabel": "WCB LED pin",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.ledPinQuery",
+          "name": "Show Status LED Pin",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?LED,PIN",
+          "params": [],
+          "examples": [
+            "?LED,PIN"
+          ],
+          "commentLabel": "WCB LED pin query",
+          "category": "Setup"
+        },
+        {
+          "id": "wcb.identify",
+          "name": "Identify Board (blink LED)",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": "?IDENTIFY",
+          "params": [],
+          "examples": [
+            "?IDENTIFY"
+          ],
+          "commentLabel": "WCB identify",
+          "category": "Setup"
+        },
         {
           "id": "wcb.mac2",
           "name": "Set MAC Byte 2",
@@ -286,6 +454,25 @@
           "commentLabel": "WCB bcast out",
           "category": "Config"
         },
+        {
+          "id": "wcb.bcastOutUsb",
+          "name": "Set Broadcast Out to USB/S0 (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?BCAST,OUT,S0,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?BCAST,OUT,S0,ON"
+          ],
+          "commentLabel": "WCB bcast out S0",
+          "category": "Config"
+        },
         {
           "id": "wcb.bcastReset",
           "name": "Reset Broadcast Settings",
@@ -435,6 +622,25 @@
           "commentLabel": "WCB map pwm out",
           "category": "Config"
         },
+        {
+          "id": "wcb.mapPwmClearOut",
+          "name": "Clear PWM Output Port (reboots)",
+          "safety": "power",
+          "encoder": "template",
+          "template": "?MAP,PWM,CLEAR,OUT,S{port}",
+          "params": [
+            {
+              "name": "port",
+              "enum": "wcb.port",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?MAP,PWM,CLEAR,OUT,S4"
+          ],
+          "commentLabel": "WCB map pwm clear out",
+          "category": "Config"
+        },
         {
           "id": "wcb.mapPwmList",
           "name": "List PWM Maps",
@@ -506,6 +712,30 @@
           "commentLabel": "WCB kyber local",
           "category": "Config"
         },
+        {
+          "id": "wcb.kyberLocalMaestros",
+          "name": "Kyber Local + Maestro Map",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?KYBER,LOCAL,S{port},{spec}",
+          "params": [
+            {
+              "name": "port",
+              "enum": "wcb.port",
+              "required": true
+            },
+            {
+              "name": "spec",
+              "pattern": "M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+(?:,M[0-9]:W[0-9]{1,2}S[0-9]:[0-9]+)*",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?KYBER,LOCAL,S2,M1:W1S1:57600,M2:W2S1:57600"
+          ],
+          "commentLabel": "WCB kyber local + maestros",
+          "category": "Config"
+        },
         {
           "id": "wcb.kyberRemote",
           "name": "Kyber Remote Mode",
@@ -592,6 +822,19 @@
           "commentLabel": "WCB maestro clear all",
           "category": "Config"
         },
+        {
+          "id": "wcb.maestroRemote",
+          "name": "Maestro Remote Mode",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?MAESTRO,REMOTE",
+          "params": [],
+          "examples": [
+            "?MAESTRO,REMOTE"
+          ],
+          "commentLabel": "WCB maestro remote",
+          "category": "Config"
+        },
         {
           "id": "wcb.maestro",
           "name": "Configure Maestro",
@@ -675,6 +918,40 @@
           "commentLabel": "WCB mp3 onerr",
           "category": "Config"
         },
+        {
+          "id": "wcb.mp3Remote",
+          "name": "Route MP3 to Host WCB (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?MP3,REMOTE,W{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?MP3,REMOTE,W2"
+          ],
+          "commentLabel": "WCB mp3 remote",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.mp3RemoteOff",
+          "name": "Stop Routing MP3 (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?MP3,REMOTE,OFF",
+          "params": [],
+          "examples": [
+            "?MP3,REMOTE,OFF"
+          ],
+          "commentLabel": "WCB mp3 remote off",
+          "category": "Config"
+        },
         {
           "id": "wcb.mp3Clear",
           "name": "Clear MP3 Config",
@@ -689,11 +966,11 @@
           "category": "Config"
         },
         {
-          "id": "wcb.hcrPort",
-          "name": "Set HCR Port",
+          "id": "wcb.dfpCfg",
+          "name": "Configure DFPlayer (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,PORT,S{port}:{baud}",
+          "template": "?DFP,S{port}:9600:V{vol}",
           "params": [
             {
               "name": "port",
@@ -701,124 +978,408 @@
               "required": true
             },
             {
-              "name": "baud",
-              "enum": "wcb.devBaud",
-              "required": true
+              "name": "vol",
+              "type": "int",
+              "min": 0,
+              "max": 30,
+              "required": true,
+              "default": 20
             }
           ],
           "examples": [
-            "?HCR,PORT,S1:9600"
+            "?DFP,S2:9600:V20"
           ],
-          "commentLabel": "WCB hcr port",
+          "commentLabel": "WCB dfp config",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrPoll",
-          "name": "Set HCR Poll Interval",
+          "id": "wcb.dfpPort",
+          "name": "Configure DFPlayer, default volume (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,POLL,{sec}",
+          "template": "?DFP,S{port}",
           "params": [
             {
-              "name": "sec",
-              "type": "int",
-              "min": 3,
-              "max": 3600,
+              "name": "port",
+              "enum": "wcb.port",
               "required": true
             }
           ],
           "examples": [
-            "?HCR,POLL,10"
+            "?DFP,S3"
           ],
-          "commentLabel": "WCB hcr poll",
+          "commentLabel": "WCB dfp port",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrList",
-          "name": "List HCR Config",
+          "id": "wcb.dfpList",
+          "name": "List DFPlayer Config (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,LIST",
+          "template": "?DFP,LIST",
           "params": [],
           "examples": [
-            "?HCR,LIST"
+            "?DFP,LIST"
           ],
-          "commentLabel": "WCB hcr list",
+          "commentLabel": "WCB dfp list",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrStatus",
-          "name": "HCR Status",
+          "id": "wcb.dfpClear",
+          "name": "Clear DFPlayer Config (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,STATUS",
+          "template": "?DFP,CLEAR",
           "params": [],
           "examples": [
-            "?HCR,STATUS"
+            "?DFP,CLEAR"
           ],
-          "commentLabel": "WCB hcr status",
+          "commentLabel": "WCB dfp clear",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrRefresh",
-          "name": "Refresh HCR",
+          "id": "wcb.dfpRemote",
+          "name": "Route DFPlayer to Host WCB (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,REFRESH",
+          "template": "?DFP,REMOTE,W{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?DFP,REMOTE,W3"
+          ],
+          "commentLabel": "WCB dfp remote",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.dfpRemoteOff",
+          "name": "Stop Routing DFPlayer (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?DFP,REMOTE,OFF",
           "params": [],
           "examples": [
-            "?HCR,REFRESH"
+            "?DFP,REMOTE,OFF"
           ],
-          "commentLabel": "WCB hcr refresh",
+          "commentLabel": "WCB dfp remote off",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrClear",
-          "name": "Clear HCR Config",
+          "id": "wcb.dfpOnErrClear",
+          "name": "Clear DFPlayer On-Error Sequence (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,CLEAR",
+          "template": "?DFP,ONERR,CLEAR",
           "params": [],
           "examples": [
-            "?HCR,CLEAR"
+            "?DFP,ONERR,CLEAR"
           ],
-          "commentLabel": "WCB hcr clear",
+          "commentLabel": "WCB dfp onerr clear",
           "category": "Config"
         },
         {
-          "id": "wcb.hcrGet",
-          "name": "Get HCR Field",
+          "id": "wcb.dfpOnErr",
+          "name": "Set DFPlayer On-Error Sequence (WCB 6.2+)",
           "safety": "config",
           "encoder": "template",
-          "template": "?HCR,GET,{field}",
+          "template": "?DFP,ONERR,{key}",
           "params": [
             {
-              "name": "field",
-              "enum": "wcb.hcrField",
+              "name": "key",
+              "pattern": "(?![Cc][Ll][Ee][Aa][Rr]$)[A-Za-z0-9_]{1,23}",
               "required": true
             }
           ],
           "examples": [
-            "?HCR,GET,WAVCOUNT"
+            "?DFP,ONERR,errseq"
           ],
-          "commentLabel": "WCB hcr get",
+          "commentLabel": "WCB dfp onerr",
           "category": "Config"
         },
         {
-          "id": "wcb.routeSerial",
-          "name": "Route to Serial Port",
+          "id": "wcb.hcrPort",
+          "name": "Set HCR Port",
           "safety": "config",
           "encoder": "template",
-          "template": ";S{port},{message}",
+          "template": "?HCR,PORT,S{port}:{baud}",
           "params": [
             {
               "name": "port",
-              "enum": "wcb.portUsb",
+              "enum": "wcb.port",
               "required": true
             },
             {
-              "name": "message",
-              "pattern": ".+",
+              "name": "baud",
+              "enum": "wcb.devBaud",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?HCR,PORT,S1:9600"
+          ],
+          "commentLabel": "WCB hcr port",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrPoll",
+          "name": "Set HCR Poll Interval",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,POLL,{sec}",
+          "params": [
+            {
+              "name": "sec",
+              "type": "int",
+              "min": 3,
+              "max": 3600,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?HCR,POLL,10"
+          ],
+          "commentLabel": "WCB hcr poll",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrPollOff",
+          "name": "HCR Polling Off",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,POLL,OFF",
+          "params": [],
+          "examples": [
+            "?HCR,POLL,OFF"
+          ],
+          "commentLabel": "WCB hcr poll off",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrRemote",
+          "name": "Route HCR to Host WCB (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,REMOTE,W{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?HCR,REMOTE,W2"
+          ],
+          "commentLabel": "WCB hcr remote",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrRemoteOff",
+          "name": "Stop Routing HCR (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,REMOTE,OFF",
+          "params": [],
+          "examples": [
+            "?HCR,REMOTE,OFF"
+          ],
+          "commentLabel": "WCB hcr remote off",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrList",
+          "name": "List HCR Config",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,LIST",
+          "params": [],
+          "examples": [
+            "?HCR,LIST"
+          ],
+          "commentLabel": "WCB hcr list",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrStatus",
+          "name": "HCR Status",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,STATUS",
+          "params": [],
+          "examples": [
+            "?HCR,STATUS"
+          ],
+          "commentLabel": "WCB hcr status",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrRefresh",
+          "name": "Refresh HCR",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,REFRESH",
+          "params": [],
+          "examples": [
+            "?HCR,REFRESH"
+          ],
+          "commentLabel": "WCB hcr refresh",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrClear",
+          "name": "Clear HCR Config",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,CLEAR",
+          "params": [],
+          "examples": [
+            "?HCR,CLEAR"
+          ],
+          "commentLabel": "WCB hcr clear",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.hcrGet",
+          "name": "Get HCR Field",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?HCR,GET,{field}",
+          "params": [
+            {
+              "name": "field",
+              "enum": "wcb.hcrField",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?HCR,GET,WAVCOUNT"
+          ],
+          "commentLabel": "WCB hcr get",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.wledCfg",
+          "name": "Configure WLED (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WLED,{id}:W{wcb}S{port}:{baud}",
+          "params": [
+            {
+              "name": "id",
+              "type": "int",
+              "min": 1,
+              "max": 9,
+              "required": true
+            },
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            },
+            {
+              "name": "port",
+              "enum": "wcb.port",
+              "required": true
+            },
+            {
+              "name": "baud",
+              "enum": "wcb.devBaud",
+              "required": true,
+              "default": "115200"
+            }
+          ],
+          "examples": [
+            "?WLED,1:W3S2:115200"
+          ],
+          "commentLabel": "WCB wled config",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.wledList",
+          "name": "List WLED Config (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WLED,LIST",
+          "params": [],
+          "examples": [
+            "?WLED,LIST"
+          ],
+          "commentLabel": "WCB wled list",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.wledStatus",
+          "name": "WLED Status (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WLED,STATUS",
+          "params": [],
+          "examples": [
+            "?WLED,STATUS"
+          ],
+          "commentLabel": "WCB wled status",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.wledClear",
+          "name": "Clear All WLED Config (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WLED,CLEAR",
+          "params": [],
+          "examples": [
+            "?WLED,CLEAR"
+          ],
+          "commentLabel": "WCB wled clear",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.wledClearId",
+          "name": "Clear One WLED (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WLED,CLEAR,{id}",
+          "params": [
+            {
+              "name": "id",
+              "type": "int",
+              "min": 1,
+              "max": 9,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WLED,CLEAR,1"
+          ],
+          "commentLabel": "WCB wled clear id",
+          "category": "Config"
+        },
+        {
+          "id": "wcb.routeSerial",
+          "name": "Route to Serial Port",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";S{port},{message}",
+          "params": [
+            {
+              "name": "port",
+              "enum": "wcb.portUsb",
+              "required": true
+            },
+            {
+              "name": "message",
+              "pattern": ".+",
               "required": true
             }
           ],
@@ -854,6 +1415,57 @@
           "commentLabel": "WCB route wcb",
           "category": "Routing"
         },
+        {
+          "id": "wcb.routeAlias",
+          "name": "Route to WCB by Alias (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";W{alias},{message}",
+          "params": [
+            {
+              "name": "alias",
+              "pattern": "[A-Za-z][^,;?]{0,23}",
+              "required": true
+            },
+            {
+              "name": "message",
+              "pattern": ".+",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";Wdome,;A,PLAY,1"
+          ],
+          "commentLabel": "WCB route alias",
+          "category": "Routing"
+        },
+        {
+          "id": "wcb.pwmPulse",
+          "name": "Output PWM Pulse",
+          "safety": "movement",
+          "encoder": "template",
+          "template": ";P{port}{width}",
+          "params": [
+            {
+              "name": "port",
+              "enum": "wcb.port",
+              "required": true
+            },
+            {
+              "name": "width",
+              "type": "int",
+              "min": 500,
+              "max": 2500,
+              "required": true,
+              "default": 1500
+            }
+          ],
+          "examples": [
+            ";P11500"
+          ],
+          "commentLabel": "WCB PWM pulse",
+          "category": "Movement"
+        },
         {
           "id": "wcb.timer",
           "name": "Delayed Command",
@@ -899,93 +1511,387 @@
             }
           ],
           "examples": [
-            "?SEQ,SAVE,wave,;A,PLAY,1"
+            "?SEQ,SAVE,wave,;A,PLAY,1"
+          ],
+          "commentLabel": "WCB seq save",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.seqNames",
+          "name": "List Sequence Names (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?SEQ,NAMES",
+          "params": [],
+          "examples": [
+            "?SEQ,NAMES"
+          ],
+          "commentLabel": "WCB seq names",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.seqGet",
+          "name": "Get One Sequence (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?SEQ,GET,{key}",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?SEQ,GET,wave"
+          ],
+          "commentLabel": "WCB seq get",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.seqList",
+          "name": "List Sequences",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?SEQ,LIST",
+          "params": [],
+          "examples": [
+            "?SEQ,LIST"
+          ],
+          "commentLabel": "WCB seq list",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.seqClearAll",
+          "name": "Clear All Sequences",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?SEQ,CLEAR,ALL",
+          "params": [],
+          "examples": [
+            "?SEQ,CLEAR,ALL"
+          ],
+          "commentLabel": "WCB seq clear all",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.seqClear",
+          "name": "Clear Sequence",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?SEQ,CLEAR,{key}",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?SEQ,CLEAR,wave"
+          ],
+          "commentLabel": "WCB seq clear",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.runSeq",
+          "name": "Run Sequence (short)",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";C{key}",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";Cwave"
+          ],
+          "commentLabel": "WCB run seq",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.runSeqLong",
+          "name": "Run Sequence (long)",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";SEQ{key}",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";SEQwave"
+          ],
+          "commentLabel": "WCB run seq (long)",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.runSeqLocal",
+          "name": "Run Sequence on This Board Only (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";C{key},L",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";Cwave,L"
+          ],
+          "commentLabel": "WCB run seq local",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.runSeqLongLocal",
+          "name": "Run Sequence on This Board Only, long (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": ";SEQ{key},L",
+          "params": [
+            {
+              "name": "key",
+              "pattern": "[A-Za-z0-9_]+",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";SEQwave,L"
+          ],
+          "commentLabel": "WCB run seq local (long)",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.timerStop",
+          "name": "Stop Running Timer Sequence",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?STOP",
+          "params": [],
+          "examples": [
+            "?STOP"
+          ],
+          "commentLabel": "WCB timer stop",
+          "category": "Sequences"
+        },
+        {
+          "id": "wcb.varSet",
+          "name": "Set Variable",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";{scope},{name},{value}",
+          "params": [
+            {
+              "name": "scope",
+              "enum": "wcb.varScope",
+              "required": true,
+              "default": "V"
+            },
+            {
+              "name": "name",
+              "pattern": "[A-Za-z0-9_]{1,15}",
+              "required": true
+            },
+            {
+              "name": "value",
+              "type": "int",
+              "min": -2147483648,
+              "max": 2147483647,
+              "required": true
+            }
+          ],
+          "examples": [
+            ";V,flag,1",
+            ";VP,mode,2"
+          ],
+          "commentLabel": "WCB var set",
+          "category": "Variables"
+        },
+        {
+          "id": "wcb.varOp",
+          "name": "Change Variable",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";{scope},{name},{op}",
+          "params": [
+            {
+              "name": "scope",
+              "enum": "wcb.varScope",
+              "required": true,
+              "default": "V"
+            },
+            {
+              "name": "name",
+              "pattern": "[A-Za-z0-9_]{1,15}",
+              "required": true
+            },
+            {
+              "name": "op",
+              "enum": "wcb.varOp",
+              "required": true
+            }
+          ],
+          "examples": [
+            ";V,armed,TOGGLE"
+          ],
+          "commentLabel": "WCB var op",
+          "category": "Variables"
+        },
+        {
+          "id": "wcb.varStep",
+          "name": "Increment/Decrement Variable by n",
+          "safety": "cosmetic",
+          "encoder": "template",
+          "template": ";{scope},{name},{dir},{n}",
+          "params": [
+            {
+              "name": "scope",
+              "enum": "wcb.varScope",
+              "required": true,
+              "default": "V"
+            },
+            {
+              "name": "name",
+              "pattern": "[A-Za-z0-9_]{1,15}",
+              "required": true
+            },
+            {
+              "name": "dir",
+              "enum": "wcb.varDir",
+              "required": true
+            },
+            {
+              "name": "n",
+              "type": "int",
+              "min": 1,
+              "max": 2147483647,
+              "required": true,
+              "default": 1
+            }
+          ],
+          "examples": [
+            ";V,volume,INC,5"
           ],
-          "commentLabel": "WCB seq save",
-          "category": "Sequences"
+          "commentLabel": "WCB var step",
+          "category": "Variables"
         },
         {
-          "id": "wcb.seqList",
-          "name": "List Sequences",
-          "safety": "config",
+          "id": "wcb.if",
+          "name": "IF Condition (gates the next step)",
+          "safety": "cosmetic",
           "encoder": "template",
-          "template": "?SEQ,LIST",
-          "params": [],
+          "template": "IF,{cond}",
+          "params": [
+            {
+              "name": "cond",
+              "pattern": "[A-Za-z0-9_]{1,15}(?:!=|<=|>=|=|<|>)-?[0-9]+(?:,(?:AND|OR|and|or),[A-Za-z0-9_]{1,15}(?:!=|<=|>=|=|<|>)-?[0-9]+)*",
+              "required": true
+            }
+          ],
           "examples": [
-            "?SEQ,LIST"
+            "IF,armed=1",
+            "IF,mode>2,AND,armed=1"
           ],
-          "commentLabel": "WCB seq list",
-          "category": "Sequences"
+          "commentLabel": "IF",
+          "category": "Variables"
         },
         {
-          "id": "wcb.seqClearAll",
-          "name": "Clear All Sequences",
+          "id": "wcb.varList",
+          "name": "List Variables",
           "safety": "config",
           "encoder": "template",
-          "template": "?SEQ,CLEAR,ALL",
+          "template": "?VAR,LIST",
           "params": [],
           "examples": [
-            "?SEQ,CLEAR,ALL"
+            "?VAR,LIST"
           ],
-          "commentLabel": "WCB seq clear all",
-          "category": "Sequences"
+          "commentLabel": "WCB var list",
+          "category": "Variables"
         },
         {
-          "id": "wcb.seqClear",
-          "name": "Clear Sequence",
+          "id": "wcb.varSetNvs",
+          "name": "Create/Set Persistent Variable",
           "safety": "config",
           "encoder": "template",
-          "template": "?SEQ,CLEAR,{key}",
+          "template": "?VAR,SET,{name},{value}",
           "params": [
             {
-              "name": "key",
-              "pattern": "[A-Za-z0-9_]+",
+              "name": "name",
+              "pattern": "[A-Za-z0-9_]{1,15}",
+              "required": true
+            },
+            {
+              "name": "value",
+              "type": "int",
+              "min": -2147483648,
+              "max": 2147483647,
               "required": true
             }
           ],
           "examples": [
-            "?SEQ,CLEAR,wave"
+            "?VAR,SET,mode,2"
           ],
-          "commentLabel": "WCB seq clear",
-          "category": "Sequences"
+          "commentLabel": "WCB var set nvs",
+          "category": "Variables"
         },
         {
-          "id": "wcb.runSeq",
-          "name": "Run Sequence (short)",
+          "id": "wcb.varGet",
+          "name": "Show Variable",
           "safety": "config",
           "encoder": "template",
-          "template": ";C{key}",
+          "template": "?VAR,GET,{name}",
           "params": [
             {
-              "name": "key",
-              "pattern": "[A-Za-z0-9_]+",
+              "name": "name",
+              "pattern": "[A-Za-z0-9_]{1,15}",
               "required": true
             }
           ],
           "examples": [
-            ";Cwave"
+            "?VAR,GET,mode"
           ],
-          "commentLabel": "WCB run seq",
-          "category": "Sequences"
+          "commentLabel": "WCB var get",
+          "category": "Variables"
         },
         {
-          "id": "wcb.runSeqLong",
-          "name": "Run Sequence (long)",
+          "id": "wcb.varClearAll",
+          "name": "Delete All Variables",
           "safety": "config",
           "encoder": "template",
-          "template": ";SEQ{key}",
+          "template": "?VAR,CLEAR,ALL",
+          "params": [],
+          "examples": [
+            "?VAR,CLEAR,ALL"
+          ],
+          "commentLabel": "WCB var clear all",
+          "category": "Variables"
+        },
+        {
+          "id": "wcb.varClear",
+          "name": "Delete Variable",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?VAR,CLEAR,{name}",
           "params": [
             {
-              "name": "key",
-              "pattern": "[A-Za-z0-9_]+",
+              "name": "name",
+              "pattern": "(?![Aa][Ll][Ll]$)[A-Za-z0-9_]{1,15}",
               "required": true
             }
           ],
           "examples": [
-            ";SEQwave"
+            "?VAR,CLEAR,mode"
           ],
-          "commentLabel": "WCB run seq (long)",
-          "category": "Sequences"
+          "commentLabel": "WCB var clear",
+          "category": "Variables"
         },
         {
           "id": "wcb.etmOn",
@@ -1266,6 +2172,294 @@
           "commentLabel": "WCB debug hcr",
           "category": "System"
         },
+        {
+          "id": "wcb.debugMgmt",
+          "name": "Debug MGMT",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?DEBUG,MGMT,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?DEBUG,MGMT,ON"
+          ],
+          "commentLabel": "WCB debug mgmt",
+          "category": "System"
+        },
+        {
+          "id": "wcb.debugRaw",
+          "name": "Debug Raw Serial",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?DEBUG,RAW,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?DEBUG,RAW,ON"
+          ],
+          "commentLabel": "WCB debug raw",
+          "category": "System"
+        },
+        {
+          "id": "wcb.track",
+          "name": "Delivery Tracking On/Off",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?TRACK,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?TRACK,ON"
+          ],
+          "commentLabel": "WCB track",
+          "category": "System"
+        },
+        {
+          "id": "wcb.trackStatus",
+          "name": "Delivery Tracking Status",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?TRACK,STATUS",
+          "params": [],
+          "examples": [
+            "?TRACK,STATUS"
+          ],
+          "commentLabel": "WCB track status",
+          "category": "System"
+        },
+        {
+          "id": "wcb.version",
+          "name": "Show Firmware Version",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?VERSION",
+          "params": [],
+          "examples": [
+            "?VERSION"
+          ],
+          "commentLabel": "WCB version",
+          "category": "System"
+        },
+        {
+          "id": "wcb.peersLive",
+          "name": "Live Peer Count (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?PEERSLIVE",
+          "params": [],
+          "examples": [
+            "?PEERSLIVE"
+          ],
+          "commentLabel": "WCB peers live",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpList",
+          "name": "WDP Neighbor Table (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,LIST",
+          "params": [],
+          "examples": [
+            "?WDP,LIST"
+          ],
+          "commentLabel": "WCB wdp list",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpDetail",
+          "name": "WDP Neighbor Detail (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WDP,3"
+          ],
+          "commentLabel": "WCB wdp detail",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpStatus",
+          "name": "WDP Status (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,STATUS",
+          "params": [],
+          "examples": [
+            "?WDP,STATUS"
+          ],
+          "commentLabel": "WCB wdp status",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpDump",
+          "name": "WDP Dump (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,DUMP",
+          "params": [],
+          "examples": [
+            "?WDP,DUMP"
+          ],
+          "commentLabel": "WCB wdp dump",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpDa",
+          "name": "WDP Serial-Attached Devices (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,DA",
+          "params": [],
+          "examples": [
+            "?WDP,DA"
+          ],
+          "commentLabel": "WCB wdp da",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpPoll",
+          "name": "WDP Poll Mesh (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,POLL",
+          "params": [],
+          "examples": [
+            "?WDP,POLL"
+          ],
+          "commentLabel": "WCB wdp poll",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpEnable",
+          "name": "WDP On/Off (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WDP,ON"
+          ],
+          "commentLabel": "WCB wdp enable",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpAutojoin",
+          "name": "WDP Auto-Join State (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,AUTOJOIN",
+          "params": [],
+          "examples": [
+            "?WDP,AUTOJOIN"
+          ],
+          "commentLabel": "WCB wdp autojoin",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpAutojoinSet",
+          "name": "WDP Auto-Join On/Off (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,AUTOJOIN,{state}",
+          "params": [
+            {
+              "name": "state",
+              "enum": "wcb.onOff",
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WDP,AUTOJOIN,OFF"
+          ],
+          "commentLabel": "WCB wdp autojoin set",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpAdd",
+          "name": "WDP Add Peer (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,ADD,{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WDP,ADD,12"
+          ],
+          "commentLabel": "WCB wdp add",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpForget",
+          "name": "WDP Forget Peer (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,FORGET,{wcb}",
+          "params": [
+            {
+              "name": "wcb",
+              "type": "int",
+              "min": 1,
+              "max": 20,
+              "required": true
+            }
+          ],
+          "examples": [
+            "?WDP,FORGET,12"
+          ],
+          "commentLabel": "WCB wdp forget",
+          "category": "System"
+        },
+        {
+          "id": "wcb.wdpClear",
+          "name": "WDP Clear Learned Peers (WCB 6.2+)",
+          "safety": "config",
+          "encoder": "template",
+          "template": "?WDP,CLEAR",
+          "params": [],
+          "examples": [
+            "?WDP,CLEAR"
+          ],
+          "commentLabel": "WCB wdp clear",
+          "category": "System"
+        },
         {
           "id": "wcb.stats",
           "name": "Show Stats",
@@ -1402,7 +2596,7 @@
           "category": "Power"
         }
       ],
-      "categories": ["Setup", "Config", "Routing", "Sequences", "System", "Power"]
+      "categories": ["Setup", "Config", "Routing", "Movement", "Sequences", "Variables", "System", "Power"]
     }
   ]
 }
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index 89ceb5b..e474088 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -438,3 +438,152 @@ describe('wcb-native: WCB 6.2.1 ranges and grammar', () => {
     roundTrips('?MAP,PWM,S1,S2,W20S5');
   });
 });
+
+describe('wcb-native: 66 commands for WCB 6.2.1 (and missed 6.1.5 surface)', () => {
+  let cb;
+  beforeEach(() => {
+    cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+  const hit = (wire) => { const m = cb.match(wire); return m && m.commandId; };
+
+  // Present in WCB 6.1.5 already (6.1.5 WCB.ino / WCB_Variables.cpp), so no firmware suffix.
+  const SINCE_615 = [
+    'wcb.aliasClear', 'wcb.aliasList', 'wcb.alias', 'wcb.ledPin', 'wcb.ledPinQuery', 'wcb.identify',
+    'wcb.mapPwmClearOut', 'wcb.kyberLocalMaestros', 'wcb.maestroRemote', 'wcb.hcrPollOff', 'wcb.pwmPulse',
+    'wcb.timerStop', 'wcb.varSet', 'wcb.varOp', 'wcb.varStep', 'wcb.if', 'wcb.varList', 'wcb.varSetNvs',
+    'wcb.varGet', 'wcb.varClearAll', 'wcb.varClear', 'wcb.debugMgmt', 'wcb.debugRaw', 'wcb.track',
+    'wcb.trackStatus', 'wcb.version',
+  ];
+  // Absent from 6.1.5; "(WCB 6.2+)" in the name is the only place the composer shows it.
+  const NEW_IN_62 = [
+    'wcb.meshChannel', 'wcb.controllerOn', 'wcb.controllerOnId', 'wcb.controllerOff', 'wcb.bcastOutUsb',
+    'wcb.mp3Remote', 'wcb.mp3RemoteOff', 'wcb.dfpCfg', 'wcb.dfpPort', 'wcb.dfpList', 'wcb.dfpClear',
+    'wcb.dfpRemote', 'wcb.dfpRemoteOff', 'wcb.dfpOnErrClear', 'wcb.dfpOnErr', 'wcb.hcrRemote',
+    'wcb.hcrRemoteOff', 'wcb.wledCfg', 'wcb.wledList', 'wcb.wledStatus', 'wcb.wledClear', 'wcb.wledClearId',
+    'wcb.routeAlias', 'wcb.seqNames', 'wcb.seqGet', 'wcb.runSeqLocal', 'wcb.runSeqLongLocal', 'wcb.peersLive',
+    'wcb.wdpList', 'wcb.wdpDetail', 'wcb.wdpStatus', 'wcb.wdpDump', 'wcb.wdpDa', 'wcb.wdpPoll', 'wcb.wdpEnable',
+    'wcb.wdpAutojoin', 'wcb.wdpAutojoinSet', 'wcb.wdpAdd', 'wcb.wdpForget', 'wcb.wdpClear',
+  ];
+
+  test('adds exactly the 66 new ids, on wcb-native', () => {
+    const added = cb.getCommands('wcb-native').map(c => c.id).filter(id => !FROZEN_420[id]);
+    expect(added.length).toBe(66);
+    expect([...added].sort()).toEqual([...SINCE_615, ...NEW_IN_62].sort());
+  });
+
+  test('firmware requirement is in the name: 6.2-only commands say "(WCB 6.2+)", 6.1.5 ones do not', () => {
+    for (const id of NEW_IN_62) expect(cb.getCommand(id).name).toMatch(/ \(WCB 6\.2\+\)$/);
+    for (const id of SINCE_615) expect(cb.getCommand(id).name).not.toMatch(/6\.2/);
+  });
+
+  test('safety: ;P moves hardware, ?MAP,PWM,CLEAR,OUT reboots, ?IDENTIFY only blinks', () => {
+    expect(cb.getCommand('wcb.pwmPulse').safety).toBe('movement');
+    expect(cb.getCommand('wcb.mapPwmClearOut').safety).toBe('power');
+    expect(cb.getCommand('wcb.identify').safety).toBe('cosmetic');
+  });
+
+  test('literal verbs win over their catch-alls (first match wins)', () => {
+    expect(hit('?ALIAS,CLEAR')).toBe('wcb.aliasClear');
+    expect(hit('?ALIAS,LIST')).toBe('wcb.aliasList');
+    expect(cb.match('?ALIAS,Dome Left')).toEqual({ commandId: 'wcb.alias', params: { name: 'Dome Left' } });
+    expect(hit('?VAR,CLEAR,ALL')).toBe('wcb.varClearAll');
+    expect(cb.match('?VAR,CLEAR,mode')).toEqual({ commandId: 'wcb.varClear', params: { name: 'mode' } });
+    expect(hit('?DFP,ONERR,CLEAR')).toBe('wcb.dfpOnErrClear');
+    expect(cb.match('?DFP,ONERR,errseq')).toEqual({ commandId: 'wcb.dfpOnErr', params: { key: 'errseq' } });
+    expect(hit('?MAESTRO,REMOTE')).toBe('wcb.maestroRemote');
+    expect(hit('?MAESTRO,M1:W2S1:57600')).toBe('wcb.maestro');
+  });
+
+  test('firmware compares CLEAR / LIST / ALL case-insensitively, so any-case spellings stay raw', () => {
+    // WCB.ino:5375-5378 (?ALIAS), WCB_DFP.cpp:189 (?DFP,ONERR), WCB_Variables.cpp:328 (?VAR,CLEAR)
+    expect(cb.match('?ALIAS,clear')).toBeNull();
+    expect(cb.match('?ALIAS,List')).toBeNull();
+    expect(cb.match('?DFP,ONERR,clear')).toBeNull();
+    expect(cb.match('?VAR,CLEAR,all')).toBeNull();
+    expect(cb.parseWCBValue('?ALIAS,clear')[0]).toMatchObject({ type: 'raw' });
+  });
+
+  test(';W routes by alias (letter first) or by board number (digits)', () => {
+    expect(cb.match(';Wdome,;A,PLAY,1')).toEqual({ commandId: 'wcb.routeAlias', params: { alias: 'dome', message: ';A,PLAY,1' } });
+    expect(cb.match(';W2,;A,PLAY,1')).toEqual({ commandId: 'wcb.routeWcb', params: { wcb: '2', message: ';A,PLAY,1' } });
+    expect(hit(';W12,;A,PLAY,1')).toBe('wcb.routeWcb');
+  });
+
+  test(';C<key>,L / ;SEQ<key>,L run locally; the bare forms stay mesh-wide', () => {
+    expect(cb.match(';Cwave,L')).toEqual({ commandId: 'wcb.runSeqLocal', params: { key: 'wave' } });
+    expect(cb.match(';Cwave')).toEqual({ commandId: 'wcb.runSeq', params: { key: 'wave' } });
+    expect(cb.match(';SEQwave,L')).toEqual({ commandId: 'wcb.runSeqLongLocal', params: { key: 'wave' } });
+    expect(hit(';SEQwave')).toBe('wcb.runSeqLong');
+    expect(hit('?STOP')).toBe('wcb.timerStop');
+  });
+
+  test(';P reads one port digit then the pulse width', () => {
+    expect(cb.match(';P11500')).toEqual({ commandId: 'wcb.pwmPulse', params: { port: '1', width: '1500' } });
+    expect(cb.match(';P52500')).toEqual({ commandId: 'wcb.pwmPulse', params: { port: '5', width: '2500' } });
+    expect(cb.match(';P61500')).toBeNull();
+  });
+
+  test('variables: ;V / ;VP set, verb, and step forms; IF conditions', () => {
+    expect(cb.match(';V,flag,1')).toEqual({ commandId: 'wcb.varSet', params: { scope: 'V', name: 'flag', value: '1' } });
+    expect(cb.match(';VP,mode,-2')).toEqual({ commandId: 'wcb.varSet', params: { scope: 'VP', name: 'mode', value: '-2' } });
+    expect(cb.match(';V,armed,TOGGLE')).toEqual({ commandId: 'wcb.varOp', params: { scope: 'V', name: 'armed', op: 'TOGGLE' } });
+    expect(hit(';VP,armed,INC')).toBe('wcb.varOp');
+    expect(cb.match(';V,volume,INC,5')).toEqual({ commandId: 'wcb.varStep', params: { scope: 'V', name: 'volume', dir: 'INC', n: '5' } });
+    expect(cb.match(';V,this_name_is_too_long,1')).toBeNull();
+    expect(cb.match('IF,mode>2,AND,armed=1')).toEqual({ commandId: 'wcb.if', params: { cond: 'mode>2,AND,armed=1' } });
+    for (const c of ['a=1', 'a!=1', 'a<=-3', 'a>=3', 'a<3', 'a>3', 'a=1,OR,b=0,and,c>2']) expect(hit('IF,' + c)).toBe('wcb.if');
+    expect(cb.match('IF,armed')).toBeNull();
+    expect(cb.match('IF,armed=1,AND')).toBeNull();
+    expect(hit('?VAR,SET,mode,2')).toBe('wcb.varSetNvs');
+    expect(hit('?VAR,GET,mode')).toBe('wcb.varGet');
+  });
+
+  test('device routing and config verbs', () => {
+    expect(cb.match('?WLED,1:W3S2:115200')).toEqual({ commandId: 'wcb.wledCfg', params: { id: '1', wcb: '3', port: '2', baud: '115200' } });
+    expect(cb.match('?WLED,1:W3S0:115200')).toBeNull();   // a WLED port is S1-S5 (WCB_WLED.cpp:311)
+    expect(hit('?WLED,CLEAR')).toBe('wcb.wledClear');
+    expect(hit('?WLED,CLEAR,2')).toBe('wcb.wledClearId');
+    expect(cb.match('?DFP,S2:9600:V20')).toEqual({ commandId: 'wcb.dfpCfg', params: { port: '2', vol: '20' } });
+    expect(hit('?DFP,S3')).toBe('wcb.dfpPort');
+    expect(hit('?DFP,REMOTE,W3')).toBe('wcb.dfpRemote');
+    expect(hit('?MP3,REMOTE,W2')).toBe('wcb.mp3Remote');
+    expect(hit('?MP3,REMOTE,OFF')).toBe('wcb.mp3RemoteOff');
+    expect(hit('?HCR,REMOTE,W2')).toBe('wcb.hcrRemote');
+    expect(hit('?HCR,POLL,OFF')).toBe('wcb.hcrPollOff');
+    expect(hit('?HCR,POLL,10')).toBe('wcb.hcrPoll');
+    expect(hit('?BCAST,OUT,S0,ON')).toBe('wcb.bcastOutUsb');
+    expect(hit('?BCAST,OUT,S2,OFF')).toBe('wcb.bcastOut');
+    expect(hit('?MAP,PWM,CLEAR,OUT,S4')).toBe('wcb.mapPwmClearOut');
+    expect(hit('?MAP,PWM,CLEAR,S4')).toBe('wcb.mapPwmClear');
+    expect(cb.match('?KYBER,LOCAL,S2,M1:W1S1:57600,M2:W2S1:57600')).toEqual({
+      commandId: 'wcb.kyberLocalMaestros', params: { port: '2', spec: 'M1:W1S1:57600,M2:W2S1:57600' } });
+    expect(hit('?KYBER,LOCAL')).toBe('wcb.kyberLocal');
+  });
+
+  test('setup and system verbs with optional arguments', () => {
+    expect(hit('?CONTROLLER,ON')).toBe('wcb.controllerOn');
+    expect(cb.match('?CONTROLLER,ON,19')).toEqual({ commandId: 'wcb.controllerOnId', params: { id: '19' } });
+    expect(hit('?LED,PIN')).toBe('wcb.ledPinQuery');
+    expect(hit('?LED,PIN,48')).toBe('wcb.ledPin');
+    expect(hit('?WCBCH,11')).toBe('wcb.meshChannel');
+    expect(hit('?TRACK,STATUS')).toBe('wcb.trackStatus');
+    expect(hit('?TRACK,OFF')).toBe('wcb.track');
+    expect(hit('?DEBUG,MGMT,ON')).toBe('wcb.debugMgmt');
+    expect(hit('?DEBUG,RAW,OFF')).toBe('wcb.debugRaw');
+    expect(hit('?DEBUG,ON')).toBe('wcb.debug');
+    expect(hit('?WDP,3')).toBe('wcb.wdpDetail');
+    expect(hit('?WDP,ON')).toBe('wcb.wdpEnable');
+    expect(hit('?WDP,AUTOJOIN')).toBe('wcb.wdpAutojoin');
+    expect(hit('?WDP,AUTOJOIN,ON')).toBe('wcb.wdpAutojoinSet');
+    expect(hit('?WDP,FORGET,12')).toBe('wcb.wdpForget');
+    expect(hit('?SEQ,NAMES')).toBe('wcb.seqNames');
+    expect(hit('?SEQ,GET,wave')).toBe('wcb.seqGet');
+  });
+
+  test('every new example round-trips byte-identical', () => {
+    const added = cb.getCommands('wcb-native').filter(c => !FROZEN_420[c.id]);
+    for (const cmd of added) for (const ex of cmd.examples) expect(cb.buildWCBValue(cb.parseWCBValue(ex))).toBe(ex);
+  });
+});

From fc4035c7f43771d0b46f31ed697a337fdb38cc0c Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:30:21 -0400
Subject: [PATCH 10/17] docs(maestro-native): not a WCB grammar
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

routing.notes only (D3); no command, range or category change.

The board is the bare Pololu action grammar NaviCore and local controllers
use. Re-read WCB 6.2.1 WCB.ino:4868-4880: handleSingleCommand sends any line
without the ? or ; prefix to processBroadcastCommand as-is, so a WCB never
translates setTarget,… / goHome into Pololu frames. The notes point WCB
users at the maestro board (;M{id},…) and record that WcbCmd's WcbMaestro
omits restartScript, setSpeedAccel and setEasing (WcbMaestro.h:48-51).

Test: maestro-native notes say a WCB does not translate it and name the
;M{id}, forms.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 libraries/boards/maestro-native.json |  3 ++-
 test/wcb-621.test.js                 | 13 +++++++++++++
 2 files changed, 15 insertions(+), 1 deletion(-)

diff --git a/libraries/boards/maestro-native.json b/libraries/boards/maestro-native.json
index 72d008b..8a3699c 100644
--- a/libraries/boards/maestro-native.json
+++ b/libraries/boards/maestro-native.json
@@ -12,7 +12,8 @@
         "nativeWrapper": "none",
         "durationSuffix": {
           "supported": false
-        }
+        },
+        "notes": "Bare Pololu action grammar used by NaviCore and local controllers; a WCB does not translate it (WCB 6.2.1 broadcasts unprefixed text as-is, WCB.ino handleSingleCommand -> processBroadcastCommand). For a WCB use the maestro board (;M{id},…). WcbCmd's WcbMaestro omits restartScript, setSpeedAccel and setEasing (WcbMaestro.h:48-51)."
       },
       "commands": [
         {
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index e474088..b5a167e 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -185,6 +185,19 @@ describe('maestro: WCB 6.2 comma verbs and get queries', () => {
   });
 });
 
+// maestro-native (A10): routing.notes only (D3). The bare Pololu action grammar is not a WCB grammar;
+// the notes steer WCB users to the maestro board's ;M{id}, forms.
+describe('maestro-native: not a WCB grammar', () => {
+  test('notes say a WCB does not translate it and point at the maestro board', () => {
+    const cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+    const comp = cb.getComponents().find(c => c.id === 'maestro-native');
+    expect(comp.routing.notes).toMatch(/a WCB does not translate it/);
+    expect(comp.routing.notes).toMatch(/;M\{id\},/);
+  });
+});
+
 // ---- wcb-dfp: DFPlayer Mini ;D verbs (WCB 6.2+) --------------------------------------------
 // Grammar and ranges: WcbCmd 0.8.0 DfPlayerCodec::handle (WcbDfPlayer.cpp:51-168), which WCB
 // 6.2.1 links; dispatch WCB_DFP.cpp:69-91; host routing WCB.ino:6426-6428; help WCB_Help.cpp:566-593.

From 3ef1a3c4087b2177e5e22fdec3981da733a75864 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:28:14 -0400
Subject: [PATCH 11/17] fix(flthy-hps): sequence codes per FlthyHPs v1.81
 firmware

2.3.0 (b38b5d2) took the LED sequence numbers from the FlthyHPs Manual v1.8
command table, which is the order of the v1.3-v1.5 sketches. Every sketch from
v1.6 on, including v1.81 (FlthyHPs_v1.8.ino:932-934) and the author's v2.1
(FlthyHPs_v2.1.ino:440-442), dispatches 5 = solid, 6 = rainbow and
7 = short circuit, and accepts the X/Y/Z designators (v1.81 :791-797, :813-818).

- flthy.led.solid        {designator}006{color} -> {designator}005{color}
- flthy.led.rainbow      {designator}007        -> {designator}006
- flthy.led.shortcircuit {designator}005{color} -> {designator}007{color}
- flthy.designator regains X (Front & Rear), Y (Front & Top), Z (Rear & Top)
- examples follow the author's manual (R0053 solid green, T006, A006|45);
  firmware field now names the v1.6+ numbering

Ids and param names are unchanged. The 4.2.0 freeze test allowlists exactly
these three template changes, pinning both templates and the reason, and new
assertions cover the codes and designators. Tests, the sample fixture, the
README quick start, the integration guide, the Node example and the schema
durationSuffix example move to the firmware codes. The 2026-07-06 FlthyHPs spec
gets a note that decisions 1 and 2 are superseded (servo codes stand).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 README.md                                     |  6 +-
 docs/INTEGRATION_GUIDE.md                     | 10 ++--
 ...flthy-hps-full-command-reference-design.md | 13 +++++
 examples/node-example.js                      |  6 +-
 libraries/boards/flthy-hps.json               | 35 ++++++++----
 schema/library.schema.json                    |  2 +-
 test/engine.test.js                           | 18 +++---
 test/fixtures/commands.sample.json            |  2 +-
 test/load-node.test.js                        |  2 +-
 test/wcb-621.test.js                          | 55 ++++++++++++++++++-
 10 files changed, 114 insertions(+), 35 deletions(-)

diff --git a/README.md b/README.md
index 447bdba..8e445c0 100644
--- a/README.md
+++ b/README.md
@@ -51,7 +51,7 @@ validates — not a code change.
         DroidNetCommandLibrary.loadLibrary(boards, { libraryVersion: m.libraryVersion });
         DroidNetCommandLibraryUI.renderComposer(
           document.getElementById('host'),
-          'A007^*** Flthy Rainbow',
+          'A006^*** Flthy Rainbow',
           { onChange: (wire) => console.log(wire) }
         );
       }));
@@ -65,8 +65,8 @@ const DroidNetCommandLibrary = require('droidnet-command-library');
 require('droidnet-command-library/node-loader').loadCatalog(); // reads manifest + boards, merges, loads
 
 const solid = DroidNetCommandLibrary.getCommand('flthy.led.solid');
-DroidNetCommandLibrary.encode(solid, { designator: 'A', color: '5' }, {}); // 'A0065'
-DroidNetCommandLibrary.match('A0065'); // { commandId: 'flthy.led.solid', params: {...} }
+DroidNetCommandLibrary.encode(solid, { designator: 'A', color: '5' }, {}); // 'A0055'
+DroidNetCommandLibrary.match('A0055'); // { commandId: 'flthy.led.solid', params: {...} }
 ```
 
 See **[docs/INTEGRATION_GUIDE.md](docs/INTEGRATION_GUIDE.md)** for the full API.
diff --git a/docs/INTEGRATION_GUIDE.md b/docs/INTEGRATION_GUIDE.md
index 0988f5a..e2591d7 100644
--- a/docs/INTEGRATION_GUIDE.md
+++ b/docs/INTEGRATION_GUIDE.md
@@ -74,9 +74,9 @@ exactly what an "Update Library" button does after downloading a newer set of fi
 
 ```js
 const cmd = DroidNetCommandLibrary.getCommand('flthy.led.solid');
-DroidNetCommandLibrary.encode(cmd, { designator: 'A', color: '5' }, {});       // 'A0065'
-DroidNetCommandLibrary.encode(cmd, { designator: 'A' }, { duration: 60 });     // 'A0065|60'  (default color, duration)
-DroidNetCommandLibrary.match('A0065');  // { commandId: 'flthy.led.solid', params: { designator:'A', color:'5' }, duration: undefined }
+DroidNetCommandLibrary.encode(cmd, { designator: 'A', color: '5' }, {});       // 'A0055'
+DroidNetCommandLibrary.encode(cmd, { designator: 'A' }, { duration: 60 });     // 'A0055|60'  (default color, duration)
+DroidNetCommandLibrary.match('A0055');  // { commandId: 'flthy.led.solid', params: { designator:'A', color:'5' }, duration: undefined }
 ```
 
 ## The wire format
@@ -91,7 +91,7 @@ DroidNetCommandLibrary.match('A0065');  // { commandId: 'flthy.led.solid', param
   so unknown tokens round-trip without loss.
 
 ```text
-A007^*** Flthy rainbow^;t500^T52
+A006^*** Flthy rainbow^;t500^T52
 └ cmd ┘└── label ──┘└delay┘└cmd┘
 ```
 
@@ -120,7 +120,7 @@ engine being loaded first.
         DroidNetCommandLibrary.loadLibrary(boards, { libraryVersion: m.libraryVersion });
         DroidNetCommandLibraryUI.renderComposer(
           document.getElementById('host'),
-          'A007^*** Flthy Rainbow',           // initial wire value (or '' for empty)
+          'A006^*** Flthy Rainbow',           // initial wire value (or '' for empty)
           {
             onChange: (wireValue) => {
               // fired on every edit — persist or mirror it
diff --git a/docs/superpowers/specs/2026-07-06-flthy-hps-full-command-reference-design.md b/docs/superpowers/specs/2026-07-06-flthy-hps-full-command-reference-design.md
index 4d6ee9f..34cc346 100644
--- a/docs/superpowers/specs/2026-07-06-flthy-hps-full-command-reference-design.md
+++ b/docs/superpowers/specs/2026-07-06-flthy-hps-full-command-reference-design.md
@@ -4,6 +4,19 @@
 **Board:** `libraries/boards/flthy-hps.json`
 **Source of truth:** [FlthyHPs Manual v1.8](https://www.printed-droid.com/wp-content/uploads/2020/01/FlthyHPsManual_v1.8.pdf), "I2C/Serial Command Structure" (pp. 22–24)
 
+> **Superseded in part by 4.3.0 (2026-09-15).** Decisions 1 and 2 below are reversed, and the
+> "Problem" section's diagnosis is wrong. The manual's command table (05 Short Circuit, 06 Solid,
+> 07 Rainbow; examples `R0063`, `T007`) is the numbering of the v1.3-v1.5 sketches. From v1.6 on,
+> every sketch dispatches `005` solid, `006` rainbow and `007` short circuit, and accepts the
+> `X`/`Y`/`Z` designators. That includes v1.81, the last v1 sketch (`FlthyHPs_v1.8.ino`: designators
+> `:791-797`, dispatch `:932-934`), and the author's current v2.1. 4.3.0 therefore sets
+> `flthy.led.solid` to `{designator}005{color}`, `flthy.led.rainbow` to `{designator}006` and
+> `flthy.led.shortcircuit` to `{designator}007{color}`, and restores X (Front & Rear), Y (Front & Top)
+> and Z (Rear & Top). The ids and param names do not change. Decision 3 (servo codes follow the
+> table) stands; it matches the v1.81 servo dispatch (`FlthyHPs_v1.8.ino:956-961`). Sources and
+> line references: `2026-09-15-wcb-firmware-6.2.1-sweep-design.md`, "FlthyHPs sequence codes".
+> The tables below record the 2.3.0 design as it shipped.
+
 ## Problem
 
 The `flthy-hps` board implements only 2 of the manual's ~20 device commands, and **both are mis-encoded** (off by one sequence number):
diff --git a/examples/node-example.js b/examples/node-example.js
index e49518c..df9dd61 100644
--- a/examples/node-example.js
+++ b/examples/node-example.js
@@ -19,7 +19,7 @@ const macro = DroidNetCommandLibrary.buildWCBValue([
   { type: 'command', commandId: 'iamp.mode', params: { mode: '52' }, label: ' MP VU meter' },
 ]);
 console.log('built :', macro);
-// built : A007^*** Flthy rainbow^;t500^T52^*** MP VU meter
+// built : A006^*** Flthy rainbow^;t500^T52^*** MP VU meter
 
 // 2) Parse a wire string back into steps (round-trips byte-identically).
 const steps = DroidNetCommandLibrary.parseWCBValue(macro);
@@ -27,7 +27,7 @@ console.log('steps :', JSON.stringify(steps.map(s => ({ type: s.type, id: s.comm
 
 // 3) Encode a single command directly.
 const solid = DroidNetCommandLibrary.getCommand('flthy.led.solid');
-console.log('solid :', DroidNetCommandLibrary.encode(solid, { designator: 'F', color: '1' }, {})); // F0061
+console.log('solid :', DroidNetCommandLibrary.encode(solid, { designator: 'F', color: '1' }, {})); // F0051
 
 // 4) Recognize an unknown-but-well-formed token.
-console.log('match :', DroidNetCommandLibrary.match('A0065'));
+console.log('match :', DroidNetCommandLibrary.match('A0055'));
diff --git a/libraries/boards/flthy-hps.json b/libraries/boards/flthy-hps.json
index 15805e8..8a92bdc 100644
--- a/libraries/boards/flthy-hps.json
+++ b/libraries/boards/flthy-hps.json
@@ -16,6 +16,18 @@
           "code": "T",
           "label": "Top"
         },
+        {
+          "code": "X",
+          "label": "Front & Rear"
+        },
+        {
+          "code": "Y",
+          "label": "Front & Top"
+        },
+        {
+          "code": "Z",
+          "label": "Rear & Top"
+        },
         {
           "code": "A",
           "label": "All"
@@ -190,7 +202,7 @@
       "name": "FlthyHPs Holoprojectors",
       "kind": "device-native",
       "confidence": "high",
-      "firmware": "v1.8",
+      "firmware": "v1.6+ (checked against v1.81 and v2.1 source)",
       "routing": {
         "class": "broadcast",
         "nativeWrapper": "none",
@@ -314,7 +326,7 @@
           "name": "Short Circuit",
           "safety": "cosmetic",
           "encoder": "template",
-          "template": "{designator}005{color}",
+          "template": "{designator}007{color}",
           "params": [
             {
               "name": "designator",
@@ -329,8 +341,8 @@
           ],
           "supportsDuration": true,
           "examples": [
-            "A0057",
-            "F0055|10"
+            "A0077",
+            "F0075|10"
           ],
           "commentLabel": "Flthy short circuit",
           "category": "Lighting"
@@ -367,7 +379,7 @@
           "name": "Solid Color",
           "safety": "cosmetic",
           "encoder": "template",
-          "template": "{designator}006{color}",
+          "template": "{designator}005{color}",
           "params": [
             {
               "name": "designator",
@@ -382,9 +394,10 @@
           ],
           "supportsDuration": true,
           "examples": [
-            "A0065",
-            "R0063",
-            "A0065|60"
+            "A0055",
+            "R0053",
+            "A0055|60",
+            "X0055"
           ],
           "commentLabel": "Flthy solid",
           "category": "Lighting"
@@ -394,7 +407,7 @@
           "name": "Rainbow",
           "safety": "cosmetic",
           "encoder": "template",
-          "template": "{designator}007",
+          "template": "{designator}006",
           "params": [
             {
               "name": "designator",
@@ -404,8 +417,8 @@
           ],
           "supportsDuration": true,
           "examples": [
-            "T007",
-            "A007|45"
+            "T006",
+            "A006|45"
           ],
           "commentLabel": "Flthy rainbow",
           "category": "Lighting"
diff --git a/schema/library.schema.json b/schema/library.schema.json
index 894a0c0..085fffa 100644
--- a/schema/library.schema.json
+++ b/schema/library.schema.json
@@ -97,7 +97,7 @@
         "notes": { "type": "string" },
         "durationSuffix": {
           "type": "object",
-          "description": "If the board accepts a trailing duration (e.g. 'A007|60'), describe it here so the engine can append/strip it.",
+          "description": "If the board accepts a trailing duration (e.g. 'A006|60'), describe it here so the engine can append/strip it.",
           "required": ["supported"],
           "properties": {
             "supported": { "type": "boolean" },
diff --git a/test/engine.test.js b/test/engine.test.js
index 6d559a6..b222961 100644
--- a/test/engine.test.js
+++ b/test/engine.test.js
@@ -41,13 +41,13 @@ describe('encode (template)', () => {
   beforeEach(() => { cb = loadEngine(); loadCatalog(cb); });
 
   test('substitutes enum params', () => {
-    expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'A', color: '5' }, {})).toBe('A0065');
+    expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'A', color: '5' }, {})).toBe('A0055');
   });
   test('uses param default when value missing', () => {
-    expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'A' }, {})).toBe('A0065');
+    expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'A' }, {})).toBe('A0055');
   });
   test('appends duration with the component sep', () => {
-    expect(cb.encode(cb.getCommand('flthy.led.rainbow'), { designator: 'A' }, { duration: 240 })).toBe('A007|240');
+    expect(cb.encode(cb.getCommand('flthy.led.rainbow'), { designator: 'A' }, { duration: 240 })).toBe('A006|240');
   });
   test('ignores duration when command does not support it', () => {
     expect(cb.encode(cb.getCommand('iamp.mode'), { mode: '52' }, { duration: 9 })).toBe('T52');
@@ -62,10 +62,10 @@ describe('match (template)', () => {
   beforeEach(() => { cb = loadEngine(); loadCatalog(cb); });
 
   test('recognizes a FlthyHPs solid token', () => {
-    expect(cb.match('A0065')).toEqual({ commandId: 'flthy.led.solid', params: { designator: 'A', color: '5' }, duration: undefined });
+    expect(cb.match('A0055')).toEqual({ commandId: 'flthy.led.solid', params: { designator: 'A', color: '5' }, duration: undefined });
   });
   test('recovers a duration suffix', () => {
-    expect(cb.match('A007|240')).toEqual({ commandId: 'flthy.led.rainbow', params: { designator: 'A' }, duration: 240 });
+    expect(cb.match('A006|240')).toEqual({ commandId: 'flthy.led.rainbow', params: { designator: 'A' }, duration: 240 });
   });
   test('recognizes an IA MagicPanel mode token', () => {
     expect(cb.match('T52')).toEqual({ commandId: 'iamp.mode', params: { mode: '52' }, duration: undefined });
@@ -93,7 +93,7 @@ describe('FlthyHPs LED effects', () => {
     expect(cb.match('A00362')).toMatchObject({ commandId: 'flthy.led.dimpulse', params: { designator: 'A', color: '6', speed: '2' } });
   });
   test('short circuit defaults to orange (shortColor)', () => {
-    expect(cb.encode(cb.getCommand('flthy.led.shortcircuit'), { designator: 'A' }, {})).toBe('A0057');
+    expect(cb.encode(cb.getCommand('flthy.led.shortcircuit'), { designator: 'A' }, {})).toBe('A0077');
   });
   test('clear/auto uses longest-code-first so 3-digit modes win', () => {
     expect(cb.encode(cb.getCommand('flthy.led.clearauto'), { designator: 'A', mode: '96' }, {})).toBe('A096');
@@ -219,11 +219,11 @@ describe('build/parse + round-trip', () => {
       { type: 'delay', ms: 500 },
       { type: 'command', commandId: 'iamp.mode', params: { mode: '52' } },
     ]);
-    expect(v).toBe('A007^*** Flthy rainbow^;t500^T52');
+    expect(v).toBe('A006^*** Flthy rainbow^;t500^T52');
   });
 
   test('parseWCBValue recognizes commands, raw, and labels', () => {
-    const steps = cb.parseWCBValue('A007^*** Flthy rainbow^<XYZ>^*** raw note');
+    const steps = cb.parseWCBValue('A006^*** Flthy rainbow^<XYZ>^*** raw note');
     expect(steps[0]).toMatchObject({ type: 'command', commandId: 'flthy.led.rainbow', label: ' Flthy rainbow' });
     expect(steps[1]).toMatchObject({ type: 'raw', text: '<XYZ>', label: ' raw note' });
   });
@@ -236,7 +236,7 @@ describe('build/parse + round-trip', () => {
   });
 
   test('round-trips a bare *** comment fragment (empty label) losslessly', () => {
-    const v = 'A007^***';
+    const v = 'A006^***';
     expect(cb.buildWCBValue(cb.parseWCBValue(v))).toBe(v);
   });
 });
diff --git a/test/fixtures/commands.sample.json b/test/fixtures/commands.sample.json
index b665962..fee58a6 100644
--- a/test/fixtures/commands.sample.json
+++ b/test/fixtures/commands.sample.json
@@ -1,7 +1,7 @@
 [
   { "key": "holotwitch", "value": "A104^*** Random Holo Twitch" },
   { "key": "frontholoright", "value": "F1016^*** Front Holo Right" },
-  { "key": "rainbowdemo", "value": "A007^*** Flthy Rainbow^T52^*** MP VU Meter" },
+  { "key": "rainbowdemo", "value": "A006^*** Flthy Rainbow^T52^*** MP VU Meter" },
   { "key": "logicalarm", "value": "~RTLE10590^*** Logics Alarm" },
   { "key": "vscanyellow", "value": "~RTLE213000^*** Vertical Scan Yellow" },
   { "key": "logicpink", "value": "~RTLE59015^*** Logics Pink" },
diff --git a/test/load-node.test.js b/test/load-node.test.js
index b88e342..1cc7d4b 100644
--- a/test/load-node.test.js
+++ b/test/load-node.test.js
@@ -18,5 +18,5 @@ test('loadCatalog() loads the engine and resolves commands', () => {
   const engine = loadCatalog();
   expect(engine.getLibraryVersion()).toBe('4.2.0');
   expect(engine.getCommand('flthy.led.solid')).not.toBeNull();
-  expect(engine.encode(engine.getCommand('flthy.led.solid'), { designator: 'A', color: '5' }, {})).toBe('A0065');
+  expect(engine.encode(engine.getCommand('flthy.led.solid'), { designator: 'A', color: '5' }, {})).toBe('A0055');
 });
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index b5a167e..0168849 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -24,7 +24,18 @@ function loadEngine() { jest.resetModules(); return require('../src/droidnet-com
 // both the frozen 4.2.0 template and the corrected one, plus the reason, so nothing else can
 // change under cover of an allowlisted id. Param names stay frozen regardless.
 //   'some.id': { from: '<4.2.0 template>', to: '<corrected template>', why: '<firmware ref>' },
-const TEMPLATE_FIXES = {};
+//
+// FlthyHPs LED sequence codes (spec "FlthyHPs sequence codes"). 2.3.0 (b38b5d2) took 005/006/007
+// from the FlthyHPs Manual v1.8 command table, which is the pre-v1.6 sketch order. Every sketch
+// from v1.6 through the author's v2.1 dispatches 5 = solid, 6 = rainbow, 7 = short circuit:
+// FlthyHPs_v1.8.ino (v1.81) :932-934, FlthyHPs_v2.1.ino :440-442. Stored wire text is untouched;
+// the three ids now encode and decode the codes the firmware actually runs.
+const FLTHY_V16_CODES = 'FlthyHPs v1.6+ firmware: 005 solid, 006 rainbow, 007 short circuit (v1.81 :932-934)';
+const TEMPLATE_FIXES = {
+  'flthy.led.solid': { from: '{designator}006{color}', to: '{designator}005{color}', why: FLTHY_V16_CODES },
+  'flthy.led.rainbow': { from: '{designator}007', to: '{designator}006', why: FLTHY_V16_CODES },
+  'flthy.led.shortcircuit': { from: '{designator}005{color}', to: '{designator}007{color}', why: FLTHY_V16_CODES },
+};
 
 const WCB_BOARDS = ['maestro', 'wcb-hcr', 'wcb-mp3', 'wcb-wled', 'wcb-native', 'wcb-dfp'];
 const ETM_MAX_CMD_WITH_CRC = 187;
@@ -66,6 +77,11 @@ describe('WCB 6.2.1 sweep guards', () => {
     for (const id of Object.keys(TEMPLATE_FIXES)) expect(FROZEN_420).toHaveProperty([id]);
   });
 
+  test('(a) the template-fix allowlist is exactly the three FlthyHPs LED codes, each with a reason', () => {
+    expect(Object.keys(TEMPLATE_FIXES).sort()).toEqual(['flthy.led.rainbow', 'flthy.led.shortcircuit', 'flthy.led.solid']);
+    for (const fix of Object.values(TEMPLATE_FIXES)) expect(fix.why).toEqual(expect.any(String));
+  });
+
   test('(b) every example on the WCB boards decodes to its own command', () => {
     const present = cb.getComponents().map(c => c.id).filter(id => WCB_BOARDS.includes(id));
     // Guard against a board rename silently emptying the scope; wcb-dfp arrives in 4.3.0.
@@ -600,3 +616,40 @@ describe('wcb-native: 66 commands for WCB 6.2.1 (and missed 6.1.5 surface)', ()
     for (const cmd of added) for (const ex of cmd.examples) expect(cb.buildWCBValue(cb.parseWCBValue(ex))).toBe(ex);
   });
 });
+
+describe('FlthyHPs sequence codes follow the v1.6+ firmware', () => {
+  // FlthyHPs_v1.8.ino (v1.81): function = digits 3-4 (:802); dispatch case 5 ledColor, case 6 rainbow,
+  // case 7 ShortCircuit (:932-934); designators F R T X Y Z A (:791-797), X/Y/Z fan out at :813-818.
+  let cb;
+  beforeEach(() => {
+    cb = loadEngine();
+    const { manifest, boards } = readCatalog();
+    cb.loadLibrary(boards.map(b => JSON.parse(JSON.stringify(b))), { libraryVersion: manifest.libraryVersion });
+  });
+
+  test('005 is solid, 006 is rainbow, 007 is short circuit', () => {
+    expect(cb.match('A0055')).toEqual({ commandId: 'flthy.led.solid', params: { designator: 'A', color: '5' }, duration: undefined });
+    expect(cb.match('A006')).toEqual({ commandId: 'flthy.led.rainbow', params: { designator: 'A' }, duration: undefined });
+    expect(cb.match('A0077')).toEqual({ commandId: 'flthy.led.shortcircuit', params: { designator: 'A', color: '7' }, duration: undefined });
+  });
+
+  test('the author\'s manual examples decode as documented (R0053 solid green, T006 rainbow, A006|45)', () => {
+    expect(cb.match('R0053')).toMatchObject({ commandId: 'flthy.led.solid', params: { designator: 'R', color: '3' } });
+    expect(cb.match('T006')).toMatchObject({ commandId: 'flthy.led.rainbow', params: { designator: 'T' } });
+    expect(cb.match('A006|45')).toMatchObject({ commandId: 'flthy.led.rainbow', params: { designator: 'A' }, duration: 45 });
+  });
+
+  test('4.2.0 wire text for "solid" and "rainbow" is no longer claimed by those ids', () => {
+    // A0065 and A007 run rainbow and short circuit on v1.6+ firmware; they survive as raw steps.
+    expect(cb.match('A0065')).toBeNull();
+    expect(cb.match('A007')).toBeNull();
+    expect(cb.buildWCBValue(cb.parseWCBValue('A0065^A007|240'))).toBe('A0065^A007|240');
+  });
+
+  test('X, Y and Z designators encode and decode', () => {
+    expect(cb.getEnum('flthy.designator').values.map(v => v.code)).toEqual(['F', 'R', 'T', 'X', 'Y', 'Z', 'A']);
+    expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'X', color: '5' }, {})).toBe('X0055');
+    expect(cb.match('Y006|10')).toMatchObject({ commandId: 'flthy.led.rainbow', params: { designator: 'Y' }, duration: 10 });
+    expect(cb.match('Z1011')).toMatchObject({ commandId: 'flthy.servo.preset', params: { designator: 'Z', position: '1' } });
+  });
+});

From 94a022f7ad16e06ab4f75c2b3c9f125d3ee9ba63 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:47:13 -0400
Subject: [PATCH 12/17] docs(wcb-6.2.1): record as-built deviations in the
 sweep spec

The board commits re-read the firmware and, as the spec allows, followed it
where it disagreed with the tables. Add an "As built" section so the spec
matches what 4.3.0 ships:

- wcb-dfp has 21 commands: ;D,DEVICE,<n> is rejected by 6.2.1 (the leading
  D is stripped twice, WCB_DFP.cpp:72-74 and WcbDfPlayer.cpp:54), so
  dfp.device is not modeled.
- maestro: a numeric-only comma payload is forwarded in the legacy ;M<id><n>
  spelling (WCB_Maestro.cpp:262-271); 6.1.5 also allows a Maestro at id 9.
- wcb-native: wledCfg port is S1-S5; dfpOnErr / varClear lookaheads; ONERR
  key <= 23 chars; queries stay config; var enums land with the new commands.
- wcb-hcr: volume sends cap at 99; fn track range note.
- Totals: 22 boards, 500 commands; only the FlthyHPs template fixes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 ...6-09-15-wcb-firmware-6.2.1-sweep-design.md | 34 +++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
index 42e946d..59deee8 100644
--- a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
+++ b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
@@ -442,6 +442,40 @@ Committed before any board edit and green on 4.2.0:
   ids (`wcb.runSeqLocal`, `wcb.runSeqLongLocal`, `wcb.seqNames`, `wcb.seqGet`,
   `wcb.timerStop`) are not moved by its split automatically; mention them in the PR.
 
+## As built
+
+Where the implementation commits re-read the firmware and departed from, or refined, the
+tables above (each commit message gives the detail):
+
+- **`wcb-dfp` has 21 commands, not 22.** `dfp.device` and its enum are not modeled because WCB
+  6.2.1 rejects `;D,DEVICE,<n>`: `processDFPCommand` strips the leading `D,`
+  (`WCB_DFP.cpp:72-74`), then WcbCmd `DfPlayerCodec::handle` strips an optional leading `D`
+  again (`WcbDfPlayer.cpp:54`), so the codec sees `EVICE,<n>`. WcbCmd's own golden vector
+  `DEVICE,2` (`examples/GoldenVectors/GoldenVectors.ino:211`) fails the same way. `;D,DEVICE,2`
+  stays a raw step; adding `dfp.device` once a fix ships is a minor. Only `dfp.reset` is
+  `config`.
+- **`maestro` comma forms.** A 6.2.1 board forwards a comma form whose payload is only a
+  number (`;M1,5`) in the legacy spelling `;M15` (`WCB_Maestro.cpp:262-271`), so only verbs
+  and subroutines with a parameter need 6.2.1 on the Maestro host. 6.1.5 also accepts a
+  Maestro configured as id 9 (6.1.5 `WCB_Maestro.cpp:247-248`); 6.2.1 allows 1-8. The
+  `routing.notes` say both.
+- **`wcb-native`.**
+  - `wcb.wledCfg` port uses `wcb.port` (S1-S5), not `wcb.portUsb`: a local WLED must be on
+    S1-S5 (`WCB_WLED.cpp:311`).
+  - `wcb.dfpOnErr` and `wcb.varClear` get case-insensitive lookaheads like `wcb.alias`, because
+    the firmware compares `CLEAR` and `ALL` case-insensitively (`WCB_DFP.cpp:189`,
+    `WCB_Variables.cpp:326-328`). The ONERR key is capped at 23 characters
+    (`WCB_DFP.cpp:193`).
+  - Read-only `?` queries keep the board's existing `config` convention; only `wcb.identify`
+    is `cosmetic`.
+  - `wcb.varScope`, `wcb.varOp`, `wcb.varDir` and the Movement and Variables categories land
+    with the 66 new commands rather than with the range fixes.
+- **`wcb-hcr`.** `;H,VOL` / `VOLUP` / `VOLDN` accept 0-100, but `hcrSetVol` sends at most 99
+  (`WCB_HCR.cpp:84-87`). Ranges stay 0-100 and the notes record the cap. `hcr.fn` `track`
+  0-9999 fits fn 14 (Play WAV); the other codes take 0-99.
+- **Totals.** 22 boards and 500 commands: 397 + 12 `maestro.wcb.*` + 21 `dfp.*` + 4 `hcr.*` +
+  66 `wcb.*`. The only template changes to 4.2.0 ids are the three allowlisted FlthyHPs codes.
+
 ## Verification status
 
 Verified against source only (WCB `66845b9a`, WcbCmd `168f1e5`, the Pololu Maestro guide, the

From 40c66f23ee108eac53511dd5350b4ceb21bb85bb Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 11:45:15 -0400
Subject: [PATCH 13/17] release: bump library to 4.3.0 (WCB 6.2.1 sweep)

- libraries/manifest.json: libraryVersion 4.3.0; generatedFrom appends
  "WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0 (2026-09)". The wcb-dfp entry
  and the renamed maestro / wcb-wled names landed with their boards.
- releases.json: latest and libraries[0] -> 4.3.0, releasedAt 2026-09-15,
  notes for the sweep as built: maestro +12 (maestro.wcb.*), new wcb-dfp
  (21 verbs; ;D,DEVICE is not modeled because 6.2.1 rejects it), wcb-hcr +4,
  wcb-native +66 with range fixes, wled.preset from 1, the FlthyHPs v1.6+
  sequence codes, and the engine 3.1.0 compatibility sentence old DroidNet
  confirm dialogs show. Boards 21 -> 22, commands 397 -> 500.
- package.json and package-lock.json (top-level and packages[""]) -> 4.3.0
  (D4), hand-edited.
- Test pins: load-node and engine libraryVersion 4.3.0 (board count 22
  already pinned by the wcb-dfp commit).

npm run validate exits 0 (category-outlier warnings only); npm test 385/385.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 libraries/manifest.json | 4 ++--
 package-lock.json       | 4 ++--
 package.json            | 2 +-
 releases.json           | 8 ++++----
 test/engine.test.js     | 2 +-
 test/load-node.test.js  | 6 +++---
 6 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/libraries/manifest.json b/libraries/manifest.json
index 7d503b0..2196a2d 100644
--- a/libraries/manifest.json
+++ b/libraries/manifest.json
@@ -1,8 +1,8 @@
 {
   "$schema": "droidnet-command-library/catalog/v1",
-  "libraryVersion": "4.2.0",
+  "libraryVersion": "4.3.0",
   "schemaVersion": "v1",
-  "generatedFrom": "C2B5 firmware + WIPDocs (2026-06); R2UppitySpinnerV3 ALT fw 3.5.3 (2026-07); Printed Droid Magic Panel 32 Wireless KB (2026-07); WCB 6.1.5_290119RJUN2026 (2026-07)",
+  "generatedFrom": "C2B5 firmware + WIPDocs (2026-06); R2UppitySpinnerV3 ALT fw 3.5.3 (2026-07); Printed Droid Magic Panel 32 Wireless KB (2026-07); WCB 6.1.5_290119RJUN2026 (2026-07); WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0 (2026-09)",
   "boards": [
     {
       "id": "flthy-hps",
diff --git a/package-lock.json b/package-lock.json
index 2244193..8d5688f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "droidnet-command-library",
-  "version": "1.0.0",
+  "version": "4.3.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "droidnet-command-library",
-      "version": "1.0.0",
+      "version": "4.3.0",
       "license": "MPL-2.0",
       "devDependencies": {
         "ajv": "^8.17.1",
diff --git a/package.json b/package.json
index 2db7458..2898aa5 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "droidnet-command-library",
-  "version": "2.1.1",
+  "version": "4.3.0",
   "description": "Schema-driven encoder/decoder and visual composer for building serial commands to control a vibrant community of Astromech droid components. Anyone can add their board by editing a JSON library — no code changes required.",
   "license": "MPL-2.0",
   "keywords": [
diff --git a/releases.json b/releases.json
index 5fed061..e995e04 100644
--- a/releases.json
+++ b/releases.json
@@ -2,17 +2,17 @@
   "$schema": "droidnet-command-library/releases/v1",
   "_comment": "Update pointer for the 'Update Library' flow. A device fetches this file, compares latest.libraryVersion to its installed catalog, and (if newer) downloads latest.url (the catalog manifest), then fetches each board listed in manifest.boards in order, validates them, and loads them via loadLibrary(boards, { libraryVersion }).",
   "latest": {
-    "libraryVersion": "4.2.0",
+    "libraryVersion": "4.3.0",
     "schemaVersion": "v1",
-    "releasedAt": "2026-07-22",
+    "releasedAt": "2026-09-15",
     "url": "https://raw.githubusercontent.com/travisccook/droidnet-command-library/main/libraries/manifest.json",
-    "notes": "Minor: Maestro servo control + WLED lighting. Adds Maestro (Pololu Protocol) board (maestro-native): the device-native Pololu servo grammar — setTarget, goHome, setSpeed/setAccel/setSpeedAccel, setEasing, and restartScript/stopScript. The existing Maestro board (maestro) is now scoped to just the ;M sequence-trigger WCB verb, so each board carries a single transport. Adds WCB · WLED Lighting board (wcb-wled): the ;L, verb set — on/off/toggle, brightness, preset, color, effect (+ speed/intensity), palette, and a raw /json/state escape hatch. Board catalog 19 -> 21."
+    "notes": "Minor: WCB firmware 6.2.1 sweep. Maestro (maestro) adds the WCB 6.2+ comma forms: Run Subroutine (with and without a parameter, number and sub-verb spellings), Stop Script, Go Home, Set Servo Target/Speed/Acceleration, and Read Position/Moving State/Errors queries. Ids widen to 0-9 (9 = this WCB's Maestros) and subroutines to 0-127. Adds WCB · DFPlayer Mini board (wcb-dfp, WCB 6.2+): 21 ;D, verbs (play/folder/MP3-folder with optional ONFIN callback, stop/pause/resume/next/prev/random, loop track/all/folder, EQ, volume/up/down, reset, status). WCB · HCR Vocalizer (wcb-hcr) adds TRIGGER, all-channel VOL and VOLUP/VOLDN steps, and limits FN to the firmware's function codes. WCB (native config) (wcb-native) adds 66 commands (mesh channel, alias, controller, status LED pin/identify, WLED/DFPlayer config, MP3/DFPlayer/HCR host routing, Maestro remote/Kyber map, ;W alias routing, ;P PWM pulse, ;V/;VP variables and IF, sequence names/get and ,L local runs, timer stop, WDP, debug/track/version) and corrects ranges (board numbers 1-20, 30-minute timer, S0 routing, HCR baud/poll/get fields, ETM miss 100, multi-destination maps). WLED presets start at 1; the MP3 Trigger and WLED boards document 6.2.1 routing. FlthyHPs Holoprojectors (flthy-hps): Solid Color, Rainbow and Short Circuit now send the codes FlthyHPs v1.6+ firmware runs (005, 006, 007; 4.2.0 sent 006, 007, 005), and the X/Y/Z designators are back. Saved steps keep their exact text. Text fields (keys, aliases, variable names, conditions, colors) need a host that uses engine 3.1.0 or later. Generated against WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0; board catalog 21 -> 22, commands 397 -> 500."
   },
   "libraries": [
     {
       "id": "droidnet-astromech",
       "name": "DroidNet Astromech Boards",
-      "libraryVersion": "4.2.0",
+      "libraryVersion": "4.3.0",
       "schemaVersion": "v1",
       "url": "https://raw.githubusercontent.com/travisccook/droidnet-command-library/main/libraries/manifest.json"
     }
diff --git a/test/engine.test.js b/test/engine.test.js
index b222961..0f9c211 100644
--- a/test/engine.test.js
+++ b/test/engine.test.js
@@ -19,7 +19,7 @@ describe('engine lookups', () => {
     expect(cb.getComponents().map(c => c.id)).toEqual(expect.arrayContaining(['flthy-hps', 'ia-magic-panel']));
   });
   test('getLibraryVersion reports the loaded version', () => {
-    expect(cb.getLibraryVersion()).toBe('4.2.0');
+    expect(cb.getLibraryVersion()).toBe('4.3.0');
   });
   test('getCommand resolves and back-links its component', () => {
     const cmd = cb.getCommand('flthy.led.solid');
diff --git a/test/load-node.test.js b/test/load-node.test.js
index 1cc7d4b..268bc8d 100644
--- a/test/load-node.test.js
+++ b/test/load-node.test.js
@@ -3,20 +3,20 @@ const { readCatalog, loadCatalog } = require('../src/load-node.js');
 
 test('readCatalog returns the manifest and every board, in order', () => {
   const { manifest, boards } = readCatalog();
-  expect(manifest.libraryVersion).toBe('4.2.0');
+  expect(manifest.libraryVersion).toBe('4.3.0');
   expect(boards).toHaveLength(manifest.boards.length);
   expect(boards.map(b => b.components[0].id)).toEqual(manifest.boards.map(b => b.id));
 });
 
 test('loadCatalog({ load: false }) returns the merged catalog object', () => {
   const lib = loadCatalog({ load: false });
-  expect(lib.libraryVersion).toBe('4.2.0');
+  expect(lib.libraryVersion).toBe('4.3.0');
   expect(lib.components.length).toBe(22);
 });
 
 test('loadCatalog() loads the engine and resolves commands', () => {
   const engine = loadCatalog();
-  expect(engine.getLibraryVersion()).toBe('4.2.0');
+  expect(engine.getLibraryVersion()).toBe('4.3.0');
   expect(engine.getCommand('flthy.led.solid')).not.toBeNull();
   expect(engine.encode(engine.getCommand('flthy.led.solid'), { designator: 'A', color: '5' }, {})).toBe('A0055');
 });

From de0a57dccd7323514987d7db3e4d7846f6996c63 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 12:13:49 -0400
Subject: [PATCH 14/17] fix(wcb-native): alias names exclude ^, |, stripped
 characters and trailing space

wcb.alias and wcb.routeAlias accepted [A-Za-z][^,;?]{0,23}, which let
names through that the firmware or the wire format cannot keep:

- WCB 6.2.1 saveWCBAlias() trims the alias and rewrites ^ , ; ? CR LF
  to '_' (WCB_Storage.cpp:212-229), so no saved alias holds them.
- ?ALIAS trims its argument before the LIST/CLEAR compare
  (WCB.ino:5372-5384), so "?ALIAS,List " runs LIST but decoded as Set
  Board Alias. ;W<alias>, trims the alias too (WCB.ino:6525-6531).
- ^ splits steps, and match() strips a trailing |<digits> as a
  duration, so "?ALIAS,Dome|25" can never decode to wcb.alias.

Both patterns are now [A-Za-z](?:[^,;?^|\r\n]{0,22}[^,;?^|\s])?
(still 1-24 characters, letter first); wcb.alias keeps its CLEAR/LIST
lookahead. Strings outside the shape survive as raw steps. The spec
tables and As built section record the change.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 ...6-09-15-wcb-firmware-6.2.1-sweep-design.md | 11 +++++++--
 libraries/boards/wcb-native.json              |  4 ++--
 test/wcb-621.test.js                          | 24 +++++++++++++++++++
 3 files changed, 35 insertions(+), 4 deletions(-)

diff --git a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
index 59deee8..a3fb181 100644
--- a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
+++ b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
@@ -266,7 +266,7 @@ the catch-all after it.
 
 | Insert before | Commands (id: template) | Firmware |
 |---|---|---|
-| `wcb.mac2` | `wcb.meshChannel` `?WCBCH,{ch}` 1-11 (6.2+, applies on reboot) · → `wcb.aliasClear` `?ALIAS,CLEAR` · → `wcb.aliasList` `?ALIAS,LIST` · `wcb.alias` `?ALIAS,{name}` pattern `(?![Cc][Ll][Ee][Aa][Rr]$\|[Ll][Ii][Ss][Tt]$)[A-Za-z][^,;?]{0,23}` · `wcb.controllerOn` `?CONTROLLER,ON` · `wcb.controllerOnId` `?CONTROLLER,ON,{id}` 1-20 · `wcb.controllerOff` `?CONTROLLER,OFF` (controller 6.2+) · `wcb.ledPin` `?LED,PIN,{gpio}` 0-48 · `wcb.ledPinQuery` `?LED,PIN` · `wcb.identify` `?IDENTIFY` (cosmetic) | `WCB.ino:5323`, `:5372-5384`, `:5394-5420`, `:5678-5681`, `:5629`; `WCB_Storage.cpp:212-240` |
+| `wcb.mac2` | `wcb.meshChannel` `?WCBCH,{ch}` 1-11 (6.2+, applies on reboot) · → `wcb.aliasClear` `?ALIAS,CLEAR` · → `wcb.aliasList` `?ALIAS,LIST` · `wcb.alias` `?ALIAS,{name}` pattern `(?![Cc][Ll][Ee][Aa][Rr]$\|[Ll][Ii][Ss][Tt]$)[A-Za-z](?:[^,;?^\|\r\n]{0,22}[^,;?^\|\s])?` · `wcb.controllerOn` `?CONTROLLER,ON` · `wcb.controllerOnId` `?CONTROLLER,ON,{id}` 1-20 · `wcb.controllerOff` `?CONTROLLER,OFF` (controller 6.2+) · `wcb.ledPin` `?LED,PIN,{gpio}` 0-48 · `wcb.ledPinQuery` `?LED,PIN` · `wcb.identify` `?IDENTIFY` (cosmetic) | `WCB.ino:5323`, `:5372-5384`, `:5394-5420`, `:5678-5681`, `:5629`; `WCB_Storage.cpp:212-240` |
 | `wcb.bcastReset` | `wcb.bcastOutUsb` `?BCAST,OUT,S0,{state}` (6.2+) | `WCB.ino:5133` |
 | `wcb.mapPwmList` | `wcb.mapPwmClearOut` `?MAP,PWM,CLEAR,OUT,S{port}` — **safety `power`**, it reboots | `WCB.ino:5026-5033` |
 | near `wcb.kyber*` | `wcb.kyberLocalMaestros` `?KYBER,LOCAL,S{port},{spec}` (spec = the Maestro spec pattern above) | `WCB_Help.cpp:213` |
@@ -275,7 +275,7 @@ the catch-all after it.
 | `wcb.hcrPort` | `wcb.dfpCfg` `?DFP,S{port}:9600:V{vol}` (vol 0-30) · `wcb.dfpPort` `?DFP,S{port}` · `wcb.dfpList` · `wcb.dfpClear` · `wcb.dfpRemote` `?DFP,REMOTE,W{wcb}` · `wcb.dfpRemoteOff` · → `wcb.dfpOnErrClear` `?DFP,ONERR,CLEAR` · `wcb.dfpOnErr` `?DFP,ONERR,{key}` (all 6.2+) | `WCB_DFP.cpp:144-327` |
 | `wcb.hcrList` | `wcb.hcrPollOff` `?HCR,POLL,OFF` · `wcb.hcrRemote` `?HCR,REMOTE,W{wcb}` (6.2+) · `wcb.hcrRemoteOff` `?HCR,REMOTE,OFF` (6.2+) | `WCB_HCR.cpp:537-562`, `:568-575` |
 | `wcb.routeSerial` | `wcb.wledCfg` `?WLED,{id}:W{wcb}S{port}:{baud}` (id 1-9, wcb 1-20, port `wcb.portUsb`, baud `wcb.devBaud`; `?WLED,1:W3S2:115200`) · `wcb.wledList` · `wcb.wledStatus` · `wcb.wledClear` · `wcb.wledClearId` `?WLED,CLEAR,{id}` (all 6.2+) | `WCB_WLED.cpp:229-353` |
-| `wcb.timer` | `wcb.routeAlias` `;W{alias},{message}`, alias `[A-Za-z][^,;?]{0,23}` (6.2+) · `wcb.pwmPulse` `;P{port}{width}` port single-digit 1-5 (enum or pattern, see hazards), width 500-2500, Movement / movement | `WCB.ino:6525-6550`, `:6788-6834` |
+| `wcb.timer` | `wcb.routeAlias` `;W{alias},{message}`, alias `[A-Za-z](?:[^,;?^\|\r\n]{0,22}[^,;?^\|\s])?` (6.2+) · `wcb.pwmPulse` `;P{port}{width}` port single-digit 1-5 (enum or pattern, see hazards), width 500-2500, Movement / movement | `WCB.ino:6525-6550`, `:6788-6834` |
 | `wcb.seqList` | `wcb.seqNames` `?SEQ,NAMES` · `wcb.seqGet` `?SEQ,GET,{key}` (6.2+) | `WCB.ino:5497`, `:5513` |
 | after `wcb.runSeqLong` | `wcb.runSeqLocal` `;C{key},L` · `wcb.runSeqLongLocal` `;SEQ{key},L` (6.2+; on 6.1 the `,L` becomes part of the key) · `wcb.timerStop` `?STOP` | `WCB.ino:6654-6691`, `:7053`; `command_timer.cpp:66-78` |
 | `wcb.etmOn` | `wcb.varSet` `;{scope},{name},{value}` (name `[A-Za-z0-9_]{1,15}`, value int) · `wcb.varOp` `;{scope},{name},{op}` · `wcb.varStep` `;{scope},{name},{dir},{n}` · `wcb.if` `IF,{cond}` (gates the next step; cannot ride inside a `;W` or `;T` payload) · `wcb.varList` `?VAR,LIST` · `wcb.varSetNvs` `?VAR,SET,{name},{value}` · `wcb.varGet` `?VAR,GET,{name}` · → `wcb.varClearAll` `?VAR,CLEAR,ALL` · `wcb.varClear` `?VAR,CLEAR,{name}` | `WCB_Variables.cpp:63-73`, `:209-337`, `:372`, `:435`; `WCB.ino:6568-6581` |
@@ -462,6 +462,13 @@ tables above (each commit message gives the detail):
 - **`wcb-native`.**
   - `wcb.wledCfg` port uses `wcb.port` (S1-S5), not `wcb.portUsb`: a local WLED must be on
     S1-S5 (`WCB_WLED.cpp:311`).
+  - Alias names (`wcb.alias`, `wcb.routeAlias`) exclude `^ , ; ? CR LF`, `|` and trailing
+    whitespace. `saveWCBAlias` trims and rewrites the first six to `_` (`WCB_Storage.cpp:212-229`),
+    and `?ALIAS` and `;W<alias>,` trim before comparing (`WCB.ino:5372-5384`, `:6525-6531`), so
+    `?ALIAS,List ` runs LIST and stays a raw step. `^` splits steps, and a trailing `|<digits>` is
+    read as a duration, so `?ALIAS,Dome|25` cannot decode to `wcb.alias`. The firmware keeps `|`
+    in an alias; the patterns leave it out so both ids share one alias shape, and such a step
+    survives as raw text.
   - `wcb.dfpOnErr` and `wcb.varClear` get case-insensitive lookaheads like `wcb.alias`, because
     the firmware compares `CLEAR` and `ALL` case-insensitively (`WCB_DFP.cpp:189`,
     `WCB_Variables.cpp:326-328`). The ONERR key is capped at 23 characters
diff --git a/libraries/boards/wcb-native.json b/libraries/boards/wcb-native.json
index c0c3308..b4debb7 100644
--- a/libraries/boards/wcb-native.json
+++ b/libraries/boards/wcb-native.json
@@ -164,7 +164,7 @@
           "params": [
             {
               "name": "name",
-              "pattern": "(?![Cc][Ll][Ee][Aa][Rr]$|[Ll][Ii][Ss][Tt]$)[A-Za-z][^,;?]{0,23}",
+              "pattern": "(?![Cc][Ll][Ee][Aa][Rr]$|[Ll][Ii][Ss][Tt]$)[A-Za-z](?:[^,;?^|\\r\\n]{0,22}[^,;?^|\\s])?",
               "required": true
             }
           ],
@@ -1424,7 +1424,7 @@
           "params": [
             {
               "name": "alias",
-              "pattern": "[A-Za-z][^,;?]{0,23}",
+              "pattern": "[A-Za-z](?:[^,;?^|\\r\\n]{0,22}[^,;?^|\\s])?",
               "required": true
             },
             {
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index 0168849..f0a5f6b 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -534,6 +534,30 @@ describe('wcb-native: 66 commands for WCB 6.2.1 (and missed 6.1.5 surface)', ()
     expect(cb.parseWCBValue('?ALIAS,clear')[0]).toMatchObject({ type: 'raw' });
   });
 
+  test('alias names exclude what the firmware trims or rewrites, and the step delimiters', () => {
+    // saveWCBAlias() trims, then rewrites ^ , ; ? CR LF to '_' (WCB_Storage.cpp:212-229), so no saved
+    // alias holds them or ends in whitespace. ?ALIAS trims before its LIST/CLEAR compare
+    // (WCB.ino:5372-5384) and ;W<alias>, trims the alias (WCB.ino:6525-6531). In the wire format ^
+    // splits steps and match() strips a trailing |<digits> as a duration (?ALIAS,Dome|25 can never
+    // decode to wcb.alias), so the library keeps ^ and | out of names; such steps stay raw.
+    const nameRe = (id) => new RegExp('^(?:' + cb.getCommand(id).params[0].pattern + ')$');
+    for (const id of ['wcb.alias', 'wcb.routeAlias']) {
+      const re = nameRe(id);
+      for (const ok of ['A', 'Dome', 'Dome Left', 'R2-D2_body.1', 'x'.repeat(24)]) expect(re.test(ok)).toBe(true);
+      for (const bad of ['Dome^Body', 'Dome|25', 'Dome|L', 'Do,me', 'Do;me', 'Do?me', 'Do\rme', 'Do\nme',
+        'Dome ', 'Dome\t', ' Dome', '1Dome', '', 'x'.repeat(25)]) expect(re.test(bad)).toBe(false);
+    }
+    // Trailing whitespace: the firmware runs LIST / CLEAR, or saves the trimmed name; either way raw.
+    expect(cb.match('?ALIAS,List ')).toBeNull();
+    expect(cb.match('?ALIAS,CLEAR\t')).toBeNull();
+    expect(cb.match('?ALIAS,Dome ')).toBeNull();
+    expect(cb.match(';Wdome ,;A,PLAY,1')).toBeNull();
+    for (const v of ['?ALIAS,List ', '?ALIAS,Dome|25', '?ALIAS,Dome^Body', ';Wdome ,;A,PLAY,1']) {
+      expect(cb.buildWCBValue(cb.parseWCBValue(v))).toBe(v);
+    }
+    expect(cb.parseWCBValue('?ALIAS,List ')).toEqual([{ type: 'raw', text: '?ALIAS,List ' }]);
+  });
+
   test(';W routes by alias (letter first) or by board number (digits)', () => {
     expect(cb.match(';Wdome,;A,PLAY,1')).toEqual({ commandId: 'wcb.routeAlias', params: { alias: 'dome', message: ';A,PLAY,1' } });
     expect(cb.match(';W2,;A,PLAY,1')).toEqual({ commandId: 'wcb.routeWcb', params: { wcb: '2', message: ';A,PLAY,1' } });

From 15d6bbc23629c6fd426ab78cf4ca5bbc612fd005 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 12:15:31 -0400
Subject: [PATCH 15/17] test: freeze board, encoder and duration support of
 4.2.0 ids

The D2 freeze guard compared only template and ordered param names, but
match() keeps a trailing |n only when the matched command sets
supportsDuration. Deleting supportsDuration from ap.hp.native.solid left
validate and every test green while the stored value @HPF0051|30 stopped
decoding (five 4.2.0 duration commands have no |n example).

- test/fixtures/catalog-4.2.0-commands.json: each entry adds encoder
  (default "template") and supportsDuration (boolean), regenerated from
  a pristine 82b6a04 export in the same one-line format. The generator
  reproduced the committed board/template/params byte-for-byte first.
- test (a) also asserts the entry's board, encoder and supportsDuration,
  and that a frozen duration command still encodes a |n suffix (the
  board's durationSuffix is on).

Mutation-checked in a scratch copy: deleting or adding supportsDuration,
changing an encoder, turning a board's durationSuffix off and a board
mismatch each fail test (a) with a named drift line.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 test/fixtures/catalog-4.2.0-commands.json | 794 +++++++++++-----------
 test/wcb-621.test.js                      |  23 +-
 2 files changed, 415 insertions(+), 402 deletions(-)

diff --git a/test/fixtures/catalog-4.2.0-commands.json b/test/fixtures/catalog-4.2.0-commands.json
index 46ce722..ef9e2e6 100644
--- a/test/fixtures/catalog-4.2.0-commands.json
+++ b/test/fixtures/catalog-4.2.0-commands.json
@@ -1,399 +1,399 @@
 {
-  "flthy.led.leia": { "board": "flthy-hps", "template": "{designator}001", "params": ["designator"] },
-  "flthy.led.colorproj": { "board": "flthy-hps", "template": "{designator}002{color}", "params": ["designator","color"] },
-  "flthy.led.dimpulse": { "board": "flthy-hps", "template": "{designator}003{color}{speed}", "params": ["designator","color","speed"] },
-  "flthy.led.cycle": { "board": "flthy-hps", "template": "{designator}004{color}", "params": ["designator","color"] },
-  "flthy.led.shortcircuit": { "board": "flthy-hps", "template": "{designator}005{color}", "params": ["designator","color"] },
-  "flthy.led.clearauto": { "board": "flthy-hps", "template": "{designator}0{mode}", "params": ["designator","mode"] },
-  "flthy.led.solid": { "board": "flthy-hps", "template": "{designator}006{color}", "params": ["designator","color"] },
-  "flthy.led.rainbow": { "board": "flthy-hps", "template": "{designator}007", "params": ["designator"] },
-  "flthy.servo.preset": { "board": "flthy-hps", "template": "{designator}101{position}", "params": ["designator","position"] },
-  "flthy.servo.rc-lr": { "board": "flthy-hps", "template": "{designator}102", "params": ["designator"] },
-  "flthy.servo.rc-ud": { "board": "flthy-hps", "template": "{designator}103", "params": ["designator"] },
-  "flthy.servo.random": { "board": "flthy-hps", "template": "{designator}104", "params": ["designator"] },
-  "flthy.servo.wag-lr": { "board": "flthy-hps", "template": "{designator}105", "params": ["designator"] },
-  "flthy.servo.wag-ud": { "board": "flthy-hps", "template": "{designator}106", "params": ["designator"] },
-  "flthy.servo.autotwitch": { "board": "flthy-hps", "template": "{designator}1{mode}", "params": ["designator","mode"] },
-  "flthy.special.sequence": { "board": "flthy-hps", "template": "{special}", "params": ["special"] },
-  "iamp.mode": { "board": "ia-magic-panel", "template": "T{mode}", "params": ["mode"] },
-  "pdmp.pattern": { "board": "pd-magic-panel", "template": "T{pattern}", "params": ["pattern"] },
-  "pdmp.pattern.timed": { "board": "pd-magic-panel", "template": "T{pattern}:{duration}", "params": ["pattern","duration"] },
-  "pdmp.demo": { "board": "pd-magic-panel", "template": "DEMO", "params": [] },
-  "pdmp.brightness": { "board": "pd-magic-panel", "template": "B{level}", "params": ["level"] },
-  "pdmp.speed": { "board": "pd-magic-panel", "template": "V{speed}", "params": ["speed"] },
-  "pdmp.color": { "board": "pd-magic-panel", "template": "C {color}", "params": ["color"] },
-  "pdmp.rgb": { "board": "pd-magic-panel", "template": "C {r},{g},{b}", "params": ["r","g","b"] },
-  "pdmp.transition": { "board": "pd-magic-panel", "template": "TRANSITION {state}", "params": ["state"] },
-  "pdmp.text": { "board": "pd-magic-panel", "template": "TEXT:{message}", "params": ["message"] },
-  "pdmp.text.bounce": { "board": "pd-magic-panel", "template": "TEXT_BOUNCE:{message}", "params": ["message"] },
-  "pdmp.text.save": { "board": "pd-magic-panel", "template": "TEXTSAVE{slot}:{message}", "params": ["slot","message"] },
-  "pdmp.text.load": { "board": "pd-magic-panel", "template": "TEXTLOAD{slot}", "params": ["slot"] },
-  "pdmp.font": { "board": "pd-magic-panel", "template": "FONT {font}", "params": ["font"] },
-  "pdmp.playlist": { "board": "pd-magic-panel", "template": "PLAYLIST_RUN:{ids}", "params": ["ids"] },
-  "pdmp.startup": { "board": "pd-magic-panel", "template": "START {pattern}", "params": ["pattern"] },
-  "pdmp.mode": { "board": "pd-magic-panel", "template": "P{mode}", "params": ["mode"] },
-  "pdmp.save": { "board": "pd-magic-panel", "template": "SAVE", "params": [] },
-  "pdmp.load": { "board": "pd-magic-panel", "template": "LOAD", "params": [] },
-  "pdmp.on": { "board": "pd-magic-panel", "template": "ON", "params": [] },
-  "pdmp.off": { "board": "pd-magic-panel", "template": "OFF", "params": [] },
-  "rseries.effect": { "board": "rseries-logic", "template": null, "params": ["effect","color","speed","seconds","target"] },
-  "rseries.text": { "board": "rseries-logic", "template": "@{address}M{text}", "params": ["address","text"] },
-  "rseries.font": { "board": "rseries-logic", "template": "@{address}P{font}", "params": ["address","font"] },
-  "rseries.cfg.wifi": { "board": "rseries-logic", "template": "#LEWIFI{state}", "params": ["state"] },
-  "rseries.cfg.remote": { "board": "rseries-logic", "template": "#LEREMOTE{state}", "params": ["state"] },
-  "rseries.sys.restart": { "board": "rseries-logic", "template": "#LERESTART", "params": [] },
-  "rseries.sys.zero": { "board": "rseries-logic", "template": "#LEZERO", "params": [] },
-  "hcr.stim": { "board": "wcb-hcr", "template": ";H,STIM,{emotion},{strength}", "params": ["emotion","strength"] },
-  "hcr.play": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file}", "params": ["channel","file"] },
-  "hcr.vol": { "board": "wcb-hcr", "template": ";H,VOL,{channel},{level}", "params": ["channel","level"] },
-  "hcr.volUp": { "board": "wcb-hcr", "template": ";H,VOLUP,{channel},{step}", "params": ["channel","step"] },
-  "hcr.volUpAll": { "board": "wcb-hcr", "template": ";H,VOLUP", "params": [] },
-  "hcr.volDown": { "board": "wcb-hcr", "template": ";H,VOLDN,{channel},{step}", "params": ["channel","step"] },
-  "hcr.volDownAll": { "board": "wcb-hcr", "template": ";H,VOLDN", "params": [] },
-  "hcr.fadeIn": { "board": "wcb-hcr", "template": ";H,FADEIN,{channel},{sec}", "params": ["channel","sec"] },
-  "hcr.fadeOut": { "board": "wcb-hcr", "template": ";H,FADEOUT,{channel},{sec}", "params": ["channel","sec"] },
-  "hcr.playFade": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file},FADEIN,{sec}", "params": ["channel","file","sec"] },
-  "hcr.overload": { "board": "wcb-hcr", "template": ";H,OVERLOAD", "params": [] },
-  "hcr.setEmotion": { "board": "wcb-hcr", "template": ";H,SETEMOTION,{emotion},{value}", "params": ["emotion","value"] },
-  "hcr.override": { "board": "wcb-hcr", "template": ";H,OVERRIDE,{state}", "params": ["state"] },
-  "hcr.muse": { "board": "wcb-hcr", "template": ";H,MUSE", "params": [] },
-  "hcr.museSet": { "board": "wcb-hcr", "template": ";H,MUSE,{mode}", "params": ["mode"] },
-  "hcr.museGap": { "board": "wcb-hcr", "template": ";H,MUSE,GAP,{min},{max}", "params": ["min","max"] },
-  "hcr.stopEmote": { "board": "wcb-hcr", "template": ";H,STOPEMOTE", "params": [] },
-  "hcr.resetEmotions": { "board": "wcb-hcr", "template": ";H,RESETEMOTIONS", "params": [] },
-  "hcr.stop": { "board": "wcb-hcr", "template": ";H,STOP", "params": [] },
-  "hcr.stopWav": { "board": "wcb-hcr", "template": ";H,STOPWAV,{channel}", "params": ["channel"] },
-  "hcr.fn": { "board": "wcb-hcr", "template": ";H,FN,{fn},{chan},{track}", "params": ["fn","chan","track"] },
-  "hcr.raw": { "board": "wcb-hcr", "template": ";H,RAW,{payload}", "params": ["payload"] },
-  "mp3.play": { "board": "wcb-mp3", "template": ";A,PLAY,{track}", "params": ["track"] },
-  "mp3.playCb": { "board": "wcb-mp3", "template": ";A,PLAY,{track},ONFIN,{key}", "params": ["track","key"] },
-  "mp3.playFs": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track}", "params": ["track"] },
-  "mp3.playFsCb": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track},ONFIN,{key}", "params": ["track","key"] },
-  "mp3.stop": { "board": "wcb-mp3", "template": ";A,STOP", "params": [] },
-  "mp3.next": { "board": "wcb-mp3", "template": ";A,NEXT", "params": [] },
-  "mp3.prev": { "board": "wcb-mp3", "template": ";A,PREV", "params": [] },
-  "mp3.vol": { "board": "wcb-mp3", "template": ";A,VOL,{level}", "params": ["level"] },
-  "mp3.volUp": { "board": "wcb-mp3", "template": ";A,VOLUP", "params": [] },
-  "mp3.volDown": { "board": "wcb-mp3", "template": ";A,VOLDN", "params": [] },
-  "mp3.count": { "board": "wcb-mp3", "template": ";A,COUNT", "params": [] },
-  "mp3.ver": { "board": "wcb-mp3", "template": ";A,VER", "params": [] },
-  "maestro.trigger": { "board": "maestro", "template": ";M{id}{seq}", "params": ["id","seq"] },
-  "maestro.setTarget": { "board": "maestro-native", "template": "setTarget,{channel},{position}", "params": ["channel","position"] },
-  "maestro.goHome": { "board": "maestro-native", "template": "goHome", "params": [] },
-  "maestro.setSpeed": { "board": "maestro-native", "template": "setSpeed,{channel},{value}", "params": ["channel","value"] },
-  "maestro.setAccel": { "board": "maestro-native", "template": "setAccel,{channel},{value}", "params": ["channel","value"] },
-  "maestro.setSpeedAccel": { "board": "maestro-native", "template": "setSpeedAccel,{channel},{speed},{accel}", "params": ["channel","speed","accel"] },
-  "maestro.setEasing": { "board": "maestro-native", "template": "setEasing,{profile}", "params": ["profile"] },
-  "maestro.restartScript": { "board": "maestro-native", "template": "restartScript,{sub}", "params": ["sub"] },
-  "maestro.stopScript": { "board": "maestro-native", "template": "stopScript", "params": [] },
-  "psi.mode": { "board": "psi-pro", "template": "{address}T{mode}", "params": ["address","mode"] },
-  "psi.swipe": { "board": "psi-pro", "template": "{address}A", "params": ["address"] },
-  "psi.default": { "board": "psi-pro", "template": "{address}D", "params": ["address"] },
-  "psi.cfg.alwaysOn": { "board": "psi-pro", "template": "0P{onoff}", "params": ["onoff"] },
-  "psi.cfg.brightSource": { "board": "psi-pro", "template": "1P{source}", "params": ["source"] },
-  "psi.cfg.brightSave": { "board": "psi-pro", "template": "2P{level}", "params": ["level"] },
-  "psi.cfg.brightTemp": { "board": "psi-pro", "template": "3P{level}", "params": ["level"] },
-  "hcr.native.stimulus": { "board": "hcr-native", "template": "<S{emotion}{intensity}>", "params": ["emotion","intensity"] },
-  "hcr.native.overload": { "board": "hcr-native", "template": "<SE>", "params": [] },
-  "hcr.native.muse": { "board": "hcr-native", "template": "<M{state}>", "params": ["state"] },
-  "hcr.native.museSingle": { "board": "hcr-native", "template": "<MM>", "params": [] },
-  "hcr.native.museMinGap": { "board": "hcr-native", "template": "<MN{seconds}>", "params": ["seconds"] },
-  "hcr.native.museMaxGap": { "board": "hcr-native", "template": "<MX{seconds}>", "params": ["seconds"] },
-  "hcr.native.playWav": { "board": "hcr-native", "template": "<C{channel}{file}>", "params": ["channel","file"] },
-  "hcr.native.playWavRandom": { "board": "hcr-native", "template": "<C{channel}{fileFrom}C{fileTo}>", "params": ["channel","fileFrom","fileTo"] },
-  "hcr.native.stop": { "board": "hcr-native", "template": "<PS{target}>", "params": ["target"] },
-  "hcr.native.volume": { "board": "hcr-native", "template": "<PV{target}{level}>", "params": ["target","level"] },
-  "hcr.native.canonMode": { "board": "hcr-native", "template": "<OA{mode}>", "params": ["mode"] },
-  "hcr.native.personalityOverride": { "board": "hcr-native", "template": "<O{state}>", "params": ["state"] },
-  "hcr.native.resetEmotions": { "board": "hcr-native", "template": "<OR>", "params": [] },
-  "hcr.native.setEmotion": { "board": "hcr-native", "template": "<O{emotion}{value}>", "params": ["emotion","value"] },
-  "hcr.native.memoryPlay": { "board": "hcr-native", "template": "<RRP{slot}>", "params": ["slot"] },
-  "hcr.native.memorySave": { "board": "hcr-native", "template": "<RRS{slot}>", "params": ["slot"] },
-  "hcr.native.memoryMode": { "board": "hcr-native", "template": "<R{mode}>", "params": ["mode"] },
-  "hcr.native.query": { "board": "hcr-native", "template": "<Q{query}>", "params": ["query"] },
-  "chirp.play": { "board": "chirp", "template": "PLAY:{index}", "params": ["index"] },
-  "chirp.stop": { "board": "chirp", "template": "STOP", "params": [] },
-  "chirp.stop.stream": { "board": "chirp", "template": "STOP:{stream}", "params": ["stream"] },
-  "chirp.vol": { "board": "chirp", "template": "VOL:{volume}", "params": ["volume"] },
-  "chirp.vol.stream": { "board": "chirp", "template": "VOL:{stream},{volume}", "params": ["stream","volume"] },
-  "chirp.stat": { "board": "chirp", "template": "STAT:{stream}", "params": ["stream"] },
-  "chirp.list": { "board": "chirp", "template": "LIST", "params": [] },
-  "chirp.gman": { "board": "chirp", "template": "GMAN", "params": [] },
-  "chirp.gnme": { "board": "chirp", "template": "GNME:{bank},{page},{index}", "params": ["bank","page","index"] },
-  "chirp.baud": { "board": "chirp", "template": "BAUD:{rate}", "params": ["rate"] },
-  "chirp.bpage": { "board": "chirp", "template": "BPAGE:{page}", "params": ["page"] },
-  "chirp.ccrc": { "board": "chirp", "template": "CCRC", "params": [] },
-  "chirp.musb": { "board": "chirp", "template": "MUSB:{on}", "params": ["on"] },
-  "chirp.pvoice": { "board": "chirp", "template": "PVOICE:{filename}", "params": ["filename"] },
-  "chirp.play.full": { "board": "chirp", "template": "PLAY:{index},{bank},{page},{volume}", "params": ["index","bank","page","volume"] },
-  "chirp.chirp": { "board": "chirp", "template": "CHRP:{startHz},{endHz},{durationMs}", "params": ["startHz","endHz","durationMs"] },
-  "uppity.playseq": { "board": "r2uppityspinner-alt", "template": ":PS{seq}", "params": ["seq"] },
-  "uppity.lifter.seek": { "board": "r2uppityspinner-alt", "template": ":PP{position}", "params": ["position"] },
-  "uppity.lifter.seek.speed": { "board": "r2uppityspinner-alt", "template": ":PP{position},{speed}", "params": ["position","speed"] },
-  "uppity.lifter.seek.random": { "board": "r2uppityspinner-alt", "template": ":PPR", "params": [] },
-  "uppity.lifter.home": { "board": "r2uppityspinner-alt", "template": ":PH", "params": [] },
-  "uppity.lifter.home.speed": { "board": "r2uppityspinner-alt", "template": ":PH{speed}", "params": ["speed"] },
-  "uppity.estop": { "board": "r2uppityspinner-alt", "template": ":PX", "params": [] },
-  "uppity.rotary.spin": { "board": "r2uppityspinner-alt", "template": ":PR{speed}", "params": ["speed"] },
-  "uppity.rotary.spin.random": { "board": "r2uppityspinner-alt", "template": ":PRR{max}", "params": ["max"] },
-  "uppity.rotary.abs": { "board": "r2uppityspinner-alt", "template": ":PA{degrees}", "params": ["degrees"] },
-  "uppity.rotary.abs.speed": { "board": "r2uppityspinner-alt", "template": ":PA{degrees},{speed},{maxspeed}", "params": ["degrees","speed","maxspeed"] },
-  "uppity.rotary.abs.random": { "board": "r2uppityspinner-alt", "template": ":PAR", "params": [] },
-  "uppity.rotary.rel": { "board": "r2uppityspinner-alt", "template": ":PD{degrees}", "params": ["degrees"] },
-  "uppity.rotary.rel.random": { "board": "r2uppityspinner-alt", "template": ":PDR", "params": [] },
-  "uppity.movemode.auto": { "board": "r2uppityspinner-alt", "template": ":PM", "params": [] },
-  "uppity.movemode.aggr": { "board": "r2uppityspinner-alt", "template": ":PM{level}", "params": ["level"] },
-  "uppity.movemode.params": { "board": "r2uppityspinner-alt", "template": ":PM,{liftSpeed},{rotSpeed},{minInterval},{maxInterval}", "params": ["liftSpeed","rotSpeed","minInterval","maxInterval"] },
-  "uppity.light": { "board": "r2uppityspinner-alt", "template": ":PL{mode}", "params": ["mode"] },
-  "uppity.light.random": { "board": "r2uppityspinner-alt", "template": ":PLR", "params": [] },
-  "uppity.wait": { "board": "r2uppityspinner-alt", "template": ":PW{seconds}", "params": ["seconds"] },
-  "uppity.wait.random": { "board": "r2uppityspinner-alt", "template": ":PWR{max}", "params": ["max"] },
-  "uppity.cfg.calibrate": { "board": "r2uppityspinner-alt", "template": "#PSC", "params": [] },
-  "uppity.cfg.setId": { "board": "r2uppityspinner-alt", "template": "#PID{id}", "params": ["id"] },
-  "uppity.cfg.zero": { "board": "r2uppityspinner-alt", "template": "#PZERO", "params": [] },
-  "uppity.cfg.factory": { "board": "r2uppityspinner-alt", "template": "#PFACTORY", "params": [] },
-  "uppity.cfg.restart": { "board": "r2uppityspinner-alt", "template": "#PRESTART", "params": [] },
-  "uppity.cfg.debug": { "board": "r2uppityspinner-alt", "template": "#PDEBUG{state}", "params": ["state"] },
-  "uppity.cfg.wifiReset": { "board": "r2uppityspinner-alt", "template": "#PWIFIRESET", "params": [] },
-  "uppity.cfg.wifi": { "board": "r2uppityspinner-alt", "template": "#PWIFI{state}", "params": ["state"] },
-  "uppity.cfg.aggression": { "board": "r2uppityspinner-alt", "template": "#PAGGRESSION{level}", "params": ["level"] },
-  "uppity.cfg.motor": { "board": "r2uppityspinner-alt", "template": "#PMOTOR{type}", "params": ["type"] },
-  "uppity.cfg.expert": { "board": "r2uppityspinner-alt", "template": "#PEXPERT{state}", "params": ["state"] },
-  "uppity.cfg.status": { "board": "r2uppityspinner-alt", "template": "#PSTATUS", "params": [] },
-  "uppity.cfg.config": { "board": "r2uppityspinner-alt", "template": "#PCONFIG", "params": [] },
-  "uppity.cfg.listSeq": { "board": "r2uppityspinner-alt", "template": "#PL", "params": [] },
-  "uppity.cfg.deleteSeq": { "board": "r2uppityspinner-alt", "template": "#PD{seq}", "params": ["seq"] },
-  "uppity.cfg.rc": { "board": "r2uppityspinner-alt", "template": "#PRC{state}", "params": ["state"] },
-  "uppity.cfg.rotaryToggle": { "board": "r2uppityspinner-alt", "template": "#PR", "params": [] },
-  "uppity.cfg.baud": { "board": "r2uppityspinner-alt", "template": "#PBAUD{rate}", "params": ["rate"] },
-  "uppity.cfg.lifterLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"] },
-  "uppity.cfg.rotaryLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"] },
-  "rad.rotate.abs": { "board": "roam-a-dome", "template": ":DPA{deg}", "params": ["deg"] },
-  "rad.rotate.absRamp": { "board": "roam-a-dome", "template": ":DPA{deg},{speed},{maxspeed}", "params": ["deg","speed","maxspeed"] },
-  "rad.rotate.absRandom": { "board": "roam-a-dome", "template": ":DPAR", "params": [] },
-  "rad.rotate.rel": { "board": "roam-a-dome", "template": ":DPD{deg}", "params": ["deg"] },
-  "rad.rotate.relRandom": { "board": "roam-a-dome", "template": ":DPDR", "params": [] },
-  "rad.spin": { "board": "roam-a-dome", "template": ":DPR{speed}", "params": ["speed"] },
-  "rad.home": { "board": "roam-a-dome", "template": ":DPH", "params": [] },
-  "rad.wait": { "board": "roam-a-dome", "template": ":DPW{seconds}", "params": ["seconds"] },
-  "rad.waitRandom": { "board": "roam-a-dome", "template": ":DPWR{min},{max}", "params": ["min","max"] },
-  "rad.playSeq": { "board": "roam-a-dome", "template": ":DPS{number}", "params": ["number"] },
-  "rad.togglePin": { "board": "roam-a-dome", "template": ":DPT{pin}", "params": ["pin"] },
-  "rad.cfg.zero": { "board": "roam-a-dome", "template": "#DPZERO", "params": [] },
-  "rad.cfg.factory": { "board": "roam-a-dome", "template": "#DPFACTORY", "params": [] },
-  "rad.cfg.restart": { "board": "roam-a-dome", "template": "#DPRESTART", "params": [] },
-  "rad.cfg.status": { "board": "roam-a-dome", "template": "#DPSTATUS", "params": [] },
-  "rad.cfg.config": { "board": "roam-a-dome", "template": "#DPCONFIG", "params": [] },
-  "rad.cfg.setupVelocity": { "board": "roam-a-dome", "template": "#DPSETUPVELOCITY{value}", "params": ["value"] },
-  "rad.cfg.setup": { "board": "roam-a-dome", "template": "#DPSETUP", "params": [] },
-  "rad.cfg.maxspeed": { "board": "roam-a-dome", "template": "#DPMAXSPEED{value}", "params": ["value"] },
-  "rad.cfg.homespeed": { "board": "roam-a-dome", "template": "#DPHOMESPEED{value}", "params": ["value"] },
-  "rad.cfg.autospeed": { "board": "roam-a-dome", "template": "#DPAUTOSPEED{value}", "params": ["value"] },
-  "rad.cfg.targetspeed": { "board": "roam-a-dome", "template": "#DPTARGETSPEED{value}", "params": ["value"] },
-  "rad.cfg.minspeed": { "board": "roam-a-dome", "template": "#DPMINSPEED{value}", "params": ["value"] },
-  "rad.cfg.inputspeed": { "board": "roam-a-dome", "template": "#DPINPUTSPEED{value}", "params": ["value"] },
-  "rad.cfg.autoleft": { "board": "roam-a-dome", "template": "#DPAUTOLEFT{value}", "params": ["value"] },
-  "rad.cfg.autoright": { "board": "roam-a-dome", "template": "#DPAUTORIGHT{value}", "params": ["value"] },
-  "rad.cfg.fudge": { "board": "roam-a-dome", "template": "#DPFUDGE{value}", "params": ["value"] },
-  "rad.cfg.homePosHere": { "board": "roam-a-dome", "template": "#DPHOMEPOS", "params": [] },
-  "rad.cfg.homePos": { "board": "roam-a-dome", "template": "#DPHOMEPOS{deg}", "params": ["deg"] },
-  "rad.cfg.automin": { "board": "roam-a-dome", "template": "#DPAUTOMIN{value}", "params": ["value"] },
-  "rad.cfg.automax": { "board": "roam-a-dome", "template": "#DPAUTOMAX{value}", "params": ["value"] },
-  "rad.cfg.homemin": { "board": "roam-a-dome", "template": "#DPHOMEMIN{value}", "params": ["value"] },
-  "rad.cfg.homemax": { "board": "roam-a-dome", "template": "#DPHOMEMAX{value}", "params": ["value"] },
-  "rad.cfg.targetmin": { "board": "roam-a-dome", "template": "#DPTARGETMIN{value}", "params": ["value"] },
-  "rad.cfg.targetmax": { "board": "roam-a-dome", "template": "#DPTARGETMAX{value}", "params": ["value"] },
-  "rad.cfg.timeout": { "board": "roam-a-dome", "template": "#DPTIMEOUT{value}", "params": ["value"] },
-  "rad.cfg.report": { "board": "roam-a-dome", "template": "#DPREPORT{value}", "params": ["value"] },
-  "rad.cfg.home": { "board": "roam-a-dome", "template": "#DPHOME{state}", "params": ["state"] },
-  "rad.cfg.auto": { "board": "roam-a-dome", "template": "#DPAUTO{state}", "params": ["state"] },
-  "rad.cfg.autosafety": { "board": "roam-a-dome", "template": "#DPAUTOSAFETY{state}", "params": ["state"] },
-  "rad.cfg.autorestart": { "board": "roam-a-dome", "template": "#DPAUTORESTART{state}", "params": ["state"] },
-  "rad.cfg.invert": { "board": "roam-a-dome", "template": "#DPINVERT{state}", "params": ["state"] },
-  "rad.cfg.scale": { "board": "roam-a-dome", "template": "#DPSCALE{state}", "params": ["state"] },
-  "rad.cfg.ascale": { "board": "roam-a-dome", "template": "#DPASCALE{value}", "params": ["value"] },
-  "rad.cfg.dscale": { "board": "roam-a-dome", "template": "#DPDSCALE{value}", "params": ["value"] },
-  "rad.cfg.serialin": { "board": "roam-a-dome", "template": "#DPSERIALIN{state}", "params": ["state"] },
-  "rad.cfg.serialout": { "board": "roam-a-dome", "template": "#DPSERIALOUT{state}", "params": ["state"] },
-  "rad.cfg.serialbaud": { "board": "roam-a-dome", "template": "#DPSERIALBAUD{baud}", "params": ["baud"] },
-  "rad.cfg.syrenbaud": { "board": "roam-a-dome", "template": "#DPSYRENBAUD{baud}", "params": ["baud"] },
-  "rad.cfg.syrenaddrin": { "board": "roam-a-dome", "template": "#DPSYRENADDRIN{value}", "params": ["value"] },
-  "rad.cfg.syrenaddrout": { "board": "roam-a-dome", "template": "#DPSYRENADDROUT{value}", "params": ["value"] },
-  "rad.cfg.syrenaddr": { "board": "roam-a-dome", "template": "#DPSYRENADDR{value}", "params": ["value"] },
-  "rad.cfg.sensorbaud": { "board": "roam-a-dome", "template": "#DPSENSORBAUD{baud}", "params": ["baud"] },
-  "rad.cfg.pwmin": { "board": "roam-a-dome", "template": "#DPPWMIN{state}", "params": ["state"] },
-  "rad.cfg.pwmout": { "board": "roam-a-dome", "template": "#DPPWMOUT{state}", "params": ["state"] },
-  "rad.cfg.pwmarc": { "board": "roam-a-dome", "template": "#DPPWMARC{state}", "params": ["state"] },
-  "rad.cfg.pwmmin": { "board": "roam-a-dome", "template": "#DPPWMMIN{value}", "params": ["value"] },
-  "rad.cfg.pwmmax": { "board": "roam-a-dome", "template": "#DPPWMMAX{value}", "params": ["value"] },
-  "rad.cfg.pwmneutral": { "board": "roam-a-dome", "template": "#DPPWMNEUTRAL{value}", "params": ["value"] },
-  "rad.cfg.pwmdeadband": { "board": "roam-a-dome", "template": "#DPPWMDEADBAND{value}", "params": ["value"] },
-  "rad.cfg.pin": { "board": "roam-a-dome", "template": "#DPPIN{pin}{value}", "params": ["pin","value"] },
-  "rad.cfg.wifi": { "board": "roam-a-dome", "template": "#DPWIFI{state}", "params": ["state"] },
-  "rad.cfg.remote": { "board": "roam-a-dome", "template": "#DPREMOTE{state}", "params": ["state"] },
-  "rad.cfg.rname": { "board": "roam-a-dome", "template": "#DPRNAME{name}", "params": ["name"] },
-  "rad.cfg.rsecret": { "board": "roam-a-dome", "template": "#DPRSECRET{secret}", "params": ["secret"] },
-  "rad.cfg.pair": { "board": "roam-a-dome", "template": "#DPPAIR", "params": [] },
-  "rad.cfg.unpair": { "board": "roam-a-dome", "template": "#DPUNPAIR", "params": [] },
-  "rad.cfg.listSeq": { "board": "roam-a-dome", "template": "#DPL", "params": [] },
-  "rad.cfg.deleteSeq": { "board": "roam-a-dome", "template": "#DPD{slot}", "params": ["slot"] },
-  "rad.cfg.storeSeq": { "board": "roam-a-dome", "template": "#DPS{slot}:{body}", "params": ["slot","body"] },
-  "rad.cfg.debug": { "board": "roam-a-dome", "template": "#DPDEBUG{state}", "params": ["state"] },
-  "rad.cfg.joy": { "board": "roam-a-dome", "template": "#DPJOY", "params": [] },
-  "ap.cfg.wifi": { "board": "astropixels-plus", "template": "#APWIFI{state}", "params": ["state"] },
-  "ap.cfg.remote": { "board": "astropixels-plus", "template": "#APREMOTE{state}", "params": ["state"] },
-  "ap.cfg.rname": { "board": "astropixels-plus", "template": "#APRNAME{name}", "params": ["name"] },
-  "ap.cfg.rsecret": { "board": "astropixels-plus", "template": "#APRSECRET{secret}", "params": ["secret"] },
-  "ap.cfg.pair": { "board": "astropixels-plus", "template": "#APPAIR", "params": [] },
-  "ap.cfg.unpair": { "board": "astropixels-plus", "template": "#APUNPAIR", "params": [] },
-  "ap.cfg.zero": { "board": "astropixels-plus", "template": "#APZERO", "params": [] },
-  "ap.cfg.restart": { "board": "astropixels-plus", "template": "#APRESTART", "params": [] },
-  "ap.panel.macro": { "board": "astropixels-plus", "template": ":{action}{group}", "params": ["action","group"] },
-  "ap.panel.dynamic": { "board": "astropixels-plus", "template": ":{code}${rest}", "params": ["code","rest"] },
-  "ap.seq.play": { "board": "astropixels-plus", "template": ":SE{seq}", "params": ["seq"] },
-  "ap.snd.play": { "board": "astropixels-sound", "template": "${bank}{nn}", "params": ["bank","nn"] },
-  "ap.snd.random": { "board": "astropixels-sound", "template": "$R", "params": [] },
-  "ap.snd.off": { "board": "astropixels-sound", "template": "$O", "params": [] },
-  "ap.snd.stop": { "board": "astropixels-sound", "template": "$s", "params": [] },
-  "ap.snd.leia": { "board": "astropixels-sound", "template": "$L", "params": [] },
-  "ap.snd.cantinaMusic": { "board": "astropixels-sound", "template": "$C", "params": [] },
-  "ap.snd.beepCantina": { "board": "astropixels-sound", "template": "$c", "params": [] },
-  "ap.snd.scream": { "board": "astropixels-sound", "template": "$S", "params": [] },
-  "ap.snd.faint": { "board": "astropixels-sound", "template": "$F", "params": [] },
-  "ap.snd.disco": { "board": "astropixels-sound", "template": "$D", "params": [] },
-  "ap.snd.starwars": { "board": "astropixels-sound", "template": "$W", "params": [] },
-  "ap.snd.march": { "board": "astropixels-sound", "template": "$M", "params": [] },
-  "ap.snd.volUp": { "board": "astropixels-sound", "template": "$+", "params": [] },
-  "ap.snd.volDown": { "board": "astropixels-sound", "template": "$-", "params": [] },
-  "ap.snd.volMid": { "board": "astropixels-sound", "template": "$m", "params": [] },
-  "ap.snd.volMax": { "board": "astropixels-sound", "template": "$f", "params": [] },
-  "ap.snd.volMin": { "board": "astropixels-sound", "template": "$p", "params": [] },
-  "ap.psi.effect": { "board": "astropixels-psi", "template": "@{addr}P{effect}", "params": ["addr","effect"] },
-  "ap.logic.effect": { "board": "astropixels-logics", "template": "@{addr}T{effect}", "params": ["addr","effect"] },
-  "ap.logic.text": { "board": "astropixels-logics", "template": "@{addr}M{text}", "params": ["addr","text"] },
-  "ap.logic.font": { "board": "astropixels-logics", "template": "@{addr}P{font}", "params": ["addr","font"] },
-  "ap.hp.on": { "board": "astropixels-holo", "template": "*ON{dev}", "params": ["dev"] },
-  "ap.hp.off": { "board": "astropixels-holo", "template": "*OF{dev}", "params": ["dev"] },
-  "ap.hp.resetAll": { "board": "astropixels-holo", "template": "*ST00", "params": [] },
-  "ap.hp.random": { "board": "astropixels-holo", "template": "*RD{dev}", "params": ["dev"] },
-  "ap.hp.dimPulse": { "board": "astropixels-holo", "template": "*HPS3{dev}", "params": ["dev"] },
-  "ap.hp.rainbow": { "board": "astropixels-holo", "template": "*HPS6{dev}", "params": ["dev"] },
-  "ap.hp.position": { "board": "astropixels-holo", "template": "*HP{pos}{dev}", "params": ["pos","dev"] },
-  "ap.hp.wag": { "board": "astropixels-holo", "template": "*HW{dev}", "params": ["dev"] },
-  "ap.hp.nod": { "board": "astropixels-holo", "template": "*HN{dev}", "params": ["dev"] },
-  "ap.hp.radar": { "board": "astropixels-holo", "template": "*HRS{mode}", "params": ["mode"] },
-  "ap.hp.legacyOn": { "board": "astropixels-holo", "template": "@{ldev}T1", "params": ["ldev"] },
-  "ap.hp.legacyOff": { "board": "astropixels-holo", "template": "@{ldev}D", "params": ["ldev"] },
-  "ap.hp.native.leia": { "board": "astropixels-holo", "template": "@HP{dev}001", "params": ["dev"] },
-  "ap.hp.native.colorproj": { "board": "astropixels-holo", "template": "@HP{dev}002{color}", "params": ["dev","color"] },
-  "ap.hp.native.dimpulse": { "board": "astropixels-holo", "template": "@HP{dev}003{color}{speed}", "params": ["dev","color","speed"] },
-  "ap.hp.native.cycle": { "board": "astropixels-holo", "template": "@HP{dev}004{color}", "params": ["dev","color"] },
-  "ap.hp.native.solid": { "board": "astropixels-holo", "template": "@HP{dev}005{color}", "params": ["dev","color"] },
-  "ap.hp.native.rainbow": { "board": "astropixels-holo", "template": "@HP{dev}006", "params": ["dev"] },
-  "ap.hp.native.shortcircuit": { "board": "astropixels-holo", "template": "@HP{dev}007{color}", "params": ["dev","color"] },
-  "ap.hp.native.clearauto": { "board": "astropixels-holo", "template": "@HP{dev}0{mode}", "params": ["dev","mode"] },
-  "ap.hp.native.preset": { "board": "astropixels-holo", "template": "@HP{dev}101{position}", "params": ["dev","position"] },
-  "ap.hp.native.rcLR": { "board": "astropixels-holo", "template": "@HP{dev}102", "params": ["dev"] },
-  "ap.hp.native.rcUD": { "board": "astropixels-holo", "template": "@HP{dev}103", "params": ["dev"] },
-  "ap.hp.native.randomPos": { "board": "astropixels-holo", "template": "@HP{dev}104", "params": ["dev"] },
-  "ap.hp.native.wag": { "board": "astropixels-holo", "template": "@HP{dev}105", "params": ["dev"] },
-  "ap.hp.native.nod": { "board": "astropixels-holo", "template": "@HP{dev}106", "params": ["dev"] },
-  "ap.hp.native.autotwitch": { "board": "astropixels-holo", "template": "@HP{dev}1{mode}", "params": ["dev","mode"] },
-  "ap.hp.native.sequence": { "board": "astropixels-holo", "template": "@HP{seq}", "params": ["seq"] },
-  "ap.servo.quickMove": { "board": "astropixels-servo", "template": ":SQ{index},{pulse}", "params": ["index","pulse"] },
-  "ap.servo.move": { "board": "astropixels-servo", "template": ":SM{index},{pulse}", "params": ["index","pulse"] },
-  "ap.servo.moveTimed": { "board": "astropixels-servo", "template": ":SM{index},{moveTime},{pulse}", "params": ["index","moveTime","pulse"] },
-  "ap.servo.moveDelayed": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{pulse}", "params": ["index","startDelay","moveTime","pulse"] },
-  "ap.servo.moveFrom": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{startPulse},{pulse}", "params": ["index","startDelay","moveTime","startPulse","pulse"] },
-  "ap.servo.limits3": { "board": "astropixels-servo", "template": ":SL{index},{start},{end}", "params": ["index","start","end"] },
-  "ap.servo.limits4": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral}", "params": ["index","start","end","neutral"] },
-  "ap.servo.limits5": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral},{group}", "params": ["index","start","end","neutral","group"] },
-  "ap.servo.easing": { "board": "astropixels-servo", "template": ":SF{easingId}${group}", "params": ["easingId","group"] },
-  "wcb.hw": { "board": "wcb-native", "template": "?HW,{ver}", "params": ["ver"] },
-  "wcb.num": { "board": "wcb-native", "template": "?WCB,{n}", "params": ["n"] },
-  "wcb.qty": { "board": "wcb-native", "template": "?WCBQ,{n}", "params": ["n"] },
-  "wcb.mac2": { "board": "wcb-native", "template": "?MAC,2,{hex}", "params": ["hex"] },
-  "wcb.mac3": { "board": "wcb-native", "template": "?MAC,3,{hex}", "params": ["hex"] },
-  "wcb.epass": { "board": "wcb-native", "template": "?EPASS,{password}", "params": ["password"] },
-  "wcb.baud": { "board": "wcb-native", "template": "?BAUD,S{port},{rate}", "params": ["port","rate"] },
-  "wcb.label": { "board": "wcb-native", "template": "?LABEL,S{port},{text}", "params": ["port","text"] },
-  "wcb.labelClear": { "board": "wcb-native", "template": "?LABEL,CLEAR,S{port}", "params": ["port"] },
-  "wcb.labelClearAll": { "board": "wcb-native", "template": "?LABEL,CLEAR,ALL", "params": [] },
-  "wcb.bcastIn": { "board": "wcb-native", "template": "?BCAST,IN,S{port},{state}", "params": ["port","state"] },
-  "wcb.bcastOut": { "board": "wcb-native", "template": "?BCAST,OUT,S{port},{state}", "params": ["port","state"] },
-  "wcb.bcastReset": { "board": "wcb-native", "template": "?BCAST,RESET", "params": [] },
-  "wcb.mapSerial": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},{dest}", "params": ["port","dest"] },
-  "wcb.mapSerialRaw": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},R,{dest}", "params": ["port","dest"] },
-  "wcb.mapSerialList": { "board": "wcb-native", "template": "?MAP,SERIAL,LIST", "params": [] },
-  "wcb.mapSerialClear": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,S{port}", "params": ["port"] },
-  "wcb.mapSerialClearAll": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,ALL", "params": [] },
-  "wcb.mapPwm": { "board": "wcb-native", "template": "?MAP,PWM,S{port},{dest}", "params": ["port","dest"] },
-  "wcb.mapPwmOut": { "board": "wcb-native", "template": "?MAP,PWM,OUT,S{port}", "params": ["port"] },
-  "wcb.mapPwmList": { "board": "wcb-native", "template": "?MAP,PWM,LIST", "params": [] },
-  "wcb.mapPwmClear": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,S{port}", "params": ["port"] },
-  "wcb.mapPwmClearAll": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,ALL", "params": [] },
-  "wcb.mapClearAll": { "board": "wcb-native", "template": "?MAP,CLEAR,ALL", "params": [] },
-  "wcb.kyberLocal": { "board": "wcb-native", "template": "?KYBER,LOCAL", "params": [] },
-  "wcb.kyberRemote": { "board": "wcb-native", "template": "?KYBER,REMOTE", "params": [] },
-  "wcb.kyberClear": { "board": "wcb-native", "template": "?KYBER,CLEAR", "params": [] },
-  "wcb.kyberList": { "board": "wcb-native", "template": "?KYBER,LIST", "params": [] },
-  "wcb.maestroList": { "board": "wcb-native", "template": "?MAESTRO,LIST", "params": [] },
-  "wcb.maestroClear": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,{id}", "params": ["id"] },
-  "wcb.maestroClearAll": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,ALL", "params": [] },
-  "wcb.maestro": { "board": "wcb-native", "template": "?MAESTRO,{spec}", "params": ["spec"] },
-  "wcb.mp3Cfg": { "board": "wcb-native", "template": "?MP3,{spec}", "params": ["spec"] },
-  "wcb.mp3List": { "board": "wcb-native", "template": "?MP3,LIST", "params": [] },
-  "wcb.mp3OnErrClear": { "board": "wcb-native", "template": "?MP3,ONERR,CLEAR", "params": [] },
-  "wcb.mp3OnErr": { "board": "wcb-native", "template": "?MP3,ONERR,{key}", "params": ["key"] },
-  "wcb.mp3Clear": { "board": "wcb-native", "template": "?MP3,CLEAR", "params": [] },
-  "wcb.hcrPort": { "board": "wcb-native", "template": "?HCR,PORT,S{port}:{baud}", "params": ["port","baud"] },
-  "wcb.hcrPoll": { "board": "wcb-native", "template": "?HCR,POLL,{sec}", "params": ["sec"] },
-  "wcb.hcrList": { "board": "wcb-native", "template": "?HCR,LIST", "params": [] },
-  "wcb.hcrStatus": { "board": "wcb-native", "template": "?HCR,STATUS", "params": [] },
-  "wcb.hcrRefresh": { "board": "wcb-native", "template": "?HCR,REFRESH", "params": [] },
-  "wcb.hcrClear": { "board": "wcb-native", "template": "?HCR,CLEAR", "params": [] },
-  "wcb.hcrGet": { "board": "wcb-native", "template": "?HCR,GET,{field}", "params": ["field"] },
-  "wcb.routeSerial": { "board": "wcb-native", "template": ";S{port},{message}", "params": ["port","message"] },
-  "wcb.routeWcb": { "board": "wcb-native", "template": ";W{wcb},{message}", "params": ["wcb","message"] },
-  "wcb.timer": { "board": "wcb-native", "template": ";T{ms},{command}", "params": ["ms","command"] },
-  "wcb.seqSave": { "board": "wcb-native", "template": "?SEQ,SAVE,{key},{value}", "params": ["key","value"] },
-  "wcb.seqList": { "board": "wcb-native", "template": "?SEQ,LIST", "params": [] },
-  "wcb.seqClearAll": { "board": "wcb-native", "template": "?SEQ,CLEAR,ALL", "params": [] },
-  "wcb.seqClear": { "board": "wcb-native", "template": "?SEQ,CLEAR,{key}", "params": ["key"] },
-  "wcb.runSeq": { "board": "wcb-native", "template": ";C{key}", "params": ["key"] },
-  "wcb.runSeqLong": { "board": "wcb-native", "template": ";SEQ{key}", "params": ["key"] },
-  "wcb.etmOn": { "board": "wcb-native", "template": "?ETM,ON", "params": [] },
-  "wcb.etmOff": { "board": "wcb-native", "template": "?ETM,OFF", "params": [] },
-  "wcb.etmTimeout": { "board": "wcb-native", "template": "?ETM,TIMEOUT,{ms}", "params": ["ms"] },
-  "wcb.etmHb": { "board": "wcb-native", "template": "?ETM,HB,{sec}", "params": ["sec"] },
-  "wcb.etmMiss": { "board": "wcb-native", "template": "?ETM,MISS,{count}", "params": ["count"] },
-  "wcb.etmBoot": { "board": "wcb-native", "template": "?ETM,BOOT,{sec}", "params": ["sec"] },
-  "wcb.etmCount": { "board": "wcb-native", "template": "?ETM,COUNT,{n}", "params": ["n"] },
-  "wcb.etmDelay": { "board": "wcb-native", "template": "?ETM,DELAY,{ms}", "params": ["ms"] },
-  "wcb.etmChar": { "board": "wcb-native", "template": "?ETM,CHAR", "params": [] },
-  "wcb.etmChksum": { "board": "wcb-native", "template": "?ETM,CHKSM,{state}", "params": ["state"] },
-  "wcb.debug": { "board": "wcb-native", "template": "?DEBUG,{state}", "params": ["state"] },
-  "wcb.debugEtm": { "board": "wcb-native", "template": "?DEBUG,ETM,{state}", "params": ["state"] },
-  "wcb.debugPwm": { "board": "wcb-native", "template": "?DEBUG,PWM,{state}", "params": ["state"] },
-  "wcb.debugMaestro": { "board": "wcb-native", "template": "?DEBUG,MAESTRO,{state}", "params": ["state"] },
-  "wcb.debugHcr": { "board": "wcb-native", "template": "?DEBUG,HCR,{state}", "params": ["state"] },
-  "wcb.stats": { "board": "wcb-native", "template": "?STATS", "params": [] },
-  "wcb.statsReset": { "board": "wcb-native", "template": "?STATS,RESET", "params": [] },
-  "wcb.delim": { "board": "wcb-native", "template": "?DELIM,{char}", "params": ["char"] },
-  "wcb.funcChar": { "board": "wcb-native", "template": "?FUNCCHAR,{char}", "params": ["char"] },
-  "wcb.cmdChar": { "board": "wcb-native", "template": "?CMDCHAR,{char}", "params": ["char"] },
-  "wcb.config": { "board": "wcb-native", "template": "?config", "params": [] },
-  "wcb.backup": { "board": "wcb-native", "template": "?backup", "params": [] },
-  "wcb.reboot": { "board": "wcb-native", "template": "?reboot", "params": [] },
-  "wcb.eraseNvs": { "board": "wcb-native", "template": "?ERASE,NVS", "params": [] },
-  "wled.on": { "board": "wcb-wled", "template": ";L{wledId},ON", "params": ["wledId"] },
-  "wled.off": { "board": "wcb-wled", "template": ";L{wledId},OFF", "params": ["wledId"] },
-  "wled.toggle": { "board": "wcb-wled", "template": ";L{wledId},TOGGLE", "params": ["wledId"] },
-  "wled.bri": { "board": "wcb-wled", "template": ";L{wledId},BRI,{level}", "params": ["wledId","level"] },
-  "wled.preset": { "board": "wcb-wled", "template": ";L{wledId},PS,{preset}", "params": ["wledId","preset"] },
-  "wled.color": { "board": "wcb-wled", "template": ";L{wledId},COL,{color}", "params": ["wledId","color"] },
-  "wled.fx": { "board": "wcb-wled", "template": ";L{wledId},FX,{index}", "params": ["wledId","index"] },
-  "wled.fxfull": { "board": "wcb-wled", "template": ";L{wledId},FX,{index},{speed},{intensity}", "params": ["wledId","index","speed","intensity"] },
-  "wled.pal": { "board": "wcb-wled", "template": ";L{wledId},PAL,{index}", "params": ["wledId","index"] },
-  "wled.json": { "board": "wcb-wled", "template": ";L{wledId},JSON,{payload}", "params": ["wledId","payload"] }
+  "flthy.led.leia": { "board": "flthy-hps", "template": "{designator}001", "params": ["designator"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.colorproj": { "board": "flthy-hps", "template": "{designator}002{color}", "params": ["designator","color"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.dimpulse": { "board": "flthy-hps", "template": "{designator}003{color}{speed}", "params": ["designator","color","speed"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.cycle": { "board": "flthy-hps", "template": "{designator}004{color}", "params": ["designator","color"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.shortcircuit": { "board": "flthy-hps", "template": "{designator}005{color}", "params": ["designator","color"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.clearauto": { "board": "flthy-hps", "template": "{designator}0{mode}", "params": ["designator","mode"], "encoder": "template", "supportsDuration": false },
+  "flthy.led.solid": { "board": "flthy-hps", "template": "{designator}006{color}", "params": ["designator","color"], "encoder": "template", "supportsDuration": true },
+  "flthy.led.rainbow": { "board": "flthy-hps", "template": "{designator}007", "params": ["designator"], "encoder": "template", "supportsDuration": true },
+  "flthy.servo.preset": { "board": "flthy-hps", "template": "{designator}101{position}", "params": ["designator","position"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.rc-lr": { "board": "flthy-hps", "template": "{designator}102", "params": ["designator"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.rc-ud": { "board": "flthy-hps", "template": "{designator}103", "params": ["designator"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.random": { "board": "flthy-hps", "template": "{designator}104", "params": ["designator"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.wag-lr": { "board": "flthy-hps", "template": "{designator}105", "params": ["designator"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.wag-ud": { "board": "flthy-hps", "template": "{designator}106", "params": ["designator"], "encoder": "template", "supportsDuration": false },
+  "flthy.servo.autotwitch": { "board": "flthy-hps", "template": "{designator}1{mode}", "params": ["designator","mode"], "encoder": "template", "supportsDuration": false },
+  "flthy.special.sequence": { "board": "flthy-hps", "template": "{special}", "params": ["special"], "encoder": "template", "supportsDuration": false },
+  "iamp.mode": { "board": "ia-magic-panel", "template": "T{mode}", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "pdmp.pattern": { "board": "pd-magic-panel", "template": "T{pattern}", "params": ["pattern"], "encoder": "template", "supportsDuration": false },
+  "pdmp.pattern.timed": { "board": "pd-magic-panel", "template": "T{pattern}:{duration}", "params": ["pattern","duration"], "encoder": "template", "supportsDuration": false },
+  "pdmp.demo": { "board": "pd-magic-panel", "template": "DEMO", "params": [], "encoder": "template", "supportsDuration": false },
+  "pdmp.brightness": { "board": "pd-magic-panel", "template": "B{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "pdmp.speed": { "board": "pd-magic-panel", "template": "V{speed}", "params": ["speed"], "encoder": "template", "supportsDuration": false },
+  "pdmp.color": { "board": "pd-magic-panel", "template": "C {color}", "params": ["color"], "encoder": "template", "supportsDuration": false },
+  "pdmp.rgb": { "board": "pd-magic-panel", "template": "C {r},{g},{b}", "params": ["r","g","b"], "encoder": "template", "supportsDuration": false },
+  "pdmp.transition": { "board": "pd-magic-panel", "template": "TRANSITION {state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "pdmp.text": { "board": "pd-magic-panel", "template": "TEXT:{message}", "params": ["message"], "encoder": "template", "supportsDuration": false },
+  "pdmp.text.bounce": { "board": "pd-magic-panel", "template": "TEXT_BOUNCE:{message}", "params": ["message"], "encoder": "template", "supportsDuration": false },
+  "pdmp.text.save": { "board": "pd-magic-panel", "template": "TEXTSAVE{slot}:{message}", "params": ["slot","message"], "encoder": "template", "supportsDuration": false },
+  "pdmp.text.load": { "board": "pd-magic-panel", "template": "TEXTLOAD{slot}", "params": ["slot"], "encoder": "template", "supportsDuration": false },
+  "pdmp.font": { "board": "pd-magic-panel", "template": "FONT {font}", "params": ["font"], "encoder": "template", "supportsDuration": false },
+  "pdmp.playlist": { "board": "pd-magic-panel", "template": "PLAYLIST_RUN:{ids}", "params": ["ids"], "encoder": "template", "supportsDuration": false },
+  "pdmp.startup": { "board": "pd-magic-panel", "template": "START {pattern}", "params": ["pattern"], "encoder": "template", "supportsDuration": false },
+  "pdmp.mode": { "board": "pd-magic-panel", "template": "P{mode}", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "pdmp.save": { "board": "pd-magic-panel", "template": "SAVE", "params": [], "encoder": "template", "supportsDuration": false },
+  "pdmp.load": { "board": "pd-magic-panel", "template": "LOAD", "params": [], "encoder": "template", "supportsDuration": false },
+  "pdmp.on": { "board": "pd-magic-panel", "template": "ON", "params": [], "encoder": "template", "supportsDuration": false },
+  "pdmp.off": { "board": "pd-magic-panel", "template": "OFF", "params": [], "encoder": "template", "supportsDuration": false },
+  "rseries.effect": { "board": "rseries-logic", "template": null, "params": ["effect","color","speed","seconds","target"], "encoder": "rseries-le", "supportsDuration": false },
+  "rseries.text": { "board": "rseries-logic", "template": "@{address}M{text}", "params": ["address","text"], "encoder": "template", "supportsDuration": false },
+  "rseries.font": { "board": "rseries-logic", "template": "@{address}P{font}", "params": ["address","font"], "encoder": "template", "supportsDuration": false },
+  "rseries.cfg.wifi": { "board": "rseries-logic", "template": "#LEWIFI{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rseries.cfg.remote": { "board": "rseries-logic", "template": "#LEREMOTE{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rseries.sys.restart": { "board": "rseries-logic", "template": "#LERESTART", "params": [], "encoder": "template", "supportsDuration": false },
+  "rseries.sys.zero": { "board": "rseries-logic", "template": "#LEZERO", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.stim": { "board": "wcb-hcr", "template": ";H,STIM,{emotion},{strength}", "params": ["emotion","strength"], "encoder": "template", "supportsDuration": false },
+  "hcr.play": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file}", "params": ["channel","file"], "encoder": "template", "supportsDuration": false },
+  "hcr.vol": { "board": "wcb-hcr", "template": ";H,VOL,{channel},{level}", "params": ["channel","level"], "encoder": "template", "supportsDuration": false },
+  "hcr.volUp": { "board": "wcb-hcr", "template": ";H,VOLUP,{channel},{step}", "params": ["channel","step"], "encoder": "template", "supportsDuration": false },
+  "hcr.volUpAll": { "board": "wcb-hcr", "template": ";H,VOLUP", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.volDown": { "board": "wcb-hcr", "template": ";H,VOLDN,{channel},{step}", "params": ["channel","step"], "encoder": "template", "supportsDuration": false },
+  "hcr.volDownAll": { "board": "wcb-hcr", "template": ";H,VOLDN", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.fadeIn": { "board": "wcb-hcr", "template": ";H,FADEIN,{channel},{sec}", "params": ["channel","sec"], "encoder": "template", "supportsDuration": false },
+  "hcr.fadeOut": { "board": "wcb-hcr", "template": ";H,FADEOUT,{channel},{sec}", "params": ["channel","sec"], "encoder": "template", "supportsDuration": false },
+  "hcr.playFade": { "board": "wcb-hcr", "template": ";H,PLAY,{channel},{file},FADEIN,{sec}", "params": ["channel","file","sec"], "encoder": "template", "supportsDuration": false },
+  "hcr.overload": { "board": "wcb-hcr", "template": ";H,OVERLOAD", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.setEmotion": { "board": "wcb-hcr", "template": ";H,SETEMOTION,{emotion},{value}", "params": ["emotion","value"], "encoder": "template", "supportsDuration": false },
+  "hcr.override": { "board": "wcb-hcr", "template": ";H,OVERRIDE,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "hcr.muse": { "board": "wcb-hcr", "template": ";H,MUSE", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.museSet": { "board": "wcb-hcr", "template": ";H,MUSE,{mode}", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "hcr.museGap": { "board": "wcb-hcr", "template": ";H,MUSE,GAP,{min},{max}", "params": ["min","max"], "encoder": "template", "supportsDuration": false },
+  "hcr.stopEmote": { "board": "wcb-hcr", "template": ";H,STOPEMOTE", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.resetEmotions": { "board": "wcb-hcr", "template": ";H,RESETEMOTIONS", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.stop": { "board": "wcb-hcr", "template": ";H,STOP", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.stopWav": { "board": "wcb-hcr", "template": ";H,STOPWAV,{channel}", "params": ["channel"], "encoder": "template", "supportsDuration": false },
+  "hcr.fn": { "board": "wcb-hcr", "template": ";H,FN,{fn},{chan},{track}", "params": ["fn","chan","track"], "encoder": "template", "supportsDuration": false },
+  "hcr.raw": { "board": "wcb-hcr", "template": ";H,RAW,{payload}", "params": ["payload"], "encoder": "template", "supportsDuration": false },
+  "mp3.play": { "board": "wcb-mp3", "template": ";A,PLAY,{track}", "params": ["track"], "encoder": "template", "supportsDuration": false },
+  "mp3.playCb": { "board": "wcb-mp3", "template": ";A,PLAY,{track},ONFIN,{key}", "params": ["track","key"], "encoder": "template", "supportsDuration": false },
+  "mp3.playFs": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track}", "params": ["track"], "encoder": "template", "supportsDuration": false },
+  "mp3.playFsCb": { "board": "wcb-mp3", "template": ";A,PLAYFS,{track},ONFIN,{key}", "params": ["track","key"], "encoder": "template", "supportsDuration": false },
+  "mp3.stop": { "board": "wcb-mp3", "template": ";A,STOP", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.next": { "board": "wcb-mp3", "template": ";A,NEXT", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.prev": { "board": "wcb-mp3", "template": ";A,PREV", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.vol": { "board": "wcb-mp3", "template": ";A,VOL,{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "mp3.volUp": { "board": "wcb-mp3", "template": ";A,VOLUP", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.volDown": { "board": "wcb-mp3", "template": ";A,VOLDN", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.count": { "board": "wcb-mp3", "template": ";A,COUNT", "params": [], "encoder": "template", "supportsDuration": false },
+  "mp3.ver": { "board": "wcb-mp3", "template": ";A,VER", "params": [], "encoder": "template", "supportsDuration": false },
+  "maestro.trigger": { "board": "maestro", "template": ";M{id}{seq}", "params": ["id","seq"], "encoder": "template", "supportsDuration": false },
+  "maestro.setTarget": { "board": "maestro-native", "template": "setTarget,{channel},{position}", "params": ["channel","position"], "encoder": "template", "supportsDuration": false },
+  "maestro.goHome": { "board": "maestro-native", "template": "goHome", "params": [], "encoder": "template", "supportsDuration": false },
+  "maestro.setSpeed": { "board": "maestro-native", "template": "setSpeed,{channel},{value}", "params": ["channel","value"], "encoder": "template", "supportsDuration": false },
+  "maestro.setAccel": { "board": "maestro-native", "template": "setAccel,{channel},{value}", "params": ["channel","value"], "encoder": "template", "supportsDuration": false },
+  "maestro.setSpeedAccel": { "board": "maestro-native", "template": "setSpeedAccel,{channel},{speed},{accel}", "params": ["channel","speed","accel"], "encoder": "template", "supportsDuration": false },
+  "maestro.setEasing": { "board": "maestro-native", "template": "setEasing,{profile}", "params": ["profile"], "encoder": "template", "supportsDuration": false },
+  "maestro.restartScript": { "board": "maestro-native", "template": "restartScript,{sub}", "params": ["sub"], "encoder": "template", "supportsDuration": false },
+  "maestro.stopScript": { "board": "maestro-native", "template": "stopScript", "params": [], "encoder": "template", "supportsDuration": false },
+  "psi.mode": { "board": "psi-pro", "template": "{address}T{mode}", "params": ["address","mode"], "encoder": "template", "supportsDuration": true },
+  "psi.swipe": { "board": "psi-pro", "template": "{address}A", "params": ["address"], "encoder": "template", "supportsDuration": false },
+  "psi.default": { "board": "psi-pro", "template": "{address}D", "params": ["address"], "encoder": "template", "supportsDuration": false },
+  "psi.cfg.alwaysOn": { "board": "psi-pro", "template": "0P{onoff}", "params": ["onoff"], "encoder": "template", "supportsDuration": false },
+  "psi.cfg.brightSource": { "board": "psi-pro", "template": "1P{source}", "params": ["source"], "encoder": "template", "supportsDuration": false },
+  "psi.cfg.brightSave": { "board": "psi-pro", "template": "2P{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "psi.cfg.brightTemp": { "board": "psi-pro", "template": "3P{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.stimulus": { "board": "hcr-native", "template": "<S{emotion}{intensity}>", "params": ["emotion","intensity"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.overload": { "board": "hcr-native", "template": "<SE>", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.native.muse": { "board": "hcr-native", "template": "<M{state}>", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.museSingle": { "board": "hcr-native", "template": "<MM>", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.native.museMinGap": { "board": "hcr-native", "template": "<MN{seconds}>", "params": ["seconds"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.museMaxGap": { "board": "hcr-native", "template": "<MX{seconds}>", "params": ["seconds"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.playWav": { "board": "hcr-native", "template": "<C{channel}{file}>", "params": ["channel","file"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.playWavRandom": { "board": "hcr-native", "template": "<C{channel}{fileFrom}C{fileTo}>", "params": ["channel","fileFrom","fileTo"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.stop": { "board": "hcr-native", "template": "<PS{target}>", "params": ["target"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.volume": { "board": "hcr-native", "template": "<PV{target}{level}>", "params": ["target","level"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.canonMode": { "board": "hcr-native", "template": "<OA{mode}>", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.personalityOverride": { "board": "hcr-native", "template": "<O{state}>", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.resetEmotions": { "board": "hcr-native", "template": "<OR>", "params": [], "encoder": "template", "supportsDuration": false },
+  "hcr.native.setEmotion": { "board": "hcr-native", "template": "<O{emotion}{value}>", "params": ["emotion","value"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.memoryPlay": { "board": "hcr-native", "template": "<RRP{slot}>", "params": ["slot"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.memorySave": { "board": "hcr-native", "template": "<RRS{slot}>", "params": ["slot"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.memoryMode": { "board": "hcr-native", "template": "<R{mode}>", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "hcr.native.query": { "board": "hcr-native", "template": "<Q{query}>", "params": ["query"], "encoder": "template", "supportsDuration": false },
+  "chirp.play": { "board": "chirp", "template": "PLAY:{index}", "params": ["index"], "encoder": "template", "supportsDuration": false },
+  "chirp.stop": { "board": "chirp", "template": "STOP", "params": [], "encoder": "template", "supportsDuration": false },
+  "chirp.stop.stream": { "board": "chirp", "template": "STOP:{stream}", "params": ["stream"], "encoder": "template", "supportsDuration": false },
+  "chirp.vol": { "board": "chirp", "template": "VOL:{volume}", "params": ["volume"], "encoder": "template", "supportsDuration": false },
+  "chirp.vol.stream": { "board": "chirp", "template": "VOL:{stream},{volume}", "params": ["stream","volume"], "encoder": "template", "supportsDuration": false },
+  "chirp.stat": { "board": "chirp", "template": "STAT:{stream}", "params": ["stream"], "encoder": "template", "supportsDuration": false },
+  "chirp.list": { "board": "chirp", "template": "LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "chirp.gman": { "board": "chirp", "template": "GMAN", "params": [], "encoder": "template", "supportsDuration": false },
+  "chirp.gnme": { "board": "chirp", "template": "GNME:{bank},{page},{index}", "params": ["bank","page","index"], "encoder": "template", "supportsDuration": false },
+  "chirp.baud": { "board": "chirp", "template": "BAUD:{rate}", "params": ["rate"], "encoder": "template", "supportsDuration": false },
+  "chirp.bpage": { "board": "chirp", "template": "BPAGE:{page}", "params": ["page"], "encoder": "template", "supportsDuration": false },
+  "chirp.ccrc": { "board": "chirp", "template": "CCRC", "params": [], "encoder": "template", "supportsDuration": false },
+  "chirp.musb": { "board": "chirp", "template": "MUSB:{on}", "params": ["on"], "encoder": "template", "supportsDuration": false },
+  "chirp.pvoice": { "board": "chirp", "template": "PVOICE:{filename}", "params": ["filename"], "encoder": "template", "supportsDuration": false },
+  "chirp.play.full": { "board": "chirp", "template": "PLAY:{index},{bank},{page},{volume}", "params": ["index","bank","page","volume"], "encoder": "template", "supportsDuration": false },
+  "chirp.chirp": { "board": "chirp", "template": "CHRP:{startHz},{endHz},{durationMs}", "params": ["startHz","endHz","durationMs"], "encoder": "template", "supportsDuration": false },
+  "uppity.playseq": { "board": "r2uppityspinner-alt", "template": ":PS{seq}", "params": ["seq"], "encoder": "template", "supportsDuration": false },
+  "uppity.lifter.seek": { "board": "r2uppityspinner-alt", "template": ":PP{position}", "params": ["position"], "encoder": "template", "supportsDuration": false },
+  "uppity.lifter.seek.speed": { "board": "r2uppityspinner-alt", "template": ":PP{position},{speed}", "params": ["position","speed"], "encoder": "template", "supportsDuration": false },
+  "uppity.lifter.seek.random": { "board": "r2uppityspinner-alt", "template": ":PPR", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.lifter.home": { "board": "r2uppityspinner-alt", "template": ":PH", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.lifter.home.speed": { "board": "r2uppityspinner-alt", "template": ":PH{speed}", "params": ["speed"], "encoder": "template", "supportsDuration": false },
+  "uppity.estop": { "board": "r2uppityspinner-alt", "template": ":PX", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.spin": { "board": "r2uppityspinner-alt", "template": ":PR{speed}", "params": ["speed"], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.spin.random": { "board": "r2uppityspinner-alt", "template": ":PRR{max}", "params": ["max"], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.abs": { "board": "r2uppityspinner-alt", "template": ":PA{degrees}", "params": ["degrees"], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.abs.speed": { "board": "r2uppityspinner-alt", "template": ":PA{degrees},{speed},{maxspeed}", "params": ["degrees","speed","maxspeed"], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.abs.random": { "board": "r2uppityspinner-alt", "template": ":PAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.rel": { "board": "r2uppityspinner-alt", "template": ":PD{degrees}", "params": ["degrees"], "encoder": "template", "supportsDuration": false },
+  "uppity.rotary.rel.random": { "board": "r2uppityspinner-alt", "template": ":PDR", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.movemode.auto": { "board": "r2uppityspinner-alt", "template": ":PM", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.movemode.aggr": { "board": "r2uppityspinner-alt", "template": ":PM{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "uppity.movemode.params": { "board": "r2uppityspinner-alt", "template": ":PM,{liftSpeed},{rotSpeed},{minInterval},{maxInterval}", "params": ["liftSpeed","rotSpeed","minInterval","maxInterval"], "encoder": "template", "supportsDuration": false },
+  "uppity.light": { "board": "r2uppityspinner-alt", "template": ":PL{mode}", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "uppity.light.random": { "board": "r2uppityspinner-alt", "template": ":PLR", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.wait": { "board": "r2uppityspinner-alt", "template": ":PW{seconds}", "params": ["seconds"], "encoder": "template", "supportsDuration": false },
+  "uppity.wait.random": { "board": "r2uppityspinner-alt", "template": ":PWR{max}", "params": ["max"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.calibrate": { "board": "r2uppityspinner-alt", "template": "#PSC", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.setId": { "board": "r2uppityspinner-alt", "template": "#PID{id}", "params": ["id"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.zero": { "board": "r2uppityspinner-alt", "template": "#PZERO", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.factory": { "board": "r2uppityspinner-alt", "template": "#PFACTORY", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.restart": { "board": "r2uppityspinner-alt", "template": "#PRESTART", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.debug": { "board": "r2uppityspinner-alt", "template": "#PDEBUG{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.wifiReset": { "board": "r2uppityspinner-alt", "template": "#PWIFIRESET", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.wifi": { "board": "r2uppityspinner-alt", "template": "#PWIFI{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.aggression": { "board": "r2uppityspinner-alt", "template": "#PAGGRESSION{level}", "params": ["level"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.motor": { "board": "r2uppityspinner-alt", "template": "#PMOTOR{type}", "params": ["type"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.expert": { "board": "r2uppityspinner-alt", "template": "#PEXPERT{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.status": { "board": "r2uppityspinner-alt", "template": "#PSTATUS", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.config": { "board": "r2uppityspinner-alt", "template": "#PCONFIG", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.listSeq": { "board": "r2uppityspinner-alt", "template": "#PL", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.deleteSeq": { "board": "r2uppityspinner-alt", "template": "#PD{seq}", "params": ["seq"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.rc": { "board": "r2uppityspinner-alt", "template": "#PRC{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.rotaryToggle": { "board": "r2uppityspinner-alt", "template": "#PR", "params": [], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.baud": { "board": "r2uppityspinner-alt", "template": "#PBAUD{rate}", "params": ["rate"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.lifterLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"], "encoder": "template", "supportsDuration": false },
+  "uppity.cfg.rotaryLimit": { "board": "r2uppityspinner-alt", "template": "#P{polarity}", "params": ["polarity"], "encoder": "template", "supportsDuration": false },
+  "rad.rotate.abs": { "board": "roam-a-dome", "template": ":DPA{deg}", "params": ["deg"], "encoder": "template", "supportsDuration": false },
+  "rad.rotate.absRamp": { "board": "roam-a-dome", "template": ":DPA{deg},{speed},{maxspeed}", "params": ["deg","speed","maxspeed"], "encoder": "template", "supportsDuration": false },
+  "rad.rotate.absRandom": { "board": "roam-a-dome", "template": ":DPAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.rotate.rel": { "board": "roam-a-dome", "template": ":DPD{deg}", "params": ["deg"], "encoder": "template", "supportsDuration": false },
+  "rad.rotate.relRandom": { "board": "roam-a-dome", "template": ":DPDR", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.spin": { "board": "roam-a-dome", "template": ":DPR{speed}", "params": ["speed"], "encoder": "template", "supportsDuration": false },
+  "rad.home": { "board": "roam-a-dome", "template": ":DPH", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.wait": { "board": "roam-a-dome", "template": ":DPW{seconds}", "params": ["seconds"], "encoder": "template", "supportsDuration": false },
+  "rad.waitRandom": { "board": "roam-a-dome", "template": ":DPWR{min},{max}", "params": ["min","max"], "encoder": "template", "supportsDuration": false },
+  "rad.playSeq": { "board": "roam-a-dome", "template": ":DPS{number}", "params": ["number"], "encoder": "template", "supportsDuration": false },
+  "rad.togglePin": { "board": "roam-a-dome", "template": ":DPT{pin}", "params": ["pin"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.zero": { "board": "roam-a-dome", "template": "#DPZERO", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.factory": { "board": "roam-a-dome", "template": "#DPFACTORY", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.restart": { "board": "roam-a-dome", "template": "#DPRESTART", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.status": { "board": "roam-a-dome", "template": "#DPSTATUS", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.config": { "board": "roam-a-dome", "template": "#DPCONFIG", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.setupVelocity": { "board": "roam-a-dome", "template": "#DPSETUPVELOCITY{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.setup": { "board": "roam-a-dome", "template": "#DPSETUP", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.maxspeed": { "board": "roam-a-dome", "template": "#DPMAXSPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.homespeed": { "board": "roam-a-dome", "template": "#DPHOMESPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.autospeed": { "board": "roam-a-dome", "template": "#DPAUTOSPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.targetspeed": { "board": "roam-a-dome", "template": "#DPTARGETSPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.minspeed": { "board": "roam-a-dome", "template": "#DPMINSPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.inputspeed": { "board": "roam-a-dome", "template": "#DPINPUTSPEED{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.autoleft": { "board": "roam-a-dome", "template": "#DPAUTOLEFT{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.autoright": { "board": "roam-a-dome", "template": "#DPAUTORIGHT{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.fudge": { "board": "roam-a-dome", "template": "#DPFUDGE{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.homePosHere": { "board": "roam-a-dome", "template": "#DPHOMEPOS", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.homePos": { "board": "roam-a-dome", "template": "#DPHOMEPOS{deg}", "params": ["deg"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.automin": { "board": "roam-a-dome", "template": "#DPAUTOMIN{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.automax": { "board": "roam-a-dome", "template": "#DPAUTOMAX{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.homemin": { "board": "roam-a-dome", "template": "#DPHOMEMIN{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.homemax": { "board": "roam-a-dome", "template": "#DPHOMEMAX{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.targetmin": { "board": "roam-a-dome", "template": "#DPTARGETMIN{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.targetmax": { "board": "roam-a-dome", "template": "#DPTARGETMAX{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.timeout": { "board": "roam-a-dome", "template": "#DPTIMEOUT{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.report": { "board": "roam-a-dome", "template": "#DPREPORT{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.home": { "board": "roam-a-dome", "template": "#DPHOME{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.auto": { "board": "roam-a-dome", "template": "#DPAUTO{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.autosafety": { "board": "roam-a-dome", "template": "#DPAUTOSAFETY{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.autorestart": { "board": "roam-a-dome", "template": "#DPAUTORESTART{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.invert": { "board": "roam-a-dome", "template": "#DPINVERT{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.scale": { "board": "roam-a-dome", "template": "#DPSCALE{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.ascale": { "board": "roam-a-dome", "template": "#DPASCALE{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.dscale": { "board": "roam-a-dome", "template": "#DPDSCALE{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.serialin": { "board": "roam-a-dome", "template": "#DPSERIALIN{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.serialout": { "board": "roam-a-dome", "template": "#DPSERIALOUT{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.serialbaud": { "board": "roam-a-dome", "template": "#DPSERIALBAUD{baud}", "params": ["baud"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.syrenbaud": { "board": "roam-a-dome", "template": "#DPSYRENBAUD{baud}", "params": ["baud"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.syrenaddrin": { "board": "roam-a-dome", "template": "#DPSYRENADDRIN{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.syrenaddrout": { "board": "roam-a-dome", "template": "#DPSYRENADDROUT{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.syrenaddr": { "board": "roam-a-dome", "template": "#DPSYRENADDR{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.sensorbaud": { "board": "roam-a-dome", "template": "#DPSENSORBAUD{baud}", "params": ["baud"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmin": { "board": "roam-a-dome", "template": "#DPPWMIN{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmout": { "board": "roam-a-dome", "template": "#DPPWMOUT{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmarc": { "board": "roam-a-dome", "template": "#DPPWMARC{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmmin": { "board": "roam-a-dome", "template": "#DPPWMMIN{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmmax": { "board": "roam-a-dome", "template": "#DPPWMMAX{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmneutral": { "board": "roam-a-dome", "template": "#DPPWMNEUTRAL{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pwmdeadband": { "board": "roam-a-dome", "template": "#DPPWMDEADBAND{value}", "params": ["value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pin": { "board": "roam-a-dome", "template": "#DPPIN{pin}{value}", "params": ["pin","value"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.wifi": { "board": "roam-a-dome", "template": "#DPWIFI{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.remote": { "board": "roam-a-dome", "template": "#DPREMOTE{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.rname": { "board": "roam-a-dome", "template": "#DPRNAME{name}", "params": ["name"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.rsecret": { "board": "roam-a-dome", "template": "#DPRSECRET{secret}", "params": ["secret"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.pair": { "board": "roam-a-dome", "template": "#DPPAIR", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.unpair": { "board": "roam-a-dome", "template": "#DPUNPAIR", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.listSeq": { "board": "roam-a-dome", "template": "#DPL", "params": [], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.deleteSeq": { "board": "roam-a-dome", "template": "#DPD{slot}", "params": ["slot"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.storeSeq": { "board": "roam-a-dome", "template": "#DPS{slot}:{body}", "params": ["slot","body"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.debug": { "board": "roam-a-dome", "template": "#DPDEBUG{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "rad.cfg.joy": { "board": "roam-a-dome", "template": "#DPJOY", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.wifi": { "board": "astropixels-plus", "template": "#APWIFI{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.remote": { "board": "astropixels-plus", "template": "#APREMOTE{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.rname": { "board": "astropixels-plus", "template": "#APRNAME{name}", "params": ["name"], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.rsecret": { "board": "astropixels-plus", "template": "#APRSECRET{secret}", "params": ["secret"], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.pair": { "board": "astropixels-plus", "template": "#APPAIR", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.unpair": { "board": "astropixels-plus", "template": "#APUNPAIR", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.zero": { "board": "astropixels-plus", "template": "#APZERO", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.cfg.restart": { "board": "astropixels-plus", "template": "#APRESTART", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.panel.macro": { "board": "astropixels-plus", "template": ":{action}{group}", "params": ["action","group"], "encoder": "template", "supportsDuration": false },
+  "ap.panel.dynamic": { "board": "astropixels-plus", "template": ":{code}${rest}", "params": ["code","rest"], "encoder": "template", "supportsDuration": false },
+  "ap.seq.play": { "board": "astropixels-plus", "template": ":SE{seq}", "params": ["seq"], "encoder": "template", "supportsDuration": false },
+  "ap.snd.play": { "board": "astropixels-sound", "template": "${bank}{nn}", "params": ["bank","nn"], "encoder": "template", "supportsDuration": false },
+  "ap.snd.random": { "board": "astropixels-sound", "template": "$R", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.off": { "board": "astropixels-sound", "template": "$O", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.stop": { "board": "astropixels-sound", "template": "$s", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.leia": { "board": "astropixels-sound", "template": "$L", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.cantinaMusic": { "board": "astropixels-sound", "template": "$C", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.beepCantina": { "board": "astropixels-sound", "template": "$c", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.scream": { "board": "astropixels-sound", "template": "$S", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.faint": { "board": "astropixels-sound", "template": "$F", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.disco": { "board": "astropixels-sound", "template": "$D", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.starwars": { "board": "astropixels-sound", "template": "$W", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.march": { "board": "astropixels-sound", "template": "$M", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.volUp": { "board": "astropixels-sound", "template": "$+", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.volDown": { "board": "astropixels-sound", "template": "$-", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.volMid": { "board": "astropixels-sound", "template": "$m", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.volMax": { "board": "astropixels-sound", "template": "$f", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.snd.volMin": { "board": "astropixels-sound", "template": "$p", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.psi.effect": { "board": "astropixels-psi", "template": "@{addr}P{effect}", "params": ["addr","effect"], "encoder": "template", "supportsDuration": false },
+  "ap.logic.effect": { "board": "astropixels-logics", "template": "@{addr}T{effect}", "params": ["addr","effect"], "encoder": "template", "supportsDuration": false },
+  "ap.logic.text": { "board": "astropixels-logics", "template": "@{addr}M{text}", "params": ["addr","text"], "encoder": "template", "supportsDuration": false },
+  "ap.logic.font": { "board": "astropixels-logics", "template": "@{addr}P{font}", "params": ["addr","font"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.on": { "board": "astropixels-holo", "template": "*ON{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.off": { "board": "astropixels-holo", "template": "*OF{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.resetAll": { "board": "astropixels-holo", "template": "*ST00", "params": [], "encoder": "template", "supportsDuration": false },
+  "ap.hp.random": { "board": "astropixels-holo", "template": "*RD{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.dimPulse": { "board": "astropixels-holo", "template": "*HPS3{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.rainbow": { "board": "astropixels-holo", "template": "*HPS6{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.position": { "board": "astropixels-holo", "template": "*HP{pos}{dev}", "params": ["pos","dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.wag": { "board": "astropixels-holo", "template": "*HW{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.nod": { "board": "astropixels-holo", "template": "*HN{dev}", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.radar": { "board": "astropixels-holo", "template": "*HRS{mode}", "params": ["mode"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.legacyOn": { "board": "astropixels-holo", "template": "@{ldev}T1", "params": ["ldev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.legacyOff": { "board": "astropixels-holo", "template": "@{ldev}D", "params": ["ldev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.leia": { "board": "astropixels-holo", "template": "@HP{dev}001", "params": ["dev"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.colorproj": { "board": "astropixels-holo", "template": "@HP{dev}002{color}", "params": ["dev","color"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.dimpulse": { "board": "astropixels-holo", "template": "@HP{dev}003{color}{speed}", "params": ["dev","color","speed"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.cycle": { "board": "astropixels-holo", "template": "@HP{dev}004{color}", "params": ["dev","color"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.solid": { "board": "astropixels-holo", "template": "@HP{dev}005{color}", "params": ["dev","color"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.rainbow": { "board": "astropixels-holo", "template": "@HP{dev}006", "params": ["dev"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.shortcircuit": { "board": "astropixels-holo", "template": "@HP{dev}007{color}", "params": ["dev","color"], "encoder": "template", "supportsDuration": true },
+  "ap.hp.native.clearauto": { "board": "astropixels-holo", "template": "@HP{dev}0{mode}", "params": ["dev","mode"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.preset": { "board": "astropixels-holo", "template": "@HP{dev}101{position}", "params": ["dev","position"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.rcLR": { "board": "astropixels-holo", "template": "@HP{dev}102", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.rcUD": { "board": "astropixels-holo", "template": "@HP{dev}103", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.randomPos": { "board": "astropixels-holo", "template": "@HP{dev}104", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.wag": { "board": "astropixels-holo", "template": "@HP{dev}105", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.nod": { "board": "astropixels-holo", "template": "@HP{dev}106", "params": ["dev"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.autotwitch": { "board": "astropixels-holo", "template": "@HP{dev}1{mode}", "params": ["dev","mode"], "encoder": "template", "supportsDuration": false },
+  "ap.hp.native.sequence": { "board": "astropixels-holo", "template": "@HP{seq}", "params": ["seq"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.quickMove": { "board": "astropixels-servo", "template": ":SQ{index},{pulse}", "params": ["index","pulse"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.move": { "board": "astropixels-servo", "template": ":SM{index},{pulse}", "params": ["index","pulse"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.moveTimed": { "board": "astropixels-servo", "template": ":SM{index},{moveTime},{pulse}", "params": ["index","moveTime","pulse"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.moveDelayed": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{pulse}", "params": ["index","startDelay","moveTime","pulse"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.moveFrom": { "board": "astropixels-servo", "template": ":SM{index},{startDelay},{moveTime},{startPulse},{pulse}", "params": ["index","startDelay","moveTime","startPulse","pulse"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.limits3": { "board": "astropixels-servo", "template": ":SL{index},{start},{end}", "params": ["index","start","end"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.limits4": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral}", "params": ["index","start","end","neutral"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.limits5": { "board": "astropixels-servo", "template": ":SL{index},{start},{end},{neutral},{group}", "params": ["index","start","end","neutral","group"], "encoder": "template", "supportsDuration": false },
+  "ap.servo.easing": { "board": "astropixels-servo", "template": ":SF{easingId}${group}", "params": ["easingId","group"], "encoder": "template", "supportsDuration": false },
+  "wcb.hw": { "board": "wcb-native", "template": "?HW,{ver}", "params": ["ver"], "encoder": "template", "supportsDuration": false },
+  "wcb.num": { "board": "wcb-native", "template": "?WCB,{n}", "params": ["n"], "encoder": "template", "supportsDuration": false },
+  "wcb.qty": { "board": "wcb-native", "template": "?WCBQ,{n}", "params": ["n"], "encoder": "template", "supportsDuration": false },
+  "wcb.mac2": { "board": "wcb-native", "template": "?MAC,2,{hex}", "params": ["hex"], "encoder": "template", "supportsDuration": false },
+  "wcb.mac3": { "board": "wcb-native", "template": "?MAC,3,{hex}", "params": ["hex"], "encoder": "template", "supportsDuration": false },
+  "wcb.epass": { "board": "wcb-native", "template": "?EPASS,{password}", "params": ["password"], "encoder": "template", "supportsDuration": false },
+  "wcb.baud": { "board": "wcb-native", "template": "?BAUD,S{port},{rate}", "params": ["port","rate"], "encoder": "template", "supportsDuration": false },
+  "wcb.label": { "board": "wcb-native", "template": "?LABEL,S{port},{text}", "params": ["port","text"], "encoder": "template", "supportsDuration": false },
+  "wcb.labelClear": { "board": "wcb-native", "template": "?LABEL,CLEAR,S{port}", "params": ["port"], "encoder": "template", "supportsDuration": false },
+  "wcb.labelClearAll": { "board": "wcb-native", "template": "?LABEL,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.bcastIn": { "board": "wcb-native", "template": "?BCAST,IN,S{port},{state}", "params": ["port","state"], "encoder": "template", "supportsDuration": false },
+  "wcb.bcastOut": { "board": "wcb-native", "template": "?BCAST,OUT,S{port},{state}", "params": ["port","state"], "encoder": "template", "supportsDuration": false },
+  "wcb.bcastReset": { "board": "wcb-native", "template": "?BCAST,RESET", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mapSerial": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},{dest}", "params": ["port","dest"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapSerialRaw": { "board": "wcb-native", "template": "?MAP,SERIAL,S{port},R,{dest}", "params": ["port","dest"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapSerialList": { "board": "wcb-native", "template": "?MAP,SERIAL,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mapSerialClear": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,S{port}", "params": ["port"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapSerialClearAll": { "board": "wcb-native", "template": "?MAP,SERIAL,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mapPwm": { "board": "wcb-native", "template": "?MAP,PWM,S{port},{dest}", "params": ["port","dest"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapPwmOut": { "board": "wcb-native", "template": "?MAP,PWM,OUT,S{port}", "params": ["port"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapPwmList": { "board": "wcb-native", "template": "?MAP,PWM,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mapPwmClear": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,S{port}", "params": ["port"], "encoder": "template", "supportsDuration": false },
+  "wcb.mapPwmClearAll": { "board": "wcb-native", "template": "?MAP,PWM,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mapClearAll": { "board": "wcb-native", "template": "?MAP,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.kyberLocal": { "board": "wcb-native", "template": "?KYBER,LOCAL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.kyberRemote": { "board": "wcb-native", "template": "?KYBER,REMOTE", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.kyberClear": { "board": "wcb-native", "template": "?KYBER,CLEAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.kyberList": { "board": "wcb-native", "template": "?KYBER,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.maestroList": { "board": "wcb-native", "template": "?MAESTRO,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.maestroClear": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,{id}", "params": ["id"], "encoder": "template", "supportsDuration": false },
+  "wcb.maestroClearAll": { "board": "wcb-native", "template": "?MAESTRO,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.maestro": { "board": "wcb-native", "template": "?MAESTRO,{spec}", "params": ["spec"], "encoder": "template", "supportsDuration": false },
+  "wcb.mp3Cfg": { "board": "wcb-native", "template": "?MP3,{spec}", "params": ["spec"], "encoder": "template", "supportsDuration": false },
+  "wcb.mp3List": { "board": "wcb-native", "template": "?MP3,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mp3OnErrClear": { "board": "wcb-native", "template": "?MP3,ONERR,CLEAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.mp3OnErr": { "board": "wcb-native", "template": "?MP3,ONERR,{key}", "params": ["key"], "encoder": "template", "supportsDuration": false },
+  "wcb.mp3Clear": { "board": "wcb-native", "template": "?MP3,CLEAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrPort": { "board": "wcb-native", "template": "?HCR,PORT,S{port}:{baud}", "params": ["port","baud"], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrPoll": { "board": "wcb-native", "template": "?HCR,POLL,{sec}", "params": ["sec"], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrList": { "board": "wcb-native", "template": "?HCR,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrStatus": { "board": "wcb-native", "template": "?HCR,STATUS", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrRefresh": { "board": "wcb-native", "template": "?HCR,REFRESH", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrClear": { "board": "wcb-native", "template": "?HCR,CLEAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.hcrGet": { "board": "wcb-native", "template": "?HCR,GET,{field}", "params": ["field"], "encoder": "template", "supportsDuration": false },
+  "wcb.routeSerial": { "board": "wcb-native", "template": ";S{port},{message}", "params": ["port","message"], "encoder": "template", "supportsDuration": false },
+  "wcb.routeWcb": { "board": "wcb-native", "template": ";W{wcb},{message}", "params": ["wcb","message"], "encoder": "template", "supportsDuration": false },
+  "wcb.timer": { "board": "wcb-native", "template": ";T{ms},{command}", "params": ["ms","command"], "encoder": "template", "supportsDuration": false },
+  "wcb.seqSave": { "board": "wcb-native", "template": "?SEQ,SAVE,{key},{value}", "params": ["key","value"], "encoder": "template", "supportsDuration": false },
+  "wcb.seqList": { "board": "wcb-native", "template": "?SEQ,LIST", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.seqClearAll": { "board": "wcb-native", "template": "?SEQ,CLEAR,ALL", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.seqClear": { "board": "wcb-native", "template": "?SEQ,CLEAR,{key}", "params": ["key"], "encoder": "template", "supportsDuration": false },
+  "wcb.runSeq": { "board": "wcb-native", "template": ";C{key}", "params": ["key"], "encoder": "template", "supportsDuration": false },
+  "wcb.runSeqLong": { "board": "wcb-native", "template": ";SEQ{key}", "params": ["key"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmOn": { "board": "wcb-native", "template": "?ETM,ON", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.etmOff": { "board": "wcb-native", "template": "?ETM,OFF", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.etmTimeout": { "board": "wcb-native", "template": "?ETM,TIMEOUT,{ms}", "params": ["ms"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmHb": { "board": "wcb-native", "template": "?ETM,HB,{sec}", "params": ["sec"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmMiss": { "board": "wcb-native", "template": "?ETM,MISS,{count}", "params": ["count"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmBoot": { "board": "wcb-native", "template": "?ETM,BOOT,{sec}", "params": ["sec"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmCount": { "board": "wcb-native", "template": "?ETM,COUNT,{n}", "params": ["n"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmDelay": { "board": "wcb-native", "template": "?ETM,DELAY,{ms}", "params": ["ms"], "encoder": "template", "supportsDuration": false },
+  "wcb.etmChar": { "board": "wcb-native", "template": "?ETM,CHAR", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.etmChksum": { "board": "wcb-native", "template": "?ETM,CHKSM,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.debug": { "board": "wcb-native", "template": "?DEBUG,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.debugEtm": { "board": "wcb-native", "template": "?DEBUG,ETM,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.debugPwm": { "board": "wcb-native", "template": "?DEBUG,PWM,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.debugMaestro": { "board": "wcb-native", "template": "?DEBUG,MAESTRO,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.debugHcr": { "board": "wcb-native", "template": "?DEBUG,HCR,{state}", "params": ["state"], "encoder": "template", "supportsDuration": false },
+  "wcb.stats": { "board": "wcb-native", "template": "?STATS", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.statsReset": { "board": "wcb-native", "template": "?STATS,RESET", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.delim": { "board": "wcb-native", "template": "?DELIM,{char}", "params": ["char"], "encoder": "template", "supportsDuration": false },
+  "wcb.funcChar": { "board": "wcb-native", "template": "?FUNCCHAR,{char}", "params": ["char"], "encoder": "template", "supportsDuration": false },
+  "wcb.cmdChar": { "board": "wcb-native", "template": "?CMDCHAR,{char}", "params": ["char"], "encoder": "template", "supportsDuration": false },
+  "wcb.config": { "board": "wcb-native", "template": "?config", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.backup": { "board": "wcb-native", "template": "?backup", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.reboot": { "board": "wcb-native", "template": "?reboot", "params": [], "encoder": "template", "supportsDuration": false },
+  "wcb.eraseNvs": { "board": "wcb-native", "template": "?ERASE,NVS", "params": [], "encoder": "template", "supportsDuration": false },
+  "wled.on": { "board": "wcb-wled", "template": ";L{wledId},ON", "params": ["wledId"], "encoder": "template", "supportsDuration": false },
+  "wled.off": { "board": "wcb-wled", "template": ";L{wledId},OFF", "params": ["wledId"], "encoder": "template", "supportsDuration": false },
+  "wled.toggle": { "board": "wcb-wled", "template": ";L{wledId},TOGGLE", "params": ["wledId"], "encoder": "template", "supportsDuration": false },
+  "wled.bri": { "board": "wcb-wled", "template": ";L{wledId},BRI,{level}", "params": ["wledId","level"], "encoder": "template", "supportsDuration": false },
+  "wled.preset": { "board": "wcb-wled", "template": ";L{wledId},PS,{preset}", "params": ["wledId","preset"], "encoder": "template", "supportsDuration": false },
+  "wled.color": { "board": "wcb-wled", "template": ";L{wledId},COL,{color}", "params": ["wledId","color"], "encoder": "template", "supportsDuration": false },
+  "wled.fx": { "board": "wcb-wled", "template": ";L{wledId},FX,{index}", "params": ["wledId","index"], "encoder": "template", "supportsDuration": false },
+  "wled.fxfull": { "board": "wcb-wled", "template": ";L{wledId},FX,{index},{speed},{intensity}", "params": ["wledId","index","speed","intensity"], "encoder": "template", "supportsDuration": false },
+  "wled.pal": { "board": "wcb-wled", "template": ";L{wledId},PAL,{index}", "params": ["wledId","index"], "encoder": "template", "supportsDuration": false },
+  "wled.json": { "board": "wcb-wled", "template": ";L{wledId},JSON,{payload}", "params": ["wledId","payload"], "encoder": "template", "supportsDuration": false }
 }
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index f0a5f6b..e312970 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -1,10 +1,12 @@
 // WCB firmware 6.2.1 sweep guards (spec 2026-09-15-wcb-firmware-6.2.1-sweep-design).
 //
 // (a) 4.2.0 freeze. test/fixtures/catalog-4.2.0-commands.json records every command id
-//     published in 4.2.0 (commit 82b6a04) with its template and ordered param names. Stored
-//     wire strings and host apps depend on both, so a minor/patch release may add ids and
-//     tighten ranges/enums/patterns, but must not remove an id or change its template or
-//     param names. Update this fixture only on a major release.
+//     published in 4.2.0 (commit 82b6a04) with its board, template, ordered param names,
+//     encoder and supportsDuration. Stored wire strings and host apps depend on all of them
+//     (match() keeps a trailing |n only for a command with supportsDuration), so a minor/patch
+//     release may add ids and tighten ranges/enums/patterns, but must not remove an id or move
+//     it to another board, or change its template, param names, encoder or duration support.
+//     Update this fixture only on a major release.
 // (b) Every example on the WCB boards decodes to its OWN command. Matching is first-match-wins
 //     in manifest order, so a greedy template (e.g. ?ALIAS,{name}) can silently claim a more
 //     specific sibling (?ALIAS,CLEAR). test/web.test.js only checks that an example parses to
@@ -50,13 +52,24 @@ describe('WCB 6.2.1 sweep guards', () => {
 
   test('the 4.2.0 fixture is complete (397 commands)', () => {
     expect(Object.keys(FROZEN_420)).toHaveLength(397);
+    for (const frozen of Object.values(FROZEN_420)) {
+      expect(Object.keys(frozen)).toEqual(['board', 'template', 'params', 'encoder', 'supportsDuration']);
+      expect(typeof frozen.supportsDuration).toBe('boolean');
+    }
   });
 
-  test('(a) every 4.2.0 id still resolves with the same template and ordered param names', () => {
+  test('(a) every 4.2.0 id still resolves on its board with the same template, param names, encoder and duration support', () => {
     const drift = [];
     for (const [id, frozen] of Object.entries(FROZEN_420)) {
       const cmd = cb.getCommand(id);
       if (!cmd) { drift.push(`${id}: removed (was on ${frozen.board})`); continue; }
+      if (cmd._component.id !== frozen.board) drift.push(`${id}: board ${frozen.board} -> ${cmd._component.id}`);
+      const encoder = cmd.encoder || 'template';
+      if (encoder !== frozen.encoder) drift.push(`${id}: encoder ${frozen.encoder} -> ${encoder}`);
+      const supportsDuration = cmd.supportsDuration === true;
+      if (supportsDuration !== frozen.supportsDuration) drift.push(`${id}: supportsDuration ${frozen.supportsDuration} -> ${supportsDuration}`);
+      // A stored |n only decodes if the composer can still write it: the board's durationSuffix must stay on.
+      if (frozen.supportsDuration && !cb.encode(cmd, {}, { duration: 7 }).endsWith('|7')) drift.push(`${id}: no longer encodes a |n duration`);
       const template = typeof cmd.template === 'string' ? cmd.template : null;
       const fix = TEMPLATE_FIXES[id];
       if (fix) {

From ae7415ae850f1ff90b25505cac2964cad9717e01 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 12:16:44 -0400
Subject: [PATCH 16/17] docs(release): say how 4.2.0 FlthyHPs steps decode in
 4.3.0

The 4.3.0 notes said "Saved steps keep their exact text." True of the
bytes, but the FlthyHPs code fix is the one change to how stored values
decode, and the notes an old DroidNet update dialog shows did not say
so:

- 4.2.0 Solid Color / Rainbow steps (A0065, R0063, T007, A007|45) no
  longer match a command and load as raw text.
- 4.2.0 Short Circuit steps (A0057, F0055|10) load as Solid Color and
  keep their saved "*** Flthy short circuit" label.

Verified by decoding with the 82b6a04 and HEAD engines.

- releases.json: the notes name both effects.
- test/wcb-621.test.js pins the Short Circuit -> Solid Color decode
  (with label and duration) and the raw decode of the old codes.
- Spec: the FlthyHPs hardware check is recorded as not yet run, and
  gated as in release plan M1 (bench result or maintainer sign-off,
  otherwise the fix moves to a 4.3.1).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 .../specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md   | 6 ++++--
 releases.json                                             | 2 +-
 test/wcb-621.test.js                                      | 8 ++++++++
 3 files changed, 13 insertions(+), 3 deletions(-)

diff --git a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
index a3fb181..a2e13b7 100644
--- a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
+++ b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
@@ -365,8 +365,10 @@ v2.1 — dispatches 005 solid, 006 rainbow, 007 short circuit, and accepts X/Y/Z
 firmware they run rainbow and short circuit respectively. DroidNet's bundled 2.1.0 catalog
 already emits 005 / 006, so adopting 4.3.0 is not a user-facing regression.
 
-**Hardware check** (recommended, not blocking): send `A0055` (solid blue) and `A006` (rainbow)
-to a v1.81 board.
+**Hardware check** (not yet run): send `A0055` (solid blue) and `A006` (rainbow) to a v1.81
+board. Merging this fix in 4.3.0 needs that result or the maintainer's sign-off on the source
+evidence above; otherwise it moves to a 4.3.1 released before the DroidNet release that bundles
+4.3.0. The 4.3.0 release notes spell out the decode change for steps saved by 4.2.0.
 
 **Freeze-test exception.** The A2 fixture keeps the 4.2.0 templates. A11 adds exactly these
 three ids to the freeze test's allowlist, each pinning its 4.2.0 and corrected template.
diff --git a/releases.json b/releases.json
index e995e04..167f3d2 100644
--- a/releases.json
+++ b/releases.json
@@ -6,7 +6,7 @@
     "schemaVersion": "v1",
     "releasedAt": "2026-09-15",
     "url": "https://raw.githubusercontent.com/travisccook/droidnet-command-library/main/libraries/manifest.json",
-    "notes": "Minor: WCB firmware 6.2.1 sweep. Maestro (maestro) adds the WCB 6.2+ comma forms: Run Subroutine (with and without a parameter, number and sub-verb spellings), Stop Script, Go Home, Set Servo Target/Speed/Acceleration, and Read Position/Moving State/Errors queries. Ids widen to 0-9 (9 = this WCB's Maestros) and subroutines to 0-127. Adds WCB · DFPlayer Mini board (wcb-dfp, WCB 6.2+): 21 ;D, verbs (play/folder/MP3-folder with optional ONFIN callback, stop/pause/resume/next/prev/random, loop track/all/folder, EQ, volume/up/down, reset, status). WCB · HCR Vocalizer (wcb-hcr) adds TRIGGER, all-channel VOL and VOLUP/VOLDN steps, and limits FN to the firmware's function codes. WCB (native config) (wcb-native) adds 66 commands (mesh channel, alias, controller, status LED pin/identify, WLED/DFPlayer config, MP3/DFPlayer/HCR host routing, Maestro remote/Kyber map, ;W alias routing, ;P PWM pulse, ;V/;VP variables and IF, sequence names/get and ,L local runs, timer stop, WDP, debug/track/version) and corrects ranges (board numbers 1-20, 30-minute timer, S0 routing, HCR baud/poll/get fields, ETM miss 100, multi-destination maps). WLED presets start at 1; the MP3 Trigger and WLED boards document 6.2.1 routing. FlthyHPs Holoprojectors (flthy-hps): Solid Color, Rainbow and Short Circuit now send the codes FlthyHPs v1.6+ firmware runs (005, 006, 007; 4.2.0 sent 006, 007, 005), and the X/Y/Z designators are back. Saved steps keep their exact text. Text fields (keys, aliases, variable names, conditions, colors) need a host that uses engine 3.1.0 or later. Generated against WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0; board catalog 21 -> 22, commands 397 -> 500."
+    "notes": "Minor: WCB firmware 6.2.1 sweep. Maestro (maestro) adds the WCB 6.2+ comma forms: Run Subroutine (with and without a parameter, number and sub-verb spellings), Stop Script, Go Home, Set Servo Target/Speed/Acceleration, and Read Position/Moving State/Errors queries. Ids widen to 0-9 (9 = this WCB's Maestros) and subroutines to 0-127. Adds WCB · DFPlayer Mini board (wcb-dfp, WCB 6.2+): 21 ;D, verbs (play/folder/MP3-folder with optional ONFIN callback, stop/pause/resume/next/prev/random, loop track/all/folder, EQ, volume/up/down, reset, status). WCB · HCR Vocalizer (wcb-hcr) adds TRIGGER, all-channel VOL and VOLUP/VOLDN steps, and limits FN to the firmware's function codes. WCB (native config) (wcb-native) adds 66 commands (mesh channel, alias, controller, status LED pin/identify, WLED/DFPlayer config, MP3/DFPlayer/HCR host routing, Maestro remote/Kyber map, ;W alias routing, ;P PWM pulse, ;V/;VP variables and IF, sequence names/get and ,L local runs, timer stop, WDP, debug/track/version) and corrects ranges (board numbers 1-20, 30-minute timer, S0 routing, HCR baud/poll/get fields, ETM miss 100, multi-destination maps). WLED presets start at 1; the MP3 Trigger and WLED boards document 6.2.1 routing. FlthyHPs Holoprojectors (flthy-hps): Solid Color, Rainbow and Short Circuit now send the codes FlthyHPs v1.6+ firmware runs (005, 006, 007; 4.2.0 sent 006, 007, 005), and the X/Y/Z designators are back. Saved steps keep their exact text, but they decode by what the firmware runs: steps saved by 4.2.0 as Solid Color or Rainbow (006, 007) now show as raw text, and 4.2.0 Short Circuit steps (005) now show as Solid Color. Text fields (keys, aliases, variable names, conditions, colors) need a host that uses engine 3.1.0 or later. Generated against WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0; board catalog 21 -> 22, commands 397 -> 500."
   },
   "libraries": [
     {
diff --git a/test/wcb-621.test.js b/test/wcb-621.test.js
index e312970..168f294 100644
--- a/test/wcb-621.test.js
+++ b/test/wcb-621.test.js
@@ -683,6 +683,14 @@ describe('FlthyHPs sequence codes follow the v1.6+ firmware', () => {
     expect(cb.buildWCBValue(cb.parseWCBValue('A0065^A007|240'))).toBe('A0065^A007|240');
   });
 
+  test('4.2.0 "short circuit" wire text decodes as Solid Color, keeping its saved label (releases.json 4.3.0 notes)', () => {
+    expect(cb.parseWCBValue('A0057^*** Flthy short circuit^F0055|10')).toEqual([
+      { type: 'command', commandId: 'flthy.led.solid', params: { designator: 'A', color: '7' }, label: ' Flthy short circuit' },
+      { type: 'command', commandId: 'flthy.led.solid', params: { designator: 'F', color: '5' }, duration: 10 },
+    ]);
+    for (const v of ['A0065', 'R0063', 'A0065|60', 'T007', 'A007|45']) expect(cb.parseWCBValue(v)).toEqual([{ type: 'raw', text: v }]);
+  });
+
   test('X, Y and Z designators encode and decode', () => {
     expect(cb.getEnum('flthy.designator').values.map(v => v.code)).toEqual(['F', 'R', 'T', 'X', 'Y', 'Z', 'A']);
     expect(cb.encode(cb.getCommand('flthy.led.solid'), { designator: 'X', color: '5' }, {})).toBe('X0055');

From 2ed1cc9d68cb73b966d7abdb768780fb2e4f4525 Mon Sep 17 00:00:00 2001
From: travisccook <travisccook@gmail.com>
Date: Tue, 15 Sep 2026 12:17:20 -0400
Subject: [PATCH 17/17] docs(wcb-6.2.1): wcb-dfp shipped 21 commands in the
 spec and plan

The wcb-dfp section, the DroidNet id map and the plan still described
the planned board: a dfp.device command and enum, "22 commands", and
"plus 19 more dfp.*". Only the As built bullet said otherwise.

- Spec wcb-dfp section: drop the dfp.device enum and table row, say 21
  commands with only dfp.reset as config, and point to As built for why
  DEVICE is not modeled (WCB_DFP.cpp:72-74 strips "D," and WcbCmd
  WcbDfPlayer.cpp:54 strips a leading D again, so "DEVICE,2" arrives
  as "EVICE,2").
- Spec id map: "plus 18 more dfp.*" (21 - dfp.play/stop/volume).
- Plan A4 and A12: 21 commands/verbs, no dfp.device enum.

The board, tests and releases.json already said 21.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Cv8VK6dup1R8xDzk3MJgRZ
---
 .../plans/2026-09-15-wcb-firmware-6.2.1-sweep.md     |  4 ++--
 .../2026-09-15-wcb-firmware-6.2.1-sweep-design.md    | 12 ++++++------
 2 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md b/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
index e56fd01..b63b71c 100644
--- a/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
+++ b/docs/superpowers/plans/2026-09-15-wcb-firmware-6.2.1-sweep.md
@@ -72,7 +72,7 @@ Lands before any board edit and must pass on 4.2.0.
 
 **Firmware to re-check:** WcbCmd `WcbDfPlayer.cpp:51-168`; `WCB_DFP.cpp:144-327`; `WCB_Help.cpp:566-593`; `WCB.ino:6426-6428`.
 
-- [ ] Component, enums (`dfp.eq`, `dfp.device`, `dfp.loopAll`) and the 22 commands from the spec table. `dfp.play`, `dfp.stop`, `dfp.volume` keep DroidNet's templates and param names (D1).
+- [ ] Component, enums (`dfp.eq`, `dfp.loopAll`) and the 21 commands from the spec table (`dfp.device` dropped: WCB 6.2.1 cannot run `DEVICE`, see the spec's As built). `dfp.play`, `dfp.stop`, `dfp.volume` keep DroidNet's templates and param names (D1).
 - [ ] Manifest entry `{ "id": "wcb-dfp", "file": "boards/wcb-dfp.json", "name": "WCB · DFPlayer Mini (WCB 6.2+)", "confidence": "high" }` right after `wcb-mp3`.
 - [ ] Update the component-count pin in `test/load-node.test.js` if it is checked before A12 (21 → 22).
 
@@ -130,7 +130,7 @@ Lands before any board edit and must pass on 4.2.0.
 ### Task A12: `release: bump library to 4.3.0 (WCB 6.2.1 sweep)`
 
 - [ ] `libraries/manifest.json`: `libraryVersion` 4.3.0; `generatedFrom` += `; WCB 6.2.1_021242RSEP2026 + WcbCmd 0.8.0 (2026-09)`; 22 boards.
-- [ ] `releases.json`: `latest.libraryVersion` and `libraries[0].libraryVersion` 4.3.0; `releasedAt` = merge date; `latest.notes` one string starting "Minor:" (Maestro comma verbs and queries, ids 0-9 / subs 0-127; `wcb-dfp` with 22 verbs; HCR TRIGGER and all-channel volume, FN codes; 66 `wcb-native` commands and range fixes; WLED presets from 1; FlthyHPs codes follow firmware v1.6+; text fields need a host engine 3.1.0 or later; catalog 21 → 22).
+- [ ] `releases.json`: `latest.libraryVersion` and `libraries[0].libraryVersion` 4.3.0; `releasedAt` = merge date; `latest.notes` one string starting "Minor:" (Maestro comma verbs and queries, ids 0-9 / subs 0-127; `wcb-dfp` with 21 verbs; HCR TRIGGER and all-channel volume, FN codes; 66 `wcb-native` commands and range fixes; WLED presets from 1; FlthyHPs codes follow firmware v1.6+; text fields need a host engine 3.1.0 or later; catalog 21 → 22).
 - [ ] `package.json` and `package-lock.json` (both `version` fields) 4.3.0 — hand-edit, or `npm --no-git-tag-version version 4.3.0`.
 - [ ] Test pins: `test/load-node.test.js` `'4.3.0'` and `toBe(22)`; `test/engine.test.js` `'4.3.0'`.
 - [ ] Gate: `npm run validate` (warnings only for non-standard categories), `npm test` green.
diff --git a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
index a2e13b7..e01dfa2 100644
--- a/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
+++ b/docs/superpowers/specs/2026-09-15-wcb-firmware-6.2.1-sweep-design.md
@@ -163,10 +163,11 @@ Grammar: WcbCmd `WcbDfPlayer.cpp:51-168`; config `WCB_DFP.cpp:144-327`; help
   else the `?DFP,REMOTE` board, else a board advertising a DFPlayer over WDP; volume 0 = silent,
   30 = loudest (the reverse of `;A`); allow 1.5-3 s after power-on; clone modules may ignore
   RANDOM, EQ and LOOPFOLDER.
-- **Enums:** `dfp.eq` 0 Normal, 1 Pop, 2 Rock, 3 Jazz, 4 Classic, 5 Bass; `dfp.device` 1 USB,
-  2 SD card, 3 AUX, 4 Sleep, 5 Flash; `dfp.loopAll` 0 Off, 1 On.
-- **22 commands**, all `cosmetic` except `dfp.device` and `dfp.reset` (`config`). Callback key
-  pattern `[A-Za-z0-9_]+`.
+- **Enums:** `dfp.eq` 0 Normal, 1 Pop, 2 Rock, 3 Jazz, 4 Classic, 5 Bass; `dfp.loopAll` 0 Off,
+  1 On.
+- **21 commands**, all `cosmetic` except `dfp.reset` (`config`). Callback key pattern
+  `[A-Za-z0-9_]+`. A `dfp.device` command (`;D,DEVICE,{source}`) and its enum were planned but
+  not shipped: WCB 6.2.1 cannot run `DEVICE` (see As built).
 
 | id | template | params | example |
 |---|---|---|---|
@@ -183,7 +184,6 @@ Grammar: WcbCmd `WcbDfPlayer.cpp:51-168`; config `WCB_DFP.cpp:144-327`; help
 | `dfp.eq` | `;D,EQ,{preset}` | `dfp.eq` | `;D,EQ,2` |
 | `dfp.volume` | `;D,VOL,{volume}` | volume 0-30, default 20 | `;D,VOL,20` |
 | `dfp.volUp`, `dfp.volDown` | `;D,VOLUP`, `;D,VOLDN` | — (steps of 2) | same as template |
-| `dfp.device` | `;D,DEVICE,{source}` | `dfp.device` | `;D,DEVICE,2` |
 | `dfp.reset` | `;D,RESET` | — | `;D,RESET` |
 | `dfp.status` | `;D,STATUS` | — | `;D,STATUS` |
 
@@ -390,7 +390,7 @@ is stored.
 | `wled.power`, `wled.brightness`, `wled.effect`, `wled.effectTuned`, `wled.palette` | DroidNet only | — | not added (D1) |
 | `wled.preset` | `{id}` enum, 1-250 | `{wledId}` int, 0-250 | published shape, min 1 |
 | `wled.color` | named-color enum | hex `pattern` | unchanged |
-| `dfp.play`, `dfp.stop`, `dfp.volume` | as in the `wcb-dfp` table | — | same template and params, plus 19 more `dfp.*` |
+| `dfp.play`, `dfp.stop`, `dfp.volume` | as in the `wcb-dfp` table | — | same template and params, plus 18 more `dfp.*` |
 | `mp.mode` / `magic-panel` | DroidNet | `iamp.mode` / `ia-magic-panel` since 4.0.0 | unchanged |
 | `flthy.led.solid`, `flthy.led.rainbow` | 005 / 006 | 006 / 007 | 005 / 006 (firmware) |