Skip to content
This repository was archived by the owner on Aug 20, 2026. It is now read-only.

development.md

Latest commit

 

History

History
59 lines (43 loc) · 1.34 KB

development.md

File metadata and controls

59 lines (43 loc) · 1.34 KB
Raw

Development

Prerequisites

  • Python 3.11-3.13 and uv
  • Node.js 22+ and npm
  • git, gh, GitHub Copilot CLI, and rootless bwrap
  • Docker or Podman 5+ for repositories that provide a Dev Container
  • Signed-in GitHub CLI and GitHub Copilot CLI sessions

Local setup

cp .env.example .env
uv sync
npm install
npm install --prefix apps/web
uv run alembic upgrade head

Run the API:

uv run uvicorn mafia.main:app --reload

Run the web application in a separate terminal:

npm run dev

The API listens on http://127.0.0.1:8000; the web application listens on http://127.0.0.1:3000.

The root npm run dev command loads the repository .env into Next.js. Authentication remains disabled unless MAFIA_AUTH_MODE=github is explicitly configured; see GitHub web authentication.

Runtime state is stored under data/ and intentionally excluded from Git. It includes SQLite state, pending actions, repository caches, analysis worktrees, and phase worktrees. The data-reset command is destructive and requires an explicit MAFIA_DATA_DIR; it refuses a target with any symlink path component.

Validation

Run the complete local gate:

npm run check

The individual gates are also available:

npm run check:api
npm run check:web
npm run check:scripts