docs: add forgejo_ci.md — CI patterns and known limitations #145

Closed

mik-tf wants to merge 1 commit from development_mik into development

mik-tf commented

2026-04-28 02:49:15 +00:00

Owner

Captures the CI workflow knowledge accumulated this week — actions/checkout@v4 Forgejo auth bug + manual-clone workaround, FORGEJO_TOKEN scope, cargo_env requirement, openssl-musl vendored fix, bun unzip prereq, runner Docker pool exhaustion, etc.

Makes it discoverable in tools/docs/ so future contributors don't rediscover the same gotchas. References home#200 (action bug) and circle_ops#773 (runner pool).

Signed-off-by: mik-tf

Captures the CI workflow knowledge accumulated this week — `actions/checkout@v4` Forgejo auth bug + manual-clone workaround, FORGEJO_TOKEN scope, cargo_env requirement, openssl-musl vendored fix, bun unzip prereq, runner Docker pool exhaustion, etc. Makes it discoverable in `tools/docs/` so future contributors don't rediscover the same gotchas. References home#200 (action bug) and circle_ops#773 (runner pool). Signed-off-by: mik-tf

mik-tf added 1 commit

2026-04-28 02:49:15 +00:00

docs: add forgejo_ci.md — CI patterns and known limitations

Build and Publish Skills / build-and-publish (pull_request) Successful in 3s

Details

76883b3e85

Captures the CI workflow knowledge accumulated this week so future
contributors don't have to rediscover it. Topics covered:

* Standard workflow triggers (no `branches: ["*"]` push)
* `actions/checkout@v4` Forgejo auth bug + manual-clone workaround
  (tracking: home#200)
* `FORGEJO_TOKEN` secret — scope, where to set, how to verify
* `cargo_env` after sourcing build_lib.sh (or inline source on PATH)
* Rust toolchain — explicit `rustup install 1.93` before cargo
* `openssl = { features = ["vendored"] }` for musl cross-builds
* Bun installer needs `unzip` (apt-install before curl)
* Runner Docker pool exhaustion — empty-commit retrigger
  (tracking: circle_ops#773)
* `continue-on-error: true` masks silent reds — audit step status
* Cross-repo dep patching via `.forgejo/deps.txt`

Companion to the `forge_ci` Claude skill in
`claude/skills/forge_ci/`, which covers the Actions API surface.

Signed-off-by: mik-tf