internal/

Package branchprotection emits the JSON body an operator applies to GitHub's branch-protection API for a cascade-managed trunk.

Package changelog generates release changelogs from conventional commit history, parsing commits into typed entries and enriching authors with GitHub usernames for release notes.

Package changes detects which files changed between two commits and, from the path rules in the manifest, which component builds and deploys those changes trigger.

Package config defines the cascade manifest schema and its parsing, validation, and state handling.

Package coverage records, for every workflow kind the generator emits, the executing coverage that exercises it: e2e scenarios, e2e harness tests, and fleet lanes.

Package environments emits a per-environment configuration file an operator applies to GitHub's Environments REST API.

Package external provides CLI commands for handling external repo notifications.

Package fleetreconcile holds the run-ledger reconcile core that backs the fleet-reconcile reusable workflow.

Package generate is the compiler core: it renders a parsed manifest into the GitHub Actions workflow files that run the pipeline.

Package ghaoutput writes step outputs to the file named by $GITHUB_OUTPUT, using plain key=value lines for single-line values and randomized heredoc delimiters for multiline values so untrusted content cannot forge additional outputs.

Package git wraps the git CLI for the repository operations cascade needs: listing changed files and commits between SHAs, reading and validating version tags, querying branches, and committing and pushing state updates with rebase and retry handling.

Package github queries the GitHub Actions jobs API through the gh CLI and maps workflow job names to their conclusions.

Package globals provides access to global CLI flags and state.

Package graph drives the cascade visualizer from the command line.

Package hotfix plans and validates per-environment hotfixes that apply a trunk commit onto an environment pinned to an older trunk base.

Package initcmd implements the "cascade init" command, which scaffolds a new project: it renders a starter manifest and matching reusable-workflow stubs, self-checks them through the real generator, and writes them to disk so a repository can adopt cascade with a working configuration on the first try.

Package log provides structured logging with INFO, DEBUG, and TRACE levels.

Package orchestrate provides CLI commands for CI/CD orchestration.

Package output provides helpers for outputting data to GitHub Actions and JSON.

Package pinreconcile implements the pin-reconciliation engine: adopting an external action-pin change back into the manifest and regenerating so every owned file agrees with it again.

Package plan implements the read-only "cascade plan" command.

Package promote implements environment promotion: moving an already built artifact from one environment to the next in the chain.

Package release manages GitHub releases over the GitHub REST API: creating and updating the draft release that accumulates changes and publishing it when a version is released.

Package reset provides functionality to reset test repositories by wiping releases, tags, and optionally resetting state in the manifest.

Package rollback implements the `cascade rollback` command: explicit re-promotion of a prior version or SHA to a target environment.

Package scaffold renders a starter cascade manifest and the matching reusable-workflow stubs for a project, so a new repository can adopt cascade with a working, self-consistent configuration on the first try.

Package schema embeds the hand-authored JSON Schema for the cascade manifest and exposes it to the CLI and to editors.

Package setupcli holds the hermetic fixture tests for the setup-cli composite action's install script (.github/actions/setup-cli/install.sh).

Package simulate implements the what-if engine behind cascade simulate: it applies a hypothetical promote, rollback, release, or hotfix action to an in-memory copy of the manifest and reports the resulting state diff and side effects without changing anything.

Package statewrite provides the shared optimistic-lock retry used by every finalize verb (orchestrate, promote, rollback, hotfix) when it commits the manifest to the trunk branch through the GitHub Contents REST API.

Package status implements the cascade status command group: it reads the deployed state recorded in the manifest for environments, builds, and deploys, and includes a consistency check that compares recorded state against the repository's remote branches.

Package taggrammar is the single source of truth for the shape of cascade's own release tags.

Package verify implements the read-only "cascade verify" command.

Package version provides semantic versioning utilities for release management.

Package visualize builds a render-agnostic view of a cascade pipeline and emits it as a diagram.