Skip to content

ci-cd.md

Latest commit

 

History

History
73 lines (46 loc) · 2.39 KB

ci-cd.md

File metadata and controls

73 lines (46 loc) · 2.39 KB
Raw

CI/CD

Continuous integration for the DNA monorepo and recommended CI patterns for DNA-managed projects.

DNA monorepo CI

GitHub Actions on push/PR to main:

pnpm install
pnpm build
pnpm test
pnpm typecheck

Workflow: .github/workflows/ in this repository.

Failed workflow runs are cleaned up by .github/workflows/cleanup-failed-runs.yml, which listens for completed workflow_run events from CI, DNA CI/Preview/Security, Publish npm, and path-style workflow names (used when a workflow file fails validation) and deletes failures immediately after they finish. A six-hourly schedule and manual workflow_dispatch sweep any backlog. DNA ci install scaffolds the same cleanup workflow for consumer projects.

Billing / spending-limit lockouts: when GitHub cannot start runners (failed payment or Actions spending limit), jobs fail in a few seconds with empty steps. Cleanup skips those runs and always uses continue-on-error so a billing outage does not spawn a cascade of failed cleanup workflows. Lab /labs Quality → CI surfaces a dedicated GitHub Actions billing blocker banner with a link to GitHub Billing.

Private repos and Actions minutes

Public repositories use free GitHub Actions minutes. Private repos under a personal account require a valid payment method and sufficient Actions spending limit. If Lab shows wall-to-wall CI failures that finish in ~2–10s with a billing badge, fix billing first — re-running tests will not help until runners can start.

Preview deploy (consumer projects)

When ci.pushToPreview is true, dna ci install scaffolds .github/workflows/dna-preview.yml with Vercel or Netlify templates and an optional branch filter. See Integrations.

Recommended consumer project CI

Add DNA health checks to your pipeline:

# Example GitHub Actions step
- name: DNA health check
  run: |
    npx @superhumaan/dna-by-humaan doctor
    npx @superhumaan/dna-by-humaan validate

Feature factory gates

Close-out sequence for feature factory work:

dna quality report --feature
dna docker build
dna github push

Wiki CI

Build the local Docusaurus wiki:

pnpm run wiki:build

Related