DEVX-176: ci: docs fast-path, notify-failure scoping, post-merge queue

Co-authored-by: emil User <emil.simeonov@tutanota.com>
2026-09-21 19:38:37 +00:00
parent 693e7962da
commit 8633980062
3 changed files with 71 additions and 14 deletions
@@ -0,0 +1,43 @@
+# DEVX-176: CI hygiene — docs fast-path, failure-notify scoping, post-merge cancel
+
+## Problem
+
+devx CI has the same inefficiencies fixed in infra (OBL-INFRA-613/615/616):
+docs-only PRs run the full quality suite (~10 min), CI failures auto-create
+issues (noise — the user decided issues are for deploy failures only), and
+post-merge `cancel-in-progress: true` can kill a release mid-publish.
+
+## Approach
+
+REQ-1: Docs-only PRs skip heavy validate steps (lint-all, unit tests,
+test-speed, translation check, security scan, workflow dry-run). Docs gate,
+spec validation, PR size, and auto-merge preconditions still run.
+Restricted to pull_request events.
+
+REQ-2: Remove the failure-issue step from `ci.yml` validate job.
+Post-merge keeps failure notification (release/publish failures are
+deploy-pipeline events).
+
+REQ-3: post-merge `cancel-in-progress: false` — a new push queues instead
+of killing an in-flight release/publish.
+
+## Test Plan
+
+- `make workflow-lint` passes.
+- Docs-only PR: quality steps skipped, docs gate + spec + size + merge run.
+- Non-docs PR: unchanged behavior.
+
+## Deploy Plan
+
+Workflow-only change; takes effect on merge. No release needed.
+
+## Rollback Plan
+
+Revert the commit.
+
+## Acceptance Criteria
+
+- [x] REQ-1 implemented — early docs-only step + step-level `if` gates
+- [x] REQ-2 implemented — notify step removed from ci.yml only
+- [x] REQ-3 implemented — post-merge concurrency flipped
+- [x] `make workflow-lint` passes