Scale & orchestration
Cosmic Sovereign Symphony Explore a flagship coordination scenario and its complete operator runbook.
Code & guide What to expect This directory includes code and documentation. Its guide defines dependencies, execution modes and what the results demonstrate.
Guides & runbooks 8
Registered commands 1 Environment setup ↗ Guided tour Inspect the sources Try it locally Architecture Complete library
A CLOSER LOOK
How can a multi-stage governance rehearsal leave an auditable trail? For operators: inspect a flagship orchestration script, multinational governance inputs and the sequence of artifacts it assembles.
REAL REPOSITORY MATERIAL
Inspect. Understand. Reproduce. Reading the exact source at revision 5b4cebb3. This browser inspection does not execute the demo.
demo/cosmic-omni-sovereign-symphony/config/multinational-governance.json
Select a walkthrough step to explore its source.
Show more fields ↓ Full source text {
"owner": "0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266",
"pauserRole": "0x706175736572726f6c653a636f736d69632d6f6d6e69",
"nations": [
{
"id": "0x474c4f42414c5f4e4f52544845524e5f414c4c49414e4345",
"governor": "0x70997970c51812dc3a010c7d01b50e0d17dc79c8",
"weight": 1,
"metadataURI": "ipfs://example-global-northern-alliance"
},
{
"id": "0x504143494649435f434f4f4c4954494f4e5f534f5645524549474e",
"governor": "0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc",
"weight": 2,
"metadataURI": "ipfs://example-pacific-coalition"
}
],
"mandates": [
{
"id": "0x474f5645524e414e43455f4841524d4f4e59",
"quorum": 2,
"metadataURI": "ipfs://example-governance-harmony",
"startDelaySeconds": 30,
"durationSeconds": 3600
}
],
"votes": [
{
"mandateId": "0x474f5645524e414e43455f4841524d4f4e59",
"nationId": "0x474c4f42414c5f4e4f52544845524e5f414c4c49414e4345",
"support": true,
"metadataURI": "ipfs://example-global-northern-alliance/support"
},
{
"mandateId": "0x474f5645524e414e43455f4841524d4f4e59",
"nationId": "0x504143494649435f434f4f4c4954494f4e5f534f5645524549474e",
"support": true,
"metadataURI": "ipfs://example-pacific-coalition/support"
}
]
}
SHA-256 017b9c9521752a53b68f260d217d0dedba3e3717b461edd2cdef21c92609270c
The first source is shown in full. All walkthrough source links and the complete document library remain available without JavaScript.
{"revision":"5b4cebb309a83a7a6749d8911d8bf96a1921e042","sources":[{"file":"demo/cosmic-omni-sovereign-symphony/config/multinational-governance.json","content":"{\n \"owner\": \"0xf39fd6e51aad88f6f4ce6ab8827279cfffb92266\",\n \"pauserRole\": \"0x706175736572726f6c653a636f736d69632d6f6d6e69\",\n \"nations\": [\n {\n \"id\": \"0x474c4f42414c5f4e4f52544845524e5f414c4c49414e4345\",\n \"governor\": \"0x70997970c51812dc3a010c7d01b50e0d17dc79c8\",\n \"weight\": 1,\n \"metadataURI\": \"ipfs://example-global-northern-alliance\"\n },\n {\n \"id\": \"0x504143494649435f434f4f4c4954494f4e5f534f5645524549474e\",\n \"governor\": \"0x3c44cdddb6a900fa2b585dd299e03d12fa4293bc\",\n \"weight\": 2,\n \"metadataURI\": \"ipfs://example-pacific-coalition\"\n }\n ],\n \"mandates\": [\n {\n \"id\": \"0x474f5645524e414e43455f4841524d4f4e59\",\n \"quorum\": 2,\n \"metadataURI\": \"ipfs://example-governance-harmony\",\n \"startDelaySeconds\": 30,\n \"durationSeconds\": 3600\n }\n ],\n \"votes\": [\n {\n \"mandateId\": \"0x474f5645524e414e43455f4841524d4f4e59\",\n \"nationId\": \"0x474c4f42414c5f4e4f52544845524e5f414c4c49414e4345\",\n \"support\": true,\n \"metadataURI\": \"ipfs://example-global-northern-alliance/support\"\n },\n {\n \"mandateId\": \"0x474f5645524e414e43455f4841524d4f4e59\",\n \"nationId\": \"0x504143494649435f434f4f4c4954494f4e5f534f5645524549474e\",\n \"support\": true,\n \"metadataURI\": \"ipfs://example-pacific-coalition/support\"\n }\n ]\n}\n","format":"json","sha256":"017b9c9521752a53b68f260d217d0dedba3e3717b461edd2cdef21c92609270c","bytes":1315,"download":"/AGIJobsv0/examples/017b9c9521752a53-multinational-governance.json","source":"https://github.com/MontrealAI/AGIJobsv0/blob/5b4cebb309a83a7a6749d8911d8bf96a1921e042/demo/cosmic-omni-sovereign-symphony/config/multinational-governance.json"},{"file":"demo/cosmic-omni-sovereign-symphony/bin/flagship-demo.sh","content":"#!/usr/bin/env bash\nset -euo pipefail\n\ncd \"$(dirname \"$0\")/..\"\n\nusage() {\n cat <<USAGE\nUsage: $0 [--ci] [--dry-run]\n --ci Emit CI-friendly logs and disable interactive confirmations.\n --dry-run Forward dry-run mode to orchestrated components when available.\nUSAGE\n}\n\nCI_MODE=false\nDRY_RUN=false\n\nwhile [[ $# -gt 0 ]]; do\n case \"$1\" in\n --ci)\n CI_MODE=true\n shift\n ;;\n --dry-run)\n DRY_RUN=true\n shift\n ;;\n -h|--help)\n usage\n exit 0\n ;;\n *)\n echo \"[flagship] Unknown argument: $1\" >&2\n usage\n exit 1\n ;;\n esac\ndone\n\nLOG_DIR=\"logs/flagship-demo\"\nLOG_FILE=\"$LOG_DIR/flagship-demo.log\"\nmkdir -p \"$LOG_DIR\"\n\nif [[ -f .env ]]; then\n set -a\n # shellcheck disable=SC1091\n source .env\n set +a\nfi\n\nREPO_ROOT=\"$(realpath ..)\"\nWORKSPACE_ROOT=\"$(realpath \"$REPO_ROOT/..\")\"\n\nlog() {\n local level=\"$1\"\n shift\n printf '[%s] [flagship] [%s] %s\\n' \"$(date --iso-8601=seconds)\" \"$level\" \"$*\" | tee -a \"$LOG_FILE\"\n}\n\nrun_step() {\n local name=\"$1\"\n shift\n log INFO \">>> $name\"\n if \"$@\" > >(tee -a \"$LOG_FILE\") 2> >(tee -a \"$LOG_FILE\" >&2); then\n log INFO \"<<< $name\"\n else\n local status=$?\n log ERROR \"Step failed: $name\"\n exit $status\n fi\n}\n\nORCHESTRATE_ARGS=(\"--ci\")\nif [[ \"$CI_MODE\" != \"true\" ]]; then\n ORCHESTRATE_ARGS=()\nfi\nif [[ \"$DRY_RUN\" == \"true\" ]]; then\n ORCHESTRATE_ARGS+=(\"--dry-run\")\n export AGIJOBS_DEMO_DRY_RUN=true\nfi\n\nlog INFO \"Starting AGI Jobs flagship operating system rehearsal (CI_MODE=$CI_MODE, DRY_RUN=$DRY_RUN)\"\n\nif [[ \"$CI_MODE\" == \"true\" ]]; then\n export CYPRESS_INSTALL_BINARY=\"${CYPRESS_INSTALL_BINARY:-0}\"\n log INFO \"CI mode enabled – forcing CYPRESS_INSTALL_BINARY=$CYPRESS_INSTALL_BINARY to skip binary download\"\n export AGIJOBS_FLAGSHIP_SKIP_ONCHAIN=\"${AGIJOBS_FLAGSHIP_SKIP_ONCHAIN:-true}\"\n log INFO \"CI mode enabled – defaulting AGIJOBS_FLAGSHIP_SKIP_ONCHAIN=$AGIJOBS_FLAGSHIP_SKIP_ONCHAIN\"\nfi\n\nif [[ -d \"$WORKSPACE_ROOT/node_modules\" ]]; then\n log INFO \"node_modules detected at $WORKSPACE_ROOT/node_modules – skipping npm ci\"\nelse\n run_step \"Seed toolchain\" bash -c \"cd \\\"$WORKSPACE_ROOT\\\" && npm ci\"\nfi\nexport SKIP_NPM_CI=true\nrun_step \"Execute governance symphony\" ./bin/orchestrate.sh \"${ORCHESTRATE_ARGS[@]}\"\nrun_step \"Simulate AGI OS mission\" bash -c \"cd '$REPO_ROOT' && npm run demo:agi-os\"\nif [[ \"${AGIJOBS_FLAGSHIP_SKIP_ONCHAIN:-false}\" == \"true\" ]]; then\n run_step \"Capture owner control matrix\" bash -c \"cd '$REPO_ROOT' && (npm run owner:parameters || { echo '[owner:parameters] Non-zero exit tolerated with AGIJOBS_FLAGSHIP_SKIP_ONCHAIN=true'; exit 0; })\"\nelse\n run_step \"Capture owner control matrix\" bash -c \"cd '$REPO_ROOT' && npm run owner:parameters\"\nfi\n\nMERMAID_INPUT=\"docs/architecture.mmd\"\nMERMAID_OUTPUT=\"docs/architecture.svg\"\nif command -v mmdc >/dev/null 2>&1; then\n run_step \"Render governance diagram\" mmdc -i \"$MERMAID_INPUT\" -o \"$MERMAID_OUTPUT\"\nelif npx --no-install @mermaid-js/mermaid-cli --help >/dev/null 2>&1; then\n run_step \"Render governance diagram\" npx --no-install @mermaid-js/mermaid-cli -i \"$MERMAID_INPUT\" -o \"$MERMAID_OUTPUT\"\nelse\n log WARN \"Mermaid CLI not available; skipping diagram render\"\nfi\n\nSUMMARY_PATH=\"$LOG_DIR/summary.txt\"\ncat <<SUMMARY >\"$SUMMARY_PATH\"\nAGI Jobs v0 (v2) Flagship Demo Completed\n========================================\n- Governance ledger: demo/cosmic-omni-sovereign-symphony/logs/ledger-latest.json\n- Vote simulation: demo/cosmic-omni-sovereign-symphony/logs/vote-simulation.json\n- Knowledge graph payloads: demo/cosmic-omni-sovereign-symphony/logs/\n- Mission bundle: reports/agi-os/\n- Owner control matrix: reports/agi-os/owner-control-matrix.json (generated via npm run owner:parameters)\n- Verification report: demo/cosmic-omni-sovereign-symphony/logs/flagship-demo/verification.json\nSUMMARY\n\nVERIFY_CMD=(\"node\" \"./scripts/verify-flagship-report.mjs\")\nVERIFY_CMD+=(\"--reports-root\" \"$WORKSPACE_ROOT/reports/agi-os\")\nrun_step \"Verify flagship artefacts\" \"${VERIFY_CMD[@]}\"\n\nlog INFO \"Summary available at $SUMMARY_PATH\"\nlog INFO \"Flagship demo finished\"\n","format":"text","sha256":"6035aff433aea99997557ad1e03103397a3fb8b1b1d987dd7d24be626d838c3f","bytes":4076,"download":"/AGIJobsv0/examples/6035aff433aea999-flagship-demo.sh","source":"https://github.com/MontrealAI/AGIJobsv0/blob/5b4cebb309a83a7a6749d8911d8bf96a1921e042/demo/cosmic-omni-sovereign-symphony/bin/flagship-demo.sh"},{"file":"demo/cosmic-omni-sovereign-symphony/docs/architecture.mmd","content":"flowchart TD\n Operator[\"👩💼 Non-Technical Operator\"] -->|runs| Orchestrator{{\"bin/orchestrate.sh\"}}\n Orchestrator -->|calls| HardhatCLI[[\"Hardhat CLI\"]]\n Orchestrator -->|runs| Foundry[[\"Foundry Tests\"]]\n Orchestrator -->|exports| Logs((\"Audit Logs\"))\n HardhatCLI -->|deploys| CouncilContract[[\"GlobalGovernanceCouncil\"]]\n CouncilContract --> EthereumMainnet[(\"Ethereum Mainnet\")]\n CouncilContract --> DataPipelines[[\"Telemetry Exporters\"]]\n DataPipelines --> Grafana[(\"Grafana Dashboards\")]\n DataPipelines --> NationBriefings[(\"Nation Briefing Kits\")]\n Grafana --> Observers[\"Global Governance Observers\"]\n NationBriefings --> MultinationalLeaders[\"Multinational Leadership\"]\n","format":"text","sha256":"8a571a90308e71144940c420b99fabd93778cad2bb7afaefca898135fd27eac2","bytes":718,"download":"/AGIJobsv0/examples/8a571a90308e7114-architecture.mmd","source":"https://github.com/MontrealAI/AGIJobsv0/blob/5b4cebb309a83a7a6749d8911d8bf96a1921e042/demo/cosmic-omni-sovereign-symphony/docs/architecture.mmd"}]}
FROM READING TO A REPRODUCIBLE RUN
Try the selected path. Configured operator environment Start with the linked setup and component runbooks. This experience crosses several services or network-aware scripts; the first command below is labeled with its actual scope. Prepare local addresses, services and output paths before invoking the broader launcher.
Complete environment setup ↗ SELECTED EXECUTION PATH Copy
npm run demo:flagship -- --ci --dry-runWhat you should observe The rehearsal writes logs and report artifacts. It can require external tools and component prerequisites; read the wrapper and runbooks before execution. CI/dry-run evidence must remain labeled as rehearsal.
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. Pick a logged stage and identify its inputs, exit status and output artifact. Check whether it executed, simulated or skipped the corresponding external action.
THE SYSTEM, MADE VISIBLE
Architecture & relationships Architecture diagram · source preserved below
View original Mermaid source flowchart TD
Operator["👩💼 Non-Technical Operator"] -->|runs| Orchestrator{{"bin/orchestrate.sh"}}
Orchestrator -->|calls| HardhatCLI[["Hardhat CLI"]]
Orchestrator -->|runs| Foundry[["Foundry Tests"]]
Orchestrator -->|exports| Logs(("Audit Logs"))
HardhatCLI -->|deploys| CouncilContract[["GlobalGovernanceCouncil"]]
CouncilContract --> EthereumMainnet[("Ethereum Mainnet")]
CouncilContract --> DataPipelines[["Telemetry Exporters"]]
DataPipelines --> Grafana[("Grafana Dashboards")]
DataPipelines --> NationBriefings[("Nation Briefing Kits")]
Grafana --> Observers["Global Governance Observers"]
NationBriefings --> MultinationalLeaders["Multinational Leadership"]All standalone flowcharts (1)
WHEN SOMETHING DOESN’T MATCH
Troubleshooting A command or service fails Start at the first error, confirm the working directory and pinned toolchain, then follow the linked component guide. Optional packages and provider services have separate prerequisites.
A report looks successful but lacks evidence Check its source revision, configuration, timestamps and underlying events. Historical fixtures and generated plans do not prove a fresh execution.
TRACE THE CHECKS
Verification & next steps This directory has no standalone test source files. Follow the shared implementation and its behavioral tests before making correctness claims.
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:flagshipCopy
Full command catalog and troubleshooting ↗