25 lines
903 B
Markdown
25 lines
903 B
Markdown
|
# 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.
|