DarkHelm.org/plex-playlist
Public Access
4
1
Fork 0
Code Issues 55 Pull Requests 3 Actions 9 Packages Projects 1 Releases Wiki Activity

ci: add source-first fast-check gate before build promotion

Browse Source
This commit is contained in:
copilotcoder
2026-07-01 17:37:08 -04:00
parent b16ef3a276
commit 21d81ec74c
4 changed files with 414 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/DEVELOPMENT.md
View File

@@ -390,8 +390,9 @@ pre-commit run end-of-file-fixer --all-files
The CI/CD pipeline uses a **multi-stage build architecture** for optimal performance:
- **Stage 1**: Build base image (system dependencies, Python, Node.js) - **cached across runs**
- **Stage 2**: Build complete image (project code and dependencies) - **rebuilt every time**
- **Stage 1**: Source-level fast checks (format, lint, type-check) - **hard promotion gate**
- **Stage 2**: Build base image (system dependencies, Python, Node.js) - **cached across runs**
- **Stage 3**: Build complete image (project code and dependencies) - **rebuilt every time**
Pipeline triggers:
@@ -425,26 +426,19 @@ For detailed technical information, see [CI/CD Multi-Stage Build Architecture](C
All jobs run in parallel after the setup phases:
1. **Setup Base**: Builds and pushes base Docker image (conditional)
2. **Setup Complete**: Builds and pushes complete CI/CD Docker image
3. **Code Quality**:
- Trailing whitespace check
- End-of-file formatting
- YAML syntax validation
- TOML syntax validation
4. **Backend Validation**:
- Ruff formatting check
- Ruff linting
- Pyright type checking
- Darglint docstring validation
- Unit tests with coverage
- Integration tests
- Doctests (xdoctest)
5. **Frontend Validation**:
- Prettier formatting check
- ESLint linting
- TypeScript compilation
- Unit tests with coverage
1. **Source Fast Gate**:
Backend source checks (Ruff format/lint, Pyright), frontend source checks (Prettier, ESLint, TypeScript), and dispatches downstream build only on success.
2. **Setup Base**: Builds and pushes base Docker image (conditional)
3. **Setup Complete**: Builds and pushes complete CI/CD Docker image
4. **Code Quality**:
Trailing whitespace check, end-of-file formatting, YAML syntax validation, and TOML syntax validation.
5. **Backend Validation**:
Ruff formatting check, Ruff linting, Pyright type checking, Darglint docstring validation, unit tests with coverage, integration tests, and doctests (xdoctest).
6. **Frontend Validation**:
Prettier formatting check, ESLint linting, TypeScript compilation, and unit tests with coverage.
- E2E tests (Playwright)
### Local CI/CD Testing