add-device

Add a new implementation of the primary protocol/interface: $ARGUMENTS

Follow Alex Rivera's hardware integration standards:

1. Study the protocol: Read the primary protocol/interface definition in the core layer (see Key Abstractions and Protocol Methods in project config)

2. Implement the class in the core layer file:

   • MUST satisfy the primary protocol/interface
   • Follow the future annotations pattern (see stack concepts in project config)
   • All methods MUST have return type annotations
   • Document protocol-specific commands with clear comments
   • Raise the discovery error exception if resource not detected on open()
   • Raise the connection error exception on communication failures
   • Track is_open state accurately
   • close() MUST be idempotent — safe to call multiple times

3. Update config if new settings are needed:

   • Add to the config file's Settings class with the project's env prefix
   • Document in the env example file with defaults and description

4. Update the mock implementation to mirror any new behavior:

   • Same exceptions for same error conditions
   • Same state transitions

5. Wire into lifespan in the app factory:

   • Add selection logic in the lifespan function
   • Ensure the fail-safe operation runs on both startup and shutdown for the new implementation

6. Write tests in the core layer test file (see test file mapping in project config):

   • Test open() / close() lifecycle
   • Test state-changing operations for valid and invalid inputs
   • Test get_info() returns expected structure
   • Test error conditions raise typed exceptions
   • Test is_open property accuracy

7. Verify: Run the test command and the type-check command (see project config)