steve
89537d417a
P5-01 — Documentation site under docs/book/ rendered with mdBook
(downloaded via Makefile, same static-binary pattern as Tailwind).
Structured chapters: getting started, concepts, operations,
security, reference. `make docs` / `make docs-watch`. Generated
output gitignored.
P5-02 — CONTRIBUTING.md rewritten from placeholder to a full
guide. CODE_OF_CONDUCT.md adapted from Contributor Covenant for a
single-maintainer project. .gitea/issue_template/{bug,feature}.md
and PULL_REQUEST_TEMPLATE.md.
P5-04 — Six README screenshots captured live from a fresh server
bootstrap (login, empty dashboard, add-host, alerts, settings,
audit log). README rewritten to centre the screenshot grid and
link out to the docs site.
P5-05 — SECURITY.md with disclosure policy (3-day ack, 30-day
default window), scope in/out, threat-model summary, operator
hardening checklist. Mirrored as a docs-site chapter.
P5-06 — End-to-end test harness. e2e/compose.e2e.yml brings up
server + sibling Linux agent (alpine + restic) + restic/rest-server.
Agent uses announce-and-approve so Playwright can drive the full
operator flow: bootstrap → login → accept pending → backup →
verify terminal status. Second spec scrapes /metrics to assert
the P6-04 endpoint surface. .gitea/workflows/e2e.yml runs on every
PR; local how-to in docs/e2e.md.
98 lines
3.0 KiB
YAML
98 lines
3.0 KiB
YAML
# P5-06 — End-to-end test suite.
|
|
#
|
|
# Spec : docs/superpowers/specs/2026-05-07-p5-oss-readiness-design.md
|
|
# Stack: e2e/compose.e2e.yml (server + agent + rest-server)
|
|
# Tests: e2e/playwright/tests/*.spec.ts
|
|
#
|
|
# Triggered on every PR into main and on workflow_dispatch. Runs
|
|
# longer than the unit-test workflow (~3-4 minutes for a clean run);
|
|
# kept separate so a slow e2e doesn't block the fast lint/test loop.
|
|
|
|
name: e2e
|
|
|
|
on:
|
|
pull_request:
|
|
branches: [main]
|
|
workflow_dispatch:
|
|
|
|
jobs:
|
|
e2e:
|
|
name: Playwright vs docker-compose
|
|
runs-on: ubuntu-latest
|
|
timeout-minutes: 15
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Build the e2e stack
|
|
run: docker compose -f e2e/compose.e2e.yml build
|
|
|
|
- name: Bring up the stack
|
|
run: docker compose -f e2e/compose.e2e.yml up -d server rest-server source-fixture
|
|
|
|
- name: Wait for server health
|
|
run: |
|
|
set -eu
|
|
for i in $(seq 1 30); do
|
|
if curl -fsS http://127.0.0.1:8080/api/version >/dev/null 2>&1; then
|
|
echo "server up"; exit 0
|
|
fi
|
|
sleep 2
|
|
done
|
|
echo "server didn't come up"; docker compose -f e2e/compose.e2e.yml logs server; exit 1
|
|
|
|
- name: Capture bootstrap token from server logs
|
|
id: bootstrap
|
|
run: |
|
|
set -eu
|
|
for i in $(seq 1 15); do
|
|
line=$(docker compose -f e2e/compose.e2e.yml logs server 2>&1 | grep -E 'bootstrap token' -A2 | grep -Eo '[a-zA-Z0-9_-]{40,}' | head -1 || true)
|
|
if [ -n "$line" ]; then
|
|
echo "RM_BOOTSTRAP_TOKEN=$line" >> "$GITHUB_ENV"
|
|
echo "got bootstrap token (${#line} chars)"
|
|
exit 0
|
|
fi
|
|
sleep 1
|
|
done
|
|
echo "bootstrap token not found in logs"
|
|
docker compose -f e2e/compose.e2e.yml logs server
|
|
exit 1
|
|
|
|
- name: Start the agent
|
|
run: docker compose -f e2e/compose.e2e.yml up -d agent
|
|
|
|
- uses: actions/setup-node@v4
|
|
with:
|
|
node-version: '20'
|
|
|
|
- name: Install Playwright
|
|
working-directory: e2e/playwright
|
|
run: |
|
|
npm install --no-audit --no-fund
|
|
npx playwright install --with-deps chromium
|
|
|
|
- name: Run Playwright tests
|
|
working-directory: e2e/playwright
|
|
env:
|
|
RM_BASE_URL: http://127.0.0.1:8080
|
|
RM_BOOTSTRAP_TOKEN: ${{ env.RM_BOOTSTRAP_TOKEN }}
|
|
run: npx playwright test
|
|
|
|
- name: Compose logs (on failure)
|
|
if: failure()
|
|
run: |
|
|
docker compose -f e2e/compose.e2e.yml logs --tail=200 server
|
|
docker compose -f e2e/compose.e2e.yml logs --tail=200 agent
|
|
docker compose -f e2e/compose.e2e.yml logs --tail=200 rest-server
|
|
|
|
- name: Upload Playwright report (on failure)
|
|
if: failure()
|
|
uses: actions/upload-artifact@v3
|
|
with:
|
|
name: playwright-report
|
|
path: e2e/playwright/playwright-report
|
|
retention-days: 7
|
|
|
|
- name: Tear down
|
|
if: always()
|
|
run: docker compose -f e2e/compose.e2e.yml down -v
|