eric/ReleaseKit
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Use prepared checkouts in root workflows

Browse Source
This commit is contained in:
Eric Rakestraw
2026-10-10 03:41:36 +00:00
parent c0cc50b127
commit c9879cffa2
5 changed files with 21 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/consumers/delivery.md
View File

@@ -193,13 +193,15 @@ invokes that executable with `CI_WORKSPACE`, `CI_COMMIT_SHA`, and
Tool bootstrap and application artifact preparation are separate. The bootstrap
resolves and builds ReleaseKit from the tagged consumer's module configuration.
Afterward, `ci-deliver` loads the profile and downloads application dependencies
only when build targets are selected; it builds and delivers those targets with
the note page. Source-only profiles skip application dependency downloads and
binary work. Dependency preparation for binaries may use the network and may
update an uncommitted checksum file in the checkout. A retry still uses the
same immutable tag and that tag's module settings, even after the default branch
selects a newer ReleaseKit version.
After the workflow verifies and checks out the event tag, the resulting CLI uses
`ci-deliver --prepared` to repeat the tag, commit, HEAD, and cleanliness checks
without another fetch or checkout. It loads the tagged profile and downloads
application dependencies only when build targets are selected; it builds and
delivers those targets with the note page. Source-only profiles skip application
dependency downloads and binary work. Dependency preparation for binaries may
use the network and may update an uncommitted checksum file in the checkout. A
retry still uses the same immutable tag and that tag's module settings, even
after the default branch selects a newer ReleaseKit version.
If the application does not declare ReleaseKit as a module dependency, install
the executable separately and invoke the same `ci-deliver` command. For

8
docs/roadmap/implementation.md
View File

@@ -622,6 +622,14 @@ the original tagged module after the default branch changes. Confirm subsequent
delivery performs read-only checks without repeating checkout preparation.
Use local remotes/proxies and temporary `GOMODCACHE`, never live CI or credentials.
**Completed:** Both maintained root Woodpecker templates now verify and detach
the exact event tag before invoking `ci-deliver --prepared`, so delivery repeats
the source checks without fetching or changing checkout state. Updated workflow
tests assert the prepared flag while retaining local proxy coverage for the
tagged ReleaseKit selection, self-bootstrap, retry behavior, and source-only and
binary delivery. Verified the root profile and compiled API boundaries, the
maintained workflow harnesses, `go test ./...`, and `git diff --check`.
## Stage 13: Add a shared multi-module declaration and local launcher example
**Outcome:** Consumers select modules through small declarations with one maintained