forgejo-actions

Reusable Forgejo workflow repository for local Forgejo-hosted projects.

Purpose

This repository will hold callable workflows and related validation for repeated CI patterns used across repositories hosted on code.sieprawski.pl.

Initial targets:

• authenticated checkout of in-house repositories
• Alpine and Debian package bootstrap helpers
• Docker image build, test, and publish workflows
• end-to-end validation of reusable workflows against a child Forgejo instance

Layout

.forgejo/workflows/    Forgejo workflow entrypoints and checks
LICENSES/              REUSE license texts
check.sh               Baseline repository validation script

Baseline Quality Gates

The repository starts with separate check workflows that verify:

• REUSE compliance
• Forgejo workflow structure with actionlint, configured for the local gator runner label
• YAML formatting and structure with yamllint
• shell correctness with shellcheck
• shell formatting with shfmt
• TOML formatting with taplo
• Markdown style with markdownlint-cli2
• spelling with typos

This baseline is intended to keep the repository green before the reusable workflow implementation issues land.

Available Workflows

• .forgejo/actions/checkout: authenticated repository checkout with optional submodules and configurable auth mode
• .forgejo/workflows/test-integration-checkout.yaml: child-Forgejo integration test for the checkout action

Documentation

• docs/checkout.md: how to use the reusable checkout action, including examples

Integration Testing

• scripts/test-integration-checkout.sh: local child-Forgejo integration test entrypoint
• tests/fixtures/checkout-basic: fixture repository used by the CI integration workflow

Notes

• callers should prefer pinning workflow usage to a commit SHA or stable tag instead of a moving branch
• examples in this repository are intended to stay useful later as fixtures for integration tests