@@ -30,6 +30,7 @@ Production-grade federated learning platform that combines Byzantine-resilient a
3030[ ![ FedAvg Benchmark Compare] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/fedavg-benchmark-compare.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/fedavg-benchmark-compare.yml )
3131[ ![ API Spec Validation] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/api-spec-validation.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/api-spec-validation.yml )
3232[ ![ API Docs Pages] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/api-docs-pages.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/api-docs-pages.yml )
33+ [ ![ Full Validation PR Gate] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/full-validation-pr-gate.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/full-validation-pr-gate.yml )
3334[ ![ CodeQL Security Analysis] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/codeql-analysis.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/codeql-analysis.yml )
3435[ ![ Security Supply Chain] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/security-supply-chain.yml/badge.svg?branch=main )] ( https://github.com/rwilliamspbg-ops/Sovereign_Map_Federated_Learning/actions/workflows/security-supply-chain.yml )
3536[ ![ License] ( https://img.shields.io/github/license/rwilliamspbg-ops/Sovereign_Map_Federated_Learning?style=flat-square )] ( LICENSE )
@@ -42,6 +43,8 @@ Production-grade federated learning platform that combines Byzantine-resilient a
4243
4344Documentation entrypoint: [ docs/README.md] ( docs/README.md )
4445
46+ > Canonical docs navigation: [ docs/README.md] ( docs/README.md ) for active operator guides and [ Documentation/MASTER_DOCUMENTATION_INDEX.md] ( Documentation/MASTER_DOCUMENTATION_INDEX.md ) for full repository documentation indexing.
47+
4548## New Contributor Fast Path
4649
4750If you just cloned the repo and want to run tests quickly, use this sequence.
@@ -77,6 +80,41 @@ Where to get contribution guidance:
7780- Runtime validation expectations: [ README.md#contributor-first-steps] ( README.md#contributor-first-steps )
7881- Operations dashboard metric contract: [ docs/OPERATIONS_DASHBOARD_METRIC_CONTRACT.md] ( docs/OPERATIONS_DASHBOARD_METRIC_CONTRACT.md )
7982
83+ ## Validation and CI Upgrades April 2026
84+
85+ The consolidated validation path now supports profile-based execution, trend SLO enforcement, artifact diff summaries, browser runtime cadence checks, and scheduled deep validation runs.
86+
87+ What was added:
88+
89+ - Required-style PR gate workflow: [ .github/workflows/full-validation-pr-gate.yml] ( .github/workflows/full-validation-pr-gate.yml )
90+ - Scheduled deep workflow: [ .github/workflows/full-validation-scheduled-deep.yml] ( .github/workflows/full-validation-scheduled-deep.yml )
91+ - Fast and deep suite profiles: [ tests/scripts/python/run_full_validation_suite.py] ( tests/scripts/python/run_full_validation_suite.py )
92+ - Trend SLO checker: [ tests/scripts/ci/check_validation_trends.py] ( tests/scripts/ci/check_validation_trends.py )
93+ - CI diff summary writer: [ tests/scripts/ci/write_validation_diff_summary.py] ( tests/scripts/ci/write_validation_diff_summary.py )
94+ - Browser runtime E2E cadence check: [ tests/scripts/python/test_browser_runtime_e2e.py] ( tests/scripts/python/test_browser_runtime_e2e.py )
95+ - Playwright runtime artifacts: [ tests/e2e/runtime-cadence.spec.js] ( tests/e2e/runtime-cadence.spec.js ) , [ tests/e2e/playwright.config.js] ( tests/e2e/playwright.config.js )
96+
97+ Canonical commands:
98+
99+ ``` bash
100+ npm run test:setup
101+ npm run test:full:fast
102+ npm run test:full:deep
103+ npm run test:trends
104+ npm run test:summary:diff
105+ ```
106+
107+ Validation artifacts:
108+
109+ - ` test-results/full-validation/full_validation_<timestamp>.json `
110+ - ` test-results/full-validation/full_validation_<timestamp>.md `
111+ - ` test-results/full-validation/history.jsonl `
112+
113+ Documentation governance:
114+
115+ - Documentation maintenance runbook: [ docs/DOCUMENTATION_MAINTENANCE.md] ( docs/DOCUMENTATION_MAINTENANCE.md )
116+ - Test setup details and profile usage: [ tests/docs/TEST_ENV_SETUP.md] ( tests/docs/TEST_ENV_SETUP.md )
117+
80118## Mobile Shield Update March 2026
81119
82120The mobile hardening and store packaging track is now implemented in-repo.
0 commit comments