From 169dbe2f38fd9f02eaf5e8014fed8782ee38863f Mon Sep 17 00:00:00 2001 From: Frank Date: Sun, 18 Oct 2026 15:27:53 -0700 Subject: [PATCH 1/2] Docs: codify trunk-based git workflow in AGENTS.md The section mandated a source-test-push loop but never stated a branch regime - agents pushed straight to main. Fleet alignment (operator decision 2026-10-18, mirrors dank/command-center): main is the only long-lived branch; branch fresh off origin/main per work item; PRs target main with --no-ff; merge only on Frank's explicit OK; tags on main. Their tests/run.sh suite: ALL TESTS PASSED before push. --- AGENTS.md | 25 +++++++++++++++++-------- 1 file changed, 17 insertions(+), 8 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index edfb729..3b781ab 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -48,17 +48,26 @@ the [runbook index](#runbook-index). The full swap history lives in pages (`serverAppConfigs-docs/log.md` carries the wave plan and results) - `tests/` — bats suite + Playwright e2e -## Git Workflow +## Git Workflow — trunk-based (fleet law, aligned 2026-10-18) All edits flow through git. Never edit files on a remote machine directly. -1. **Source** the live config from the target machine -2. **Commit** the fetched version here (redact secrets into `.env`) -3. **Edit** locally -4. **Test** — `./tests/run.sh` must pass -5. **Commit and push** — origin is Gitea on Dankclaw -6. **Pull** on the target (`deploy.sh` does this) -7. **Deploy** — `scripts/deploy.sh` plans and dispatches only changed services +`main` is the only long-lived branch: no `develop`, no release branches, no +back-merges. Frank is the only dev; this repo and `dank/command-center` follow +the same regime. + +1. **Branch fresh** — `git fetch`, then branch off the current `origin/main` + (`/`, type ∈ feat|fix|docs|chore). If main moves under you, + merge it into your branch — never rebase. +2. **Source** the live config from the target machine +3. **Commit** the fetched version here (redact secrets into `.env`) +4. **Edit** locally +5. **Test** — `./tests/run.sh` must pass +6. **Push the branch and open a PR against `main`** — origin is Gitea on + Dankclaw. Merge with `--no-ff`; **never merge a PR without an explicit, + current OK from Frank.** Releases: tag `vX.Y.Z` straight on `main`. +7. **Pull** on the target (`deploy.sh` does this) +8. **Deploy** — `scripts/deploy.sh` plans and dispatches only changed services ## Deployment -- 2.54.0 From bf29518a151148a931e26f8e70ea1373e195a53d Mon Sep 17 00:00:00 2001 From: Frank Date: Sun, 18 Oct 2026 15:41:14 -0700 Subject: [PATCH 2/2] Docs: PRs get opened in Frank's browser the moment they're filed Fleet law alignment with dank/command-center: no PR-hunting in Gitea. tests/run.sh ALL TESTS PASSED before commit. --- AGENTS.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 3b781ab..ea1713a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -65,7 +65,9 @@ the same regime. 5. **Test** — `./tests/run.sh` must pass 6. **Push the branch and open a PR against `main`** — origin is Gitea on Dankclaw. Merge with `--no-ff`; **never merge a PR without an explicit, - current OK from Frank.** Releases: tag `vX.Y.Z` straight on `main`. + current OK from Frank.** **The moment the PR is open, open it in Frank's + browser** (`xdg-open ` — a Firefox tab on the workstation); never + make him hunt for it in Gitea. Releases: tag `vX.Y.Z` straight on `main`. 7. **Pull** on the target (`deploy.sh` does this) 8. **Deploy** — `scripts/deploy.sh` plans and dispatches only changed services -- 2.54.0