Skip to main content

First World

This is the fastest end-to-end workflow for proving the module is healthy.

1. Create a starter scenario​

$scenario = New-SEScenarioFromArchetype -Archetype RegionalManufacturer
$scenario = Resolve-SEScenario -Scenario $scenario
$validation = Test-SEScenario -Scenario $scenario
$validation

You should see a valid resolved scenario unless your environment is missing required catalog or plugin content.

2. Generate a world​

$world = New-SEEnterpriseWorld -Scenario $scenario -Seed 4242
$summary = $world | Get-SEWorldSummary
$summary
$world.Quality

The summary object is the quickest way to confirm you generated a substantial world instead of an unexpectedly sparse dataset. The Quality report gives you a structured realism and validation view for the same run.

3. Save the snapshot​

$snapshotPath = Join-Path $PWD 'out\first-world.seworld'
$world | Save-SEEnterpriseWorld -Path $snapshotPath -Compress

This gives you a portable DataGen snapshot for later re-import.

4. Export normalized artifacts​

$exportPath = Join-Path $PWD 'out\first-world-export'
$manifest = $world | Export-SEEnterpriseWorld `
  -OutputPath $exportPath `
  -Format Json `
  -Profile Normalized `
  -IncludeManifest `
  -IncludeSummary `
  -Overwrite

$manifest

Typical normalized export output includes entity and relationship artifacts for areas such as:

  • companies and offices
  • people, accounts, groups, and identity stores
  • devices, servers, software, and network assets
  • applications, services, tenants, and repositories
  • policies, access evidence, observed views, and CMDB artifacts
  • temporal events and temporal snapshots when the scenario includes simulation output

5. Run a realism review​

.\scripts\invoke-realism-review.ps1 `
  -ScenarioPath .\examples\regional_manufacturer.scenario.json `
  -Seed 4242 `
  -OutputPath .\artifacts\quality\realism-review.md `
  -JsonOutputPath .\artifacts\quality\realism-review.json `
  -OutputFormat Both

That gives you both a human-readable review and a JSON validation artifact you can reuse in CI or downstream checks.

6. Re-import the snapshot​

$imported = Import-SEEnterpriseWorld -Path $snapshotPath
$imported | Get-SEWorldSummary

That round-trip verifies the snapshot path and schema compatibility behavior.

What good looks like​

After this flow, you should have:

  • a valid scenario
  • a generated world
  • a structured quality report
  • a saved snapshot
  • a normalized export directory
  • a manifest, summary, and realism review

Next step​

From here, either: