Scale & orchestration

Helios Symphony

Explore the Helios coordination scenario, its configuration and architecture.

A CLOSER LOOK

How are several mission reports assembled into one operator packet?

For operators and reviewers: inspect a Makefile-driven assembly of ASI missions, owner reports, kits and a digest.

Inspect the orchestration recipe

Read the mission dependencies and report-copy paths. The recipe combines several workflows; report paths and prerequisites must agree before a full run.

demo/helios-omniversal-symphony/Makefile ↗

Follow a runnable component

Start with the maintained local ASI Global path to understand its actual output layout before assembling higher-level report bundles.

demo/asi-global/bin/asi-global-local.sh ↗

REAL REPOSITORY MATERIAL

Inspect. Understand. Reproduce.

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

Repository source4,032 bytesDownload source ↓View on GitHub ↗

demo/helios-omniversal-symphony/Makefile

Select a walkthrough step to explore its source.

Full source text
REPORT_ROOT ?= reports/helios-omniversal-symphony
TAKEOFF_ROOT := $(REPORT_ROOT)/asi-takeoff
GLOBAL_ROOT := $(REPORT_ROOT)/asi-global
OWNER_ROOT := $(REPORT_ROOT)/owner
LOG_ROOT := $(REPORT_ROOT)/logs
NETWORK ?= hardhat

.PHONY: mission clean prep plan governance kits digest

mission: clean prep plan governance kits digest
	@echo "Helios Omniversal Symphony mission complete → $(REPORT_ROOT)"

clean:
	rm -rf $(REPORT_ROOT)

prep:
	mkdir -p $(TAKEOFF_ROOT) $(GLOBAL_ROOT) $(OWNER_ROOT) $(LOG_ROOT)

plan: prep
	npm run demo:asi-takeoff:local
	npm run demo:asi-global
	cp demo/asi-takeoff/project-plan.json $(TAKEOFF_ROOT)/project-plan.json
	cp reports/asi-takeoff/dry-run.json $(TAKEOFF_ROOT)/dry-run.json
	cp reports/asi-takeoff/thermodynamics.json $(TAKEOFF_ROOT)/thermodynamics.json
	cp reports/asi-takeoff/mission-control.md $(TAKEOFF_ROOT)/mission-control.md
	cp reports/asi-takeoff/summary.md $(TAKEOFF_ROOT)/summary.md
	cp reports/asi-takeoff/summary.json $(TAKEOFF_ROOT)/summary.json
	if [ -d reports/asi-takeoff/mission-bundle ]; then rm -rf $(TAKEOFF_ROOT)/mission-bundle && cp -R reports/asi-takeoff/mission-bundle $(TAKEOFF_ROOT)/; fi
	if [ -d reports/asi-takeoff/logs ]; then rm -rf $(TAKEOFF_ROOT)/logs && cp -R reports/asi-takeoff/logs $(TAKEOFF_ROOT)/; fi
	cp demo/asi-global/project-plan.json $(GLOBAL_ROOT)/project-plan.json
	cp reports/asi-global/dry-run.json $(GLOBAL_ROOT)/dry-run.json
	cp reports/asi-global/thermodynamics.json $(GLOBAL_ROOT)/thermodynamics.json
	cp reports/asi-global/mission-control.md $(GLOBAL_ROOT)/mission-control.md
	cp reports/asi-global/summary.md $(GLOBAL_ROOT)/summary.md
	cp reports/asi-global/summary.json $(GLOBAL_ROOT)/summary.json
	if [ -f reports/asi-global/command-center.md ]; then cp reports/asi-global/command-center.md $(GLOBAL_ROOT)/command-center.md; fi
	if [ -f reports/asi-global/parameter-matrix.md ]; then cp reports/asi-global/parameter-matrix.md $(GLOBAL_ROOT)/parameter-matrix.md; fi
	if [ -f reports/asi-global/governance.mmd ]; then cp reports/asi-global/governance.mmd $(GLOBAL_ROOT)/governance.mmd; fi
	if [ -f reports/asi-global/governance.md ]; then cp reports/asi-global/governance.md $(GLOBAL_ROOT)/governance.md; fi
	if [ -d reports/asi-global/mission-bundle ]; then rm -rf $(GLOBAL_ROOT)/mission-bundle && cp -R reports/asi-global/mission-bundle $(GLOBAL_ROOT)/; fi
	if [ -d reports/asi-global/logs ]; then rm -rf $(GLOBAL_ROOT)/logs && cp -R reports/asi-global/logs $(GLOBAL_ROOT)/; fi


governance: prep
	npm run owner:mission-control -- --network $(NETWORK) --format markdown --out $(OWNER_ROOT)/mission-control.md --bundle $(OWNER_ROOT)/mission-control-bundle
       npm run owner:command-center -- --network $(NETWORK) --format markdown --output $(OWNER_ROOT)/command-center.md
	npm run owner:parameters -- --network $(NETWORK) --format markdown --out $(OWNER_ROOT)/parameter-matrix.md
	npm run owner:emergency -- --network $(NETWORK) --format markdown --out $(OWNER_ROOT)/emergency-runbook.md
	npx hardhat run --no-compile scripts/v2/thermodynamicsReport.ts --network $(NETWORK) -- --format markdown --out $(OWNER_ROOT)/thermodynamics.md


kits: plan governance
	npm run demo:asi-takeoff:kit -- --report-root $(TAKEOFF_ROOT) --plan $(TAKEOFF_ROOT)/project-plan.json --bundle $(TAKEOFF_ROOT)/mission-bundle --logs $(TAKEOFF_ROOT)/logs --summary-md $(TAKEOFF_ROOT)/summary.md --summary-json $(TAKEOFF_ROOT)/summary.json --mission-control $(TAKEOFF_ROOT)/mission-control.md --output-name helios-asi-takeoff-kit
	npm run demo:asi-global:kit -- --report-root $(GLOBAL_ROOT) --plan $(GLOBAL_ROOT)/project-plan.json --dry-run $(GLOBAL_ROOT)/dry-run.json --thermodynamics $(GLOBAL_ROOT)/thermodynamics.json --mission-control $(GLOBAL_ROOT)/mission-control.md --summary-md $(GLOBAL_ROOT)/summary.md --summary-json $(GLOBAL_ROOT)/summary.json --bundle $(GLOBAL_ROOT)/mission-bundle --logs $(GLOBAL_ROOT)/logs --output-basename helios-asi-global-kit


digest: kits
	cd $(REPORT_ROOT) && find . -type f -print0 | sort -z | xargs -0 sha256sum > SHA256SUMS

SHA-256 6d90f28f1507795a13896f86d08e7fa96f8f7a3ae630dc957b64d1bf8ead1175

FROM READING TO A REPRODUCIBLE RUN

Try the selected path.

Disposable local chain

From the repository root, use nvm install, nvm use and npm ci with the pinned Node/npm versions. The local driver uses mock assets; its owned development node stops at the end. If port 8545 is occupied, use DEMO_PORT=18545.

Complete environment setup ↗
SELECTED EXECUTION PATH
npm run demo:asi-global:local

What you should observe

The related ASI Global component produces local transaction evidence. This is a component rehearsal; the Helios Makefile remains a separate assembly recipe requiring its documented inputs.

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.

Compare the Makefile’s expected report paths with the outputs of a fresh component run. Do not copy an old report to satisfy a missing new-run artifact.

THE SYSTEM, MADE VISIBLE

Architecture & relationships

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

WHEN SOMETHING DOESN’T MATCH

Troubleshooting

Port already in use

Choose DEMO_PORT=18545 before the command. Do not connect a demo to an unrelated or valuable chain.

No final settlement evidence

Read the first failed transaction or validation step. Compare the effective mission, committee thresholds and report scope; a partial report is not a completed run.

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.

No root-level launch command is associated with this source path. Follow the guide or source directory for its own entry point.

Full command catalog and troubleshooting ↗

ORIGINAL DIRECTORYdemo/helios-omniversal-symphonyView on GitHub ↗