From 5bf607a0cbf4e7fecc14bce419698224d39759ff Mon Sep 17 00:00:00 2001 From: garrytan Date: Tue, 3 Nov 2026 04:50:21 +0000 Subject: [PATCH] docs(capy-install): wrapper 4 follows the update channel (Step 14.5 audit) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --- docs/capy-install.md | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/capy-install.md b/docs/capy-install.md index 1aa27b2dc..8c878dd5a 100644 --- a/docs/capy-install.md +++ b/docs/capy-install.md @@ -4,7 +4,7 @@ Three layers, each owned by gstack: | Layer | Where | Job | |---|---|---| -| Bootstrapper | `capy/skill/gstack/scripts/install.sh` (copied once into the owner's Drive skill folder; frozen) | clone when absent; fetch origin's default branch and read the supported minimum from `FETCH_HEAD:capy/support.env`; in install mode fast-forward a clean, unpinned checkout below it; exec the full wrapper | +| Bootstrapper | `capy/skill/gstack/scripts/install.sh` (copied once into the owner's Drive skill folder; frozen) | clone when absent; fetch origin's default branch and read the supported minimum from `FETCH_HEAD:capy/support.env` (from wrapper 4 a fresh clone or the floor fast-forward follows `stable` instead when the update channel resolves to it and `stable` meets that minimum, see [releases.md](releases.md#channels)); in install mode fast-forward a clean, unpinned checkout below it; exec the full wrapper | | Full wrapper | `bin/gstack-capy-session` (moves with the checkout) | map the session start onto the installer: `--check` certifies (and reports a checkout behind origin), otherwise fast-forward a checkout behind origin (`bin/gstack-upgrade --ff-only-no-reinstall`), then install or repair | | Installer | `bin/gstack-capy-install` | Bun, both host profiles, the doctor, the install verdict, the launch line, the trailer | @@ -591,7 +591,10 @@ Wrapper 2 only added optional exports (the trailer's `latest:` note and the `cloned` line). Wrapper 3 answers `--check --for none` itself (a copy at 1 or 2 prints `fail not-installed` for a coordinator machine and still works for every other call), so the minimum is 3: every older Drive copy prints the owner -action until the owner recopies `capy/skill/gstack/`. +action until the owner recopies `capy/skill/gstack/`. Wrapper 4 only adds the +update-channel choice for the clone and the floor fast-forward +(`GSTACK_UPDATE_CHANNEL=stable|main`, else the checkout's channel, else main); +the minimum stays 3, so a copy at 3 keeps working. ## Exit codes