# steward-plugins / index.yaml
#
# This file is the catalog index for the steward plugin repository.
# It is fetched by the app's Settings → Plugins → Plugin Catalog UI.
#
# Steward reads this file from:
#   https://git.fabledsword.com/bvandeusen/Steward-plugins/raw/branch/main/index.yaml
#
# After adding or updating a plugin entry, commit and push — the change is
# live immediately for anyone whose app fetches the catalog (cache TTL: 5 min).
#
# REQUIRED fields for each plugin entry:
#   name            - must match the plugin's directory name exactly
#   version         - semver string
#   download_url    - direct URL to a zip file containing the plugin
#   checksum_sha256 - SHA-256 hex digest of the zip (leave empty to skip verification)
#
# OPTIONAL fields:
#   description, author, license, min_app_version,
#   repository_url, homepage, tags
#
# Generating a checksum:
#   sha256sum traefik.zip
#   shasum -a 256 traefik.zip   (macOS)
#
# Download URL conventions:
#   Gitea release assets (recommended):
#     https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/traefik-v1.0.0/traefik.zip
#   Upload the zip as a release attachment in Gitea; paste the URL here.
#   Source archive tarballs work too but release assets are preferred (smaller, plugin-only).

version: 1
updated: "2026-03-22"

plugins:

  - name: http
    version: "1.0.0"
    description: "Synthetic HTTP endpoint monitoring — status code, response time, content match, TLS expiry"
    author: "Steward"
    license: "MIT"
    min_app_version: "0.1.0"
    repository_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins"
    homepage: "https://git.fabledsword.com/bvandeusen/Steward-plugins/src/branch/main/http"
    download_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/http-v1.0.0/http.zip"
    checksum_sha256: ""
    tags:
      - monitoring
      - http
      - synthetic
      - uptime

  - name: docker
    version: "1.0.0"
    description: "Docker container status, resource usage, and restart tracking via Docker socket"
    author: "Steward"
    license: "MIT"
    min_app_version: "0.1.0"
    repository_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins"
    homepage: "https://git.fabledsword.com/bvandeusen/Steward-plugins/src/branch/main/docker"
    download_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/docker-v1.0.0/docker.zip"
    checksum_sha256: ""
    tags:
      - containers
      - docker
      - infrastructure

  - name: traefik
    version: "1.0.0"
    description: "Traefik reverse proxy metrics and access log integration"
    author: "Steward"
    license: "MIT"
    min_app_version: "0.1.0"
    repository_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins"
    homepage: "https://git.fabledsword.com/bvandeusen/Steward-plugins/src/branch/main/traefik"
    download_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/traefik-v1.0.0/traefik.zip"
    checksum_sha256: ""   # fill in after running: sha256sum traefik.zip
    tags:
      - proxy
      - metrics
      - access-log

  - name: unifi
    version: "1.0.0"
    description: "UniFi Network controller integration — WAN health, devices, clients, DPI"
    author: "Steward"
    license: "MIT"
    min_app_version: "0.1.0"
    repository_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins"
    homepage: "https://git.fabledsword.com/bvandeusen/Steward-plugins/src/branch/main/unifi"
    download_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/unifi-v1.0.0/unifi.zip"
    checksum_sha256: ""
    tags:
      - network
      - unifi
      - ubiquiti

  - name: host_agent
    version: "1.0.0"
    description: "Remote Linux host resource monitoring via a lightweight Python push agent"
    author: "Steward"
    license: "MIT"
    min_app_version: "0.1.0"
    repository_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins"
    homepage: "https://git.fabledsword.com/bvandeusen/Steward-plugins/src/branch/main/host_agent"
    download_url: "https://git.fabledsword.com/bvandeusen/Steward-plugins/releases/download/host_agent-v1.0.0/host_agent.zip"
    checksum_sha256: ""
    tags:
      - host
      - monitoring
      - cpu
      - memory
      - storage