Separate collaborator docs from operator refresh

This commit is contained in:
virgil
2026-06-08 08:57:34 -07:00
parent f8b09eade7
commit e1020f0ec7
3 changed files with 30 additions and 143 deletions

View File

@@ -61,10 +61,11 @@ section0-docs pull
section0-docs status
MESSAGE="Describe the doc change" section0-docs commit
section0-docs push
git rev-parse --short HEAD
```
After a push, ask Virgil to refresh the AFFiNE copies. For now that refresh is
manual. The current refresh command lives in `docs/projection-operations.md`.
After a push, send Virgil the short commit hash. AFFiNE refresh is handled by
the lab operator side; collaborators do not need the home-lab repo.
## Contributor Setup
@@ -83,9 +84,33 @@ Then prove write access without changing `main`:
section0-docs push-test
```
`push-test` pushes the current commit to a temporary scratch branch and deletes
that branch immediately. If Git prompts for a password, use a Gitea access token
rather than your normal account password.
`push-test` does not commit files and does not change `main`. It pushes the
current commit to a temporary scratch branch, then deletes that branch
immediately. If Git prompts for a password, use a Gitea access token rather
than your normal account password.
## End-To-End Smoke Test
Use this when setting up a new machine:
```sh
section0-docs pull
cd "$(section0-docs open)"
printf '\nMBP sync smoke test: %s\n' "$(date -Is)" >> rta/reports/current-status.md
section0-docs status
MESSAGE="MBP sync smoke test" section0-docs commit
section0-docs push
git rev-parse --short HEAD
```
Send the printed commit hash to Virgil. After the AFFiNE copies are refreshed,
the smoke line should appear in:
```text
Agent Workspace / Section 0 / Git Projections / RTA Handbook / RTA Status
```
## Source Models