# .meshkore/public/links.yaml — Deployment links registry.
#
# Curl this template into your repo with:
#   curl -fsSL https://meshkore.com/reference/cluster/templates/links.yaml \
#     -o .meshkore/public/links.yaml
# then fill in one entry per module that has any reachable surface.
#
# Schema reference: https://meshkore.com/standard#13-links-registry
# Daemon endpoints:  GET /links · GET /links/<id> · POST /links/<id>

version: 1

modules:

  # Example: a Rust API deployed to Fly.io.
  # Drop or rewrite every block as needed.
  - id: <module-id>                     # MUST match cluster.yaml.modules[].id
    local:
      url: http://localhost:8080
      command: "cd <module-path> && <command-to-start-it>"
      health: /health                   # optional
    prod:
      url: https://<deployed-host>
      provider: fly                     # fly | cloudflare-pages | cloudflare-workers | vercel | render | self-hosted | other
      project: <provider-side-project-name>
      region: <provider-region>         # optional
      deploy_command: "<one-line command from repo root>"
      deployed_version: ""              # semver or arbitrary tag
      deployed_sha: ""                  # short git sha
      deployed_at: ""                   # ISO-8601 UTC
      deployed_by: ""                   # agent-id or member-id
    repo:
      branch: main
      head_sha: ""
      version: ""                       # optional, version in the repo (not deployed)
    notes: ""                           # optional, one-line free-form

  # A module that only runs locally — omit `prod`.
  # A module that's a pure library — omit `local` AND `prod`, keep `repo`
  # for version tracking, or omit the entry entirely.