-
Notifications
You must be signed in to change notification settings - Fork 0
Add Enterprise AGI/ASI governance blueprint, machine-readable artifacts, validator, and CI enforcement #62
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
OneFineStarstuff
merged 2 commits into
main
from
codex/create-ai-governance-implementation-blueprint
Apr 27, 2026
Merged
Changes from 1 commit
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,44 @@ | ||
| name: Governance Artifacts CI | ||
|
|
||
| on: | ||
| pull_request: | ||
| paths: | ||
| - 'ENTERPRISE_AGI_ASI_GOVERNANCE_BLUEPRINT_2026_2030.md' | ||
| - 'governance_blueprint/**' | ||
| - '.github/workflows/governance-artifacts-ci.yml' | ||
| push: | ||
| branches: [ main, master ] | ||
| paths: | ||
| - 'ENTERPRISE_AGI_ASI_GOVERNANCE_BLUEPRINT_2026_2030.md' | ||
| - 'governance_blueprint/**' | ||
| - '.github/workflows/governance-artifacts-ci.yml' | ||
|
|
||
| jobs: | ||
| validate-governance-artifacts: | ||
| runs-on: ubuntu-latest | ||
| timeout-minutes: 10 | ||
|
|
||
| steps: | ||
| - name: Checkout | ||
| uses: actions/checkout@v4 | ||
|
|
||
| - name: Setup Python | ||
| uses: actions/setup-python@v5 | ||
| with: | ||
| python-version: '3.11' | ||
|
|
||
| - name: Run governance validation suite | ||
| run: python3 governance_blueprint/validation/run_validation_suite.py --quiet --json-report governance-artifact-validation-report.json --suite-report governance-validation-suite-report.json | ||
|
|
||
| - name: Show validation report | ||
| run: | | ||
| cat governance-artifact-validation-report.json | ||
| cat governance-validation-suite-report.json | ||
|
OneFineStarstuff marked this conversation as resolved.
|
||
|
|
||
| - name: Upload validation report | ||
| uses: actions/upload-artifact@v4 | ||
| with: | ||
| name: governance-validation-reports | ||
| path: | | ||
| governance-artifact-validation-report.json | ||
| governance-validation-suite-report.json | ||
|
OneFineStarstuff marked this conversation as resolved.
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,9 @@ | ||
| repos: | ||
| - repo: local | ||
| hooks: | ||
| - id: governance-validation-suite | ||
| name: governance validation suite | ||
| entry: python3 governance_blueprint/validation/run_validation_suite.py --skip-selftest --quiet | ||
| language: system | ||
| pass_filenames: false | ||
| files: '^(governance_blueprint/|ENTERPRISE_AGI_ASI_GOVERNANCE_BLUEPRINT_2026_2030\.md)' |
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,43 @@ | ||
| PYTHON ?= python3 | ||
|
|
||
| .PHONY: gov-manifest gov-manifest-check gov-validate gov-validate-json gov-lint gov-dashboard-check gov-selftest gov-suite gov-suite-json gov-suite-report gov-suite-ci gov-clean | ||
|
|
||
| gov-manifest: | ||
| $(PYTHON) governance_blueprint/validation/generate_artifact_manifest.py | ||
|
|
||
| gov-manifest-check: | ||
| $(PYTHON) governance_blueprint/validation/generate_artifact_manifest.py --check | ||
|
|
||
| gov-validate: | ||
| $(PYTHON) governance_blueprint/validation/validate_artifacts.py | ||
|
|
||
| gov-validate-json: | ||
| $(PYTHON) governance_blueprint/validation/validate_artifacts.py --json | ||
|
|
||
| gov-lint: | ||
| $(PYTHON) governance_blueprint/validation/lint_python_sources.py | ||
|
|
||
| gov-dashboard-check: | ||
| $(PYTHON) governance_blueprint/validation/validate_dashboard_links.py | ||
|
|
||
| gov-selftest: | ||
| $(PYTHON) governance_blueprint/validation/selftest_validate_artifacts.py | ||
| $(PYTHON) governance_blueprint/validation/selftest_run_validation_suite.py | ||
|
|
||
| gov-suite: | ||
| $(PYTHON) governance_blueprint/validation/run_validation_suite.py | ||
|
|
||
| gov-suite-json: | ||
| $(PYTHON) governance_blueprint/validation/run_validation_suite.py --json-report governance-artifact-validation-report.json | ||
| @echo "Wrote governance-artifact-validation-report.json" | ||
|
|
||
| gov-suite-report: | ||
| $(PYTHON) governance_blueprint/validation/run_validation_suite.py --json-report governance-artifact-validation-report.json --suite-report governance-validation-suite-report.json | ||
| @echo "Wrote governance-artifact-validation-report.json and governance-validation-suite-report.json" | ||
|
|
||
| gov-suite-ci: | ||
| $(PYTHON) governance_blueprint/validation/run_validation_suite.py --quiet --json-report governance-artifact-validation-report.json --suite-report governance-validation-suite-report.json | ||
| @echo "Wrote governance-artifact-validation-report.json and governance-validation-suite-report.json (quiet mode)" | ||
|
|
||
| gov-clean: | ||
| $(PYTHON) -c "from pathlib import Path; import shutil; report=Path('governance-artifact-validation-report.json'); suite=Path('governance-validation-suite-report.json'); report.exists() and report.unlink(); suite.exists() and suite.unlink(); [shutil.rmtree(p) for p in Path('governance_blueprint/validation').rglob('__pycache__') if p.is_dir()]" |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,18 @@ | ||
| { | ||
| "package": "enterprise_agi_asi_governance_blueprint", | ||
| "version": "1.3.1", | ||
| "generated_utc": "2026-04-27T06:11:04Z", | ||
| "artifacts": { | ||
| "control_mapping_matrix.csv": "8af4170e62e6aec3c12f3f554d29fe31e6c59c196cd9b3e1590f1238597ce228", | ||
| "evidence_event_schema.json": "7c84f8fce1cefeff08308a2763c086eb4ede05881881cd53c484e879df04196a", | ||
| "opa/release_gate.rego": "bd117bddd2c77a0fd5cc4741aa6805b6f1f711d2baa5732ca037ea4db7b60c43", | ||
| "roadmap_2026_2030.yaml": "35132b486b360d91ceab94e7949278c755a28dbab0cccf64e0b3a776d7dab485", | ||
| "validation/validate_artifacts.py": "0908bb44ecf2b209861fb3fe0259bad2b652d94b1f6c50c45592b074f52848e0", | ||
| "validation/selftest_validate_artifacts.py": "50414aa4ecf39166268d76ab0363ad2ec9ac32cde6b27ae5c631764fd7bce29b", | ||
| "validation/generate_artifact_manifest.py": "654479289df4a57ab58288adcbb5c9e23861f3b3a6e4d524b8214bb8c992d060", | ||
| "validation/run_validation_suite.py": "4c7038c4d3da1d6fb3f4c43bddd5b2237856b90bd568a17d03a1d16cfc904781", | ||
| "validation/selftest_run_validation_suite.py": "2f987933769c0530eaa7ad51a0454781e8bd90bb700c120219dae5a96645adbe", | ||
| "validation/lint_python_sources.py": "52b36b1427679624fd9778dc93cb7b318b4c882930e78c0947a37d5185dafae9", | ||
| "validation/validate_dashboard_links.py": "e854e2c61ac6e31f880fce8e28c6ed95856d13a85fdfdbcf124df74925b1461a" | ||
| } | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| control_family,control_id,description,eu_ai_act_anchor,nist_ai_rmf_anchor,iso_42001_anchor,financial_anchor,evidence_artifacts,control_owner,review_frequency | ||
| Governance & accountability,AIGOV-01,Board-approved AI governance charter and accountability model,Governance/accountability obligations,Govern,Leadership & planning controls,SR 11-7 governance + SMCR,Board minutes|charter|RACI,CRO/CAIO,Quarterly | ||
| Inventory & tiering,AIGOV-02,Enterprise inventory and risk tiering for all AI systems,Risk classification/high-risk scoping,Map,Context & risk assessment controls,PRA/FCA model inventory expectations,Inventory export|tier rationale logs,Model Risk,Monthly | ||
| Data governance,AIGOV-03,Lawful basis and lineage for training/serving datasets,Logging/traceability dependencies,Map+Measure,Operational data controls,GDPR + MAS/HKMA data controls,DPIA|TIA|lineage graph,CDO/Privacy,Monthly | ||
| Validation & challenge,AIGOV-04,Independent validation before high-risk deployment,Conformity/performance support obligations,Measure+Manage,Evaluation & monitoring controls,SR 11-7 independent validation,Validation report|challenger tests,Model Validation,Per release | ||
| Explainability & oversight,AIGOV-05,Human oversight and adverse-action explainability controls,Human oversight/transparency,Govern+Manage,Human-in-the-loop controls,FCRA/ECOA + Consumer Duty,Explanation logs|override audit,Business Owner,Per release | ||
| Monitoring & incident response,AIGOV-06,Continuous monitoring with incident escalation workflows,Post-market monitoring/incident handling,Measure+Manage,Incident handling and improvement,Operational resilience expectations,Incident timeline|postmortem|notifications,SRE/CISO,Continuous | ||
| Third-party & GPAI,AIGOV-07,Supplier assurance and contractual auditability,GPAI provider/deployer dependencies,Govern+Map,External provider controls,Outsourcing/third-party risk guidance,Contracts|assessments|exit plan,TPRM,Quarterly |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| { | ||
| "$schema": "https://json-schema.org/draft/2020-12/schema", | ||
| "title": "AI Governance Evidence Event", | ||
| "type": "object", | ||
| "required": [ | ||
| "event_id", | ||
| "timestamp_utc", | ||
| "event_type", | ||
| "model_id", | ||
| "model_version", | ||
| "risk_tier", | ||
| "policy_bundle_hash", | ||
| "trace_id", | ||
| "jurisdiction_code" | ||
| ], | ||
| "properties": { | ||
| "event_id": { "type": "string", "description": "UUID for immutable event identity." }, | ||
| "timestamp_utc": { "type": "string", "format": "date-time" }, | ||
| "event_type": { | ||
| "type": "string", | ||
| "enum": [ | ||
| "model_registered", | ||
| "validation_approved", | ||
| "release_approved", | ||
| "inference_executed", | ||
| "override_recorded", | ||
| "incident_opened", | ||
| "incident_closed" | ||
| ] | ||
| }, | ||
| "model_id": { "type": "string" }, | ||
| "model_version": { "type": "string" }, | ||
| "risk_tier": { "type": "integer", "minimum": 0, "maximum": 4 }, | ||
| "policy_bundle_hash": { "type": "string" }, | ||
| "trace_id": { "type": "string" }, | ||
| "request_id": { "type": "string" }, | ||
| "decision_context": { "type": "string" }, | ||
| "explanation_reference": { "type": "string" }, | ||
| "human_override_flag": { "type": "boolean" }, | ||
| "override_reason_code": { "type": "string" }, | ||
| "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, | ||
| "latency_ms": { "type": "number", "minimum": 0 }, | ||
| "jurisdiction_code": { "type": "string" } | ||
| }, | ||
| "additionalProperties": false | ||
| } |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,40 @@ | ||
| package aigov.release | ||
|
|
||
| # Deny by default. | ||
| default allow = false | ||
|
|
||
| # Baseline requirements for all models. | ||
| baseline_requirements { | ||
| input.model_card_exists | ||
| input.security_scan_passed | ||
| input.policy_bundle_hash_approved | ||
| } | ||
|
|
||
| # Low/medium risk release path. | ||
| allow { | ||
| input.risk_tier <= 2 | ||
| baseline_requirements | ||
| } | ||
|
|
||
| # High-risk release path. | ||
| allow { | ||
| input.risk_tier >= 3 | ||
|
OneFineStarstuff marked this conversation as resolved.
|
||
| baseline_requirements | ||
| input.independent_validation_approved | ||
| input.legal_compliance_approved | ||
| input.explainability_test_passed | ||
| input.human_oversight_plan_approved | ||
| } | ||
|
|
||
| # Additional controls for frontier/special risk systems. | ||
| allow { | ||
| input.risk_tier == 4 | ||
| baseline_requirements | ||
| input.independent_validation_approved | ||
| input.legal_compliance_approved | ||
| input.explainability_test_passed | ||
| input.human_oversight_plan_approved | ||
| input.safety_case_approved | ||
| input.containment_controls_verified | ||
| input.executive_signoff | ||
| } | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,50 @@ | ||
| program: enterprise_agi_asi_governance | ||
| version: 1.0 | ||
| horizon: 2026-2030 | ||
| phases: | ||
| - name: foundation | ||
| window: "2026-Q2 to 2026-Q4" | ||
| objectives: | ||
| - Establish policy framework and control taxonomy | ||
| - Complete AI inventory and tiering | ||
| - Deploy minimum CI/CD compliance-as-code gates | ||
| - Enable immutable evidence logging baseline | ||
| exit_criteria: | ||
| - "100% production AI systems inventoried and tiered" | ||
| - "Tier 3+ systems independently validated" | ||
| - "Board-approved AI risk appetite ratified" | ||
| - name: industrialization | ||
| window: "2027" | ||
| objectives: | ||
| - Scale control automation across material business lines | ||
| - Implement supplier/GPAI assurance program | ||
| - Deploy explainability UX for regulated decisions | ||
| - Run regulator-inclusive tabletop exercises | ||
| exit_criteria: | ||
| - ">90% policy controls continuously monitored" | ||
| - "Regulator evidence packs generated in <72h" | ||
| - name: advanced_assurance | ||
| window: "2028" | ||
| objectives: | ||
| - Integrate frontier capability thresholding | ||
| - Deploy containment and safety-case workflow | ||
| - Complete external assurance against ISO/IEC 42001 | ||
| exit_criteria: | ||
| - "Tier 4 systems require approved safety case" | ||
| - "End-to-end control tests reproducible" | ||
| - name: resilience_and_advantage | ||
| window: "2029-2030" | ||
| objectives: | ||
| - Introduce adaptive governance with human approval | ||
| - Improve cross-border supervisory evidence interoperability | ||
| - Embed AGI discontinuity scenario planning | ||
| exit_criteria: | ||
| - "Stable audit outcomes while AI portfolio scales" | ||
| - "Reduced governance cost per model with higher control efficacy" | ||
| workstreams: | ||
| - governance_and_policy | ||
| - model_risk_and_validation | ||
| - safety_and_containment | ||
| - platform_controls_and_evidence | ||
| - third_party_and_gpai_assurance | ||
| - supervisory_engagement |
Oops, something went wrong.
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.