Governance & validation

OmniSovereign

Run six connected coordination analyses, inspect exact evidence, and explore reviewer-constrained machine labor.

OPEN THE COMPLETE COMMAND DECKS

Explore the model in your browser.

Read-only dashboards with energy, governance, stress scenarios and preserved diagrams. No wallet or installation required; all values come from recorded simulations.

A CLOSER LOOK

How can useful machine work scale across city, regional and planetary planning layers?

Run the complete six-stage synthetic coordination rehearsal, export exact worker tasks, and check evidence before any independent acceptance or settlement.

Run the dedicated coordination workflow

Execute the six original stage identities with actual inventory, allocation, treasury, energy, reviewer-capacity and dossier artifacts. The underlying customer briefs remain planned examples.

demo/omnisovereign/execute.mjs ↗

Challenge the evidence

Recompute source arithmetic independently; reject wrong answers even if hashes are recalculated. Check adapter receipts against separately supplied job/deployment bindings.

demo/omnisovereign/review.mjs ↗

Commission authorized computer work

Use the admitted OpenClaw adapter or an operator-led Work session. Retain the national/planetary chain drills and keep their local mock-token receipts separate from USDC planning.

demo/omnisovereign/RUNBOOK.md ↗

REAL REPOSITORY MATERIAL

Inspect. Understand. Reproduce.

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

Repository source5,703 bytesDownload source ↓View on GitHub ↗

demo/omnisovereign/execute.mjs

Select a walkthrough step to explore its source.

Full source text
import {
  amount,
  decimal,
  stages,
  boundary,
  json,
  canonical,
  sha256,
  makeTask,
  taskDigest,
  validateScenario,
} from './model.mjs';

export function produce(source, id, completed) {
  const sum = (rows, key) =>
    decimal(rows.reduce((n, row) => n + amount(row[key]), 0n));
  if (id === stages[0].id)
    return {
      workIds: source.work.map((w) => w.id),
      count: source.work.length,
      plannedRewardsUsdc: sum(source.work, 'rewardUsdc'),
      estimatedProviderCostUsdc: sum(source.work, 'estimatedCostUsdc'),
      ...boundary,
    };
  if (id === stages[1].id)
    return {
      regions: source.regions.map((r) => {
        const work = source.work.filter((w) => w.region === r.id);
        const required = work.reduce((n, w) => n + w.reviewMinutes, 0);
        return {
          id: r.id,
          workIds: work.map((w) => w.id),
          plannedRewardsUsdc: sum(work, 'rewardUsdc'),
          requiredReviewMinutes: required,
          availableReviewMinutes: r.reviewMinutes,
          shortfallMinutes: Math.max(0, required - r.reviewMinutes),
        };
      }),
      ...boundary,
    };
  if (id === stages[2].id) {
    const committed = completed[stages[0].id].plannedRewardsUsdc;
    const reserve = amount(source.budgetUsdc) - amount(committed);
    return {
      budgetUsdc: decimal(amount(source.budgetUsdc)),
      committedPlanUsdc: committed,
      unallocatedUsdc: decimal(reserve),
      minimumReserveUsdc: decimal(amount(source.minimumReserveUsdc)),
      reserveAdequate: reserve >= amount(source.minimumReserveUsdc),
      actualPaidUsdc: '0.000000',
      ...boundary,
    };
  }
  if (id === stages[3].id) {
    const regions = source.regions.map((r) => ({
      id: r.id,
      netMwh: r.generatedMwh - r.demandMwh,
    }));
    const generatedMwh = source.regions.reduce((n, r) => n + r.generatedMwh, 0);
    const demandMwh = source.regions.reduce((n, r) => n + r.demandMwh, 0);
    return {
      regions,
      generatedMwh,
      demandMwh,
      netMwh: generatedMwh - demandMwh,
      deficitRegions: regions.filter((r) => r.netMwh < 0).map((r) => r.id),
      transfersAssumed: false,
      ...boundary,
    };
  }
  if (id === stages[4].id) {
    const admittedWorkIds = [],
      deferredWorkIds = [];
    let usedMinutes = 0;
    for (const r of source.regions) {
      let left = r.reviewMinutes;
      for (const w of source.work.filter((w) => w.region === r.id)) {
        if (w.reviewMinutes <= left) {
          admittedWorkIds.push(w.id);
          left -= w.reviewMinutes;
          usedMinutes += w.reviewMinutes;
        } else deferredWorkIds.push(w.id);
      }
    }
    const requiredMinutes = source.work.reduce(
      (n, w) => n + w.reviewMinutes,
      0
    );
    return {
      admittedWorkIds,
      deferredWorkIds,
      availableMinutes: source.regions.reduce((n, r) => n + r.reviewMinutes, 0),
      usedMinutes,
      requiredMinutes,
      unmetMinutes: requiredMinutes - usedMinutes,
      independentlyReviewed: false,
      ...boundary,
    };
  }
  if (id === stages[5].id)
    return {
      workIds: source.work.map((w) => w.id),
      stageIds: stages.map((s) => s.id),
      plannedRewardsUsdc: completed[stages[0].id].plannedRewardsUsdc,
      reserveUsdc: completed[stages[2].id].unallocatedUsdc,
      energyNetMwh: completed[stages[3].id].netMwh,
      reviewDeferredCount: completed[stages[4].id].deferredWorkIds.length,
      evidenceClass: 'deterministic-simulation',
      physicalExecution: false,
      chainTransactions: 0,
      ...boundary,
    };
  throw new Error('Unknown execution stage.');
}

export async function execute(source, onStage = () => {}) {
  validateScenario(source);
  const completed = {},
    results = [];
  for (const stage of stages) {
    if (stage.dependencies.some((id) => !completed[id]))
      throw new Error('Dependency evidence is missing.');
    const task = await makeTask(source, stage.id);
    const content = json(produce(source, stage.id, completed));
    completed[stage.id] = JSON.parse(content);
    const result = {
      stageId: stage.id,
      dependencies: stage.dependencies,
      taskSha256: await taskDigest(task),
      artifact: {
        name: stage.file,
        mediaType: 'application/json',
        content,
        bytes: new TextEncoder().encode(content).length,
        sha256: await sha256(content),
      },
    };
    results.push(result);
    await onStage(result);
  }
  return {
    schemaVersion: 1,
    scenarioId: source.id,
    sourceSha256: await sha256(canonical(source)),
    evidenceClass: 'deterministic-simulation',
    providerCalls: 0,
    chainTransactions: 0,
    results,
    ...boundary,
  };
}

export function renderReport(bundle) {
  const result = Object.fromEntries(
    bundle.results.map((r) => [r.stageId, JSON.parse(r.artifact.content)])
  );
  const dossier = result['SOV-PUBLIC-DOSSIER'];
  return (
    '# OmniSovereign mission dossier\n\nEvidence: deterministic computation over synthetic inputs. No provider call, payment or infrastructure action occurred.\n\n' +
    `Planned work: ${dossier.plannedRewardsUsdc} USDC. Unallocated reserve: ${dossier.reserveUsdc} USDC. Energy balance: ${dossier.energyNetMwh} MWh. Work briefs deferred by review capacity: ${dossier.reviewDeferredCount}.\n\n` +
    bundle.results
      .map(
        (r) =>
          `- ${r.stageId}: ${r.artifact.name}, SHA-256 ${r.artifact.sha256}`
      )
      .join('\n') +
    '\n\nThese are six coordination analyses. The six underlying work briefs are planned examples, not completed customer jobs. Independent artifact checks do not prove provider provenance, substantive acceptance or settlement.\n'
  );
}

SHA-256 a979400d4bae82b27a1f065780352ed01fb0a22f6ab379f7d5622d5da5c37235

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
npm run demo:omnisovereign

What you should observe

Six JSON artifacts, six task contracts, source, evidence bundle, review result and readable dossier in a unique reports/omnisovereign directory. No provider calls or payments.

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.

Run the rehearsal, reject a rehashed wrong answer, and vary reviewer capacity before increasing agent count.

THE SYSTEM, MADE VISIBLE

Architecture & relationships

Architecture diagram · source preserved below
View original Mermaid source
flowchart TD
    I["Inventory"] --> C["Regional coordination"]
    I --> E["Energy analysis"]
    C --> T["Treasury reconciliation"]
    C --> V["Review capacity"]
    E --> V
    T --> D["Mission dossier"]
    V --> D

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:omnisovereign
npm run demo:omnisovereign:serve
npm run demo:omnisovereign:task
npm run demo:omnisovereign:review
npm run demo:omnisovereign:worker
npm run demo:omnisovereign:test
npm run demo:omnisovereign:qa

Full command catalog and troubleshooting ↗

ORIGINAL DIRECTORYdemo/omnisovereignView on GitHub ↗