quell ci
Designed for continuous integration pipelines. Scans requirement coverage for a target file or directory and fails the build if the score is below the configured threshold.
Usage
quell ci [TARGET] [OPTIONS]
Arguments
| Argument | Default | Description |
|---|---|---|
TARGET | . | File or directory to check |
Options
| Option | Default | Description |
|---|---|---|
--threshold | 0.0 | Fail CI if score is below this (0.0–1.0) |
--root | . | Project root directory |
Examples
# Basic CI run (no threshold)
quell ci
# Fail if requirement coverage drops below 80%
quell ci --threshold 0.8
# Check only a specific directory
quell ci src/ --threshold 0.75
Console output
Quell Score: 84% | Threshold: 80%
PASS
Or, on failure:
Quell Score: 62% | Threshold: 80%
FAIL: 62% < 80% threshold
Exit codes
| Code | Meaning |
|---|---|
0 | Score >= threshold (CI passes) |
1 | Score < threshold (CI fails) |
Recommended thresholds
| Project stage | Recommended threshold |
|---|---|
| New project (no history) | 0.0 (no gate yet) |
| Established project | 0.7 (70%) |
| Critical path / payment code | 0.85 (85%) |
| Security-sensitive | 0.9 (90%) |
Start low and ratchet up as your team builds the habit.
GitHub Actions
See the GitHub Actions guide for a complete workflow YAML.