# Artifex V1

Artifex V1 is the bootstrap autonomous engineering control plane defined in `docs/artifex_v1_bootstrap_spec.md`.

## Architecture

- Django application/control plane
- PostgreSQL as canonical persistent state
- Persisted Event Bus
- Project hierarchy: Project -> Milestone -> Feature -> Task -> Action
- Versioned Agent Registry
- Model access through `ModelRouter`
- LangGraph hidden behind `GraphRuntime`
- Git worktrees for mutable autonomous tasks
- Checkpoint-native fiction planning, drafting, parallel editorial review, approval, canon, and EPUB publication

## Run Locally

Set `DATABASE_URL` to PostgreSQL for canonical state:

```bash
DATABASE_URL=postgresql://artifex:artifex@localhost:5432/artifex python manage.py migrate
python manage.py seed_core_agents
python manage.py runserver
```

For lightweight local checks only, SQLite can be selected explicitly:

```bash
DATABASE_URL=sqlite:///db.sqlite3 python manage.py migrate
```

See `docs/story_authoring_workflow.md` for the durable story-authoring workflow and Spark deployment instructions.