@mythral0/workflow-bootstrap
v0.1.1
Published
Generate tested GitHub Actions and GitOps workflows from an existing repository
Maintainers
Readme
Workflow Bootstrap
Generate a consistent, test-gated GitHub Actions and GitOps delivery pattern from an existing repository.
npx @mythral0/workflow-bootstrap initThe command detects the project runtime, package manager, available checks,
Docker build targets, Helm charts, and staging/production values files. It then
writes a committed .workflow-bootstrap.yml and thin project workflows that
call mythral0/platform-workflows.
Supported detection
- Node.js with npm, pnpm, or Yarn
- Python projects
- Go modules
- .NET solutions and projects
- Generic Makefile checks
- One or many Dockerfiles and terminal multi-stage targets
- Helm
values-staging.yamlandvalues-live.yamlimage tag paths
Detection creates a starting point; the manifest is the source of truth. Edit it when a repository has custom commands or non-standard deployment paths.
Commands
# Detect and initialize the current repository
npx @mythral0/workflow-bootstrap init
# Non-interactive initialization
npx @mythral0/workflow-bootstrap init --yes
# Regenerate after editing the manifest
npx @mythral0/workflow-bootstrap sync
# Validate the manifest and generated files
npx @mythral0/workflow-bootstrap checkinit does not overwrite conflicting files unless --force is supplied.
sync intentionally rewrites generated files from the committed manifest.
Delivery behavior
- Pull requests run quality checks.
- Merges to
mainrerun checks before building images. - Staging pipelines are serialized and cannot overlap.
- A stale build cannot promote after
mainadvances. - GitOps values are committed only after successful image builds.
- GitHub Releases build immutable versioned images.
- Production promotion remains a separate manual workflow.
- Deployment controllers reconcile Git; Actions do not connect to clusters.
Configuration
The generated .workflow-bootstrap.yml contains all detected CI commands,
container components, registries, and GitOps update expressions. Repositories
with different component layouts receive different build matrices.
Requirements
- Node.js 20 or newer for the bootstrap command
- GitHub Actions for generated workflows
- GHCR for the initial
0.xcontainer workflow - A GitOps controller watching the configured branch for deployment
License
MIT
