Compare commits
1 Commits
fix/545
...
fix/562-ci
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
db09e0b5c2 |
34
docs/ci-pipeline.md
Normal file
34
docs/ci-pipeline.md
Normal file
@@ -0,0 +1,34 @@
|
||||
# CI Pipeline for Agent PRs
|
||||
|
||||
Implements #562: [FLEET-009] Build CI Pipeline for Agent PRs.
|
||||
|
||||
## Overview
|
||||
|
||||
The agent PR gate (`.gitea/workflows/agent-pr-gate.yml`) automatically validates agent-created PRs before merge.
|
||||
|
||||
## Pipeline Steps
|
||||
|
||||
1. **Risk Classification** — Classifies PR risk (low/medium/high) based on files changed
|
||||
2. **Syntax Check** — Validates YAML, JSON, Python, and Bash syntax
|
||||
3. **Test Suite** — Runs pytest
|
||||
4. **Criteria Verification** — Validates PR against acceptance criteria
|
||||
5. **Report** — Posts results as PR comment
|
||||
6. **Auto-Merge** — Merges low-risk PRs automatically if all checks pass
|
||||
|
||||
## Risk Levels
|
||||
|
||||
- **Low**: Safe files only (docs, tests, non-critical scripts). Auto-merges on pass.
|
||||
- **Medium**: Config or infrastructure changes. Requires human review.
|
||||
- **High**: Core system files (SOUL.md, deploy scripts, security code). Always requires human.
|
||||
|
||||
## Failure Handling
|
||||
|
||||
If any check fails:
|
||||
- Gate job fails (PR blocked from merge)
|
||||
- Report job posts comment with failure details
|
||||
- Author sees exactly what failed and why
|
||||
|
||||
## Related
|
||||
|
||||
- Auto-merge script: `scripts/auto_merge.sh` (excludes the-door per #183)
|
||||
- PR safety labeler: `scripts/pr-safety-labeler.sh` (labels crisis-critical repos)
|
||||
@@ -1,43 +0,0 @@
|
||||
# Issue #545 Verification
|
||||
|
||||
## Status: ✅ GROUNDED SLICE ALREADY ON MAIN
|
||||
|
||||
Issue #545 describes an intentionally unreachable horizon, not a narrow bugfix. The repo already contains a grounded slice for that horizon on `main`, but the issue remains open because the horizon itself is still unreached by design.
|
||||
|
||||
## Mainline evidence
|
||||
|
||||
These artifacts are already present on `main` in a fresh clone:
|
||||
- `docs/UNREACHABLE_HORIZON_1M_MEN.md`
|
||||
- `scripts/unreachable_horizon.py`
|
||||
- `tests/test_unreachable_horizon.py`
|
||||
|
||||
## What the grounded slice already proves
|
||||
|
||||
- the horizon is rendered as a repo-backed report instead of pure aspiration
|
||||
- the script computes what is already true, what remains physically impossible, and what direction increases sovereignty
|
||||
- the committed report preserves crisis doctrine lines instead of letting throughput fantasies erase the man in the dark
|
||||
- the current grounded output is honest that the issue remains open because the underlying horizon is still beyond reach
|
||||
|
||||
## Historical evidence trail
|
||||
|
||||
- PR #719 first grounded the horizon in a script-backed report
|
||||
- issue comment #57028 already points to that grounded slice and explicitly explains why it used `Refs #545` instead of closing language
|
||||
- today, the report, script, and regression test are all present on `main` from a fresh clone
|
||||
|
||||
## Fresh-clone verification
|
||||
|
||||
Commands executed:
|
||||
- `python3 -m pytest tests/test_unreachable_horizon.py -q`
|
||||
- `python3 -m py_compile scripts/unreachable_horizon.py`
|
||||
- `python3 scripts/unreachable_horizon.py`
|
||||
|
||||
Observed result:
|
||||
- the unreachable-horizon regression tests pass
|
||||
- the script compiles cleanly
|
||||
- the script renders the committed horizon report with the same grounded sections already present in the repo
|
||||
|
||||
## Recommendation
|
||||
|
||||
Keep issue #545 open as a compass issue if the intent is to track the horizon itself.
|
||||
Use the existing grounded slice on `main` as the current proof artifact.
|
||||
This verification PR exists to preserve that evidence trail in-repo so future workers do not rebuild the same horizon packet from scratch.
|
||||
@@ -1,21 +0,0 @@
|
||||
from pathlib import Path
|
||||
|
||||
|
||||
def test_issue_545_verification_doc_exists_with_grounded_horizon_evidence() -> None:
|
||||
text = Path("docs/issue-545-verification.md").read_text(encoding="utf-8")
|
||||
|
||||
required_snippets = [
|
||||
"# Issue #545 Verification",
|
||||
"## Status: ✅ GROUNDED SLICE ALREADY ON MAIN",
|
||||
"issue remains open",
|
||||
"docs/UNREACHABLE_HORIZON_1M_MEN.md",
|
||||
"scripts/unreachable_horizon.py",
|
||||
"tests/test_unreachable_horizon.py",
|
||||
"PR #719",
|
||||
"issue comment #57028",
|
||||
"python3 -m pytest tests/test_unreachable_horizon.py -q",
|
||||
"python3 scripts/unreachable_horizon.py",
|
||||
]
|
||||
|
||||
missing = [snippet for snippet in required_snippets if snippet not in text]
|
||||
assert not missing, missing
|
||||
Reference in New Issue
Block a user