# DocForge

DocForge is a project-scoped documentation service for people and AI agents. It loads canonical
Markdown and TOML from one repository, validates stable nodes and relationships, builds a disposable
search index, and returns bounded context with source provenance.

DocForge does not own project facts. It does not select project work, edit generated output, run
project commands, or perform Git and deployment operations.

## Current gate

DFG-1 and DFG-2 are complete. DFG-3 is the active gate: isolated changesets for structured create,
update, move, and delete proposals. Canonical writes remain closed.

## Development

```bash
uv sync
uv run python -m unittest discover -s tests -v
uv run docforge --project-root tests/fixtures/alpha validate
```

The command prints deterministic JSON. Derived indexes live under each project's configured cache
directory and are never canonical input.