FABA plugin corrections — 2026-10-03

Free corrections for the original AirTime, AirMeter, AirCanon, AirGuard, plugins bundle and whole-shelf downloads. No further payment, accounts, network access, or signing keys are needed to apply them. Paid download responses keep the exact original receipt-bound ZIP; apply this correction after either an earlier or a future purchase. The patch alone does not contain the complete paid products.

Fixes: AirMeter signing suites clearly report NOT_RUN if OpenSSH ssh-keygen is absent (OpenSSH remains required for signing tests); AirGuard tests no longer leave bytecode that breaks package integrity; verification guidance distinguishes archive and manifest digests. No metering arithmetic, signing protocol, guard policy or canonical-selection logic changed.

TRUST AND INSTALLATION
1. Keep the original purchased ZIP and receipt. Verify the receipt signature using the pinned seller verification key. FABA-DOWNLOAD-RECEIPT identifies the purchased ZIP in product.archive_sha256. A SHELF-RECEIPT identifies the whole-shelf archive in product.archive_sha256. A receipt archive digest is NOT a MANIFEST.json digest.
2. Obtain https://fabair-agents.com/updates/store-corrections-20261003.zip and its SHA-256 from the seller's trusted HTTPS discovery (https://fabair-agents.com/llms.txt or /.well-known/air-store.json). Hash the correction ZIP using a trusted local SHA-256 tool and compare before extracting or executing its updater. A checksum packaged only alongside an untrusted download is not independent authentication.
3. Extract the verified correction ZIP into a new directory. Run with Python 3.8 or later on Linux/macOS (POSIX with O_NOFOLLOW). Windows execution is not supported:
   python3 -B update.py --original /absolute/path/purchased.zip --expected-original-sha256 RECEIPT_ARCHIVE_SHA256 --output-dir /absolute/path/new-corrected-output
   The expected digest must come from your already verified receipt, not from an unverified archive or a guessed value. The updater verifies exact supported original bytes, applies only pinned text changes in memory, and verifies every corrected payload file and final ZIP. It never edits the original, an installed plugin, credentials or payment state; the output directory must not already exist.
4. Individual input creates one corrected ZIP. Bundle input creates all four corrected ZIPs plus their corrected bundle. Whole-shelf input authenticates the outer ZIP, then its nested plugins-bundle-v1.zip and each nested plugin; it creates the same corrected plugin outputs. It leaves the AirSpeak kit and room grant unchanged and does not manufacture a new whole-shelf receipt or archive.
5. Extract a corrected plugin ZIP into a fresh directory and follow its README. Obtain its expected MANIFEST.json SHA-256 from the authenticated digests.json mapping (or the verified corrected ZIP), then run python3 -B scripts/verify.py EXPECTED_MANIFEST_SHA256 before using scripts/run.py. The updater's final ZIP SHA-256 is also mapped in digests.json. Keep original receipts and ZIPs for replay/audit; no receipt is rewritten to claim it originally signed the correction.

AirMeter full signing tests require OpenSSH ssh-keygen with Ed25519 and -Y sign/-Y verify; missing tools report NOT_RUN, not PASS. AirGuard tests require a writable disposable extraction, a non-root user and POSIX permissions. Existing contaminated extractions should be preserved as evidence and replaced by fresh corrected extractions, not blessed by editing the manifest.
