@@ -5,12 +5,11 @@ This document defines policy principles, severity handling, and exit code policy
55Normative policy definitions live in:
66- ` tools/ci/policies/schema/rules.schema.json `
77- ` tools/ci/policies/rules/ `
8+ Entry index:
9+ - ` docs/governance/POLICY_INDEX.md `
810
911## Global Rules
1012- Fail-closed: no silent bypass paths.
11- - No ` continue-on-error: true ` in workflow files.
12- - No ` || true ` on critical workflow paths.
13- - No ` set +e ` without explicit allow-list entry.
1413- Workflow YAML only calls entry scripts under ` tools/ci/bin/ ` .
1514
1615## Result Contract
@@ -22,17 +21,8 @@ All required checks MUST write:
2221` result.json ` must comply with ` tools/ci/schema/result.schema.json ` .
2322
2423## Rule Catalog
25- - ` CI-ARTIFACT-001 ` fail: required artifact missing.
26- - ` CI-POLICY-001 ` fail: policy rule loading/schema validation failed.
27- - ` CI-SCHEMA-001 ` fail: ` result.json ` schema validation failed.
28- - ` CI-SHELL-001 ` fail: found ` continue-on-error: true ` .
29- - ` CI-SHELL-002 ` fail: found ` || true ` in critical workflow path.
30- - ` CI-SHELL-003 ` fail: found ` set +e ` outside allow-list.
31- - ` CI-SHELL-004 ` fail: workflow ` run: | ` block exceeds configured max lines.
32- - ` CI-GRAPH-001 ` fail: required CI graph edge or job constraint violated.
33- - ` CI-QODANA-001 ` fail: ` QODANA_TOKEN ` missing.
34- - ` CI-QODANA-002 ` fail: expected SARIF missing.
35- - ` CI-QODANA-003 ` fail: SARIF invalid JSON.
24+ - Rule IDs and file ownership are indexed in ` docs/governance/POLICY_INDEX.md ` .
25+ - Evaluation details and thresholds are defined only in ` tools/ci/policies/rules/ ` .
3626
3727## Severity Rules
3828- ` warn ` : visible, non-blocking.
@@ -43,5 +33,5 @@ All required checks MUST write:
4333- ` 1 ` : policy/contract/check failure (` fail ` )
4434- ` 2 ` : invalid invocation or missing prerequisites
4535
46- ## set +e Allow-list
47- No allow -list entries in Phase 1 .
36+ ## Allow-lists
37+ Allow -list definitions are managed in rule parameters under ` tools/ci/policies/rules/ ` .
0 commit comments