forge — local build harness

Single-developer, GitLab-free build environment. Everything is local and backed up.

Pieces

- Action log — forge.db (SQLite), actions table. Every harness action is recorded. - Local headless git remote — bare repos under remotes/<name>.git (pushed via file://). - Mirror — a second bare copy under mirror/<name>.git (headless backup of each remote). - Version stamping — git describe --tags --dirty --always → _version.py. - Package registry (mock) — pypiserver in Docker on :8085, packages in registry/. - CI/CD — forge ci <repo>: test → build → publish to the local registry, every stage logged. - Backup — forge backup: tars the harness and copies to iCloud Drive (forge-backups/).

Use

python -m forge.cli init                 # create the action DB
docker compose up -d pypi                # start the local registry
python -m forge.cli ci <repo>            # test+build+publish a module
python -m forge.cli push <repo>          # push to local bare remote
python -m forge.cli mirror <name>        # mirror that remote
python -m forge.cli backup               # tar -> iCloud
python -m forge.cli tail -n 30           # recent actions

A launchd timer (com.forge.backup) runs backup automatically.