Skip to content

world: dataset-world contract (WorldEvent + IdentityGraph + registry + visual trace) - #6

Merged
arybach merged 1 commit into
mainfrom
feat/world-contract
Aug 25, 2026
Merged

world: dataset-world contract (WorldEvent + IdentityGraph + registry + visual trace)#6
arybach merged 1 commit into
mainfrom
feat/world-contract

Conversation

@arybach

@arybach arybach commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

P0 of the Business-OS / dataset-worlds pivot (~/Documents/redevops_demo_reimplementation_plan.docx Phase 0 + the v2 Gusto-class plan) — the canonical entry contract that replaces the fictional single-tenant demo object with reproducible, provenance-preserving worlds. Built on the primitives that already exist (EvidenceRef, content_hash), so this is the seam, not a rebuild.

runtime_contracts.world:

  • WorldEvent — a source record entering the stack: canonical entity_ids, content-addressed EvidenceRefs (never a copy), bitemporal observed/effective/known, explicit RealismClass (the 2026-08-25 audit vocabulary, now a contract), permissions/tenant, optional GroundTruth, capability requirements, scenario seed. identity() = rcv1 hash of the semantic fields (known_at + optimizer hints excluded) → stable across every hop.
  • IdentityGraph — one canonical entity → many app native ids (registered or deterministically derived), with reverse resolution so a webhook maps back rather than inventing a new object.
  • WorldRegistry + default_registry() — catalogs the fleet's strongest real/public sources, each labelled by realism.
  • VisualTrace / TraceMilestone / Capsule / NeedsYouReason — the stream the animated execution canvas renders; the capsule carries identity/evidence/policy/authority by reference.

Exit criterion demonstrated (docx Phase 0): one source record retains identity + provenance through Discovery → Mission → Context → app capability. 5 tests; full suite 328 green, additive.

Next (Phase 1): the runtime components — projection seeders, outcome simulator, scenario orchestrator — and the flagship 'Answer Now, Quote Now' vertical wiring these into a live canvas.

🤖 Generated with Claude Code

…+ visual trace)

P0 of the Business-OS / dataset-worlds pivot: the canonical entry contract that
replaces the fictional single-tenant demo object with reproducible,
provenance-preserving worlds.

- WorldEvent: a source record entering the stack — canonical entity_ids,
  content-addressed evidence (EvidenceRef, never a copy), bitemporal
  observed/effective/known, explicit RealismClass (the audit vocabulary as a
  contract), permissions/tenant scope, optional GroundTruth, capability
  requirements, scenario seed. identity() = rcv1 hash of the semantic fields
  (known_at + optimizer hints excluded) — stable across every stack hop.
- EntityKind: the canonical business-object kinds; EntityRef the carried identity.
- IdentityGraph: one canonical entity -> many app native ids (registered where a
  seeder created a record, deterministically derived otherwise), + reverse
  resolution so an app webhook maps back, never inventing a new object.
- WorldRegistry + default_registry(): catalogs the fleet's strongest real/public
  sources (FinanceBench, GitHub/HN, GLEIF+OpenSanctions, gov parcels, CrowdSec,
  tau-bench) each labelled by realism.
- VisualTrace/TraceMilestone/Capsule/NeedsYouReason: the presentation stream the
  animated execution canvas renders — the capsule carries identity/evidence/
  policy/authority by reference, not copies.

Exit criterion demonstrated: one source record retains identity + provenance
through Discovery -> Mission -> Context -> app capability, and the same entity
resolves to every app. 5 tests; full suite 328 green, additive.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@arybach
arybach merged commit 78c6d66 into main Aug 25, 2026
arybach pushed a commit that referenced this pull request Aug 25, 2026
…h/WorldRegistry/VisualTrace)

v0.3.1 was tagged before the world contract (PR #6) merged to main, so
downstream pins on v0.3.1 lack runtime_contracts.world. v0.3.2 tags main with
the world module present, letting agentic-os build the world-canvas image from
published deps instead of a bundled working tree.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant