docs: git commit/push cadence 7–11 min + helper script

Match historical area: message style; optional cadence commit/push helper.
This commit is contained in:
Hernâni Marques 2026-07-17 20:03:46 +02:00
parent c711f14a92
commit 9a07eb1dfe
No known key found for this signature in database
GPG key ID: CB5738652768F7E9
2 changed files with 164 additions and 0 deletions

View file

@ -5,6 +5,54 @@ TESTPAYSAN, …). CLI monitoring lives in this directory; **Android wallet
UI automation is separate tooling** and is **not** installed on the
default ops laptop yet.
---
## Git commit / push cadence (existing model)
Observed in `koopa-admin-log` and `francpaysan-admin-log` histories
(active work on 2026-07-17):
| Rule | Practice |
|------|----------|
| **Interval** | About **711 minutes** between publishable steps while a topic is open (bursts of 02min are fine for tiny follow-ups) |
| **Message** | `area: short description` — e.g. `monitoring: …`, `landings: …`, `docs: …`, `scripts: …`, `todo: …` |
| **Size** | One logical change (or a tight bundle), not end-of-day megacommits |
| **Push** | After each commit when the remote accepts auth (`git push origin …`) |
### Agent / human workflow
1. Finish a small slice of work.
2. `git status` / diff → commit with the area-prefix style.
3. `git push` (or run the helper below).
4. Continue; next commit window ~**711 min** later (or sooner if the next slice is ready).
### Helper script
From the admin-log root:
```bash
# dry-run
CADENCE_DRY=1 ./scripts/git-cadence-commit-push.sh
# commit + push this repo if dirty (skips secrets.env / *password* / *token*)
./scripts/git-cadence-commit-push.sh
# other checkout
./scripts/git-cadence-commit-push.sh ~/taler/src/francpaysan-admin-log
```
Optional timer (every 9min ≈ mid of 711):
```bash
# user crontab example
*/9 * * * * $HOME/src/koopa/koopa-admin-log/scripts/git-cadence-commit-push.sh >>$HOME/.cache/git-cadence-koopa.log 2>&1
*/9 * * * * $HOME/src/koopa/koopa-admin-log/scripts/git-cadence-commit-push.sh $HOME/taler/src/francpaysan-admin-log >>$HOME/.cache/git-cadence-lfp.log 2>&1
```
**Auth note (this host):** `francpaysan-admin-log``ssh://git@git.gnunet.org/…` works.
`koopa-admin-log``https://git.hacktivism.ch/…` needs credentials / SSH key for
`git.hacktivism.ch` (push may stay local until that is fixed).
## What runs without Android
| Phase | Needs |