feat: Add 28 missing resource endpoints from Hue CLIP API v2

[thibauult]

Add the following new resource types to match the official Hue CLIP API:

Sensors & Inputs

• button, bell_button, relative_rotary, contact, tamper

Motion & Area Detection

• camera_motion, grouped_motion, grouped_light_level
• convenience_area_motion, security_area_motion
• motion_area_candidate, motion_area_configuration

Connectivity

• zigbee_connectivity, zgp_connectivity, wifi_connectivity
• zigbee_device_discovery

Smart Home Integration

• homekit, matter, matter_fabric

Entertainment & Media

• entertainment, entertainment_configuration, speaker

Automation & Behavior

• behavior_script, behavior_instance
• geofence_client, geolocation

Device Management

• device_software_update, service_group

---

Each resource includes:

• Collection endpoint (GET /clip/v2/resource/{resource})
• Item endpoint (GET, PUT /clip/v2/resource/{resource}/{id})
• Schema files ({Resource}Get.yaml, {Resource}Put.yaml)

Summary by CodeRabbit

• New Features
  • Added comprehensive API endpoints for managing automation scripts and instances
  • Added API endpoints for button, contact, tamper, and motion sensors
  • Added endpoints for entertainment configuration and speaker management
  • Added geofence client and geolocation management capabilities
  • Added WiFi, Zigbee, and ZGP connectivity status endpoints
  • Added Matter protocol integration and HomeKit support endpoints
  • All endpoints support consistent GET and PUT operations for retrieval and updates
  • Added developer guidance documentation for repository usage

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This pull request introduces comprehensive OpenAPI specification files for 30+ new resource types in the Hue API, including endpoints for buttons, sensors, connectivity management, automations, and device configuration. Each resource includes standardized list, retrieve, and update operations with consistent error handling and response schemas. A developer guide document is also added.

Changes

Cohort / File(s)	Summary
Developer Documentation AGENTS.md	New developer guide documenting project overview, build/development commands, architecture, testing setup, and code conventions for the WARP repository.
Main API Specification src/main.yaml	Added 30+ new resource tags, path definitions (both list and item endpoints), and HueApplicationKey security scheme to the main OpenAPI document.
Input/Control Resources src/button/..., src/bell_button/..., src/relative_rotary/...	Added complete API specifications (list, get, put operations) and schemas (Get/Put variants) for button, bell button, and relative rotary input devices.
Sensor Resources src/contact/..., src/tamper/..., src/camera_motion/..., src/grouped_motion/..., src/grouped_light_level/..., src/convenience_area_motion/..., src/security_area_motion/...	Added complete API specifications and schemas for seven sensor types with standardized list, retrieve, and update operations.
Motion Configuration src/motion_area_candidate/..., src/motion_area_configuration/...	Added specifications and schemas for motion area candidate and configuration resources with get/put operations.
Connectivity Resources src/zigbee_connectivity/..., src/zgp_connectivity/..., src/wifi_connectivity/..., src/zigbee_device_discovery/...	Added connectivity status and discovery specifications with standardized CRUD-like operations and enums for connection states.
Integration Resources src/homekit/..., src/matter/..., src/matter_fabric/...	Added HomeKit and Matter protocol integration endpoints with device pairing status and fabric configuration schemas.
Entertainment Resources src/entertainment/..., src/entertainment_configuration/..., src/speaker/...	Added entertainment and speaker management specifications with streaming configuration schemas.
Automation Resources src/behavior_script/..., src/behavior_instance/...	Added behavior script and instance (automation) resource specifications with execution state and configuration schemas.
Location & Update Resources src/geofence_client/..., src/geolocation/..., src/device_software_update/..., src/service_group/...	Added geofence/location tracking, device update management, and service grouping specifications with corresponding get/put schemas.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

• Added additional resource type values #40: Updates common enums to include grouped_motion and grouped_light_level resource definitions, directly supporting the new sensor resource specifications added in this PR.

Poem

🐰 Thirty resources now take flight,
With specs so clean and schemas tight!
Lists and gets and puts galore,
The Hue API opens up its door! ✨

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/add-missing-endpoints

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}