Files

Knacky f1fdf27012 feat(m0): bootstrap repo, design system, compose stack

- Repo scaffolding: .gitignore, .env.example, Makefile, docker-compose.yml,
  README.md, CHANGELOG.md, pre-commit config.
- Three-service stack: api (Flask 3), db (postgres:16-alpine), front (nginx
  serving the Vite bundle). Named volumes metamorph_db + metamorph_evidence.
- Backend skeleton: Flask app factory, JSON structured logging on stdout,
  GET /api/v1/health, multi-stage Dockerfile, pyproject.toml driven by uv,
  Pydantic Settings with secret guard rails (refuses to boot in non-dev with
  placeholders), APP_ENV gating.
- Frontend skeleton: Vite + React 18 + TypeScript strict + TailwindCSS, RTOps
  design tokens from tasks/design.md, self-hosted JetBrains Mono / IBM Plex
  Sans via @fontsource, base UI primitives (Card/Tag/SectionHeader/FlowNode/
  Button), home page wired to /api/v1/health.
- Engine-agnostic Makefile: auto-detects docker or podman, picks the matching
  compose driver. Targets: up/down/build/rebuild/dev/lint/fmt/test/migrate/
  seed-mitre/print-install-token/e2e/inspect-health.
- Playwright suite: e2e/tests/m0-smoke.spec.ts (8 tests) + HTML + JUnit
  reports + traces on retry.
- Docs: tasks/spec.md (finalized after Q&A), tasks/design.md, tasks/todo.md
  (14 milestones), tasks/testing-m0.md, tasks/lessons.md.

DoD: make up + make health + make e2e all pass on podman 5.x (Fedora) and
docker. TLS terminated by external reverse proxy (spec §6 NF-network).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-11 06:16:00 +02:00

1.8 KiB

Raw Blame History

Metamorph e2e

End-to-end tests powered by Playwright. Each milestone in tasks/todo.md should add at least one spec file (tests/m<N>-*.spec.ts).

One-time setup

cd e2e
npm install
npm run install-browsers      # downloads chromium (uses sudo for system deps)

Running against a live stack

# 1. Bring the stack up from the repo root:
cd .. && make up

# 2. Run the tests:
cd e2e && npm test

# 3. Open the HTML report:
npm run report                 # opens playwright-report/index.html in your browser

Or from the repo root:

make e2e        # runs against the already-up stack
make e2e-report # opens the HTML report
make e2e-up     # one-shot: make up + wait healthy + run tests

Auto-spawn mode

Set PW_AUTOSTART=1 to let Playwright spawn make up itself before the run:

PW_AUTOSTART=1 npm test

Configuration

Env var	Default	Purpose
`BASE_URL`	`http://localhost:8080`	The front nginx URL (which proxies `/api/*`)
`PW_AUTOSTART`	`0`	If `1`, spawn `make up` before the tests
`CI`	unset	When set, retries=2 and parallel workers=2

Reports

HTML : e2e/playwright-report/index.html
JUnit : e2e/playwright-report/junit.xml (CI ingestion)
Trace : kept on first retry, opened with npx playwright show-trace …

Layout

e2e/
├── tests/
│   └── m0-smoke.spec.ts        # bootstrap milestone (current)
│   └── m<N>-*.spec.ts          # one spec per milestone, added as features land
├── playwright.config.ts
├── tsconfig.json
└── package.json

1.8 KiB Raw Blame History