ble-session-appliance - SKILL.md Agent Skill

name: ble-session-appliance description: Control BLE Session Appliance through the generated BLE device CLI.

Prerequisites: Install the CLI

This skill drives the ble-session-appliance-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
```
npx -y @mvanhorn/printing-press-library install ble-session-appliance --cli-only
```
Verify: ble-session-appliance-pp-cli --version
Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails before this CLI has a public-library category, install Node or use the category-specific Go fallback after publish.

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Use ble-session-appliance-pp-cli capabilities --json to inspect callable and withheld BLE capabilities, including safety classes and evidence refs. Use ble-session-appliance-pp-cli status --json to inspect replay-backed status output. By default the CLI is replay-backed; build with -tags ble_live and pass --live to control a real device, ble-session-appliance-pp-cli doctor to check live readiness, and ble-session-appliance-pp-cli scan --live to discover devices. Use ble-session-appliance-pp-cli start --dry-run --json to preview the start write. To run it outside verify mode, pass --confirm-physical-effect after checking the dry-run output. Use ble-session-appliance-pp-cli session start --json and ble-session-appliance-pp-cli session status --json to inspect the local replay session runtime, including lock, capability-token, and endpoint metadata. Use ble-session-appliance-pp-cli telemetry capture --json and ble-session-appliance-pp-cli telemetry latest --json for the local telemetry store scaffold. Use ble-session-appliance-pp-cli telemetry sessions --json to inspect stored BLE session summaries.