apiVersion: capabilities.naftiko.dev/v1
kind: Capability
metadata:
  name: span-panel
  title: SPAN Panel
  provider: span-io
  api: span-rest-api
  tags:
    - Panel
    - Metering
    - Grid
    - Islanding
    - Power
spec:
  description: >-
    Read whole-panel state, the main meter cumulative energy registers,
    instantaneous panel power, islanding state, and operate the main grid
    relay. Includes emergency reconnect for restoring grid connection after
    islanded operation.
  operations:
    - id: get-status
      summary: Get overall system status (software, network, panel hardware).
      method: GET
      path: /api/v1/status
    - id: get-panel
      summary: Get full panel state snapshot.
      method: GET
      path: /api/v1/panel
    - id: get-panel-power
      summary: Get instantaneous panel power.
      method: GET
      path: /api/v1/panel/power
    - id: get-panel-meter
      summary: Get main meter cumulative energy registers.
      method: GET
      path: /api/v1/panel/meter
    - id: get-islanding-state
      summary: Get current islanding state.
      method: GET
      path: /api/v1/islanding-state
    - id: get-grid-relay
      summary: Get current main grid relay state.
      method: GET
      path: /api/v1/panel/grid
    - id: set-grid-relay
      summary: Set main grid relay state (OPEN or CLOSED).
      method: POST
      path: /api/v1/panel/grid
    - id: emergency-reconnect
      summary: Trigger emergency grid reconnection.
      method: POST
      path: /api/v1/panel/emergency-reconnect