---ci--- project: acdl phase: 6 milestone: v1.29 status: complete ---/ci---
GitHub Workflows — Nova Platform CI/CD Catalog
This directory contains the GitHub Actions workflows for the Nova
platform. 3 are generated from workflows-src/<name>; 4 are GitHub-only.
Shared workflows (generated from source)
These 3 are generated from workflows-src/<name>. D-232 (v1.29): the
byte-identical forge-parity generator (scripts/sync_workflows.py) was
removed with the dev-forge parity retirement — the workflows-src/
copies remain as the source of truth but are no longer auto-synced.
| Workflow | Trigger | Inputs | Required Secrets | Purpose |
|---|---|---|---|---|
ci.yml |
pull_request: [main] |
— | — | Lint + test + check-only (runs on every PR) |
deploy.yml |
workflow_call (reusable) + push: [main] |
contract (string, required), mode (string, default deploy), changeRequestId (string), environment (string) |
NOVA_AWS_ACCESS_KEY_ID, NOVA_AWS_SECRET_ACCESS_KEY, NOVA_AWS_DEFAULT_REGION, NOVA_KMS_KEY_ID, NOVA_LAMBDA_URL |
Reusable deploy workflow (invoked by consumer repos via uses: nova/.github/workflows/deploy.yml@v1.19) |
modules-lifecycle.yml |
pull_request: [main] + workflow_dispatch |
lifecycle_mode (string, default plan — plan or full) |
NOVA_AWS_ACCESS_KEY_ID, NOVA_AWS_SECRET_ACCESS_KEY, NOVA_AWS_DEFAULT_REGION, NOVA_AWS_ACCOUNT_ID |
L1 + L2 module lifecycle pipeline (plan-only default; full apply/modify/destroy on override) |
GitHub-only workflows
These 4 have no counterpart (the dev forge lacks the features
they require — reusable workflows, matrix needs, release API).
| Workflow | Trigger | Inputs | Required Secrets | Purpose |
|---|---|---|---|---|
platform-test.yml |
pull_request: [main] |
— | — | Lint + unit + integration + schema-validation (replaces ci.yml for PRs) |
primitives-plan.yml |
pull_request: [main] |
— | NOVA_AWS_* |
Plan-only for all L1 primitives (matrix) |
patterns-plan.yml |
pull_request: [main] |
— | NOVA_AWS_* |
Plan-only for all L2 modules (matrix) |
release.yml |
push: [main] |
— | NOVA_RELEASE_TOKEN |
Semver tag + MAJOR.MINOR/MAJOR floating-tag maintenance + release creation on merge to main |
Reusable deploy workflow (deploy.yml)
Consumer repos invoke the deploy workflow via a versioned tag:
jobs:
deploy:
uses: nova/.github/workflows/deploy.yml@v1.19
with:
contract: .nova/contract.yml
environment: dev
secrets: inherit
The workflow checks out the consumer repo + the Nova platform repo, runs
scripts/run_platform.sh, and posts deploy outputs as a PR comment +
to SSM Parameter Store.