administrator/DocForge2
1
0
Fork 0
Code Issues Pull requests Projects Releases 2 Packages Wiki Activity Actions Pages

Make DocForge quality gates reproducible

Browse source
This commit is contained in:
Andraxion 2026-07-25 16:23:23 -04:00
parent 78335c8973
commit 7a940b60c1
6 changed files with 139 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

14
docs/USER_MANUAL.md
View file

@ -58,23 +58,21 @@ source format.
- Python 3.12 or newer.
- [`uv`](https://docs.astral.sh/uv/) for the development environment.
- Node.js and npm for browser asset validation.
- Pyright for strict static type checking.
- Node.js and npm for browser asset validation and strict Pyright checking.
Clone and verify DocForge:
```bash
git clone forgejo@repo.andraxion.net:administrator/DocForge.git /absolute/path/DocForge
cd /absolute/path/DocForge
uv sync
uv sync --group dev
npm ci
npm install -g pyright
pyright --pythonpath .venv/bin/python
npx pyright
npm run lint:web
uv run ruff check src tests tools
uv run ruff format --check src tests tools
uv run python -m unittest discover -s tests -v
uv run pytest -q
```
Use the executables under `/absolute/path/DocForge/.venv/bin/` when DocForge is not installed into
@ -486,12 +484,12 @@ the process so it binds the new descriptor deliberately.
Run the complete release gate from the DocForge repository:
```bash
pyright --pythonpath .venv/bin/python
npx pyright
npm run lint:web
uv run ruff check src tests tools
uv run ruff format --check src tests tools
uv run python -m compileall -q src tests tools
uv run python -W error -m unittest discover -s tests -v
uv run pytest -q
```
Project-specific vocabulary, extraction rules, and serialization belong in the project adapter.