forked from tribes/tribes-plugin-template

T

self ff9817fcc2 fix: use host-backed plugin test aliases

Route raw Mix test and precommit aliases through the plugin wrapper workflow.

Update the manifest assertion so supertest remains an internal test fixture without a public capability.

2026-05-09 19:43:35 +02:00

.github/workflows

skeleton

2026-03-25 12:42:19 +01:00

config

feat: implement supertest fixture plugin

2026-04-30 11:18:12 +02:00

lib

test: add supertest plugin management method

2026-05-08 22:34:41 +02:00

priv

feat: implement supertest fixture plugin

2026-04-30 11:18:12 +02:00

scripts

chore: Update plugin scaffolding

2026-05-07 16:48:42 +02:00

test

fix: use host-backed plugin test aliases

2026-05-09 19:43:35 +02:00

.credo.exs

build: Credo, devenv, precommit

2026-04-26 22:00:17 +02:00

.envrc

build: Credo, devenv, precommit

2026-04-26 22:00:17 +02:00

.formatter.exs

skeleton

2026-03-25 12:42:19 +01:00

.gitignore

build: Credo, devenv, precommit

2026-04-26 22:00:17 +02:00

AGENTS.md

fix: use host-backed plugin test aliases

2026-05-09 19:43:35 +02:00

devenv.lock

build: Credo, devenv, precommit

2026-04-26 22:00:17 +02:00

devenv.nix

feat(template): adopt host-backed plugin workflow

2026-04-27 17:00:16 +02:00

devenv.yaml

build: Credo, devenv, precommit

2026-04-26 22:00:17 +02:00

manifest.json

fix: remove supertest plugin contract

2026-05-09 17:31:18 +02:00

mix.exs

fix: use host-backed plugin test aliases

2026-05-09 19:43:35 +02:00

mix.lock

fix: remove supertest plugin contract

2026-05-09 17:31:18 +02:00

README.md

fix: use host-backed plugin test aliases

2026-05-09 19:43:35 +02:00

README.md

tribes-plugin-supertest

Migration and sync fixture plugin for Tribes supertest scenarios.

This plugin is intentionally small and boring. It exists so live rollout tests can validate behavior that Aether does not cover:

plugin-owned Ash resources
AshNostrSync registration for plugin domains
reversible plugin database migrations
plugin-owned JSON API access from the infra runner

Runtime surface

The plugin exposes a local-only JSON API under /plugins-api/supertest:

GET /health
GET /schema
POST /reset
POST /cases
POST /cases/:id/increment
POST /events
GET /state?run_id=...

The API rejects non-loopback requests. Supertest calls it over SSH with curl against 127.0.0.1:4000 on each node.

Resources

Supertest.Case
Supertest.Event

Both resources are backed by Tribes.Repo, use AshPostgres.DataLayer, and participate in AshNostrSync.

Development

Use the host-backed plugin helper:

devenv shell plugin validate
devenv shell plugin test
devenv shell plugin precommit

Plain mix test and mix precommit are guarded because this suite expects the host plugin test environment. Use mix raw_test / mix raw_precommit only for low-level debugging after setting the same host environment yourself.