v2.1.2: CLI Overhaul, Protocol v2.1 Sync, and Robustness Patches

[dsecurity49]

Overview

Version 2.1.2 is a major stabilization and Developer Experience (DX) release. It brings the SDK fully in sync with the Intent Protocol v2.1 specifications, completely overhauls the command-line interface for production operations, and patches several critical data-handling edge cases.

Features & CLI Overhaul

The intent-bus CLI has been transformed into a first-class operator utility:

• Full Protocol Parity: The publish command now supports all advanced protocol arguments, including --priority, --delay, --max-attempts, --backoff, --target, --capability, and --idempotency.
• Operational Visibility: Added status and result commands to audit job states and easily retrieve formatted fulfillment payloads directly from the terminal.
• Targeted Topologies: Added a --publisher filter to the listen command, allowing workers to exclusively claim jobs from specific high-trust API keys.
• Enterprise Polish: Added standard --version flag support and clean visual dividers for terminal payload outputs.

Critical Bug Fixes

• Fulfillment Payload Integrity (Breaking Bug Fix): Fixed a silent data-loss regression where custom dictionary fields returned by worker handlers were being aggressively stripped. Handlers can now safely return extended metadata without losing custom keys.
• KV Store Type Safety: Restored defensive parsing guards in sync.py to prevent scalar primitive strings (like "123" or "false") from mutating into integers or booleans when retrieved from the server.
• RFC-Compliant Rate Limiting: The Transport layer now safely parses HTTP-date formatted timestamps (e.g., Tue, 02 Jun 2026...) inside Retry-After headers instead of crashing, falling back smoothly when standard delta-seconds aren't provided by proxies.
• Lambda Late-Binding Crash: Fixed a highly specific NameError inside the worker runtime orchestrator caused by exception variable cleanup occurring before retry-engine closures executed.

Internal Refactoring & Security

• Protocol Synchronization: The SDK is now officially locked to expect X-Intent-Version: 2.1, ensuring cryptographic lock isolation is strictly enforced between client and server.
• Python 3.10 Optimizations: Upgraded internal worker result parsing from LBYL (isinstance chains) to EAFP using highly optimized match/case structural pattern matching.
• Documentation Update: Updated SECURITY.md and README.md to reflect full v2.1.1+ support and the new architectural models.

Full Changelog: https://github.com/dsecurity49/Intent-Bus-sdk/commits/v2.1.2

---

This discussion was created from the release v2.1.2: CLI Overhaul, Protocol v2.1 Sync, and Robustness Patches.