Governance & validation

AGI Governance

Explore governance scenarios, control boundaries and the available alpha variants.

A CLOSER LOOK

How do mission rules translate into governance diagnostics?

For governance designers: inspect mission assumptions, simulated allocation and owner diagnostics across the original scenario and preserved alpha variants.

Inspect the baseline mission

Compare thermodynamic proxies, Hamiltonian coefficients and game-theoretic allocations. These are model parameters, not measurements of institutional governance.

demo/agi-governance/config/mission@v1.json ↗

Follow the lightweight evaluation

The Python harness reads the mission and computes a reproducible report. It does not sign or execute governance transactions.

demo/agi-governance/run_demo.py ↗

Inspect the broader pipeline

This is the alpha-v17 mission entry point. Each preserved alpha variant has its own configuration and diagnostics; do not mix a baseline report with a variant’s verification.

demo/agi-governance/alpha-v17/scripts/runMission.ts ↗

REAL REPOSITORY MATERIAL

Inspect. Understand. Reproduce.

Reading the exact source at revision 5b4cebb3.
This browser inspection does not execute the demo.

demo/agi-governance/config/mission@v1.json

Select a walkthrough step to explore its source.

Full source text
{
  "meta": {
    "version": "1.3.0",
    "title": "Solving α-AGI Governance",
    "description": "Hamiltonian-guided governance drill proving AGI Jobs v0 (v2) delivers superintelligent coordination under absolute owner control."
  },
  "thermodynamics": {
    "enthalpyKJ": 71142.64676186016,
    "entropyKJPerK": 4.331118586645678,
    "operatingTemperatureK": 310,
    "referenceTemperatureK": 300,
    "bitsProcessed": 1800000000,
    "burnRatePerBlock": 0.0625,
    "stakeBoltzmann": 1.380649e-23
  },
  "statisticalPhysics": {
    "beta": 0.0725,
    "energyScaling": 122.41864244335348,
    "toleranceKJ": 500,
    "energyLevels": [
      { "energy": 580, "degeneracy": 2 },
      { "energy": 640, "degeneracy": 3 },
      { "energy": 720, "degeneracy": 1 },
      { "energy": 780, "degeneracy": 1 }
    ]
  },
  "incentives": {
    "mintRule": {
      "eta": 0.94,
      "deltaValue": 125000,
      "treasuryMirrorShare": 0.65,
      "tolerance": 0.01,
      "rewardEngineShares": [
        { "role": "Agent", "share": 0.65 },
        { "role": "Validator", "share": 0.15 },
        { "role": "Operator", "share": 0.15 },
        { "role": "Employer", "share": 0.05 }
      ]
    },
    "burnRule": {
      "jobEscrow": 50000,
      "burnBps": 600,
      "treasuryBps": 200,
      "employerBps": 200
    },
    "slashing": {
      "stakeExample": 20000,
      "minStake": {
        "agent": 1200,
        "validator": 4800,
        "operator": 2600
      },
      "severities": [
        {
          "label": "Minor fault",
          "description": "Performance lapse with limited downstream impact.",
          "fraction": 0.05,
          "treasuryShare": 0.6,
          "employerShare": 0.3
        },
        {
          "label": "Major fault",
          "description": "Significant execution failure requiring restitution.",
          "fraction": 0.25,
          "treasuryShare": 0.75,
          "employerShare": 0.25
        },
        {
          "label": "Critical attack",
          "description": "Malicious coordination breach triggering total slash.",
          "fraction": 1.0,
          "treasuryShare": 1.0,
          "employerShare": 0.0
        }
      ]
    }
  },
  "hamiltonian": {
    "lambda": 0.94,
    "discountFactor": 0.92,
    "inertialMetric": [1.12, 0.98, 0.87],
    "kineticCoefficients": [132000, 148500, 162200],
    "potentialCoefficients": [98500, 104200, 118600],
    "divergenceTolerance": 0.001
  },
  "gameTheory": {
    "strategies": [
      {
        "name": "Pareto-Coop",
        "description": "Stake-weighted cooperation that minimises governance divergence while sharing alpha rewards.",
        "initialShare": 0.42
      },
      {
        "name": "Thermo-Titan",
        "description": "Aggressive Hamiltonian arbitrage focused on extracting free-energy residuals.",
        "initialShare": 0.35
      },
      {
        "name": "Sentinel-Tactician",
        "description": "Guardian cohort enforcing certificates, pausing misbehaviour, and arbitraging slashing curves.",
        "initialShare": 0.23
      }
    ],
    "payoffMatrix": [
      [1.0, 0.9, 1.1],
      [1.1, 1.0, 0.9],
      [0.9, 1.1, 1.0]
    ],
    "monteCarlo": {
      "iterations": 10000,
      "noise": 0.02,
      "seed": 424242
    }
  },
  "antifragility": {
    "sigmaSamples": [0, 0.1, 0.2, 0.3],
    "iterations": 4000,
    "replicatorSteps": 320,
    "seedOffset": 9000,
    "penaltyScaling": 0.001,
    "sigmaRewardMultiplier": 32,
    "divergencePenalty": 1.2,
    "curvatureBoost": 8
  },
  "risk": {
    "coverageWeights": {
      "staking": 0.4,
      "formal": 0.4,
      "fuzz": 0.2
    },
    "portfolioThreshold": 0.3,
    "classes": [
      {
        "id": "R0",
        "label": "Specification drift",
        "probability": 0.22,
        "impact": 0.8,
        "mitigations": {
          "staking": 0.45,
          "formal": 0.7,
          "fuzz": 0.65
        }
      },
      {
        "id": "R1",
        "label": "Economic exploit",
        "probability": 0.18,
        "impact": 0.75,
        "mitigations": {
          "staking": 0.8,
          "formal": 0.82,
          "fuzz": 0.75
        }
      },
      {
        "id": "R2",
        "label": "Protocol attack",
        "probability": 0.1,
        "impact": 0.9,
        "mitigations": {
          "staking": 0.85,
          "formal": 0.9,
          "fuzz": 0.8
        }
      },
      {
        "id": "R3",
        "label": "Model misbehaviour",
        "probability": 0.25,
        "impact": 0.65,
        "mitigations": {
          "staking": 0.6,
          "formal": 0.75,
          "fuzz": 0.65
        }
      },
      {
        "id": "R4",
        "label": "Societal externality",
        "probability": 0.08,
        "impact": 1.0,
        "mitigations": {
          "staking": 0.45,
          "formal": 0.35,
          "fuzz": 0.35
        }
      }
    ]
  },
  "alphaField": {
    "stackelberg": {
      "leaderBaseline": 7.4,
      "followerBaseline": 6.8,
      "valueCeiling": 10,
      "advantageFloor": 0.5
    },
    "macroAttractor": {
      "gibbsTargetKJ": 71200,
      "gibbsToleranceKJ": 420,
      "divergenceLimit": 0.001,
      "entropyFloor": 4.05
    },
    "antifragility": {
      "minSecondDerivative": 0.08,
      "sigmaGainMinimum": 0.12
    },
    "verification": {
      "energyMarginFloorKJ": 68000,
      "ownerCoverageMinimum": 0.95,
      "superintelligenceMinimum": 0.82,
      "quantumConfidenceMinimum": 0.72,
      "ownerSupremacyMinimum": 0.97,
      "thermoQuantumDriftMaximumKJ": 450
    },
    "signatureWeights": {
      "thermodynamic": 0.26,
      "governance": 0.22,
      "antifragility": 0.2,
      "owner": 0.2,
      "quantum": 0.12
    }
  },
  "ownerControls": {
    "owner": "0xA1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1A1",
    "pauser": "0xB2B2B2B2B2B2B2B2B2B2B2B2B2B2B2B2B2B2B2B2",
    "treasury": "0xC3C3C3C3C3C3C3C3C3C3C3C3C3C3C3C3C3C3C3C3",
    "timelockSeconds": 691200,
    "upgradeActions": [
      {
        "label": "Recalibrate Hamiltonian monitor",
        "command": "npm run owner:command-center -- --network mainnet --target HamiltonianMonitor --set-lambda 0.94 --set-inertia 1.08",
        "impact": "Locks the energy coupling coefficient and inertial metric to the antifragile optimum computed in the dossier.",
        "category": "parameter"
      },
      {
        "label": "Adjust reward engine burn curve",
        "command": "npm run reward-engine:update -- --network mainnet --burn-bps 600 --treasury-bps 200",
        "impact": "Aligns emission schedule with the Landauer-calibrated burn policy.",
        "category": "treasury"
      },
      {
        "label": "Rotate governance sentinels",
        "command": "npm run owner:rotate -- --network mainnet --role Sentinel --count 3",
        "impact": "Refreshes slashing guardians while keeping owner override authority.",
        "category": "sentinel"
      },
      {
        "label": "Update tax policy disclosure",
        "command": "npm run owner:update-all -- --network mainnet --module TaxPolicy --acknowledgement \"Participants accept AGI Jobs v2 tax terms.\"",
        "impact": "Publishes the latest regulatory acknowledgement without touching business logic.",
        "category": "compliance"
      }
    ],
    "criticalCapabilities": [
      {
        "category": "pause",
        "label": "Global pause switch",
        "description": "Immediate halt for the entire AGI Jobs execution surface via the owner guardian.",
        "command": "npm run owner:system-pause -- --network mainnet --pause true",
        "verification": "npm run owner:verify-control"
      },
      {
        "category": "resume",
        "label": "Resume operations",
        "description": "Restores production flows after remediation and confirms health checks.",
        "command": "npm run owner:system-pause -- --network mainnet --pause false",
        "verification": "npm run owner:verify-control"
      },
      {
        "category": "parameter",
        "label": "Tune Hamiltonian parameters",
        "description": "Applies Hamiltonian monitor adjustments to lock λ and inertial metrics at the computed optimum.",
        "command": "npm run owner:command-center -- --network mainnet --target HamiltonianMonitor --set-lambda 0.94 --set-inertia 1.08",
        "verification": "npm run owner:audit-hamiltonian"
      },
      {
        "category": "treasury",
        "label": "Reward engine burn curve",
        "description": "Aligns mint/burn ratios with thermodynamic constraints and treasury splits.",
        "command": "npm run reward-engine:update -- --network mainnet --burn-bps 600 --treasury-bps 200",
        "verification": "npm run reward-engine:report"
      },
      {
        "category": "sentinel",
        "label": "Sentinel rotation",
        "description": "Refreshes enforcement guardians to maintain antifragile coverage.",
        "command": "npm run owner:rotate -- --network mainnet --role Sentinel --count 3",
        "verification": "npm run monitoring:sentinels"
      },
      {
        "category": "upgrade",
        "label": "Timelocked upgrade queue",
        "description": "Queues upgrade bundle into the timelock for deterministic rollout.",
        "command": "npm run owner:upgrade -- --network mainnet --proposal governance_bundle.json",
        "verification": "npm run owner:upgrade-status"
      },
      {
        "category": "compliance",
        "label": "Regulatory disclosure",
        "description": "Publishes mandatory statements to participants and regulators.",
        "command": "npm run owner:update-all -- --network mainnet --module TaxPolicy --acknowledgement \"Participants accept AGI Jobs v2 tax terms.\"",
        "verification": "npm run owner:compliance-report"
      }
    ],
    "requiredCategories": ["pause", "resume", "parameter", "treasury", "sentinel", "upgrade", "compliance"],
    "monitoringSentinels": [
      "Grafana circuit-breakers watching governance divergence",
      "On-chain staking slash monitors",
      "Adaptive fuzz oracle with spectral drift alerts"
    ]
  },
  "quantum": {
    "planckConstant": 6.62607015e-34,
    "superpositionWeights": [0.62, 0.27, 0.11],
    "energyLevelsEv": [0.21, 0.37, 0.58],
    "entanglementFidelity": 0.985,
    "decoherenceTimeNs": 4500,
    "coherenceHalfLifeNs": 9200,
    "coherenceFrequencyThz": 540,
    "fisherInformation": 0.94,
    "measurementVariance": 0.0024,
    "noetherCharge": 0.00172,
    "targetCharge": 0.00165,
    "allowableChargeDrift": 0.00012
  },
  "blockchain": {
    "network": "Ethereum Mainnet-grade",
    "chainId": 1,
    "rpcProvider": "https://mainnet.infura.io/v3/YOUR_KEY",
    "gasTargetGwei": 24,
    "confirmations": 3,
    "upgradeDelaySeconds": 604800,
    "contracts": [
      {
        "name": "AGIJobsGovernor",
        "address": "0xD4D4D4D4D4D4D4D4D4D4D4D4D4D4D4D4D4D4D4D4",
        "role": "Primary governance module"
      },
      {
        "name": "AGIJobsTreasury",
        "address": "0xE5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5E5",
        "role": "Treasury vault / emission controller"
      },
      {
        "name": "HamiltonianMonitor",
        "address": "0xF6F6F6F6F6F6F6F6F6F6F6F6F6F6F6F6F6F6F6F6",
        "role": "Energy coupling supervisor"
      }
    ],
    "pausableFunctions": [
      {
        "contract": "AGIJobsGovernor",
        "function": "pause",
        "selector": "0x8456cb59",
        "description": "Global stop for task orchestration"
      },
      {
        "contract": "AGIJobsGovernor",
        "function": "unpause",
        "selector": "0x3f4ba83a",
        "description": "Resume operations"
      },
      {
        "contract": "AGIJobsTreasury",
        "function": "updateEmissionCurve",
        "selector": "0xa10204e9",
        "description": "Adjusts reward burn / mint ratios"
      }
    ],
    "safeModules": [
      "SafeModule:PauseGuardian",
      "SafeModule:UpgradeOrchestrator",
      "SafeModule:TreasuryFlows"
    ]
  },
  "ci": {
    "workflow": "ci (v2)",
    "requiredJobs": [
      { "id": "lint", "name": "Lint & static checks" },
      { "id": "tests", "name": "Tests" },
      { "id": "foundry", "name": "Foundry" },
      { "id": "coverage", "name": "Coverage thresholds" },
      { "id": "summary", "name": "CI summary" }
    ],
    "minCoverage": 90,
    "concurrency": "ci-${{ github.workflow }}-${{ github.ref }}"
  }
}

SHA-256 6b62cb88625631f0e3233747d8dc327df487285fe1fcd7230146380b87a638de

FROM READING TO A REPRODUCIBLE RUN

Try the selected path.

Python, no demo package install

Run from the repository root with Python 3.12. This selected entry point uses the Python standard library. Keep output in a separate directory so that you can compare runs.

Complete environment setup ↗
SELECTED EXECUTION PATH
python demo/agi-governance/run_demo.py --json

What you should observe

The terminal emits mission metrics as JSON. Use the original runbooks for the fuller TypeScript and owner-diagnostic workflows.

The source inspector above reads bundled repository material. Local commands run separately on your computer. Recorded examples may contain historical timestamps, placeholders and simulated metrics.

MAKE IT YOUR OWN

One useful experiment.

Change a coefficient in a copied mission file and run with --mission. Explain the changed metric from the formula rather than attributing it to real governance success.

THE SYSTEM, MADE VISIBLE

Architecture & relationships

Architecture diagram · source preserved below
View original Mermaid source
flowchart LR
    Operators((Mission Owners)) --> demo_agi_governance[[Demo → AGI Governance]]
    demo_agi_governance --> Core[[AGI Jobs v0 (v2) Core Intelligence]]
    Core --> Observability[[Unified CI / CD & Observability]]
    Core --> Governance[[Owner Control Plane]]

WHEN SOMETHING DOESN’T MATCH

Troubleshooting

Import or dependency error

Confirm the active virtual environment and the selected demo’s requirements. Run python -m pip check; do not install unrelated demo requirements over a working environment.

Unexpected result or missing file

Check the selected entry point, configuration and output argument. Keep the seed and implementation fixed before comparing outcomes.

TRACE THE CHECKS

Verification & next steps

2 tracked test source files are available in this directory. Inspect the tests and their environment before choosing a suite; file counts do not establish test results.

Browse the test sources

For live commissioning, consult the production readiness record.

EVERY VARIANT, PRESERVED

Complete document library

REPRODUCE & INSPECT

Registered commands

Run commands from the repository root after following this demo's guide. Network and owner actions require their documented setup.

npm run demo:agi-governance
npm run demo:agi-governance:alpha-v13
npm run demo:agi-governance:alpha-v13:ci
npm run demo:agi-governance:alpha-v13:full
npm run demo:agi-governance:alpha-v13:owner-diagnostics
npm run demo:agi-governance:alpha-v13:validate
npm run demo:agi-governance:alpha-v14
npm run demo:agi-governance:alpha-v14:ci
npm run demo:agi-governance:alpha-v14:full
npm run demo:agi-governance:alpha-v14:owner-diagnostics
npm run demo:agi-governance:alpha-v14:validate
npm run demo:agi-governance:alpha-v15
npm run demo:agi-governance:alpha-v15:ci
npm run demo:agi-governance:alpha-v15:full
npm run demo:agi-governance:alpha-v15:owner-diagnostics
npm run demo:agi-governance:alpha-v15:validate
npm run demo:agi-governance:alpha-v16
npm run demo:agi-governance:alpha-v16:ci
npm run demo:agi-governance:alpha-v16:full
npm run demo:agi-governance:alpha-v16:owner-diagnostics
npm run demo:agi-governance:alpha-v16:validate
npm run demo:agi-governance:alpha-v17
npm run demo:agi-governance:alpha-v17:ci
npm run demo:agi-governance:alpha-v17:full
npm run demo:agi-governance:alpha-v17:owner-diagnostics
npm run demo:agi-governance:alpha-v17:validate
npm run demo:agi-governance:ci
npm run demo:agi-governance:full
npm run demo:agi-governance:owner-diagnostics
npm run demo:agi-governance:validate

Full command catalog and troubleshooting ↗

ORIGINAL DIRECTORYdemo/agi-governanceView on GitHub ↗